Main Page Namespace List Class Hierarchy Alphabetical List Compound List File List Compound Members File Members

gnFeature Class Reference

gnFeature stores sequence features in memory. More...

#include <gnFeature.h>

Inheritance diagram for gnFeature:


Public Member Functions
	gnFeature ()
	Empty constructor.
	gnFeature (string &name, uint32 id=0, gnLocation::gnLocationType lt=gnLocation::LT_Nothing, boolean broken=false)
	Creates a memory feature with the specified name.
	gnFeature (const gnFeature &s)
	Copy constructor.
	~gnFeature ()
	Destructor, frees memory.
gnFeature *	Clone () const
virtual string	GetName () const
	Gets the feature name (e.g.
virtual void	SetName (const string &name)
	Sets the feature name.
virtual uint32	GetID () const
	Gets this feature's ID.
virtual void	SetID (uint32 id)
	Sets this feature's ID.
virtual gnFragmentSpec *	GetSpec () const
	Gets the gnFragmentSpec to which this feature refers.
virtual void	SetSpec (gnFragmentSpec *spec)
	Sets the gnFragmentSpec to which this feature refers.
virtual gnLocation::gnLocationType	GetLocationType () const
	Gets this feature's location type.
virtual void	SetLocationType (gnLocation::gnLocationType lType)
	Sets this feature's location type.
virtual uint32	GetLocationListLength () const
	Returns the number of locations this feature describes.
virtual boolean	AddLocation (const gnLocation &l, uint32 listI=0)
	Adds a new location before the location at listI.
virtual gnLocation	GetLocation (uint32 listI) const
	Gets the location at listI.
virtual boolean	RemoveLocation (uint32 listI)
	Deletes the location at listI.
virtual boolean	SetLocation (const gnLocation &l, uint32 listI)
	Sets the location at listI to a new location.
virtual boolean	MovePositive (const gnSeqI i)
	Increases this feature's coordinates by a specific number of bases.
virtual boolean	MoveNegative (const gnSeqI i)
	Decreases this feature's coordinates by a specific number of bases.
virtual boolean	CropStart (const gnSeqI i)
	Crops the start locations of this feature by the specified amount.
virtual boolean	CropEnd (const gnSeqI i)
	Crops the end locations of this feature by the specified amount.
virtual boolean	Crop (const gnLocation &l)
	Crops the locations of this feature to fit within the given location.
virtual boolean	IsBroken () const
	Returns true if the feature is broken.
virtual void	SetBroken (boolean broke)
	Sets whether the feature is broken or not.
virtual boolean	Contains (gnSeqI i) const
	Checks if the given coordinate is contained by this feature.
virtual boolean	Contains (const gnLocation &l) const
	Checks if the given location is contained by this feature.
virtual boolean	Contains (gnBaseFeature *feature) const
	Checks if the given feature is entirely contained by this feature.
virtual boolean	IsContainedBy (const gnLocation &l) const
	Checks if this feature is entirely contained by the given location.
virtual boolean	Intersects (const gnLocation &l) const
	Checks if the given location intersects this feature.
virtual boolean	Intersects (gnBaseFeature *feature) const
	Checks if the given feature intersects this feature.
virtual uint32	GetQualifierListLength () const
	Returns the number of qualifiers in this feature.
virtual boolean	AddQualifier (gnBaseQualifier *qualifier)
	Adds a new qualifier.
virtual boolean	HasQualifier (const string &name) const
	Looks for a qualifier by name.
virtual uint32	FirstIndexOfQualifier (const string &name, uint32 listI) const
	Searches for a qualifier by name, starting at the index listI.
virtual uint32	LastIndexOfQualifier (const string &name, uint32 listI) const
	Searches for a qualifier by name, ending at the index listI.
virtual string	GetQualifierName (uint32 listI) const
	Gets the name of the qualifier at the list index listI.
virtual string	GetQualifierValue (uint32 listI) const
	Gets the value of the qualifier at the list index listI.
virtual gnBaseQualifier *	GetQualifier (uint32 listI)
	Gets the qualifier at the list index listI.
virtual boolean	RemoveQualifier (uint32 listI)
	Deletes the qualifier at the list index listI.
virtual boolean	SetQualifier (string &name, string &value, uint32 listI)
	Set the name and value of the qualifier at the list index listI.
virtual boolean	SetQualifierName (string &name, uint32 listI)
	Set the name of the qualifier at the list index listI.
virtual boolean	SetQualifierValue (string &value, uint32 listI)
	Set the value of the qualifier at the list index listI.
Protected Attributes
uint32	m_id
string	m_name
boolean	m_broken
gnLocation::gnLocationType	m_locationType
vector< gnLocation >	m_locationList
vector< gnBaseQualifier * >	m_qualifierList
gnFragmentSpec *	m_spec

Detailed Description

gnFeature stores sequence features in memory.

It contains a list of locations and qualifiers which are used to describe this feature. It can be referred to by ID.

Definition at line 27 of file gnFeature.h.

Constructor & Destructor Documentation

gnFeature::gnFeature ( )

Empty constructor.

Definition at line 18 of file gnFeature.cpp.
Referenced by Clone().

gnFeature::gnFeature ( string & name,

uint32 id = 0,

gnLocation::gnLocationType lt = gnLocation::LT_Nothing,

boolean broken = false

)

Creates a memory feature with the specified name.

Parameters:

name The name of the feature.

id The id number of the feature

lt The type of sequence location covered by this feature

broken True if the feature was broken by some sequence manipulation, false otherwise.

Definition at line 25 of file gnFeature.cpp.

gnFeature::gnFeature ( const gnFeature & s )

Copy constructor.

Parameters:

s The gnFeature to copy.

Definition at line 29 of file gnFeature.cpp.
References gnBaseFeature::m_broken, gnBaseFeature::m_id, gnBaseFeature::m_locationList, gnBaseFeature::m_locationType, gnBaseFeature::m_name, gnBaseFeature::m_qualifierList, gnBaseFeature::m_spec, and uint32.

gnFeature::~gnFeature ( )

Destructor, frees memory.

Definition at line 42 of file gnFeature.cpp.

Member Function Documentation

boolean gnBaseFeature::AddLocation ( const gnLocation & l,

uint32 listI = 0

) [inline, virtual, inherited]

Adds a new location before the location at listI.

Parameters:

l The gnLocation to add.

listI The index into the location list to insert before.

Returns:
True if successful, false otherwise.

See also:
gnLocation

Definition at line 186 of file gnBaseFeature.cpp.
References gnBaseFeature::m_locationList.
Referenced by gnSEQSource::ParseStream(), and gnGBKSource::ParseStream().

boolean gnBaseFeature::AddQualifier ( gnBaseQualifier * qualifier ) [virtual, inherited]

Adds a new qualifier.

Parameters:

qualifier The qualifier to add.

Returns:
True if successful, false otherwise.

Definition at line 216 of file gnBaseFeature.cpp.
References gnBaseFeature::m_qualifierList.
Referenced by gnSEQSource::ParseStream(), and gnGBKSource::ParseStream().

gnFeature * gnFeature::Clone ( ) const [inline, virtual]

Implements gnBaseFeature.
Definition at line 58 of file gnFeature.h.
References gnFeature().

boolean gnBaseFeature::Contains ( gnBaseFeature * feature ) const [virtual, inherited]

Checks if the given feature is entirely contained by this feature.

Parameters:

feature The feature to check

Returns:
True if "feature" is contained by this feature. False otherwise

Definition at line 146 of file gnBaseFeature.cpp.
References gnBaseFeature::GetLocation(), gnBaseFeature::GetLocationListLength(), gnBaseFeature::m_locationList, and uint32.

boolean gnBaseFeature::Contains ( const gnLocation & l ) const [virtual, inherited]

Checks if the given location is contained by this feature.

Parameters:

l The location to check

Returns:
True if "l" is contained by this feature. False otherwise

Definition at line 139 of file gnBaseFeature.cpp.
References gnBaseFeature::m_locationList, and uint32.

boolean gnBaseFeature::Contains ( gnSeqI i ) const [virtual, inherited]

Checks if the given coordinate is contained by this feature.

Parameters:

i The coordinate to check

Returns:
True if "i" is contained by this feature. False otherwise

Definition at line 131 of file gnBaseFeature.cpp.
References gnBaseFeature::m_locationList, and uint32.

boolean gnBaseFeature::Crop ( const gnLocation & l ) [inline, virtual, inherited]

Crops the locations of this feature to fit within the given location.

Parameters:

l The location to crop reduce to.

Returns:
True if successful, false if the feature was broken by the change.

Definition at line 328 of file gnBaseFeature.h.
References gnBaseFeature::CropEnd(), gnBaseFeature::CropStart(), gnLocation::GetEnd(), and gnLocation::GetStart().

boolean gnBaseFeature::CropEnd ( const gnSeqI i ) [virtual, inherited]

Crops the end locations of this feature by the specified amount.

Parameters:

i The amount to crop.

Returns:
True if successful, false if the feature was broken by the change.

Definition at line 58 of file gnBaseFeature.cpp.
References gnBaseFeature::m_locationList, and uint32.
Referenced by gnBaseFeature::Crop().

boolean gnBaseFeature::CropStart ( const gnSeqI i ) [virtual, inherited]

Crops the start locations of this feature by the specified amount.

Parameters:

i The amount to crop.

Returns:
True if successful, false if the feature was broken by the change.

Definition at line 67 of file gnBaseFeature.cpp.
References gnBaseFeature::m_locationList, and uint32.
Referenced by gnBaseFeature::Crop().

uint32 gnBaseFeature::FirstIndexOfQualifier ( const string & name,

uint32 listI

) const [virtual, inherited]

Searches for a qualifier by name, starting at the index listI.

Parameters:

name The name of the qualifier to look for.

listI The index into the qualifier list to start the search at.

Returns:
The index of the qualifier.

Definition at line 74 of file gnBaseFeature.cpp.
References GNSEQI_END, gnBaseFeature::m_qualifierList, and uint32.

uint32 gnBaseFeature::GetID ( ) const [inline, virtual, inherited]

Gets this feature's ID.

Returns:
The feature's ID.

Definition at line 291 of file gnBaseFeature.h.
References gnBaseFeature::m_id, and uint32.

gnLocation gnBaseFeature::GetLocation ( uint32 listI ) const [virtual, inherited]

Gets the location at listI.

Parameters:

listI The index into the location list to get.

Returns:
The location.

Definition at line 194 of file gnBaseFeature.cpp.
References gnBaseFeature::m_locationList.
Referenced by gnBaseFeature::Contains(), gnBaseFeature::Intersects(), and gnGBKSource::Write().

uint32 gnBaseFeature::GetLocationListLength ( ) const [inline, virtual, inherited]

Returns the number of locations this feature describes.

Returns:
The number of locations this feature describes.

Definition at line 324 of file gnBaseFeature.h.
References gnBaseFeature::m_locationList, and uint32.
Referenced by gnBaseFeature::Contains(), gnBaseFeature::Intersects(), gnSEQSource::ParseStream(), gnGBKSource::ParseStream(), and gnGBKSource::Write().

gnLocation::gnLocationType gnBaseFeature::GetLocationType ( ) const [inline, virtual, inherited]

Gets this feature's location type.

Returns:
The feature's location type.

See also:
gnLocationType

Definition at line 316 of file gnBaseFeature.h.
References gnLocation::gnLocationType, and gnBaseFeature::m_locationType.
Referenced by gnGBKSource::Write().

string gnBaseFeature::GetName ( ) const [inline, virtual, inherited]

Gets the feature name (e.g.
CDS, trna...).
Returns:
The feature name.

Definition at line 283 of file gnBaseFeature.h.
References gnBaseFeature::m_name.
Referenced by gnBaseFeature::SetQualifierValue(), and gnGBKSource::Write().

gnBaseQualifier * gnBaseFeature::GetQualifier ( uint32 listI ) [virtual, inherited]

Gets the qualifier at the list index listI.

Parameters:

listI The index into the qualifier list.

Returns:
The qualifier.

Definition at line 243 of file gnBaseFeature.cpp.
References gnBaseFeature::m_qualifierList.
Referenced by gnGBKSource::Write().

uint32 gnBaseFeature::GetQualifierListLength ( ) const [inline, virtual, inherited]

Returns the number of qualifiers in this feature.

Returns:
The number of qualifiers in this feature.

Definition at line 332 of file gnBaseFeature.h.
References gnBaseFeature::m_qualifierList, and uint32.
Referenced by gnGBKSource::Write().

string gnBaseFeature::GetQualifierName ( uint32 listI ) const [virtual, inherited]

Gets the name of the qualifier at the list index listI.

Parameters:

listI The index into the qualifier list.

Returns:
The name of the qualifier.

Definition at line 231 of file gnBaseFeature.cpp.
References gnBaseFeature::m_qualifierList.

string gnBaseFeature::GetQualifierValue ( uint32 listI ) const [virtual, inherited]

Gets the value of the qualifier at the list index listI.

Parameters:

listI The index into the qualifier list.

Returns:
The value of the qualifier.

Definition at line 237 of file gnBaseFeature.cpp.
References gnBaseFeature::m_qualifierList.

gnFragmentSpec * gnBaseFeature::GetSpec ( ) const [inline, virtual, inherited]

Gets the gnFragmentSpec to which this feature refers.

Returns:
The feature's ID.

See also:
gnFragmentSpec

Definition at line 299 of file gnBaseFeature.h.
References gnBaseFeature::m_spec.

boolean gnBaseFeature::HasQualifier ( const string & name ) const [virtual, inherited]

Looks for a qualifier by name.

Parameters:

name The name of the qualifier to look for.

Returns:
True if a qualifier was found, false otherwise.

Definition at line 224 of file gnBaseFeature.cpp.
References gnBaseFeature::m_qualifierList, and uint32.

boolean gnBaseFeature::Intersects ( gnBaseFeature * feature ) const [virtual, inherited]

Checks if the given feature intersects this feature.

Parameters:

feature The location to check

Returns:
True if "feature" intersects this feature. False otherwise

Definition at line 173 of file gnBaseFeature.cpp.
References gnBaseFeature::GetLocation(), gnBaseFeature::GetLocationListLength(), gnBaseFeature::m_locationList, and uint32.

boolean gnBaseFeature::Intersects ( const gnLocation & l ) const [virtual, inherited]

Checks if the given location intersects this feature.

Parameters:

l The location to check

Returns:
True if "l" intersects this feature. False otherwise

Definition at line 166 of file gnBaseFeature.cpp.
References gnLocation::Intersects(), gnBaseFeature::m_locationList, and uint32.

boolean gnBaseFeature::IsBroken ( ) const [inline, virtual, inherited]

Returns true if the feature is broken.

Returns:
True if the feature is broken

Definition at line 307 of file gnBaseFeature.h.
References gnBaseFeature::m_broken.

boolean gnBaseFeature::IsContainedBy ( const gnLocation & l ) const [virtual, inherited]

Checks if this feature is entirely contained by the given location.

Parameters:

l The location to check

Returns:
True if "l" contains by this feature. False otherwise

Definition at line 158 of file gnBaseFeature.cpp.
References gnLocation::Contains(), gnBaseFeature::m_locationList, and uint32.
Referenced by gnGenomeSpec::AddFeature().

uint32 gnBaseFeature::LastIndexOfQualifier ( const string & name,

uint32 listI

) const [virtual, inherited]

Searches for a qualifier by name, ending at the index listI.

Parameters:

name The name of the qualifier to look for.

listI The index into the qualifier list to end the search at.

Returns:
The index of the qualifier.

Definition at line 86 of file gnBaseFeature.cpp.
References GNSEQI_END, gnBaseFeature::m_qualifierList, and uint32.

boolean gnBaseFeature::MoveNegative ( const gnSeqI i ) [virtual, inherited]

Decreases this feature's coordinates by a specific number of bases.

Parameters:

i The number of bases to decrease by.

Returns:
True if successful, false if the feature was broken by the change.

Definition at line 49 of file gnBaseFeature.cpp.
References gnBaseFeature::m_locationList, and uint32.

boolean gnBaseFeature::MovePositive ( const gnSeqI i ) [virtual, inherited]

Increases this feature's coordinates by a specific number of bases.

Parameters:

i The number of bases to increase by.

Returns:
True if successful, false if the feature was broken by the change.

Definition at line 41 of file gnBaseFeature.cpp.
References gnBaseFeature::m_locationList, and uint32.
Referenced by gnGenomeSpec::GetFeature().

boolean gnBaseFeature::RemoveLocation ( uint32 listI ) [virtual, inherited]

Deletes the location at listI.

Parameters:

listI The index into the location list to delete.

Returns:
True if successful, false otherwise.

Definition at line 200 of file gnBaseFeature.cpp.
References gnBaseFeature::m_locationList.

boolean gnBaseFeature::RemoveQualifier ( uint32 listI ) [virtual, inherited]

Deletes the qualifier at the list index listI.

Parameters:

listI The index into the qualifier list.

Returns:
True if successful, false otherwise.

Definition at line 96 of file gnBaseFeature.cpp.
References gnBaseFeature::m_qualifierList.

void gnBaseFeature::SetBroken ( boolean broke ) [inline, virtual, inherited]

Sets whether the feature is broken or not.

Parameters:

broke True if the feature should be broken, false otherwise

Definition at line 311 of file gnBaseFeature.h.
References gnBaseFeature::m_broken.

void gnBaseFeature::SetID ( uint32 id ) [inline, virtual, inherited]

Sets this feature's ID.

Parameters:

id The feature's ID.

Definition at line 295 of file gnBaseFeature.h.
References gnBaseFeature::m_id.

boolean gnBaseFeature::SetLocation ( const gnLocation & l,

uint32 listI

) [virtual, inherited]

Sets the location at listI to a new location.

Parameters:

l The new location

listI The index into the location list to set.

Returns:
True if successful, false otherwise.

Definition at line 208 of file gnBaseFeature.cpp.
References gnBaseFeature::m_locationList.

void gnBaseFeature::SetLocationType ( gnLocation::gnLocationType lType ) [inline, virtual, inherited]

Sets this feature's location type.
LT_BetweenBases is not a valid feature location type.
Parameters:

lType The feature's location type.

See also:
gnLocationType

Definition at line 320 of file gnBaseFeature.h.
References gnBaseFeature::m_locationType.
Referenced by gnSEQSource::ParseStream(), and gnGBKSource::ParseStream().

void gnBaseFeature::SetName ( const string & name ) [inline, virtual, inherited]

Sets the feature name.

Parameters:

name The feature name.

Definition at line 287 of file gnBaseFeature.h.
References gnBaseFeature::m_name.

boolean gnBaseFeature::SetQualifier ( string & name,

string & value,

uint32 listI

) [virtual, inherited]

Set the name and value of the qualifier at the list index listI.

Parameters:

name The new name of the qualifier.

value The new value of the qualifier.

listI The index into the qualifier list.

Returns:
True if successful, false otherwise.

Definition at line 104 of file gnBaseFeature.cpp.
References gnBaseFeature::m_qualifierList.

boolean gnBaseFeature::SetQualifierName ( string & name,

uint32 listI

) [virtual, inherited]

Set the name of the qualifier at the list index listI.

Parameters:

name The new name of the qualifier.

listI The index into the qualifier list.

Returns:
True if successful, false otherwise.

Definition at line 112 of file gnBaseFeature.cpp.
References gnBaseFeature::m_qualifierList.

boolean gnBaseFeature::SetQualifierValue ( string & value,

uint32 listI

) [virtual, inherited]

Set the value of the qualifier at the list index listI.

Parameters:

value The new value of the qualifier.

listI The index into the qualifier list.

Returns:
True if successful, false otherwise.

Definition at line 121 of file gnBaseFeature.cpp.
References gnBaseFeature::GetName(), and gnBaseFeature::m_qualifierList.

void gnBaseFeature::SetSpec ( gnFragmentSpec * spec ) [inline, virtual, inherited]

Sets the gnFragmentSpec to which this feature refers.

Parameters:

spec A pointer to the fragment spec.

Definition at line 303 of file gnBaseFeature.h.
References gnBaseFeature::m_spec.
Referenced by gnFragmentSpec::AddFeature().

Member Data Documentation

boolean gnBaseFeature::m_broken [protected, inherited]

Definition at line 275 of file gnBaseFeature.h.
Referenced by gnBaseFeature::gnBaseFeature(), gnFeature(), gnBaseFeature::IsBroken(), and gnBaseFeature::SetBroken().

uint32 gnBaseFeature::m_id [protected, inherited]

Definition at line 273 of file gnBaseFeature.h.
Referenced by gnBaseFeature::GetID(), gnBaseFeature::gnBaseFeature(), gnFeature(), and gnBaseFeature::SetID().

vector< gnLocation > gnBaseFeature::m_locationList [protected, inherited]

Definition at line 277 of file gnBaseFeature.h.
Referenced by gnBaseFeature::AddLocation(), gnBaseFeature::Contains(), gnBaseFeature::CropEnd(), gnBaseFeature::CropStart(), gnBaseFeature::GetLocation(), gnBaseFeature::GetLocationListLength(), gnFeature(), gnBaseFeature::Intersects(), gnBaseFeature::IsContainedBy(), gnBaseFeature::MoveNegative(), gnBaseFeature::MovePositive(), gnBaseFeature::RemoveLocation(), and gnBaseFeature::SetLocation().

gnLocation::gnLocationType gnBaseFeature::m_locationType [protected, inherited]

Definition at line 276 of file gnBaseFeature.h.
Referenced by gnBaseFeature::GetLocationType(), gnBaseFeature::gnBaseFeature(), gnFeature(), and gnBaseFeature::SetLocationType().

string gnBaseFeature::m_name [protected, inherited]

Definition at line 274 of file gnBaseFeature.h.
Referenced by gnBaseFeature::GetName(), gnBaseFeature::gnBaseFeature(), gnFeature(), and gnBaseFeature::SetName().

vector< gnBaseQualifier* > gnBaseFeature::m_qualifierList [protected, inherited]

Definition at line 278 of file gnBaseFeature.h.
Referenced by gnBaseFeature::AddQualifier(), gnBaseFeature::FirstIndexOfQualifier(), gnBaseFeature::GetQualifier(), gnBaseFeature::GetQualifierListLength(), gnBaseFeature::GetQualifierName(), gnBaseFeature::GetQualifierValue(), gnFeature(), gnBaseFeature::HasQualifier(), gnBaseFeature::LastIndexOfQualifier(), gnBaseFeature::RemoveQualifier(), gnBaseFeature::SetQualifier(), gnBaseFeature::SetQualifierName(), gnBaseFeature::SetQualifierValue(), and gnBaseFeature::~gnBaseFeature().

gnFragmentSpec* gnBaseFeature::m_spec [protected, inherited]

Definition at line 279 of file gnBaseFeature.h.
Referenced by gnBaseFeature::GetSpec(), gnBaseFeature::gnBaseFeature(), gnFeature(), and gnBaseFeature::SetSpec().

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

Generated on Mon Feb 3 02:34:46 2003 for libGenome by

1.3-rc3

gnFeature Class Reference

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation