The probabilistic sequence interface. More...

#include <Bpp/Seq/ProbabilisticSequence.h>

Inheritance diagram for bpp::ProbabilisticSequenceInterface:

Collaboration diagram for bpp::ProbabilisticSequenceInterface:

Public Types
typedef std::vector< double >	ElementType

typedef std::vector< double >	SymbolType

typedef Table< double >	DTable

Public Member Functions
virtual	~ProbabilisticSequenceInterface ()

virtual ProbabilisticSequenceInterface *	clone () const =0

virtual std::shared_ptr< const Alphabet >	getAlphabet () const =0
	Get the alphabet associated to the list. More...

virtual const Alphabet &	alphabet () const =0
	Get the alphabet associated to the list. More...

virtual size_t	size () const =0
	Get the number of elements in the list. More...

virtual std::string	toString () const =0
	Convert the list as a string. More...

virtual double	getStateValueAt (size_t position, int state) const =0
	get value of a state at a position More...

virtual double	operator() (size_t position, int state) const =0
	get value of a state at a position More...

virtual const Comments &	getComments () const =0
	Get the comments. More...

virtual void	setComments (const Comments &comments)=0
	Set the comments. More...

virtual void	clearComments ()=0

virtual const DTable &	getTable () const =0

virtual void	setContent (const DTable &list)=0

virtual void	setContent (const std::vector< T > &list)=0
	Set the whole content of the list. More...

Setting/getting the name of the sequence.
virtual const std::string &	getName () const =0
	Get the name of this sequence. More...

virtual void	setName (const std::string &name)=0
	Set the name of this sequence. More...

Adjusting the size of the sequence.
virtual void	setToSizeR (size_t newSize)=0
	Set up the size of a sequence from the right side. More...

virtual void	setToSizeL (size_t newSize)=0
	Set up the size of a sequence from the left side. More...

Edition methods.
virtual void	deleteElement (size_t pos)=0
	Remove the element at position 'pos'. More...

virtual void	deleteElements (size_t pos, size_t len)=0
	Remove the elements at position 'pos'. More...

Provide direct access to the list content.
Warning These operators allow you to modify the list content. No alphabet checking is performed for your modifications, so use with care, or consider using the setContent() method.
virtual void	shuffle ()=0
	Randomly shuffle the content of the list, with linear complexity. More...

Acting on the content of the list.
virtual void	setContent (const std::vector< T > &list)=0
	Set the whole content of the list. More...

virtual const std::vector< T > &	getContent () const =0

Edition methods.
virtual void	addElement (const T &c)=0
	Add a character to the end of the list. More...

virtual void	addElement (size_t pos, const T &c)=0
	Add a character at a certain position in the list. More...

virtual void	setElement (size_t pos, const T &c)=0
	Set the element at position 'pos' to character 'c'. More...

virtual const T &	getElement (size_t pos) const =0
	Get the element at position 'pos' as a character. More...

Provide direct access to the list content.
Warning These operators allow you to modify the list content. No alphabet checking is performed for your modifications, so use with care, or consider using the setContent() method.
virtual const T &	getValue (size_t pos) const =0
	checked access to a character in list. More...

virtual const T &	operator[] (size_t pos) const =0
	Operator [] overloaded for quick access to a character in list. More...

virtual T &	operator[] (size_t pos)=0
	Operator [] overloaded for quick access to a character in list. More...

Detailed Description

The probabilistic sequence interface.

This is a general purpose container, containing an ordered list of elements. The states represented by the elements is defined by an alphabet object.

ProbabilisticSequence objects also contain a name attribute and potentially several comment lines.

See also: Alphabet

Definition at line 30 of file ProbabilisticSequence.h.

Member Typedef Documentation

◆ DTable

typedef Table<double> bpp::ProbabilisticSymbolListInterface::DTable

inherited

Definition at line 35 of file ProbabilisticSymbolList.h.

◆ ElementType

typedef std::vector<double> bpp::ProbabilisticSequenceInterface::ElementType

