libSBML C++ API
5.18.0
|
This class of objects is defined by libSBML only and has no direct equivalent in terms of SBML components. This class is not prescribed by the SBML specifications, although it is used to implement features defined in SBML.
The SBML specification beginning with Level 2 Version 2 defines a standard approach to recording optional model history and model creator information in a form that complies with MIRIAM ("Minimum Information Requested in the Annotation of biochemical Models", Nature Biotechnology, vol. 23, no. 12, Dec. 2005). LibSBML provides the ModelHistory class as a convenient high-level interface for working with model history data.
Model histories in SBML consist of one or more model creators, a single date of creation, and one or more modification dates. The overall XML form of this data takes the following form:
<dc:creator> <rdf:Bag> <rdf:li rdf:parseType="Resource"> +++ <vCard:N rdf:parseType="Resource"> <vCard:Family>family name</vCard:Family> <vCard:Given>given name</vCard:Given> </vCard:N> +++ <vCard:EMAIL>email address</vCard:EMAIL> +++ <vCard:ORG rdf:parseType="Resource"> <vCard:Orgname>organization name</vCard:Orgname> </vCard:ORG> +++ </rdf:li> ... </rdf:Bag> </dc:creator> <dcterms:created rdf:parseType="Resource"> <dcterms:W3CDTF>creation date</dcterms:W3CDTF> </dcterms:created> <dcterms:modified rdf:parseType="Resource"> <dcterms:W3CDTF>modification date</dcterms:W3CDTF> </dcterms:modified> ...
In the template above, the underlined portions are optional, the symbol +++ is a placeholder for either no content or valid XML content that is not defined by the annotation scheme, and the ellipses ... are placeholders for zero or more elements of the same form as the immediately preceding element. The various placeholders for content, namely family name, given name, email address, organization, creation date, and modification date are data that can be filled in using the various methods on the ModelHistory class described below.
Public Member Functions | |
int | addCreator (ModelCreator *mc) |
Adds a copy of a ModelCreator object to the list of "model creator" values stored in this ModelHistory object. More... | |
int | addModifiedDate (Date *date) |
Adds a copy of a Date object to the list of "modified date" values stored in this ModelHistory object. More... | |
ModelHistory * | clone () const |
Creates and returns a deep copy of this ModelHistory object. More... | |
Date * | getCreatedDate () |
Returns the "creation date" portion of this ModelHistory object. More... | |
ModelCreator * | getCreator (unsigned int n) |
Get the nth ModelCreator object stored in this ModelHistory object. More... | |
List * | getListCreators () |
Returns the list of ModelCreator objects stored in this ModelHistory object. More... | |
List * | getListModifiedDates () |
Returns the list of "modified date" values (as Date objects) stored in this ModelHistory object. More... | |
Date * | getModifiedDate () |
Returns the "modified date" portion of this ModelHistory object. More... | |
Date * | getModifiedDate (unsigned int n) |
Get the nth Date object in the list of "modified date" values stored in this ModelHistory object. More... | |
unsigned int | getNumCreators () |
Get the number of ModelCreator objects stored in this ModelHistory object. More... | |
unsigned int | getNumModifiedDates () |
Get the number of Date objects in this ModelHistory object's list of "modified dates". More... | |
bool | hasRequiredAttributes () |
Predicate returning true if all the required elements for this ModelHistory object have been set. More... | |
bool | isSetCreatedDate () |
Predicate returning true or false depending on whether this ModelHistory's "creation date" is set. More... | |
bool | isSetModifiedDate () |
Predicate returning true or false depending on whether this ModelHistory's "modified date" is set. More... | |
ModelHistory () | |
Creates a new ModelHistory object. More... | |
ModelHistory (const ModelHistory &orig) | |
Copy constructor; creates a copy of this ModelHistory object. More... | |
ModelHistory & | operator= (const ModelHistory &rhs) |
Assignment operator for ModelHistory. More... | |
int | setCreatedDate (Date *date) |
Sets the creation date of this ModelHistory object. More... | |
int | setModifiedDate (Date *date) |
Sets the modification date of this ModelHistory object. More... | |
~ModelHistory () | |
Destroys this ModelHistory object. More... | |
ModelHistory::ModelHistory | ( | ) |
Creates a new ModelHistory object.
ModelHistory::~ModelHistory | ( | ) |
Destroys this ModelHistory object.
ModelHistory::ModelHistory | ( | const ModelHistory & | orig | ) |
Copy constructor; creates a copy of this ModelHistory object.
orig | the object to copy. |
int ModelHistory::addCreator | ( | ModelCreator * | mc | ) |
Adds a copy of a ModelCreator object to the list of "model creator" values stored in this ModelHistory object.
In the MIRIAM format for annotations, there can be multiple model creators. The libSBML ModelHistory class supports this by storing a list of "model creator" values.
mc | the ModelCreator to add. |
int ModelHistory::addModifiedDate | ( | Date * | date | ) |
Adds a copy of a Date object to the list of "modified date" values stored in this ModelHistory object.
In the MIRIAM format for annotations, there can be multiple modification dates. The libSBML ModelHistory class supports this by storing a list of "modified date" values.
date | a Date object representing the "modified date" that should be added to this ModelHistory object. |
ModelHistory * ModelHistory::clone | ( | ) | const |
Creates and returns a deep copy of this ModelHistory object.
Date * ModelHistory::getCreatedDate | ( | ) |
Returns the "creation date" portion of this ModelHistory object.
ModelCreator * ModelHistory::getCreator | ( | unsigned int | n | ) |
Get the nth ModelCreator object stored in this ModelHistory object.
In the MIRIAM format for annotations, there can be multiple model creators. The libSBML ModelHistory class supports this by storing a list of "model creator" values.
NULL
if no such object exists. List * ModelHistory::getListCreators | ( | ) |
Returns the list of ModelCreator objects stored in this ModelHistory object.
In the MIRIAM format for annotations, there can be multiple model creators. The libSBML ModelHistory class supports this by storing a list of "model creator" values.
List * ModelHistory::getListModifiedDates | ( | ) |
Returns the list of "modified date" values (as Date objects) stored in this ModelHistory object.
In the MIRIAM format for annotations, there can be multiple modification dates. The libSBML ModelHistory class supports this by storing a list of "modified date" values.
Date * ModelHistory::getModifiedDate | ( | ) |
Returns the "modified date" portion of this ModelHistory object.
Note that in the MIRIAM format for annotations, there can be multiple modification dates. The libSBML ModelHistory class supports this by storing a list of "modified date" values. If this ModelHistory object contains more than one "modified date" value in the list, this method will return the first one in the list.
Date * ModelHistory::getModifiedDate | ( | unsigned int | n | ) |
Get the nth Date object in the list of "modified date" values stored in this ModelHistory object.
In the MIRIAM format for annotations, there can be multiple modification dates. The libSBML ModelHistory class supports this by storing a list of "modified date" values.
NULL
if no such object exists. unsigned int ModelHistory::getNumCreators | ( | ) |
Get the number of ModelCreator objects stored in this ModelHistory object.
In the MIRIAM format for annotations, there can be multiple model creators. The libSBML ModelHistory class supports this by storing a list of "model creator" values.
unsigned int ModelHistory::getNumModifiedDates | ( | ) |
Get the number of Date objects in this ModelHistory object's list of "modified dates".
In the MIRIAM format for annotations, there can be multiple modification dates. The libSBML ModelHistory class supports this by storing a list of "modified date" values.
bool ModelHistory::hasRequiredAttributes | ( | ) |
Predicate returning true
if all the required elements for this ModelHistory object have been set.
The required elements for a ModelHistory object are "created name", "modified date", and at least one "model creator".
bool ModelHistory::isSetCreatedDate | ( | ) |
Predicate returning true
or false
depending on whether this ModelHistory's "creation date" is set.
true
if the creation date value of this ModelHistory is set, false
otherwise. bool ModelHistory::isSetModifiedDate | ( | ) |
Predicate returning true
or false
depending on whether this ModelHistory's "modified date" is set.
true
if the modification date value of this ModelHistory object is set, false
otherwise. ModelHistory & ModelHistory::operator= | ( | const ModelHistory & | rhs | ) |
Assignment operator for ModelHistory.
rhs | the object whose values are used as the basis of the assignment. |
int ModelHistory::setCreatedDate | ( | Date * | date | ) |
Sets the creation date of this ModelHistory object.
date | a Date object representing the date to which the "created date" portion of this ModelHistory should be set. |
int ModelHistory::setModifiedDate | ( | Date * | date | ) |
Sets the modification date of this ModelHistory object.
date | a Date object representing the date to which the "modified date" portion of this ModelHistory should be set. |