bpp::SiteInterface Class Reference

The site interface. More...

#include <Bpp/Seq/Site.h>

Inheritance diagram for bpp::SiteInterface:

Collaboration diagram for bpp::SiteInterface:

Public Types
typedef int	SymbolType

Public Member Functions
virtual	~SiteInterface ()
SiteInterface *	clone () const override=0
virtual bool	operator== (const SiteInterface &site)
virtual bool	operator< (const SiteInterface &site)
virtual double	getStateValueAt (size_t sequencePosition, int state) const override=0
	get value of a state at a position More...
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	operator() (size_t position, int state) const =0
	get value of a state at a position More...
Setting/getting the position of the site.
virtual int	getCoordinate () const =0
	Get the coordinate associated to this site. More...
virtual void	setCoordinate (int coordinate)=0
	Set the position of this site. 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< std::string > &list)=0
	Set the whole content of the list. More...
virtual void	setContent (const std::vector< T > &list)=0
	Set the whole content of the list. 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 std::string &c)=0
	Add a character to the end of the list. More...
virtual void	addElement (size_t pos, const std::string &c)=0
	Add a character at a certain position in the list. More...
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 std::string &c)=0
	Set the element at position 'pos' to character 'c'. More...
virtual void	setElement (size_t pos, const T &c)=0
	Set the element at position 'pos' to character 'c'. More...
virtual std::string	getChar (size_t pos) const =0
	Get the element at position 'pos' as a character. More...
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 site interface.

Define specific attributes and methods for sites manipulation. Currently, this interface does not add any additional method to the CoreSite interface, but this may change in the future.

Definition at line 21 of file Site.h.

Member Typedef Documentation

SymbolType

typedef int bpp::IntSymbolListInterface::SymbolType

inherited

Definition at line 31 of file IntSymbolList.h.

Constructor & Destructor Documentation

~SiteInterface()

virtual bpp::SiteInterface::~SiteInterface ( )

inlinevirtual

Definition at line 26 of file Site.h.

Member Function Documentation

addElement() [1/6]

virtual void bpp::IntSymbolListInterface::addElement ( const std::string &  c )

pure virtualinherited

Add a character to the end of the list.

Parameters

c	The character to add, given as a string.

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

addElement() [2/6]

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() [3/6]

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

inherited

Add a character to the end of the list.

Parameters

c	The character to add.

Referenced by bpp::SequenceWithQuality::addElement().

addElement() [4/6]