Definition at line 35 of file ProbabilisticSequence.h.

◆ SymbolType

typedef std::vector<double> bpp::ProbabilisticSymbolListInterface::SymbolType

inherited

Definition at line 34 of file ProbabilisticSymbolList.h.

Constructor & Destructor Documentation

◆ ~ProbabilisticSequenceInterface()

virtual bpp::ProbabilisticSequenceInterface::~ProbabilisticSequenceInterface ( )

inlinevirtual

Definition at line 38 of file ProbabilisticSequence.h.

Member Function Documentation

◆ addElement() [1/2]

template<class T >

virtual void bpp::TemplateCoreSymbolListInterface< T >::addElement ( const T & c )

pure virtualinherited

Add a character to the end of the list.

Parameters

c	The character to add.

Implemented in bpp::AbstractTemplateEventDrivenSymbolList< T >, and bpp::AbstractTemplateSymbolList< T >.

◆ addElement() [2/2]

template<class T >

virtual void bpp::TemplateCoreSymbolListInterface< T >::addElement	(	size_t	pos,
		const T &	c
	)

pure virtualinherited

Add a character at a certain position in the list.

Parameters

pos	The position where to insert the element.
c	The character to add.

Implemented in bpp::AbstractTemplateEventDrivenSymbolList< T >, and bpp::AbstractTemplateSymbolList< T >.

◆ alphabet()

virtual const Alphabet& bpp::CruxSymbolListInterface::alphabet ( ) const

pure virtualinherited

Get the alphabet associated to the list.

Returns: A const reference to the alphabet.

See also: Alphabet class.

Implemented in bpp::AbstractTemplateSymbolList< T >, bpp::AbstractTemplateSymbolList< int >, and bpp::ProbabilisticSymbolList.

◆ clearComments()

virtual void bpp::Commentable::clearComments ( )

pure virtualinherited

Implemented in bpp::SimpleCommentable.

◆ clone()

virtual ProbabilisticSequenceInterface* bpp::ProbabilisticSequenceInterface::clone ( ) const

pure virtual

Implements bpp::CoreSequenceInterface.

Implemented in bpp::ProbabilisticSequence.

◆ deleteElement()

virtual void bpp::CruxSymbolListInterface::deleteElement ( size_t pos )

pure virtualinherited

Remove the element at position 'pos'.

Parameters

pos	The position of the element to remove.

Implemented in bpp::AbstractTemplateEventDrivenSymbolList< T >, bpp::AbstractTemplateEventDrivenSymbolList< int >, bpp::AbstractTemplateSymbolList< T >, bpp::AbstractTemplateSymbolList< int >, and bpp::ProbabilisticSymbolList.

Referenced by bpp::SequenceTools::getCDS(), bpp::SequenceTools::removeGaps(), and bpp::SequenceTools::removeStops().

◆ deleteElements()

virtual void bpp::CruxSymbolListInterface::deleteElements	(	size_t	pos,
		size_t	len
	)

pure virtualinherited

Remove the elements at position 'pos'.

Parameters

pos	The position of the first element to remove.
len	The length of the region to remove.

Implemented in bpp::AbstractTemplateEventDrivenSymbolList< T >, bpp::AbstractTemplateEventDrivenSymbolList< int >, bpp::AbstractTemplateSymbolList< T >, bpp::AbstractTemplateSymbolList< int >, and bpp::ProbabilisticSymbolList.

◆ getAlphabet()

virtual std::shared_ptr<const Alphabet> bpp::CruxSymbolListInterface::getAlphabet ( ) const

pure virtualinherited

Get the alphabet associated to the list.

Returns: A const pointer to the alphabet.

See also: Alphabet class.

Implemented in bpp::AbstractTemplateSymbolList< T >, bpp::AbstractTemplateSymbolList< int >, and bpp::ProbabilisticSymbolList.

◆ getComments()

virtual const Comments& bpp::Commentable::getComments ( ) const

