SequenceHandle Class Reference

mutable sequence handle. More...

#include <sequence_handle.hh>

Inherits GenericPropContainer< SequenceHandle >.


Public Member Functions

int GetResidueIndex (int pos) const
int GetPos (int residue_index) const
int GetFirstNonGap () const
int GetLastNonGap () const
const StringGetName () const
const StringGetString () const
String GetGaplessString () const
int GetSequenceOffset () const
int GetLength () const
char GetOneLetterCode (int position) const
mol::ResidueView GetResidue (int position) const
mol::EntityView GetAttachedView () const
SequenceHandle Copy () const
bool HasAttachedView () const
bool operator== (const SequenceHandle &rhs) const
bool operator!= (const SequenceHandle &rhs) const
bool IsValid () const
 SequenceHandle ()
void SetName (const String &name)
void SetString (const String &seq)
void SetSequenceOffset (int offset)
void AttachView (const mol::EntityView &view)
 operator ConstSequenceHandle () const
void AttachView (const mol::EntityView &view, const String &chain_name)
 SequenceHandle (const impl::SequenceImplPtr &impl)
impl::SequenceImplPtrImpl () const
GenericPropContainerImplGpImpl ()
const GenericPropContainerImplGpImpl () const

Friends

class GenericPropContainer< SequenceHandle >
class SequenceList
class AlignmentHandle
class ConstSequenceList


Detailed Description

mutable sequence handle.

Sequences are mostly used as part of a multiple sequence alignment. The class allows for fast mapping between residue index and position in the sequence. The GetResidueIndex() method maps from position in the sequence to residue index, taking the sequence offset into account. The reverse mapping is done with GetPos().

Optionally, an entity view may be attached to the sequence with AttachView(). If HasAttachedView() is true, the GetResidue() method can be used directly to map from sequence position to residue. Note that it is required that the entity view has only one chain. Sequences are created from string as

 String seq_str="ALGW--ALN"
 SequenceHandle seq=CreateSequence("NAME", seq_str);

Sequences IO is dealt with in the sequence module. For more information, consult this page.

Definition at line 158 of file sequence_handle.hh.


Constructor & Destructor Documentation

SequenceHandle (  ) 

create invalid sequence handle

See also:
IsValid()

SequenceHandle ( const impl::SequenceImplPtr impl  ) 


Member Function Documentation

void AttachView ( const mol::EntityView view,
const String chain_name 
)

attach entity view to sequence

The sequence is mapped onto the chain with given name

void AttachView ( const mol::EntityView view  ) 

attach entity view to sequence

Exceptions:
IntegrityError when the view contains more than one chain

SequenceHandle Copy (  )  const

create copy sequence The newly created sequence has the same attached view.

mol::EntityView GetAttachedView (  )  const

get attached view. may be an invalid entity view

See also:
SequenceHandle::AttachView(const mol::EntityView&, const String&)

int GetFirstNonGap (  )  const

Get position of first non-gap character in sequence.

String GetGaplessString (  )  const

Get sequence as string ignoring gaps.

int GetLastNonGap (  )  const

Get position of last non-gap character in sequence.

int GetLength (  )  const

Get lenght of sequence, including gaps.

const String& GetName (  )  const

Get name of sequence.

See also:
SequenceHandle::GetName()

char GetOneLetterCode ( int  position  )  const

get one letter code of residue at position

int GetPos ( int  residue_index  )  const

Get zero-based index for given residue number.

Exceptions:
out_of_range,if number is not included in sequence.

mol::ResidueView GetResidue ( int  position  )  const

get residue at position

will return the residue view at the given sequence position or an invalid residue view when no view is attached, the index is out of bounds or the position contains a gap.

int GetResidueIndex ( int  pos  )  const

Get residue index corresponding to given sequence position.

Parameters:
pos zero-based index
Exceptions:
out_of_range if pos is not in [0, length-1].

int GetSequenceOffset (  )  const

Get sequence offset from N-terminus.

See also:
SequenceHandle::SetSequenceOffset

const String& GetString (  )  const

get sequence as a string, including all the gaps

See also:
GetGaplessString()

const GenericPropContainerImpl* GpImpl (  )  const

GenericPropContainerImpl* GpImpl (  ) 

bool HasAttachedView (  )  const

whether the sequence has an attached view

See also:
SequenceHandle::AttachView(const mol::EntityView&, const String&)

impl::SequenceImplPtr& Impl (  )  const

bool IsValid (  )  const

whether the sequence is valid

operator ConstSequenceHandle (  )  const

bool operator!= ( const SequenceHandle rhs  )  const

bool operator== ( const SequenceHandle rhs  )  const

void SetName ( const String name  ) 

set name of sequence

void SetSequenceOffset ( int  offset  ) 

Set sequence offset.

By default the sequence offset is zero, i.e. the beginning of the sequence lies exactly at the N-terminus. Setting the sequence offset to a positive number will shift the sequence towards the C-terminus.

void SetString ( const String seq  ) 

Set sequence String.


Friends And Related Function Documentation

friend class AlignmentHandle [friend]

Definition at line 164 of file sequence_handle.hh.

friend class ConstSequenceList [friend]

Definition at line 165 of file sequence_handle.hh.

friend class GenericPropContainer< SequenceHandle > [friend]

Definition at line 161 of file sequence_handle.hh.

friend class SequenceList [friend]

Definition at line 162 of file sequence_handle.hh.


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

Generated on Fri Jul 2 14:23:08 2010 for OpenStructure by  doxygen 1.5.8