virtual void bpp::IntSymbolListInterface::addElement ( size_t  pos, const std::string &  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, given as a string.

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

addElement() [5/6]

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 >.

addElement() [6/6]

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

inherited

Add a character at a certain position in the list.

Parameters

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

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.

Referenced by bpp::SequenceTools::combineSequences(), bpp::SequenceTools::complement(), bpp::SequenceTools::concatenate(), bpp::GeneticCode::getCodingSequence(), bpp::SequenceTools::getComplement(), bpp::SequenceTools::getNumberOfCompleteSites(), bpp::SequenceTools::getNumberOfSites(), bpp::SequenceTools::getPercentIdentity(), bpp::SequenceTools::getSequenceWithCompleteSites(), bpp::SequenceTools::invertComplement(), bpp::AbstractReverseTransliterator::reverse(), bpp::SequenceTools::RNYslice(), and bpp::AbstractTransliterator::translate().

clone()

SiteInterface* bpp::SiteInterface::clone ( ) const

overridepure virtual

Implements bpp::CoreSiteInterface.

Implemented in bpp::Site.

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.

Referenced by bpp::Sequence::append(), bpp::SequenceWithAnnotation::append(), bpp::SequenceTools::areSequencesIdentical(), bpp::SymbolListTools::areSymbolListsIdentical(), bpp::SequenceTools::bowkerTest(), bpp::SymbolListTools::changeGapsToUnknownCharacters(), bpp::SymbolListTools::changeUnresolvedCharactersToGaps(), bpp::SequenceTools::combineSequences(), bpp::SequenceWithQualityTools::complement(), bpp::SequenceTools::complement(), bpp::SiteContainerTools::computeSimilarity(), bpp::SequenceTools::concatenate(), bpp::SequenceWithQualityTools::concatenate(), bpp::SequenceTools::findFirstOf(), bpp::SequenceTools::getCDS(), bpp::SequenceTools::getComplement(), bpp::SymbolListTools::getCountsResolveUnknowns(), bpp::SymbolListTools::getGCContent(), bpp::SymbolListTools::getNumberOfDistinctPositions(), bpp::SymbolListTools::getNumberOfPositionsWithoutGap(), bpp::SequenceTools::getNumberOfUnresolvedSites(), bpp::SequenceTools::getPercentIdentity(), bpp::SequenceTools::getPutativeHaplotypes(), bpp::SequenceTools::getSequenceWithoutGaps(), bpp::SequenceTools::getSequenceWithoutStops(), bpp::SymbolListTools::hasGap(), bpp::SymbolListTools::hasUnknown(), bpp::SymbolListTools::hasUnresolved(), bpp::SequenceTools::invertComplement(), bpp::SymbolListTools::isComplete(), bpp::SymbolListTools::isConstant(), bpp::SymbolListTools::isGapOnly(), bpp::SymbolListTools::isGapOrUnresolvedOnly(), bpp::SymbolListTools::jointEntropy(), bpp::SequenceWithAnnotation::merge(), bpp::SymbolListTools::mutualInformation(), bpp::SymbolListTools::numberOfGaps(), bpp::SymbolListTools::numberOfUnresolved(), bpp::ProbabilisticSymbolList::operator=(), bpp::AbstractTemplateSymbolList< T >::operator=(), bpp::SequenceWithQualityTools::removeGaps(), bpp::SequenceTools::removeGaps(), bpp::SequenceTools::removeStops(), bpp::SequenceTools::replaceStopsWithGaps(), bpp::WordAlphabet::reverse(), bpp::NucleicAcidsReplication::reverse(), bpp::SequenceWithQualityTools::reverseTranscript(), bpp::SequenceTools::RNYslice(), bpp::SequenceTools::subseq(), bpp::SequenceWithQualityTools::subseq(), bpp::SequenceTools::subtractHaplotype(), bpp::SequenceWithQualityTools::transcript(), bpp::NucleicAcidsReplication::translate(), bpp::AbstractTransliterator::translate(), bpp::WordAlphabet::translate(), and bpp::SymbolListTools::variabilityShannon().

getChar()

virtual std::string bpp::IntSymbolListInterface::getChar ( 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::Sequence, bpp::EventDrivenIntSymbolList, and bpp::IntSymbolList.

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=().

getCoordinate()

virtual int bpp::CoreSiteInterface::getCoordinate ( ) const

pure virtualinherited

Get the coordinate associated to this site.

Returns

The coordinate of this site.

Implemented in bpp::AbstractCoreSite.

Referenced by operator<(), bpp::AbstractCoreSite::operator=(), and 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.

getStateValueAt()

virtual double bpp::CoreSiteInterface::getStateValueAt ( size_t  sequencePosition, int  state  ) const

overridepure virtualinherited

get value of a state at a position

Parameters

sequencePosition	index of the looked value in the site
state	state in the alphabet

Returns

The state value at the given position.

Implements bpp::CruxSymbolListInterface.

Implemented in bpp::Site, and bpp::ProbabilisticSite.

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<()

virtual bool bpp::SiteInterface::operator< ( const SiteInterface &  site )

inlinevirtual

Definition at line 51 of file Site.h.

References bpp::CoreSiteInterface::getCoordinate().

operator==()

virtual bool bpp::SiteInterface::operator== ( const SiteInterface &  site )

inlinevirtual

Definition at line 31 of file Site.h.

References bpp::CoreSiteInterface::getCoordinate(), and bpp::CruxSymbolListInterface::size().

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.

setContent() [1/3]

virtual void bpp::IntSymbolListInterface::setContent ( const std::vector< std::string > &  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::SequenceInterface, bpp::SequenceWithAnnotation, bpp::Sequence, bpp::EventDrivenIntSymbolList, and bpp::IntSymbolList.

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::EventDrivenIntSymbolList::EventDrivenIntSymbolList(), bpp::IntSymbolList::IntSymbolList(), bpp::SequenceWithAnnotation::operator=(), bpp::Sequence::operator=(), bpp::Sequence::Sequence(), bpp::SequenceWithAnnotation::SequenceWithAnnotation(), bpp::Sequence::setContent(), and bpp::SequenceWithAnnotation::setContent().

setCoordinate()

virtual void bpp::CoreSiteInterface::setCoordinate ( int  coordinate )

pure virtualinherited

Set the position of this site.

Parameters

coordinate

The new position of the site.

Implemented in bpp::AbstractCoreSite.

setElement() [1/3]

virtual void bpp::IntSymbolListInterface::setElement ( size_t  pos, const std::string &  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, given as a string.

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

Referenced by bpp::SequenceTools::complement(), bpp::SequenceTools::invert(), bpp::SequenceTools::invertComplement(), and bpp::SequenceTools::replaceStopsWithGaps().

setElement() [2/3]

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 >.

setElement() [3/3]

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

inherited

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

Parameters

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

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.

Referenced by bpp::AbstractTemplateSymbolList< T >::AbstractTemplateSymbolList(), bpp::SequenceWithQuality::addElement(), bpp::SequenceWithAnnotation::append(), bpp::SequenceTools::areSequencesIdentical(), bpp::SymbolListTools::areSymbolListsIdentical(), bpp::SequenceTools::bowkerTest(), bpp::SymbolListTools::changeGapsToUnknownCharacters(), bpp::SymbolListTools::changeUnresolvedCharactersToGaps(), bpp::SequenceTools::combineSequences(), bpp::SequenceTools::complement(), bpp::SiteContainerTools::computeSimilarity(), bpp::SequenceTools::concatenate(), bpp::SequenceTools::findFirstOf(), bpp::SequenceTools::getCDS(), bpp::GeneticCode::getCodingSequence(), bpp::SymbolListTools::getCounts(), bpp::SymbolListTools::getCountsResolveUnknowns(), bpp::SymbolListTools::getFrequencies(), bpp::SymbolListTools::getGCContent(), bpp::SymbolListTools::getMajorAllele(), bpp::SymbolListTools::getMajorAlleleFrequency(), bpp::SymbolListTools::getMinorAllele(), bpp::SymbolListTools::getMinorAlleleFrequency(), bpp::SequenceTools::getNumberOfCompleteSites(), bpp::SymbolListTools::getNumberOfDistinctCharacters(), bpp::SymbolListTools::getNumberOfDistinctPositions(), bpp::SymbolListTools::getNumberOfPositionsWithoutGap(), bpp::SequenceTools::getNumberOfSites(), bpp::SequenceTools::getNumberOfUnresolvedSites(), bpp::SequenceTools::getPercentIdentity(), bpp::SequenceTools::getPutativeHaplotypes(), bpp::SequenceTools::getSequenceWithCompleteSites(), bpp::SequenceTools::getSequenceWithoutGaps(), bpp::SequenceTools::getSequenceWithoutStops(), bpp::SymbolListTools::hasGap(), bpp::SymbolListTools::hasSingleton(), bpp::SymbolListTools::hasUnknown(), bpp::SymbolListTools::hasUnresolved(), bpp::SymbolListTools::heterozygosity(), bpp::SequenceTools::invert(), bpp::SequenceTools::invertComplement(), bpp::SymbolListTools::isComplete(), bpp::SymbolListTools::isConstant(), bpp::SymbolListTools::isDoubleton(), bpp::SymbolListTools::isGapOnly(), bpp::SymbolListTools::isGapOrUnresolvedOnly(), bpp::SymbolListTools::isParsimonyInformativeSite(), bpp::SymbolListTools::isTriplet(), bpp::SequenceMask::isValidWith(), bpp::SequenceQuality::isValidWith(), bpp::SymbolListTools::jointEntropy(), bpp::SymbolListTools::mutualInformation(), bpp::SymbolListTools::numberOfGaps(), bpp::SymbolListTools::numberOfUnresolved(), bpp::AbstractTemplateSymbolList< T >::operator=(), operator==(), bpp::SequenceWithQualityTools::removeGaps(), bpp::SequenceTools::removeGaps(), bpp::SequenceTools::removeStops(), bpp::SequenceTools::replaceStopsWithGaps(), bpp::CodonAlphabet::reverse(), bpp::WordAlphabet::reverse(), bpp::NucleicAcidsReplication::reverse(), bpp::AbstractReverseTransliterator::reverse(), bpp::SequenceTools::RNYslice(), bpp::SequenceWalker::SequenceWalker(), bpp::SequenceTools::subseq(), bpp::SequenceWithQualityTools::subseq(), bpp::SequenceTools::subtractHaplotype(), bpp::NucleicAcidsReplication::translate(), bpp::AbstractTransliterator::translate(), bpp::CodonAlphabet::translate(), bpp::WordAlphabet::translate(), bpp::SymbolListTools::variabilityFactorial(), and bpp::SymbolListTools::variabilityShannon().

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/Site.h