pure virtualinherited

Get the comments.

Returns: The comments.

Implemented in bpp::SimpleCommentable.

Referenced by bpp::Mase::appendSequencesFromStream(), bpp::AllelicAlphabet::convertFromStateAlphabet(), bpp::SiteContainerTools::getSelectedPositions(), bpp::MaseTools::getSelectedSites(), bpp::SiteContainerTools::getSelectedSites(), bpp::AbstractCoreSequence::operator=(), bpp::AbstractTemplateSequenceContainer< SequenceType, HashType >::operator=(), bpp::TemplateVectorSequenceContainer< SequenceType >::operator=(), bpp::SiteContainerTools::resolveDottedAlignment(), bpp::NucleicAcidsReplication::reverse(), bpp::AbstractReverseTransliterator::reverse(), bpp::SequenceTools::RNYslice(), bpp::SequenceTools::subseq(), bpp::TemplateAlignedSequenceContainer< SequenceType, SiteType >::TemplateAlignedSequenceContainer(), bpp::TemplateVectorSequenceContainer< SequenceType >::TemplateVectorSequenceContainer(), bpp::NucleicAcidsReplication::translate(), bpp::AbstractTransliterator::translate(), bpp::Stockholm::writeAlignment(), bpp::Fasta::writeSequences(), and bpp::Mase::writeSequences().

◆ getContent()

template<class T >

virtual const std::vector<T>& bpp::TemplateCoreSymbolListInterface< T >::getContent ( ) const

pure virtualinherited

Implemented in bpp::AbstractTemplateSymbolList< T >, bpp::AbstractTemplateSymbolList< int >, and bpp::ProbabilisticSymbolList.

Referenced by bpp::Sequence::append(), bpp::SequenceWithQualityTools::concatenate(), bpp::SequenceWithQualityTools::invert(), bpp::SequenceWithAnnotation::merge(), bpp::ProbabilisticSymbolList::operator=(), and bpp::Sequence::operator=().

◆ getElement()

template<class T >

virtual const T& bpp::TemplateCoreSymbolListInterface< T >::getElement ( size_t pos ) const

pure virtualinherited

Get the element at position 'pos' as a character.

Parameters

pos	The position of the character to retrieve.

Implemented in bpp::AbstractTemplateSymbolList< T >, bpp::AbstractTemplateSymbolList< int >, and bpp::ProbabilisticSymbolList.

◆ getName()

virtual const std::string& bpp::CoreSequenceInterface::getName ( ) const

pure virtualinherited

Get the name of this sequence.

Returns: This sequence name.

Implemented in bpp::AbstractCoreSequence.

Referenced by bpp::SequenceTools::combineSequences(), bpp::SequenceTools::concatenate(), bpp::AllelicAlphabet::convertFromStateAlphabet(), bpp::SequenceTools::getPutativeHaplotypes(), bpp::AbstractCoreSequence::operator=(), bpp::CodonAlphabet::reverse(), bpp::WordAlphabet::reverse(), bpp::NucleicAcidsReplication::reverse(), bpp::AbstractReverseTransliterator::reverse(), bpp::SequenceTools::RNYslice(), bpp::SequenceTools::subseq(), bpp::SequenceTools::subtractHaplotype(), bpp::NucleicAcidsReplication::translate(), bpp::AbstractTransliterator::translate(), bpp::CodonAlphabet::translate(), and bpp::WordAlphabet::translate().

◆ getStateValueAt()

virtual double bpp::CruxSymbolListInterface::getStateValueAt	(	size_t	position,
		int	state
	)		const

pure virtualinherited

get value of a state at a position

Parameters

position	position in the list
state	state in the alphabet

Returns: The state value at the given position.

Implemented in bpp::Sequence, bpp::ProbabilisticSequence, bpp::ProbabilisticSymbolList, bpp::IntSymbolList, bpp::CoreSiteInterface, bpp::Site, and bpp::ProbabilisticSite.

