ajfeat.c
All constructors return a new feature or feature table set by pointer.
It is the responsibility of the user to first destroy any previous feature.
The target pointer does not need to be initialised to NULL, but it is good
programming practice to do so anyway.
Generally, however, the AjPFeattable feature table object will first
be created, prior to creating any 'AjPFeature' objects and adding them.
To replace or reuse an existing feature object see instead
the Feature Assignments and Feature Modifiers methods.
Functions: ajFeattabOutOpen ajFeattabOutFile ajFeattabOutFilename ajFeattabOutIsOpen ajFeattabOutIsLocal ajFeattabOutSet ajFeattabInNew ajFeattabInNewSS ajFeattabInNewCSF ajFeattabInNewSSF ajFeattabOutNew ajFeattabOutSetBasename ajFeattabOutSetSeqname ajFeattabOutNewCSF ajFeattabOutNewSSF ajFeatRead ajFeatNew ajFeatNewII ajFeatNewIIRev ajFeatNewProt
Processes the specified UFO, and opens the resulting output file.
If the AjPFeattabOut has a filename, this is used in preference.
If not, the ufo is processed.
Synopsis
Prototype
AjBool ajFeattabOutOpen (
AjPFeattabOut thys,
const AjPStr ufo
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut | thys | Modify | Features table output object |
| const AjPStr | ufo | Input | UFO feature output specifier |
| AjBool | | RETURN | ajTrue on success |
Input
| ufo: | (Input) | UFO feature output specifier |
Input & Output
| thys: | (Modify) | Features table output object |
Returns
Description
Processes the specified UFO, and opens the resulting output file.
If the AjPFeattabOut has a filename, this is used in preference.
If not, the ufo is processed.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the name of a feature output file
Synopsis
Prototype
AjPFile ajFeattabOutFile (
const AjPFeattabOut thys
);
| Type | Name | Read/Write | Description |
| const AjPFeattabOut | thys | Input | Features table output object |
| AjPFile | | RETURN | File object |
Input
| thys: | (Input) | Features table output object |
Returns
Description
Returns the name of a feature output file
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the name of a feature output file
Synopsis
Prototype
AjPStr ajFeattabOutFilename (
const AjPFeattabOut thys
);
| Type | Name | Read/Write | Description |
| const AjPFeattabOut | thys | Input | Features table output object |
| AjPStr | | RETURN | Filename |
Input
| thys: | (Input) | Features table output object |
Returns
Description
Returns the name of a feature output file
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Checks whether feature output file has already been opened
Synopsis
Prototype
AjBool ajFeattabOutIsOpen (
const AjPFeattabOut thys
);
| Type | Name | Read/Write | Description |
| const AjPFeattabOut | thys | Input | Features table output object |
| AjBool | | RETURN | ajTrue if file is open |
Input
| thys: | (Input) | Features table output object |
Returns
| AjBool: | ajTrue if file is open |
Description
Checks whether feature output file has already been opened
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Checks whether feature output file has already been opened
Synopsis
Prototype
AjBool ajFeattabOutIsLocal (
const AjPFeattabOut thys
);
| Type | Name | Read/Write | Description |
| const AjPFeattabOut | thys | Input | Features table output object |
| AjBool | | RETURN | ajTrue if file is open |
Input
| thys: | (Input) | Features table output object |
Returns
| AjBool: | ajTrue if file is open |
Description
Checks whether feature output file has already been opened
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Processes the specified UFO, and specifies the resulting output file.
Synopsis
Prototype
AjBool ajFeattabOutSet (
AjPFeattabOut thys,
const AjPStr ufo
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut | thys | Modify | Features table output object |
| const AjPStr | ufo | Input | UFO feature output specifier |
| AjBool | | RETURN | ajTrue on success |
Input
| ufo: | (Input) | UFO feature output specifier |
Input & Output
| thys: | (Modify) | Features table output object |
Returns
Description
Processes the specified UFO, and specifies the resulting output file.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Constructor for an empty feature table input object
Synopsis
Prototype
AjPFeattabIn ajFeattabInNew (
void
);
| Type | Name | Read/Write | Description |
| AjPFeattabIn | | RETURN | Feature table input object |
Returns
| AjPFeattabIn: | Feature table input object |
Description
Constructor for an empty feature table input object
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Constructor for an empty feature table input object. The format and
name are read.
Synopsis
Prototype
AjPFeattabIn ajFeattabInNewSS (
const AjPStr fmt,
const AjPStr name,
const char* type
);
| Type | Name | Read/Write | Description |
| const AjPStr | fmt | Input | feature format |
| const AjPStr | name | Input | sequence name |
| const char* | type | Input | feature type |
| AjPFeattabIn | | RETURN | Feature table input object |
Input
| fmt: | (Input) | feature format |
| name: | (Input) | sequence name |
| type: | (Input) | feature type |
Returns
| AjPFeattabIn: | Feature table input object |
Description
Constructor for an empty feature table input object. The format and
name are read.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Constructor for an empty feature table input object. The format and
name are read. The file buffer is moved to the feature table input
object and should not be deleted by the calling program.
Synopsis
Prototype
AjPFeattabIn ajFeattabInNewCSF (
const char* fmt,
const AjPStr name,
const char* type,
AjPFilebuff buff
);
| Type | Name | Read/Write | Description |
| const char* | fmt | Input | feature format |
| const AjPStr | name | Input | sequence name |
| const char* | type | Input | feature type |
| AjPFilebuff | buff | Modify | Buffer containing feature data |
| AjPFeattabIn | | RETURN | Feature table input object |
Input
| fmt: | (Input) | feature format |
| name: | (Input) | sequence name |
| type: | (Input) | feature type |
Input & Output
| buff: | (Modify) | Buffer containing feature data |
Returns
| AjPFeattabIn: | Feature table input object |
Description
Constructor for an empty feature table input object. The format and
name are read. The file buffer is moved to the feature table input
object and should not be deleted by the calling program.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Constructor for an empty feature table input object. The format and
name are read. The file buffer is moved to the feature table input
object and should not be deleted by the calling program.
Synopsis
Prototype
AjPFeattabIn ajFeattabInNewSSF (
const AjPStr fmt,
const AjPStr name,
const char* type,
AjPFilebuff buff
);
| Type | Name | Read/Write | Description |
| const AjPStr | fmt | Input | feature format |
| const AjPStr | name | Input | sequence name |
| const char* | type | Input | feature type |
| AjPFilebuff | buff | Modify | Buffer containing feature data |
| AjPFeattabIn | | RETURN | Feature table input object |
Input
| fmt: | (Input) | feature format |
| name: | (Input) | sequence name |
| type: | (Input) | feature type |
Input & Output
| buff: | (Modify) | Buffer containing feature data |
Returns
| AjPFeattabIn: | Feature table input object |
Description
Constructor for an empty feature table input object. The format and
name are read. The file buffer is moved to the feature table input
object and should not be deleted by the calling program.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Constructor for an empty feature table output object
Synopsis
Prototype
AjPFeattabOut ajFeattabOutNew (
void
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut | | RETURN | Feature table input object |
Returns
| AjPFeattabOut: | Feature table input object |
Description
Constructor for an empty feature table output object
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets the base output filename for feature table output
Synopsis
Prototype
void ajFeattabOutSetBasename (
AjPFeattabOut thys,
const AjPStr basename
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut | thys | Modify | feature table output |
| const AjPStr | basename | Input | Output base filename |
| void | | RETURN | |
Input
| basename: | (Input) | Output base filename |
Input & Output
| thys: | (Modify) | feature table output |
Returns
Description
Sets the base output filename for feature table output
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Processes the specified UFO, and specifies the resulting output file.
Synopsis
Prototype
AjBool ajFeattabOutSetSeqname (
AjPFeattabOut thys,
const AjPStr name
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut | thys | Modify | Features table output object |
| const AjPStr | name | Input | UFO feature output specifier |
| AjBool | | RETURN | ajTrue on success |
Input
| name: | (Input) | UFO feature output specifier |
Input & Output
| thys: | (Modify) | Features table output object |
Returns
Description
Processes the specified UFO, and specifies the resulting output file.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Constructor for an empty feature table output object, using an
existing open output file (the file sequence data is already written to)
Synopsis
Prototype
AjPFeattabOut ajFeattabOutNewCSF (
const char* fmt,
const AjPStr name,
const char* type,
AjPFile file
);
| Type | Name | Read/Write | Description |
| const char* | fmt | Input | feature format |
| const AjPStr | name | Input | sequence name |
| const char* | type | Input | feature type |
| AjPFile | file | Modify | Output file |
| AjPFeattabOut | | RETURN | Feature table output object |
Input
| fmt: | (Input) | feature format |
| name: | (Input) | sequence name |
| type: | (Input) | feature type |
Input & Output
Returns
| AjPFeattabOut: | Feature table output object |
Description
Constructor for an empty feature table output object, using an
existing open output file (the file sequence data is already written to)
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Constructor for an empty feature table output object, using an
existing open output file (the file sequence data is already written to)
Synopsis
Prototype
AjPFeattabOut ajFeattabOutNewSSF (
const AjPStr fmt,
const AjPStr name,
const char* type,
AjPFile file
);
| Type | Name | Read/Write | Description |
| const AjPStr | fmt | Input | feature format |
| const AjPStr | name | Input | sequence name |
| const char* | type | Input | feature type |
| AjPFile | file | Modify | Output file |
| AjPFeattabOut | | RETURN | Feature table output object |
Input
| fmt: | (Input) | feature format |
| name: | (Input) | sequence name |
| type: | (Input) | feature type |
Input & Output
Returns
| AjPFeattabOut: | Feature table output object |
Description
Constructor for an empty feature table output object, using an
existing open output file (the file sequence data is already written to)
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Generic interface function for reading in features from a file
given the file handle, class of map, data format of input
and possibly other associated data.
Synopsis
Prototype
AjPFeattable ajFeatRead (
AjPFeattabIn ftin
);
| Type | Name | Read/Write | Description |
| AjPFeattabIn | ftin | Modify | Specifies the external source (file)
of the features to be read in |
| AjPFeattable | | RETURN | Pointer to a new feature table containing
the features read in |
Input & Output
| ftin: | (Modify) | Specifies the external source (file)
of the features to be read in |
Returns
| AjPFeattable: | Pointer to a new feature table containing
the features read in |
Description
Generic interface function for reading in features from a file
given the file handle, class of map, data format of input
and possibly other associated data.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Constructor - must specify associated 'ajFeattable'
to which the new feature is automatically added!
Synopsis
Prototype
AjPFeature ajFeatNew (
AjPFeattable thys,
const AjPStr source,
const AjPStr type,
ajint Start,
ajint End,
float score,
char strand,
ajint frame
);
| Type | Name | Read/Write | Description |
| AjPFeattable | thys | Modify | Pointer to the ajFeattable which
will own the feature |
| const AjPStr | source | Input | Analysis basis for feature |
| const AjPStr | type | Input | Type of feature (e.g. exon) |
| ajint | Start | Input | Start position of the feature |
| ajint | End | Input | End position of the feature |
| float | score | Input | Analysis score for the feature |
| char | strand | Input | Strand of the feature |
| ajint | frame | Input | Frame of the feature |
| AjPFeature | | RETURN | newly allocated feature object |
Input
| source: | (Input) | Analysis basis for feature |
| type: | (Input) | Type of feature (e.g. exon) |
| Start: | (Input) | Start position of the feature |
| End: | (Input) | End position of the feature |
| score: | (Input) | Analysis score for the feature |
| strand: | (Input) | Strand of the feature |
| frame: | (Input) | Frame of the feature |
Input & Output
| thys: | (Modify) | Pointer to the ajFeattable which
will own the feature |
Returns
| AjPFeature: | newly allocated feature object |
Description
Constructor - must specify associated 'ajFeattable'
to which the new feature is automatically added!
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Simple constructor with only start and end positions
User must specify associated 'ajFeattable' to which the new feature
is automatically added!
Synopsis
Prototype
AjPFeature ajFeatNewII (
AjPFeattable thys,
ajint Start,
ajint End
);
| Type | Name | Read/Write | Description |
| AjPFeattable | thys | Modify | Pointer to the ajFeattable which
will own the feature |
| ajint | Start | Input | Start position of the feature |
| ajint | End | Input | End position of the feature |
| AjPFeature | | RETURN | newly allocated feature object |
Input
| Start: | (Input) | Start position of the feature |
| End: | (Input) | End position of the feature |
Input & Output
| thys: | (Modify) | Pointer to the ajFeattable which
will own the feature |
Returns
| AjPFeature: | newly allocated feature object |
Description
Simple constructor with only start and end positions
User must specify associated 'ajFeattable' to which the new feature
is automatically added!
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Simple constructor with only start and end positions, sets feature to be
on the reverse strand
User must specify associated 'ajFeattable' to which the new feature
is automatically added!
Synopsis
Prototype
AjPFeature ajFeatNewIIRev (
AjPFeattable thys,
ajint Start,
ajint End
);
| Type | Name | Read/Write | Description |
| AjPFeattable | thys | Modify | Pointer to the ajFeattable which
will own the feature |
| ajint | Start | Input | Start position of the feature |
| ajint | End | Input | End position of the feature |
| AjPFeature | | RETURN | newly allocated feature object |
Input
| Start: | (Input) | Start position of the feature |
| End: | (Input) | End position of the feature |
Input & Output
| thys: | (Modify) | Pointer to the ajFeattable which
will own the feature |
Returns
| AjPFeature: | newly allocated feature object |
Description
Simple constructor with only start and end positions, sets feature to be
on the reverse strand
User must specify associated 'ajFeattable' to which the new feature
is automatically added!
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Constructor - must specify associated 'ajFeattable'
to which the new feature is automatically added!
Synopsis
Prototype
AjPFeature ajFeatNewProt (
AjPFeattable thys,
const AjPStr source,
const AjPStr type,
ajint Start,
ajint End,
float score
);
| Type | Name | Read/Write | Description |
| AjPFeattable | thys | Modify | Pointer to the ajFeattable which
will own the feature |
| const AjPStr | source | Input | Analysis basis for feature |
| const AjPStr | type | Input | Type of feature (e.g. exon) |
| ajint | Start | Input | Start position of the feature |
| ajint | End | Input | End position of the feature |
| float | score | Input | Analysis score for the feature |
| AjPFeature | | RETURN | newly allocated feature object |
Input
| source: | (Input) | Analysis basis for feature |
| type: | (Input) | Type of feature (e.g. exon) |
| Start: | (Input) | Start position of the feature |
| End: | (Input) | End position of the feature |
| score: | (Input) | Analysis score for the feature |
Input & Output
| thys: | (Modify) | Pointer to the ajFeattable which
will own the feature |
Returns
| AjPFeature: | newly allocated feature object |
Description
Constructor - must specify associated 'ajFeattable'
to which the new feature is automatically added!
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
(Simple minded) object destruction by release of memory.
No reference counting (for now).
Functions: ajFeattabInDel ajFeattableDel ajFeatDel
Destructor for a feature table input object
Synopsis
Prototype
void ajFeattabInDel (
AjPFeattabIn* pthis
);
| Type | Name | Read/Write | Description |
| AjPFeattabIn* | pthis | Delete | Feature table input object |
| void | | RETURN | |
Output
| pthis: | (Delete) | Feature table input object |
Returns
Description
Destructor for a feature table input object
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Destructor for ajFeattable objects.
If the given object (pointer) is NULL, or a NULL pointer, simply returns.
Synopsis
Prototype
void ajFeattableDel (
AjPFeattable* pthis
);
| Type | Name | Read/Write | Description |
| AjPFeattable* | pthis | Delete | Pointer to the object to be deleted.
The pointer is always deleted. |
| void | | RETURN | |
Output
| pthis: | (Delete) | Pointer to the object to be deleted.
The pointer is always deleted. |
Returns
Description
Destructor for ajFeattable objects.
If the given object (pointer) is NULL, or a NULL pointer, simply returns.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Destructor for AjPFeature objects.
If the given object (pointer) is NULL, or a NULL pointer, simply returns.
Synopsis
Prototype
void ajFeatDel (
AjPFeature* pthis
);
| Type | Name | Read/Write | Description |
| AjPFeature* | pthis | Delete | Pointer to the object to be deleted.
The pointer is always deleted. |
| void | | RETURN | |
Output
| pthis: | (Delete) | Pointer to the object to be deleted.
The pointer is always deleted. |
Returns
Description
Destructor for AjPFeature objects.
If the given object (pointer) is NULL, or a NULL pointer, simply returns.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Functions: ajFeatUfoWrite ajFeattableWrite ajFeatSortByType ajFeatSortByStart ajFeatSortByEnd
Parses a UFO, opens an output file, and writes a feature table to it.
Synopsis
Prototype
AjBool ajFeatUfoWrite (
const AjPFeattable thys,
AjPFeattabOut featout,
const AjPStr ufo
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | thys | Input | Feature table to be written |
| AjPFeattabOut | featout | Modify | Feature output object |
| const AjPStr | ufo | Input | UFO feature spec (ignored if already open) |
| AjBool | | RETURN | ajTrue on success. |
Input
| thys: | (Input) | Feature table to be written |
| ufo: | (Input) | UFO feature spec (ignored if already open) |
Input & Output
| featout: | (Modify) | Feature output object |
Returns
| AjBool: | ajTrue on success. |
Description
Parses a UFO, opens an output file, and writes a feature table to it.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Parses a UFO, opens an output file, and writes a feature table to it.
Synopsis
Prototype
AjBool ajFeattableWrite (
AjPFeattable thys,
const AjPStr ufo
);
| Type | Name | Read/Write | Description |
| AjPFeattable | thys | Output | Feature table created |
| const AjPStr | ufo | Input | UFO feature spec |
| AjBool | | RETURN | ajTrue on success. |
Input
| ufo: | (Input) | UFO feature spec |
Output
| thys: | (Output) | Feature table created |
Returns
| AjBool: | ajTrue on success. |
Description
Parses a UFO, opens an output file, and writes a feature table to it.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sort Feature table by Type.
Synopsis
Prototype
void ajFeatSortByType (
AjPFeattable Feattab
);
| Type | Name | Read/Write | Description |
| AjPFeattable | Feattab | Modify | Feature table to be sorted. |
| void | | RETURN | |
Input & Output
| Feattab: | (Modify) | Feature table to be sorted. |
Returns
Description
Sort Feature table by Type.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sort Feature table by Start position.
Synopsis
Prototype
void ajFeatSortByStart (
AjPFeattable Feattab
);
| Type | Name | Read/Write | Description |
| AjPFeattable | Feattab | Modify | Feature table to be sorted. |
| void | | RETURN | |
Input & Output
| Feattab: | (Modify) | Feature table to be sorted. |
Returns
Description
Sort Feature table by Start position.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sort Feature table by End position.
Synopsis
Prototype
void ajFeatSortByEnd (
AjPFeattable Feattab
);
| Type | Name | Read/Write | Description |
| AjPFeattable | Feattab | Modify | Feature table to be sorted. |
| void | | RETURN | |
Input & Output
| Feattab: | (Modify) | Feature table to be sorted. |
Returns
Description
Sort Feature table by End position.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Functions: ajFeattableAdd
Method to add a new AjPFeature to a AjPFeattable
Synopsis
Prototype
void ajFeattableAdd (
AjPFeattable thys,
AjPFeature feature
);
| Type | Name | Read/Write | Description |
| AjPFeattable | thys | Modify | The feature table |
| AjPFeature | feature | Modify | Feature to be added to the set |
| void | | RETURN | |
Input & Output
| thys: | (Modify) | The feature table |
| feature: | (Modify) | Feature to be added to the set |
Returns
Description
Method to add a new AjPFeature to a AjPFeattable
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
These functions use the contents of a feature object,
but do not make any changes.
Functions: ajFeattableClear ajFeatOutFormatDefault ajFeatWrite ajFeattableWriteGff2 ajFeattableWriteGff3 ajFeattableWriteDdbj ajFeattableWriteEmbl ajFeattableWriteGenbank ajFeattableWriteSwiss ajFeattableWritePir ajFeattableWriteDasgff ajFeattableGetName ajFeattableGetSize ajFeatTypeGetCategory ajFeattableGetTypeC ajFeattableGetTypeS ajFeattableGetXrefs ajFeattableIsNuc ajFeattableIsProt ajFeattableBegin ajFeattableEnd ajFeattableLen ajFeattableSize ajFeattabInClear ajFeatGetSeq ajFeatGetRemoteseq ajFeatGetXrefs ajFeatLocMark ajFeatGetNote ajFeatGetNoteC ajFeatGetNoteCI ajFeatGetNoteI ajFeatGetTagC ajFeatGetTagS ajFeatGetType ajFeatGetSource ajFeatGetStart ajFeatGetStrand ajFeatGetEnd ajFeatGetLength ajFeatGetScore ajFeatGetForward ajFeatGetFrame ajFeatGetTranslation ajFeatTest ajFeatSetDescApp ajFeatSetDesc ajFeatSetScore ajFeatSetStrand ajFeattabInSetType ajFeattabInSetTypeC ajFeattabOutSetType ajFeattabOutSetTypeC ajFeatTagSetC ajFeatTagSet ajFeatTagAddCC ajFeatTagAddC ajFeatTagAdd ajFeattableNew ajFeatUfoRead ajFeattableSetLength ajFeattableSetNuc ajFeattableSetProt ajFeattableReverse ajFeatReverse ajFeattableSetRange ajFeattableNewDna ajFeattableNewSeq ajFeattableNewProt ajFeattableCopy ajFeattableCopyLimit ajFeatCopy ajFeatTrace ajFeatTagTrace ajFeatTagIter ajFeatTagval ajFeattableTrace ajFeatTypeNuc ajFeatTypeProt ajFeatExit ajFeatUnused ajFeatTypeIsCds ajFeatTypeMatchC ajFeatTypeMatchS ajFeatIsLocal ajFeatIsLocalRange ajFeatIsChild ajFeatIsMultiple ajFeatIsCompMult ajFeattabOutClear ajFeattabOutDel ajFeattablePos ajFeattablePosI ajFeattablePosII ajFeattableTrimOff ajFeatTrimOffRange ajFeatDefName ajFeattableWriteDebug ajFeattablePrint ajFeatPrintFormat ajFeattagIsNote
Clears a feature table of all features
Synopsis
Prototype
void ajFeattableClear (
AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| AjPFeattable | thys | Modify | Feature table |
| void | | RETURN | |
Input & Output
| thys: | (Modify) | Feature table |
Returns
Description
Clears a feature table of all features
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets the default output format.
Checks the _OUTFEATFORMAT variable,
and uses GFF3 if no other definition is found.
Synopsis
Prototype
AjBool ajFeatOutFormatDefault (
AjPStr* pformat
);
| Type | Name | Read/Write | Description |
| AjPStr* | pformat | Output | Default output feature format. |
| AjBool | | RETURN | ajTrue on success. |
Output
| pformat: | (Output) | Default output feature format. |
Returns
| AjBool: | ajTrue on success. |
Description
Sets the default output format.
Checks the _OUTFEATFORMAT variable,
and uses GFF3 if no other definition is found.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Generic interface function for writing features from a file
given the file handle, class of map, data format of input
and possibly other associated data.
Synopsis
Prototype
AjBool ajFeatWrite (
AjPFeattabOut ftout,
const AjPFeattable features
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut | ftout | Modify | Specifies the external source
(file) of the features to be written |
| const AjPFeattable | features | Input | Feature set to be written out |
| AjBool | | RETURN | Returns ajTrue if successful; ajFalse otherwise |
Input
| features: | (Input) | Feature set to be written out |
Input & Output
| ftout: | (Modify) | Specifies the external source
(file) of the features to be written |
Returns
| AjBool: | Returns ajTrue if successful; ajFalse otherwise |
Description
Generic interface function for writing features from a file
given the file handle, class of map, data format of input
and possibly other associated data.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Write feature table in GFF 2.0 format
Synopsis
Prototype
AjBool ajFeattableWriteGff2 (
AjPFeattabOut ftout,
const AjPFeattable Feattab
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut | ftout | Modify | Feature table output object |
| const AjPFeattable | Feattab | Input | feature table |
| AjBool | | RETURN | ajTrue on success |
Input
| Feattab: | (Input) | feature table |
Input & Output
| ftout: | (Modify) | Feature table output object |
Returns
Description
Write feature table in GFF 2.0 format
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Write feature table in GFF format
Synopsis
Prototype
AjBool ajFeattableWriteGff3 (
AjPFeattabOut ftout,
const AjPFeattable Feattab
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut | ftout | Modify | Feature table output object |
| const AjPFeattable | Feattab | Input | feature table |
| AjBool | | RETURN | ajTrue on success |
Input
| Feattab: | (Input) | feature table |
Input & Output
| ftout: | (Modify) | Feature table output object |
Returns
Description
Write feature table in GFF format
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Write a feature table in DDBJ format.
Synopsis
Prototype
AjBool ajFeattableWriteDdbj (
AjPFeattabOut ftout,
const AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut | ftout | Modify | Feature table output object |
| const AjPFeattable | thys | Input | feature table |
| AjBool | | RETURN | ajTrue on success |
Input
| thys: | (Input) | feature table |
Input & Output
| ftout: | (Modify) | Feature table output object |
Returns
Description
Write a feature table in DDBJ format.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Write a feature table in EMBL format.
Synopsis
Prototype
AjBool ajFeattableWriteEmbl (
AjPFeattabOut ftout,
const AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut | ftout | Modify | Feature table output object |
| const AjPFeattable | thys | Input | feature table |
| AjBool | | RETURN | ajTrue on success |
Input
| thys: | (Input) | feature table |
Input & Output
| ftout: | (Modify) | Feature table output object |
Returns
Description
Write a feature table in EMBL format.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Write a feature table in GenBank format.
Synopsis
Prototype
AjBool ajFeattableWriteGenbank (
AjPFeattabOut ftout,
const AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut | ftout | Modify | Feature table output object |
| const AjPFeattable | thys | Input | feature table |
| AjBool | | RETURN | ajTrue on success |
Input
| thys: | (Input) | feature table |
Input & Output
| ftout: | (Modify) | Feature table output object |
Returns
Description
Write a feature table in GenBank format.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Write a feature table in SwissProt format.
Synopsis
Prototype
AjBool ajFeattableWriteSwiss (
AjPFeattabOut ftout,
const AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut | ftout | Modify | Feature table output object |
| const AjPFeattable | thys | Input | feature table |
| AjBool | | RETURN | ajTrue on success |
Input
| thys: | (Input) | feature table |
Input & Output
| ftout: | (Modify) | Feature table output object |
Returns
Description
Write a feature table in SwissProt format.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Write a feature table in PIR format.
Synopsis
Prototype
AjBool ajFeattableWritePir (
AjPFeattabOut ftout,
const AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut | ftout | Modify | Feature table output object |
| const AjPFeattable | thys | Input | feature table |
| AjBool | | RETURN | ajTrue on success |
Input
| thys: | (Input) | feature table |
Input & Output
| ftout: | (Modify) | Feature table output object |
Returns
Description
Write a feature table in PIR format.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Write a feature table in DAS GFF format.
Synopsis
Prototype
AjBool ajFeattableWriteDasgff (
AjPFeattabOut ftout,
const AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut | ftout | Modify | Feature table output object |
| const AjPFeattable | thys | Input | Feature table |
| AjBool | | RETURN | ajTrue on success |
Input
| thys: | (Input) | Feature table |
Input & Output
| ftout: | (Modify) | Feature table output object |
Returns
Description
Write a feature table in DAS GFF format.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the name of a feature table object. This is a copy of the
pointer to the name, and is still owned by the feature table
and is not to be destroyed.
Synopsis
Prototype
const AjPStr ajFeattableGetName (
const AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | thys | Input | Feature table |
| const AjPStr | | RETURN | Feature table name. |
Input
| thys: | (Input) | Feature table |
Returns
| const AjPStr: | Feature table name. |
Description
Returns the name of a feature table object. This is a copy of the
pointer to the name, and is still owned by the feature table
and is not to be destroyed.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the size of a feature table object.
Synopsis
Prototype
ajuint ajFeattableGetSize (
const AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | thys | Input | Feature table |
| ajuint | | RETURN | Feature table size. |
Input
| thys: | (Input) | Feature table |
Returns
| ajuint: | Feature table size. |
Description
Returns the size of a feature table object.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
returns the category name for a feature type
Used to identify category for DASGFF output
Synopsis
Prototype
const AjPStr ajFeatTypeGetCategory (
const AjPStr type
);
| Type | Name | Read/Write | Description |
| const AjPStr | type | Input | Feature type |
| const AjPStr | | RETURN | Feature category |
Input
Returns
| const AjPStr: | Feature category |
Description
returns the category name for a feature type
Used to identify category for DASGFF output
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the name of a feature table object. This is a copy of the
pointer to the name, and is still owned by the feature table
and is not to be destroyed.
Synopsis
Prototype
const char* ajFeattableGetTypeC (
const AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | thys | Input | Feature table |
| const char* | | RETURN | Feature table type. |
Input
| thys: | (Input) | Feature table |
Returns
| const char*: | Feature table type. |
Description
Returns the name of a feature table object. This is a copy of the
pointer to the name, and is still owned by the feature table
and is not to be destroyed.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the name of a feature table object. This is a copy of the
pointer to the name, and is still owned by the feature table
and is not to be destroyed.
Synopsis
Prototype
const AjPStr ajFeattableGetTypeS (
const AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | thys | Input | Feature table |
| const AjPStr | | RETURN | Feature table name. |
Input
| thys: | (Input) | Feature table |
Returns
| const AjPStr: | Feature table name. |
Description
Returns the name of a feature table object. This is a copy of the
pointer to the name, and is still owned by the feature table
and is not to be destroyed.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns all cross-references from a feature table
Synopsis
Prototype
AjBool ajFeattableGetXrefs (
const AjPFeattable thys,
AjPList xreflist,
ajuint* Ptaxid
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | thys | Input | Feature table |
| AjPList | xreflist | Modify | List of sequence cross-reference objects |
| ajuint* | Ptaxid | Output | Taxon ID |
| AjBool | | RETURN | True on success |
Input
| thys: | (Input) | Feature table |
Output
Input & Output
| xreflist: | (Modify) | List of sequence cross-reference objects |
Returns
Description
Returns all cross-references from a feature table
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns ajTrue if a feature table is knucleotide protein
Synopsis
Prototype
AjBool ajFeattableIsNuc (
const AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | thys | Input | Feature table |
| AjBool | | RETURN | ajTrue for a protein feature table |
Input
| thys: | (Input) | Feature table |
Returns
| AjBool: | ajTrue for a protein feature table |
Description
Returns ajTrue if a feature table is knucleotide protein
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns ajTrue if a feature table is protein
Synopsis
Prototype
AjBool ajFeattableIsProt (
const AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | thys | Input | Feature table |
| AjBool | | RETURN | ajTrue for a protein feature table |
Input
| thys: | (Input) | Feature table |
Returns
| AjBool: | ajTrue for a protein feature table |
Description
Returns ajTrue if a feature table is protein
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the feature table start position, or 1 if no start has been set.
Synopsis
Prototype
ajint ajFeattableBegin (
const AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | thys | Input | feature table object |
| ajint | | RETURN | Start position. |
Input
| thys: | (Input) | feature table object |
Returns
Description
Returns the feature table start position, or 1 if no start has been set.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the features table end position, or the feature table length if
no end has been set.
Synopsis
Prototype
ajint ajFeattableEnd (
const AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | thys | Input | feature table object |
| ajint | | RETURN | End position. |
Input
| thys: | (Input) | feature table object |
Returns
Description
Returns the features table end position, or the feature table length if
no end has been set.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the sequence length of a feature table
Synopsis
Prototype
ajint ajFeattableLen (
const AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | thys | Input | Feature table |
| ajint | | RETURN | Length in bases or residues |
Input
| thys: | (Input) | Feature table |
Returns
| ajint: | Length in bases or residues |
Description
Returns the sequence length of a feature table
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the number of features in a feature table
Synopsis
Prototype
ajint ajFeattableSize (
const AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | thys | Input | Feature table |
| ajint | | RETURN | Number of features |
Input
| thys: | (Input) | Feature table |
Returns
Description
Returns the number of features in a feature table
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Clears a Tabin input object back to "as new" condition, except
for the USA list which must be preserved.
Synopsis
Prototype
void ajFeattabInClear (
AjPFeattabIn thys
);
| Type | Name | Read/Write | Description |
| AjPFeattabIn | thys | Modify | Sequence input |
| void | | RETURN | |
Input & Output
| thys: | (Modify) | Sequence input |
Returns
Description
Clears a Tabin input object back to "as new" condition, except
for the USA list which must be preserved.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the sequence matching a feature. For multiple location features
(joins in an EMBL/GenBank feature table) the full feature table is used
to find all exons.
The database name is used to retrieve sequences from other entries
Synopsis
Prototype
AjBool ajFeatGetSeq (
const AjPFeature thys,
const AjPFeattable table,
const AjPSeq seq,
AjPStr* Pseqstr
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature |
| const AjPFeattable | table | Input | Full feature table |
| const AjPSeq | seq | Input | Sequence for the current feature table |
| AjPStr* | Pseqstr | Modify | Sequence for this feature |
| AjBool | | RETURN | True on success |
Input
| thys: | (Input) | Feature |
| table: | (Input) | Full feature table |
| seq: | (Input) | Sequence for the current feature table |
Input & Output
| Pseqstr: | (Modify) | Sequence for this feature |
Returns
Description
Returns the sequence matching a feature. For multiple location features
(joins in an EMBL/GenBank feature table) the full feature table is used
to find all exons.
The database name is used to retrieve sequences from other entries
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns a sequence entry from a feature location which points to
another entry
Synopsis
Prototype
AjBool ajFeatGetRemoteseq (
const AjPFeature thys,
const AjPStr usa,
AjPSeq seq
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature |
| const AjPStr | usa | Input | usa of query |
| AjPSeq | seq | Modify | Sequence object for results |
| AjBool | | RETURN | True on success |
Input
| thys: | (Input) | Feature |
| usa: | (Input) | usa of query |
Input & Output
| seq: | (Modify) | Sequence object for results |
Returns
Description
Returns a sequence entry from a feature location which points to
another entry
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns all cross-references from a feature
Synopsis
Prototype
AjBool ajFeatGetXrefs (
const AjPFeature thys,
AjPList xreflist
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature |
| AjPList | xreflist | Modify | List of sequence cross-reference objects |
| AjBool | | RETURN | True on success |
Input
Input & Output
| xreflist: | (Modify) | List of sequence cross-reference objects |
Returns
Description
Returns all cross-references from a feature
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns a sequence entry converted to lower case where a feature
location matches.
Synopsis
Prototype
AjBool ajFeatLocMark (
const AjPFeature thys,
const AjPFeattable table,
AjPStr* Pseqstr
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature |
| const AjPFeattable | table | Input | Feature table |
| AjPStr* | Pseqstr | Modify | Sequence to be marked in lower case |
| AjBool | | RETURN | true on success |
Input
| thys: | (Input) | Feature |
| table: | (Input) | Feature table |
Input & Output
| Pseqstr: | (Modify) | Sequence to be marked in lower case |
Returns
Description
Returns a sequence entry converted to lower case where a feature
location matches.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Finds a named note tag (with a * prefix)
Synopsis
Prototype
AjBool ajFeatGetNote (
const AjPFeature thys,
const AjPStr name,
AjPStr* val
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature object |
| const AjPStr | name | Input | Tag name |
| AjPStr* | val | Output | Tag value (if found) |
| AjBool | | RETURN | ajTrue on success (feature tag found) |
Input
| thys: | (Input) | Feature object |
| name: | (Input) | Tag name |
Output
| val: | (Output) | Tag value (if found) |
Returns
| AjBool: | ajTrue on success (feature tag found) |
Description
Finds a named note tag (with a * prefix)
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Finds a named note tag (with a * prefix)
Synopsis
Prototype
AjBool ajFeatGetNoteC (
const AjPFeature thys,
const char* name,
AjPStr* val
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature object |
| const char* | name | Input | Tag name |
| AjPStr* | val | Output | Tag value (if found) |
| AjBool | | RETURN | ajTrue on success (feature tag found) |
Input
| thys: | (Input) | Feature object |
| name: | (Input) | Tag name |
Output
| val: | (Output) | Tag value (if found) |
Returns
| AjBool: | ajTrue on success (feature tag found) |
Description
Finds a named note tag (with a * prefix)
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Finds a named note tag (with a * prefix)
Synopsis
Prototype
AjBool ajFeatGetNoteCI (
const AjPFeature thys,
const char* name,
ajint count,
AjPStr* val
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature object |
| const char* | name | Input | Tag name |
| ajint | count | Input | Tag count: zero for any, 1 for first, 2 for second |
| AjPStr* | val | Output | Tag value (if found) |
| AjBool | | RETURN | ajTrue on success (feature tag found) |
Input
| thys: | (Input) | Feature object |
| name: | (Input) | Tag name |
| count: | (Input) | Tag count: zero for any, 1 for first, 2 for second |
Output
| val: | (Output) | Tag value (if found) |
Returns
| AjBool: | ajTrue on success (feature tag found) |
Description
Finds a named note tag (with a * prefix)
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Finds a named note tag (with a * prefix)
Synopsis
Prototype
AjBool ajFeatGetNoteI (
const AjPFeature thys,
const AjPStr name,
ajint count,
AjPStr* val
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature object |
| const AjPStr | name | Input | Tag name |
| ajint | count | Input | Tag count: zero for any, 1 for first, 2 for second |
| AjPStr* | val | Output | Tag value (if found) |
| AjBool | | RETURN | ajTrue on success (feature tag found) |
Input
| thys: | (Input) | Feature object |
| name: | (Input) | Tag name |
| count: | (Input) | Tag count: zero for any, 1 for first, 2 for second |
Output
| val: | (Output) | Tag value (if found) |
Returns
| AjBool: | ajTrue on success (feature tag found) |
Description
Finds a named note tag (with a * prefix)
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the nth value of a named feature tag.
If not found as a tag, also searches for a named note
Synopsis
Prototype
AjBool ajFeatGetTagC (
const AjPFeature thys,
const char* tname,
ajint num,
AjPStr* Pval
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature object |
| const char* | tname | Input | Tag name |
| ajint | num | Input | Tag number |
| AjPStr* | Pval | Output | Tag value (if found) |
| AjBool | | RETURN | ajTrue on success (feature tag found) |
Input
| thys: | (Input) | Feature object |
| tname: | (Input) | Tag name |
| num: | (Input) | Tag number |
Output
| Pval: | (Output) | Tag value (if found) |
Returns
| AjBool: | ajTrue on success (feature tag found) |
Description
Returns the nth value of a named feature tag.
If not found as a tag, also searches for a named note
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the nth value of a named feature tag.
If not found as a tag, also searches for a named note
Synopsis
Prototype
AjBool ajFeatGetTagS (
const AjPFeature thys,
const AjPStr name,
ajint num,
AjPStr* val
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature object |
| const AjPStr | name | Input | Tag name |
| ajint | num | Input | Tag number |
| AjPStr* | val | Output | Tag value (if found) |
| AjBool | | RETURN | ajTrue on success (feature tag found) |
Input
| thys: | (Input) | Feature object |
| name: | (Input) | Tag name |
| num: | (Input) | Tag number |
Output
| val: | (Output) | Tag value (if found) |
Returns
| AjBool: | ajTrue on success (feature tag found) |
Description
Returns the nth value of a named feature tag.
If not found as a tag, also searches for a named note
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the type (key) of a feature object. This is a copy of the
pointer to the type, and is still owned by the feature
and is not to be destroyed.
Synopsis
Prototype
const AjPStr ajFeatGetType (
const AjPFeature thys
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature object |
| const AjPStr | | RETURN | Feature type, read only |
Input
| thys: | (Input) | Feature object |
Returns
| const AjPStr: | Feature type, read only |
Description
Returns the type (key) of a feature object. This is a copy of the
pointer to the type, and is still owned by the feature
and is not to be destroyed.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the source name of a feature object.
Synopsis
Prototype
const AjPStr ajFeatGetSource (
const AjPFeature thys
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature object |
| const AjPStr | | RETURN | Feature source name |
Input
| thys: | (Input) | Feature object |
Returns
| const AjPStr: | Feature source name |
Description
Returns the source name of a feature object.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the start position of a feature object.
Synopsis
Prototype
ajuint ajFeatGetStart (
const AjPFeature thys
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature object |
| ajuint | | RETURN | Feature start position |
Input
| thys: | (Input) | Feature object |
Returns
| ajuint: | Feature start position |
Description
Returns the start position of a feature object.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the strand of a feature object.
Synopsis
Prototype
char ajFeatGetStrand (
const AjPFeature thys
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature object |
| char | | RETURN | Feature strand code |
Input
| thys: | (Input) | Feature object |
Returns
Description
Returns the strand of a feature object.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the end position of a feature object.
Synopsis
Prototype
ajuint ajFeatGetEnd (
const AjPFeature thys
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature object |
| ajuint | | RETURN | Feature end position |
Input
| thys: | (Input) | Feature object |
Returns
| ajuint: | Feature end position |
Description
Returns the end position of a feature object.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the sequence length of a feature object.
Synopsis
Prototype
ajuint ajFeatGetLength (
const AjPFeature thys
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature object |
| ajuint | | RETURN | Feature length |
Input
| thys: | (Input) | Feature object |
Returns
Description
Returns the sequence length of a feature object.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the score of a feature object.
Synopsis
Prototype
float ajFeatGetScore (
const AjPFeature thys
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature object |
| float | | RETURN | Feature score |
Input
| thys: | (Input) | Feature object |
Returns
Description
Returns the score of a feature object.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the direction of a feature object.
Synopsis
Prototype
AjBool ajFeatGetForward (
const AjPFeature thys
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature object |
| AjBool | | RETURN | ajTrue for a forward direction, ajFalse for reverse |
Input
| thys: | (Input) | Feature object |
Returns
| AjBool: | ajTrue for a forward direction, ajFalse for reverse |
Description
Returns the direction of a feature object.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the reading frame of a feature object.
Synopsis
Prototype
ajint ajFeatGetFrame (
const AjPFeature thys
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature object |
| ajint | | RETURN | Feature reading frame (zero for undefined) |
Input
| thys: | (Input) | Feature object |
Returns
| ajint: | Feature reading frame (zero for undefined) |
Description
Returns the reading frame of a feature object.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns translation tag value
Synopsis
Prototype
AjBool ajFeatGetTranslation (
const AjPFeature thys,
AjPStr* Ptrans
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature |
| AjPStr* | Ptrans | Output | Translations |
| AjBool | | RETURN | True if translation tag was found |
Input
Output
| Ptrans: | (Output) | Translations |
Returns
| AjBool: | True if translation tag was found |
Description
Returns translation tag value
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Temporary testing function for feature handling
to be deleted when all is working happily
Synopsis
Prototype
void ajFeatTest (
void
);
| Type | Name | Read/Write | Description |
| void | | RETURN | |
Returns
Description
Temporary testing function for feature handling
to be deleted when all is working happily
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets the description for a feature
Synopsis
Prototype
void ajFeatSetDescApp (
AjPFeature thys,
const AjPStr desc
);
| Type | Name | Read/Write | Description |
| AjPFeature | thys | Modify | Feature |
| const AjPStr | desc | Input | Feature description (simple text) |
| void | | RETURN | |
Input
| desc: | (Input) | Feature description (simple text) |
Input & Output
Returns
Description
Sets the description for a feature
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets the description for a feature
Synopsis
Prototype
void ajFeatSetDesc (
AjPFeature thys,
const AjPStr desc
);
| Type | Name | Read/Write | Description |
| AjPFeature | thys | Modify | Feature |
| const AjPStr | desc | Input | Feature description (simple text) |
| void | | RETURN | |
Input
| desc: | (Input) | Feature description (simple text) |
Input & Output
Returns
Description
Sets the description for a feature
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets the score for a feature
Synopsis
Prototype
void ajFeatSetScore (
AjPFeature thys,
float score
);
| Type | Name | Read/Write | Description |
| AjPFeature | thys | Modify | Feature |
| float | score | Input | Score value |
| void | | RETURN | |
Input
Input & Output
Returns
Description
Sets the score for a feature
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets the strand for a feature
Synopsis
Prototype
void ajFeatSetStrand (
AjPFeature thys,
AjBool rev
);
| Type | Name | Read/Write | Description |
| AjPFeature | thys | Modify | Feature |
| AjBool | rev | Input | True if reverse strand |
| void | | RETURN | |
Input
| rev: | (Input) | True if reverse strand |
Input & Output
Returns
Description
Sets the strand for a feature
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets the type for feature input
Synopsis
Prototype
AjBool ajFeattabInSetType (
AjPFeattabIn thys,
const AjPStr type
);
| Type | Name | Read/Write | Description |
| AjPFeattabIn | thys | Modify | Feature input object |
| const AjPStr | type | Input | Feature type "nucleotide" "protein" |
| AjBool | | RETURN | ajTrue on success |
Input
| type: | (Input) | Feature type "nucleotide" "protein" |
Input & Output
| thys: | (Modify) | Feature input object |
Returns
Description
Sets the type for feature input
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets the type for feature input
Synopsis
Prototype
AjBool ajFeattabInSetTypeC (
AjPFeattabIn thys,
const char* type
);
| Type | Name | Read/Write | Description |
| AjPFeattabIn | thys | Modify | Feature input object |
| const char* | type | Input | Feature type "nucleotide" "protein" |
| AjBool | | RETURN | ajTrue on success |
Input
| type: | (Input) | Feature type "nucleotide" "protein" |
Input & Output
| thys: | (Modify) | Feature input object |
Returns
Description
Sets the type for feature input
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets the type for feature output
Synopsis
Prototype
AjBool ajFeattabOutSetType (
AjPFeattabOut thys,
const AjPStr type
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut | thys | Modify | Feature output object |
| const AjPStr | type | Input | Feature type "nucleotide" "protein" |
| AjBool | | RETURN | ajTrue on success |
Input
| type: | (Input) | Feature type "nucleotide" "protein" |
Input & Output
| thys: | (Modify) | Feature output object |
Returns
Description
Sets the type for feature output
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets the type for feature output
Synopsis
Prototype
AjBool ajFeattabOutSetTypeC (
AjPFeattabOut thys,
const char* type
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut | thys | Modify | Feature output object |
| const char* | type | Input | Feature type "nucleotide" "protein" |
| AjBool | | RETURN | ajTrue on success |
Input
| type: | (Input) | Feature type "nucleotide" "protein" |
Input & Output
| thys: | (Modify) | Feature output object |
Returns
Description
Sets the type for feature output
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets a feature tag value
Synopsis
Prototype
AjBool ajFeatTagSetC (
AjPFeature thys,
const char* tag,
const AjPStr value
);
| Type | Name | Read/Write | Description |
| AjPFeature | thys | Modify | Feature |
| const char* | tag | Input | Feature tag |
| const AjPStr | value | Input | Feature tag value |
| AjBool | | RETURN | ajTrue is value was valid
ajFalse if it was "corrceted" |
Input
| tag: | (Input) | Feature tag |
| value: | (Input) | Feature tag value |
Input & Output
Returns
| AjBool: | ajTrue is value was valid
ajFalse if it was "corrceted" |
Description
Sets a feature tag value
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets a feature tag value
Synopsis
Prototype
AjBool ajFeatTagSet (
AjPFeature thys,
const AjPStr tag,
const AjPStr value
);
| Type | Name | Read/Write | Description |
| AjPFeature | thys | Modify | Feature |
| const AjPStr | tag | Input | Feature tag |
| const AjPStr | value | Input | Feature tag value |
| AjBool | | RETURN | ajTrue is value was valid
ajFalse if it was "corrceted" |
Input
| tag: | (Input) | Feature tag |
| value: | (Input) | Feature tag value |
Input & Output
Returns
| AjBool: | ajTrue is value was valid
ajFalse if it was "corrceted" |
Description
Sets a feature tag value
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets a feature tag value, creating a new feature tag even if one
already exists.
Synopsis
Prototype
AjBool ajFeatTagAddCC (
AjPFeature thys,
const char* tag,
const char* value
);
| Type | Name | Read/Write | Description |
| AjPFeature | thys | Modify | Feature |
| const char* | tag | Input | Feature tag |
| const char* | value | Input | Feature tag value |
| AjBool | | RETURN | ajTrue if value was valid
ajFalse if it was bad and was "corrected" |
Input
| tag: | (Input) | Feature tag |
| value: | (Input) | Feature tag value |
Input & Output
Returns
| AjBool: | ajTrue if value was valid
ajFalse if it was bad and was "corrected" |
Description
Sets a feature tag value, creating a new feature tag even if one
already exists.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets a feature tag value, creating a new feature tag even if one
already exists.
Synopsis
Prototype
AjBool ajFeatTagAddC (
AjPFeature thys,
const char* tag,
const AjPStr value
);
| Type | Name | Read/Write | Description |
| AjPFeature | thys | Modify | Feature |
| const char* | tag | Input | Feature tag |
| const AjPStr | value | Input | Feature tag value |
| AjBool | | RETURN | ajTrue if value was valid
ajFalse if it was bad and was "corrected" |
Input
| tag: | (Input) | Feature tag |
| value: | (Input) | Feature tag value |
Input & Output
Returns
| AjBool: | ajTrue if value was valid
ajFalse if it was bad and was "corrected" |
Description
Sets a feature tag value, creating a new feature tag even if one
already exists.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets a feature tag value, creating a new feature tag even if one
already exists.
Synopsis
Prototype
AjBool ajFeatTagAdd (
AjPFeature thys,
const AjPStr tag,
const AjPStr value
);
| Type | Name | Read/Write | Description |
| AjPFeature | thys | Modify | Feature |
| const AjPStr | tag | Input | Feature tag |
| const AjPStr | value | Input | Feature tag value |
| AjBool | | RETURN | ajTrue if value was valid
ajFalse if it was bad and was "corrected" |
Input
| tag: | (Input) | Feature tag |
| value: | (Input) | Feature tag value |
Input & Output
Returns
| AjBool: | ajTrue if value was valid
ajFalse if it was bad and was "corrected" |
Description
Sets a feature tag value, creating a new feature tag even if one
already exists.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Constructor for a new (generic) feature table.
Does not define the feature table type.
Synopsis
Prototype
AjPFeattable ajFeattableNew (
const AjPStr name
);
| Type | Name | Read/Write | Description |
| const AjPStr | name | Input | Name for new feature table
(or NULL for unnamed) |
| AjPFeattable | | RETURN | Pointer to a new (empty) feature table |
Input
| name: | (Input) | Name for new feature table
(or NULL for unnamed) |
Returns
| AjPFeattable: | Pointer to a new (empty) feature table |
Description
Constructor for a new (generic) feature table.
Does not define the feature table type.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Parses a UFO, opens an input file, and reads a feature table
Synopsis
Prototype
AjPFeattable ajFeatUfoRead (
AjPFeattabIn featin,
const AjPStr ufo
);
| Type | Name | Read/Write | Description |
| AjPFeattabIn | featin | Modify | Feature input object |
| const AjPStr | ufo | Input | UFO feature spec |
| AjPFeattable | | RETURN | Feature table created, (or NULL if failed) |
Input
| ufo: | (Input) | UFO feature spec |
Input & Output
| featin: | (Modify) | Feature input object |
Returns
| AjPFeattable: | Feature table created, (or NULL if failed) |
Description
Parses a UFO, opens an input file, and reads a feature table
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets the length of a feature table with the length of the source sequence.
This is needed to reverse the table correctly
Synopsis
Prototype
void ajFeattableSetLength (
AjPFeattable thys,
ajuint len
);
| Type | Name | Read/Write | Description |
| AjPFeattable | thys | Modify | Feature table object |
| ajuint | len | Input | Length |
| void | | RETURN | |
Input
Input & Output
| thys: | (Modify) | Feature table object |
Returns
Description
Sets the length of a feature table with the length of the source sequence.
This is needed to reverse the table correctly
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets the type of a feature table as nucleotide
Synopsis
Prototype
void ajFeattableSetNuc (
AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| AjPFeattable | thys | Modify | Feature table object |
| void | | RETURN | |
Input & Output
| thys: | (Modify) | Feature table object |
Returns
Description
Sets the type of a feature table as nucleotide
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Sets the type of a feature table as Protein
Synopsis
Prototype
void ajFeattableSetProt (
AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| AjPFeattable | thys | Modify | Feature table object |
| void | | RETURN | |
Input & Output
| thys: | (Modify) | Feature table object |
Returns
Description
Sets the type of a feature table as Protein
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Reverse the features in a feature table by iterating through and
reversing all positions and strands.
Synopsis
Prototype
void ajFeattableReverse (
AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| AjPFeattable | thys | Modify | Feature table object |
| void | | RETURN | |
Input & Output
| thys: | (Modify) | Feature table object |
Returns
Description
Reverse the features in a feature table by iterating through and
reversing all positions and strands.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Reverse one feature by reversing all positions and strand.
Synopsis
Prototype
void ajFeatReverse (
AjPFeature thys,
ajint ilen
);
| Type | Name | Read/Write | Description |
| AjPFeature | thys | Modify | Feature object |
| ajint | ilen | Input | Sequence length |
| void | | RETURN | |
Input
| ilen: | (Input) | Sequence length |
Input & Output
| thys: | (Modify) | Feature object |
Returns
Description
Reverse one feature by reversing all positions and strand.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Set the begin and end range for a feature table
Synopsis
Prototype
void ajFeattableSetRange (
AjPFeattable thys,
ajint fbegin,
ajint fend
);
| Type | Name | Read/Write | Description |
| AjPFeattable | thys | Modify | Feature table object |
| ajint | fbegin | Input | Begin position |
| ajint | fend | Input | End position |
| void | | RETURN | |
Input
| fbegin: | (Input) | Begin position |
| fend: | (Input) | End position |
Input & Output
| thys: | (Modify) | Feature table object |
Returns
Description
Set the begin and end range for a feature table
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Constructor for a new DNA feature table
Synopsis
Prototype
AjPFeattable ajFeattableNewDna (
const AjPStr name
);
| Type | Name | Read/Write | Description |
| const AjPStr | name | Input | Name for new feature table
(or NULL for unnamed) |
| AjPFeattable | | RETURN | Pointer to a new (empty) feature table |
Input
| name: | (Input) | Name for new feature table
(or NULL for unnamed) |
Returns
| AjPFeattable: | Pointer to a new (empty) feature table |
Description
Constructor for a new DNA feature table
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Constructor for a new feature table for an existing sequence.
The feature table type is determined by the sequence type.
Synopsis
Prototype
AjPFeattable ajFeattableNewSeq (
const AjPSeq seq
);
| Type | Name | Read/Write | Description |
| const AjPSeq | seq | Input | Sequence object to provide the name and type |
| AjPFeattable | | RETURN | Pointer to a new (empty) feature table |
Input
| seq: | (Input) | Sequence object to provide the name and type |
Returns
| AjPFeattable: | Pointer to a new (empty) feature table |
Description
Constructor for a new feature table for an existing sequence.
The feature table type is determined by the sequence type.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Constructor for a new protein feature table
Synopsis
Prototype
AjPFeattable ajFeattableNewProt (
const AjPStr name
);
| Type | Name | Read/Write | Description |
| const AjPStr | name | Input | Name for new feature table
(or NULL for unnamed) |
| AjPFeattable | | RETURN | Pointer to a new (empty) feature table |
Input
| name: | (Input) | Name for new feature table
(or NULL for unnamed) |
Returns
| AjPFeattable: | Pointer to a new (empty) feature table |
Description
Constructor for a new protein feature table
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Makes a copy of a feature table.
For cases where we need a copy we can safely change and/or delete.
Synopsis
Prototype
AjPFeattable ajFeattableCopy (
const AjPFeattable orig
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | orig | Input | Original feature table |
| AjPFeattable | | RETURN | Feature table copy of the original |
Input
| orig: | (Input) | Original feature table |
Returns
| AjPFeattable: | Feature table copy of the original |
Description
Makes a copy of a feature table.
For cases where we need a copy we can safely change and/or delete.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Makes a copy of a feature table using only a limited number of features.
For cases where we need a copy we can safely change and/or delete.
Synopsis
Prototype
AjPFeattable ajFeattableCopyLimit (
const AjPFeattable orig,
ajint limit
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | orig | Input | Original feature table |
| ajint | limit | Input | Limit to number of features copied |
| AjPFeattable | | RETURN | Feature table copy of the original |
Input
| orig: | (Input) | Original feature table |
| limit: | (Input) | Limit to number of features copied |
Returns
| AjPFeattable: | Feature table copy of the original |
Description
Makes a copy of a feature table using only a limited number of features.
For cases where we need a copy we can safely change and/or delete.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Makes a copy of a feature.
For cases where we need a copy we can safely change and/or delete.
Synopsis
Prototype
AjPFeature ajFeatCopy (
const AjPFeature orig
);
| Type | Name | Read/Write | Description |
| const AjPFeature | orig | Input | Original feature |
| AjPFeature | | RETURN | Feature copy of the original |
Input
| orig: | (Input) | Original feature |
Returns
| AjPFeature: | Feature copy of the original |
Description
Makes a copy of a feature.
For cases where we need a copy we can safely change and/or delete.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Traces (to the debug file) a feature object
Synopsis
Prototype
void ajFeatTrace (
const AjPFeature thys
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature |
| void | | RETURN | |
Input
Returns
Description
Traces (to the debug file) a feature object
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Traces (to the debug file) the tag-value pairs of a feature object
Synopsis
Prototype
void ajFeatTagTrace (
const AjPFeature thys
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature |
| void | | RETURN | |
Input
Returns
Description
Traces (to the debug file) the tag-value pairs of a feature object
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns an iterator over all feature tag-value pairs
Synopsis
Prototype
AjIList ajFeatTagIter (
const AjPFeature thys
);
| Type | Name | Read/Write | Description |
| const AjPFeature | thys | Input | Feature |
| AjIList | | RETURN | List iterator |
Input
Returns
Description
Returns an iterator over all feature tag-value pairs
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Returns the tag-value pairs of a feature object
Synopsis
Prototype
AjBool ajFeatTagval (
AjIList iter,
AjPStr* tagnam,
AjPStr* tagval
);
| Type | Name | Read/Write | Description |
| AjIList | iter | Modify | List iterator from ajFeatTagIter |
| AjPStr* | tagnam | Output | Tag name |
| AjPStr* | tagval | Output | Tag val |
| AjBool | | RETURN | ajTrue if another tag-value pair was returned |
Output
| tagnam: | (Output) | Tag name |
| tagval: | (Output) | Tag val |
Input & Output
| iter: | (Modify) | List iterator from ajFeatTagIter |
Returns
| AjBool: | ajTrue if another tag-value pair was returned |
Description
Returns the tag-value pairs of a feature object
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Traces (to the debug file) a complete feature table
Synopsis
Prototype
void ajFeattableTrace (
const AjPFeattable thys
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | thys | Input | Feature table |
| void | | RETURN | |
Input
| thys: | (Input) | Feature table |
Returns
Description
Traces (to the debug file) a complete feature table
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Given a feature type name,
returns the valid feature type for the internal DNA feature table
Synopsis
Prototype
const AjPStr ajFeatTypeNuc (
const AjPStr type
);
| Type | Name | Read/Write | Description |
| const AjPStr | type | Input | Type name |
| const AjPStr | | RETURN | Valid feature type |
Input
Returns
| const AjPStr: | Valid feature type |
Description
Given a feature type name,
returns the valid feature type for the internal DNA feature table
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Given a feature type name,
returns the valid feature type for the internal protein feature table
Synopsis
Prototype
const AjPStr ajFeatTypeProt (
const AjPStr type
);
| Type | Name | Read/Write | Description |
| const AjPStr | type | Input | Type name |
| const AjPStr | | RETURN | Valid feature type |
Input
Returns
| const AjPStr: | Valid feature type |
Description
Given a feature type name,
returns the valid feature type for the internal protein feature table
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Prints a summary of file usage with debug calls
Cleans up feature table internal memory
Synopsis
Prototype
void ajFeatExit (
void
);
| Type | Name | Read/Write | Description |
| void | | RETURN | |
Returns
Description
Prints a summary of file usage with debug calls
Cleans up feature table internal memory
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Dummy function to prevent compiler warnings
Synopsis
Prototype
void ajFeatUnused (
void
);
| Type | Name | Read/Write | Description |
| void | | RETURN | |
Returns
Description
Dummy function to prevent compiler warnings
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Tests whether the feature is a CDS feature
Synopsis
Prototype
AjBool ajFeatTypeIsCds (
const AjPFeature gf
);
| Type | Name | Read/Write | Description |
| const AjPFeature | gf | Input | Feature |
| AjBool | | RETURN | ajTrue on success |
Input
Returns
Description
Tests whether the feature is a CDS feature
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Tests whether the feature type matches a given string
including testing for alternative names
Synopsis
Prototype
AjBool ajFeatTypeMatchC (
const AjPFeature gf,
const char* txt
);
| Type | Name | Read/Write | Description |
| const AjPFeature | gf | Input | Feature |
| const char* | txt | Input | Feature type name to test |
| AjBool | | RETURN | ajTrue on success |
Input
| gf: | (Input) | Feature |
| txt: | (Input) | Feature type name to test |
Returns
Description
Tests whether the feature type matches a given string
including testing for alternative names
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Tests whether the feature type matches a given string
including testing for alternative names
Synopsis
Prototype
AjBool ajFeatTypeMatchS (
const AjPFeature gf,
const AjPStr str
);
| Type | Name | Read/Write | Description |
| const AjPFeature | gf | Input | Feature |
| const AjPStr | str | Input | Feature type name to test |
| AjBool | | RETURN | ajTrue on success |
Input
| gf: | (Input) | Feature |
| str: | (Input) | Feature type name to test |
Returns
Description
Tests whether the feature type matches a given string
including testing for alternative names
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Tests whether the feature is local to the sequence.
Returns AJTRUE if it is local, AJFALSE if remote.
Synopsis
Prototype
AjBool ajFeatIsLocal (
const AjPFeature gf
);
| Type | Name | Read/Write | Description |
| const AjPFeature | gf | Input | Feature |
| AjBool | | RETURN | ajTrue on success |
Input
Returns
Description
Tests whether the feature is local to the sequence.
Returns AJTRUE if it is local, AJFALSE if remote.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Tests whether the feature is local and in the specified range of the
sequence.
Returns AJTRUE if it is local and within the range.
(Any label location is assumed to be outside the range.)
Synopsis
Prototype
AjBool ajFeatIsLocalRange (
const AjPFeature gf,
ajuint start,
ajuint end
);
| Type | Name | Read/Write | Description |
| const AjPFeature | gf | Input | Feature |
| ajuint | start | Input | start of range |
| ajuint | end | Input | end of range |
| AjBool | | RETURN | ajTrue on success |
Input
| gf: | (Input) | Feature |
| start: | (Input) | start of range |
| end: | (Input) | end of range |
Returns
Description
Tests whether the feature is local and in the specified range of the
sequence.
Returns AJTRUE if it is local and within the range.
(Any label location is assumed to be outside the range.)
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Tests whether the feature is a child member of a join
The parent (first) feature of a join gives:
ajFeatIsChild == ajFalse && ajFeatIsMultiple == ajTrue
Synopsis
Prototype
AjBool ajFeatIsChild (
const AjPFeature gf
);
| Type | Name | Read/Write | Description |
| const AjPFeature | gf | Input | Feature |
| AjBool | | RETURN | Returns AJTRUE if it is a child,
AJFALSE if it is not a child |
Input
Returns
| AjBool: | Returns AJTRUE if it is a child,
AJFALSE if it is not a child |
Description
Tests whether the feature is a child member of a join
The parent (first) feature of a join gives:
ajFeatIsChild == ajFalse && ajFeatIsMultiple == ajTrue
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Tests whether the feature is a member of a join, group order or one_of
Synopsis
Prototype
AjBool ajFeatIsMultiple (
const AjPFeature gf
);
| Type | Name | Read/Write | Description |
| const AjPFeature | gf | Input | Feature |
| AjBool | | RETURN | Returns AJTRUE if it is a member |
Input
Returns
| AjBool: | Returns AJTRUE if it is a member |
Description
Tests whether the feature is a member of a join, group order or one_of
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Tests whether the feature is a member of a complement around a
multiple (join, etc.)
Synopsis
Prototype
AjBool ajFeatIsCompMult (
const AjPFeature gf
);
| Type | Name | Read/Write | Description |
| const AjPFeature | gf | Input | Feature |
| AjBool | | RETURN | Returns AJTRUE if it is a complemented multiple |
Input
Returns
| AjBool: | Returns AJTRUE if it is a complemented multiple |
Description
Tests whether the feature is a member of a complement around a
multiple (join, etc.)
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Clears all data for a feature table output object
Synopsis
Prototype
void ajFeattabOutClear (
AjPFeattabOut* thys
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut* | thys | Delete | feature format |
| void | | RETURN | Feature table output object |
Output
| thys: | (Delete) | feature format |
Returns
Description
Clears all data for a feature table output object
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Destructor for a feature table output object
Synopsis
Prototype
void ajFeattabOutDel (
AjPFeattabOut* thys
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut* | thys | Delete | feature format |
| void | | RETURN | Feature table output object |
Output
| thys: | (Delete) | feature format |
Returns
Description
Destructor for a feature table output object
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Converts a string position into a true position. If ipos is negative,
it is counted from the end of the string rather than the beginning.
For strings, the result can go off the end to the terminating NULL.
For sequences the maximum is the last base.
Synopsis
Prototype
ajuint ajFeattablePos (
const AjPFeattable thys,
ajint ipos
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | thys | Input | Target feature table. |
| ajint | ipos | Input | Position. |
| ajuint | | RETURN | string position between 1 and length. |
Input
| thys: | (Input) | Target feature table. |
| ipos: | (Input) | Position. |
Returns
| ajuint: | string position between 1 and length. |
Description
Converts a string position into a true position. If ipos is negative,
it is counted from the end of the string rather than the beginning.
For strings, the result can go off the end to the terminating NULL.
For sequences the maximum is the last base.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Converts a string position into a true position. If ipos is negative,
it is counted from the end of the string rather than the beginning.
imin is a minimum relative position, also counted from the end
if negative. Usually this is the start position when the end of a range
is being tested.
Synopsis
Prototype
ajuint ajFeattablePosI (
const AjPFeattable thys,
ajuint imin,
ajint ipos
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | thys | Input | Target feature table. |
| ajuint | imin | Input | Start position. |
| ajint | ipos | Input | Position. |
| ajuint | | RETURN | string position between 1 and length. |
Input
| thys: | (Input) | Target feature table. |
| imin: | (Input) | Start position. |
| ipos: | (Input) | Position. |
Returns
| ajuint: | string position between 1 and length. |
Description
Converts a string position into a true position. If ipos is negative,
it is counted from the end of the string rather than the beginning.
imin is a minimum relative position, also counted from the end
if negative. Usually this is the start position when the end of a range
is being tested.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Converts a position into a true position. If ipos is negative,
it is counted from the end of the sequence rather than the beginning.
imin is a minimum relative position, also counted from the end
if negative. Usually this is the start position when the end of a range
is being tested.
For strings, the result can go off the end to the terminating NULL.
For sequences the maximum is the last base.
Synopsis
Prototype
ajuint ajFeattablePosII (
ajuint ilen,
ajuint imin,
ajint ipos
);
| Type | Name | Read/Write | Description |
| ajuint | ilen | Input | maximum length. |
| ajuint | imin | Input | Start position. |
| ajint | ipos | Input | Position. |
| ajuint | | RETURN | string position between 1 and length. |
Input
| ilen: | (Input) | maximum length. |
| imin: | (Input) | Start position. |
| ipos: | (Input) | Position. |
Returns
| ajuint: | string position between 1 and length. |
Description
Converts a position into a true position. If ipos is negative,
it is counted from the end of the sequence rather than the beginning.
imin is a minimum relative position, also counted from the end
if negative. Usually this is the start position when the end of a range
is being tested.
For strings, the result can go off the end to the terminating NULL.
For sequences the maximum is the last base.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Trim a feature table using the Begin and Ends.
Called where a sequence has been trimmed, so we have to allow for
missing sequence positions at the start (ioffset) or at the end (ilen).
Synopsis
Prototype
AjBool ajFeattableTrimOff (
AjPFeattable thys,
ajuint ioffset,
ajuint ilen
);
| Type | Name | Read/Write | Description |
| AjPFeattable | thys | Modify | Target feature table. |
| ajuint | ioffset | Input | Offset from start of sequence |
| ajuint | ilen | Input | Length of sequence |
| AjBool | | RETURN | AjTrue returned if successful. |
Input
| ioffset: | (Input) | Offset from start of sequence |
| ilen: | (Input) | Length of sequence |
Input & Output
| thys: | (Modify) | Target feature table. |
Returns
| AjBool: | AjTrue returned if successful. |
Description
Trim a feature table using the Begin and Ends.
Called where a sequence has been trimmed, so we have to allow for
missing sequence positions at the start (ioffset) or at the end (ilen).
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Trim a feature table using the Begin and Ends.
Called where a sequence has been trimmed, so we have to allow for
missing sequence positions at the start (ioffset) or at the end (ilen).
Synopsis
Prototype
AjBool ajFeatTrimOffRange (
AjPFeature ft,
ajuint ioffset,
ajuint begin,
ajuint end,
AjBool dobegin,
AjBool doend
);
| Type | Name | Read/Write | Description |
| AjPFeature | ft | Modify | Target feature |
| ajuint | ioffset | Input | Offset from start of sequence |
| ajuint | begin | Input | Range start of sequence |
| ajuint | end | Input | range end of sequence |
| AjBool | dobegin | Input | Reset begin |
| AjBool | doend | Input | Reset end |
| AjBool | | RETURN | AjTrue returned if successful. |
Input
| ioffset: | (Input) | Offset from start of sequence |
| begin: | (Input) | Range start of sequence |
| end: | (Input) | range end of sequence |
| dobegin: | (Input) | Reset begin |
| doend: | (Input) | Reset end |
Input & Output
| ft: | (Modify) | Target feature |
Returns
| AjBool: | AjTrue returned if successful. |
Description
Trim a feature table using the Begin and Ends.
Called where a sequence has been trimmed, so we have to allow for
missing sequence positions at the start (ioffset) or at the end (ilen).
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Provides a unique (for this program run) name for a feature table.
Synopsis
Prototype
void ajFeatDefName (
AjPFeattable thys,
const AjPStr setname
);
| Type | Name | Read/Write | Description |
| AjPFeattable | thys | Output | Feature table |
| const AjPStr | setname | Input | Name set by caller |
| void | | RETURN | |
Input
| setname: | (Input) | Name set by caller |
Output
| thys: | (Output) | Feature table |
Returns
Description
Provides a unique (for this program run) name for a feature table.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Print contents of a feature table to a file
Synopsis
Prototype
AjBool ajFeattableWriteDebug (
AjPFeattabOut ftout,
const AjPFeattable ftable
);
| Type | Name | Read/Write | Description |
| AjPFeattabOut | ftout | Modify | Feature table output object |
| const AjPFeattable | ftable | Input | Feature table |
| AjBool | | RETURN | Always true |
Input
| ftable: | (Input) | Feature table |
Input & Output
| ftout: | (Modify) | Feature table output object |
Returns
Description
Print contents of a feature table to a file
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Print contents of a feature table to a file
Synopsis
Prototype
AjBool ajFeattablePrint (
const AjPFeattable ftable,
AjPFile outf
);
| Type | Name | Read/Write | Description |
| const AjPFeattable | ftable | Input | Feature table |
| AjPFile | outf | Modify | Output file object |
| AjBool | | RETURN | Always true |
Input
| ftable: | (Input) | Feature table |
Input & Output
| outf: | (Modify) | Output file object |
Returns
Description
Print contents of a feature table to a file
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Reports the internal data structures
Synopsis
Prototype
void ajFeatPrintFormat (
AjPFile outf,
AjBool full
);
| Type | Name | Read/Write | Description |
| AjPFile | outf | Modify | Output file |
| AjBool | full | Input | Full report (usually ajFalse) |
| void | | RETURN | |
Input
| full: | (Input) | Full report (usually ajFalse) |
Input & Output
Returns
Description
Reports the internal data structures
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0
Tests whether the feature tag is a note (the default feature tag)
Synopsis
Prototype
AjBool ajFeattagIsNote (
const AjPStr tag
);
| Type | Name | Read/Write | Description |
| const AjPStr | tag | Input | Feature tag |
| AjBool | | RETURN | ajTrue on success |
Input
Returns
Description
Tests whether the feature tag is a note (the default feature tag)
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 5.0.0