Referenced by bpp::ProbabilisticSymbolList::ProbabilisticSymbolList().

◆ getTable()

virtual const DTable& bpp::ProbabilisticSymbolListInterface::getTable ( ) const

pure virtualinherited

Implemented in bpp::ProbabilisticSymbolList.

◆ getValue()

template<class T >

virtual const T& bpp::TemplateCoreSymbolListInterface< T >::getValue ( size_t pos ) const

pure virtualinherited

checked access to a character in list.

Parameters

pos	The position to retrieve.

Returns: The T value of character at position pos.

Implemented in bpp::AbstractTemplateSymbolList< T >, bpp::AbstractTemplateSymbolList< int >, and bpp::ProbabilisticSymbolList.

Referenced by bpp::SequenceTools::combineSequences(), bpp::SequenceTools::complement(), bpp::SequenceTools::findFirstOf(), bpp::SymbolListTools::getGCContent(), bpp::SequenceTools::getPercentIdentity(), bpp::SequenceTools::invert(), bpp::SequenceTools::invertComplement(), bpp::NucleicAcidsReplication::reverse(), bpp::AbstractReverseTransliterator::reverse(), bpp::SequenceTools::subtractHaplotype(), bpp::NucleicAcidsReplication::translate(), and bpp::AbstractTransliterator::translate().

◆ operator()()

virtual double bpp::CruxSymbolListInterface::operator()	(	size_t	position,
		int	state
	)		const

pure virtualinherited

get value of a state at a position

Short-cut for getStateValueAt.

Parameters

position	position in the list
state	state in the alphabet

Returns: The state value at the given position.

Implemented in bpp::ProbabilisticSymbolList, and bpp::IntSymbolList.

◆ operator[]() [1/2]

template<class T >

virtual const T& bpp::TemplateCoreSymbolListInterface< T >::operator[] ( size_t pos ) const

pure virtualinherited

Operator [] overloaded for quick access to a character in list.

Parameters

pos	The position to retrieve.

Returns: The T value of character at position pos.

Implemented in bpp::AbstractTemplateSymbolList< T >, bpp::AbstractTemplateSymbolList< int >, and bpp::ProbabilisticSymbolList.

◆ operator[]() [2/2]

template<class T >

virtual T& bpp::TemplateCoreSymbolListInterface< T >::operator[] ( size_t pos )

pure virtualinherited

Operator [] overloaded for quick access to a character in list.

Parameters

pos	The position to retrieve.

Returns: The T value of character at position pos.

Implemented in bpp::AbstractTemplateSymbolList< T >, bpp::AbstractTemplateSymbolList< int >, and bpp::ProbabilisticSymbolList.

◆ setComments()

virtual void bpp::Commentable::setComments ( const Comments & comments )

pure virtualinherited

Set the comments.

Parameters

comments The new comments.

Implemented in bpp::SimpleCommentable.

Referenced by bpp::Pasta::appendAlignmentFromStream(), bpp::Clustal::appendAlignmentFromStream(), bpp::Fasta::appendSequencesFromStream(), and bpp::Mase::appendSequencesFromStream().

◆ setContent() [1/3]

virtual void bpp::ProbabilisticSymbolListInterface::setContent ( const DTable & list )

pure virtualinherited

Implemented in bpp::ProbabilisticSymbolList.

◆ setContent() [2/3]

template<class T >

virtual void bpp::TemplateCoreSymbolListInterface< T >::setContent ( const std::vector< T > & list )

pure virtualinherited

Set the whole content of the list.

Parameters

list	The new content of the list.

See also: The list constructor for information about the way lists are internally stored.

Implemented in bpp::AbstractTemplateEventDrivenSymbolList< T >, and bpp::AbstractTemplateSymbolList< T >.

◆ setContent() [3/3]

virtual void bpp::TemplateCoreSymbolListInterface< T >::setContent

inherited

Set the whole content of the list.

Parameters

list	The new content of the list.

See also: The list constructor for information about the way lists are internally stored.

Referenced by bpp::ProbabilisticSymbolList::operator=(), and bpp::ProbabilisticSymbolList::ProbabilisticSymbolList().

◆ setElement()

template<class T >

virtual void bpp::TemplateCoreSymbolListInterface< T >::setElement	(	size_t	pos,
		const T &	c
	)

pure virtualinherited

Set the element at position 'pos' to character 'c'.

Parameters

pos	The position of the character to set.
c	The value of the element.

Implemented in bpp::AbstractTemplateEventDrivenSymbolList< T >, and bpp::AbstractTemplateSymbolList< T >.

◆ setName()

virtual void bpp::CoreSequenceInterface::setName ( const std::string & name )

pure virtualinherited

Set the name of this sequence.

Parameters

name	The new name of the sequence.

Implemented in bpp::AbstractCoreSequence.

◆ setToSizeL()

virtual void bpp::CoreSequenceInterface::setToSizeL ( size_t newSize )

pure virtualinherited

Set up the size of a sequence from the left side.

All new characters are filled with gaps. If the specified size is < to the sequence size, the sequence will be truncated.

Parameters

newSize The new size of the sequence.

Implemented in bpp::SequenceWithAnnotation, bpp::Sequence, and bpp::ProbabilisticSequence.

◆ setToSizeR()

virtual void bpp::CoreSequenceInterface::setToSizeR ( size_t newSize )

pure virtualinherited

Set up the size of a sequence from the right side.

All new characters are filled with gaps. If the specified size is < to the sequence size, the sequence will be truncated.

Parameters

newSize The new size of the sequence.

Implemented in bpp::SequenceWithAnnotation, bpp::Sequence, and bpp::ProbabilisticSequence.

◆ shuffle()

virtual void bpp::CruxSymbolListInterface::shuffle ( )

pure virtualinherited

Randomly shuffle the content of the list, with linear complexity.

Implemented in bpp::AbstractTemplateSymbolList< T >, bpp::AbstractTemplateSymbolList< int >, and bpp::ProbabilisticSymbolList.

◆ size()

virtual size_t bpp::CruxSymbolListInterface::size ( ) const

pure virtualinherited

Get the number of elements in the list.

Returns: The number of sites in the list.

Implemented in bpp::AbstractTemplateSymbolList< T >, bpp::AbstractTemplateSymbolList< int >, and bpp::ProbabilisticSymbolList.

◆ toString()

virtual std::string bpp::CruxSymbolListInterface::toString ( ) const

pure virtualinherited

Convert the list as a string.

This method is useful for dumping a list to a file or to the screen for display.

Returns: The whole list as a string.

Implemented in bpp::AbstractTemplateSymbolList< T >, bpp::AbstractTemplateSymbolList< int >, bpp::Sequence, bpp::ProbabilisticSymbolList, bpp::EventDrivenIntSymbolList, and bpp::IntSymbolList.

The documentation for this class was generated from the following file:

Bpp/Seq/ProbabilisticSequence.h

Public Types

Public Member Functions

Detailed Description

Member Typedef Documentation

◆ DTable

◆ ElementType

◆ SymbolType

Constructor & Destructor Documentation

◆ ~ProbabilisticSequenceInterface()

Member Function Documentation

◆ addElement() [1/2]

◆ addElement() [2/2]

◆ alphabet()

◆ clearComments()

◆ clone()

◆ deleteElement()

◆ deleteElements()

◆ getAlphabet()

◆ getComments()

◆ getContent()

◆ getElement()

◆ getName()

◆ getStateValueAt()

◆ getTable()

◆ getValue()

◆ operator()()

◆ operator[]() [1/2]

◆ operator[]() [2/2]

◆ setComments()

◆ setContent() [1/3]

◆ setContent() [2/3]

◆ setContent() [3/3]

◆ setElement()

◆ setName()

◆ setToSizeL()

◆ setToSizeR()

◆ shuffle()

◆ size()

◆ toString()