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.
RDFAnnotationParser is a libSBML construct used as part of the libSBML support for annotations conforming to the guidelines specified by MIRIAM ("Minimum
Information Requested in the Annotation of biochemical Models", Nature Biotechnology, vol. 23, no. 12, Dec. 2005). Section 6 of the SBML Level 2 and Level 3 specification documents defines a recommended way of encoding MIRIAM information using a subset of RDF (Resource Description Format). The general scheme is as follows. A set of RDF-based annotations attached to a given SBML <annotation>
element are read by RDFAnnotationParser and converted into a list of CVTerm objects. There are different versions of the main method, RDFAnnotationParser::parseRDFAnnotation(const XMLNode *annotation, List *CVTerms) and RDFAnnotationParser::parseRDFAnnotation(const XMLNode *annotation), used depending on whether the annotation in question concerns the MIRIAM model history or other MIRIAM resource annotations. A special object class, ModelHistory, is used to make it easier to manipulate model history annotations.
All of the methods on RDFAnnotationParser are static; the class exists only to encapsulate the annotation and CVTerm parsing and manipulation functionality.
Static Public Member Functions | |
static XMLNode * | createAnnotation () |
Creates a blank annotation and returns its root XMLNode object. More... | |
static XMLNode * | createCVTerms (const SBase *obj) |
Takes a list of CVTerm objects and creates a the RDF "Description" element. More... | |
static XMLNode * | createRDFAnnotation (unsigned int level=3, unsigned int version=1) |
Creates a blank RDF element suitable for use in SBML annotations. More... | |
static XMLNode * | createRDFDescription (const SBase *obj) |
Takes an SBML object and creates an empty XMLNode corresponding to an RDF "Description" element. More... | |
static XMLNode * | deleteRDFAnnotation (const XMLNode *annotation) |
Deletes any SBML MIRIAM RDF annotation found in the given XMLNode tree and returns any remaining annotation content. More... | |
static XMLNode * | deleteRDFCVTermAnnotation (const XMLNode *annotation) |
Deletes any SBML MIRIAM RDF 'CVTerm' annotation found in the given XMLNode tree and returns any remaining annotation content. More... | |
static XMLNode * | deleteRDFHistoryAnnotation (const XMLNode *annotation) |
Deletes any SBML MIRIAM RDF 'History' annotation found in the given XMLNode tree and returns any remaining annotation content. More... | |
static XMLNode * | parseCVTerms (const SBase *obj) |
Takes a list of CVTerm objects and creates a complete SBML annotation around it. More... | |
static XMLNode * | parseModelHistory (const SBase *obj) |
Reads the model history and cvTerms stored in obj and creates the XML structure for an SBML annotation representing that metadata if there is a model history stored in obj . More... | |
static XMLNode * | parseOnlyModelHistory (const SBase *obj) |
Reads the model history stored in obj and creates the XML structure for an SBML annotation representing that history. More... | |
static void | parseRDFAnnotation (const XMLNode *annotation, List *CVTerms, const char *metaId=NULL, XMLInputStream *stream=NULL) |
Parses an annotation (given as an XMLNode tree) into a list of CVTerm objects. More... | |
static ModelHistory * | parseRDFAnnotation (const XMLNode *annotation, const char *metaId=NULL, XMLInputStream *stream=NULL) |
Parses an annotation into a ModelHistory class instance. More... | |
|
static |
Creates a blank annotation and returns its root XMLNode object.
This creates a completely empty SBML <annotation>
element. It is not attached to any SBML element. An example of how this might be used is illustrated in the following code fragment. In this example, suppose that content
is an XMLNode object previously created, containing MIRIAM-style annotations, and that sbmlObject
is an SBML object derived from SBase (e.g., a Model, or a Species, or a Compartment, etc.). Then:
The SBML specification contains more information about the format of annotations. We urge readers to consult Section 6 of the SBML Level 2 (Versions 2–4) and SBML Level 3 specification documents.
Takes a list of CVTerm objects and creates a the RDF "Description" element.
This essentially takes the given SBML object, reads out the CVTerm objects attached to it, creates an RDF "Description" element to hold the terms, and adds each term with appropriate qualifiers.
obj | the SBML object to start from. |
|
static |
Creates a blank RDF element suitable for use in SBML annotations.
The annotation created by this method has namespace declarations for all the relevant XML namespaces used in RDF annotations and also has an empty RDF element. The result is the following XML:
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:vCard="http://www.w3.org/2001/vcard-rdf/3.0#" xmlns:bqbiol="http://biomodels.net/biology-qualifiers/" xmlns:bqmodel="http://biomodels.net/model-qualifiers/" > </rdf:RDF>
Note that this does not create the containing SBML <annotation>
element; the method createAnnotation() is available for creating the container.
Takes an SBML object and creates an empty XMLNode corresponding to an RDF "Description" element.
This method is a handy way of creating RDF description objects linked by the appropriate "metaid" field to the given object
, for insertion into RDF annotations in a model. The method retrieves the "metaid" attribute from the object
passed in as argument, then creates an empty element having the following form (where metaid the value of the "metaid" attribute of the argument):
<rdf:Description rdf:about="#metaid" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">
...
</rdf:Description>
Note that this method does not create a complete annotation or even an RDF element; it only creates the "Description" portion. Callers will need to use other methods such as createRDFAnnotation() to create the rest of the structure for an annotation.
obj | the object to which the "Description" refers. |
object
meta identifier.Deletes any SBML MIRIAM RDF annotation found in the given XMLNode tree and returns any remaining annotation content.
The name of the XMLNode given as parameter annotation
must be "annotation", or else this method returns NULL
. The method will walk down the XML structure looking for elements that are in the RDF XML namespace, and remove them if they conform to the syntax of a History or CVTerm element.
annotation | the XMLNode tree within which the RDF annotation is to be found and deleted. |
Deletes any SBML MIRIAM RDF 'CVTerm' annotation found in the given XMLNode tree and returns any remaining annotation content.
The name of the XMLNode given as parameter annotation
must be "annotation", or else this method returns NULL
. The method will walk down the XML structure looking for elements that are in the RDF XML namespace, and remove any that conform to the syntax of a CVTerm element.
annotation | the XMLNode tree within which the RDF annotation is to be found and deleted. |
Deletes any SBML MIRIAM RDF 'History' annotation found in the given XMLNode tree and returns any remaining annotation content.
The name of the XMLNode given as parameter annotation
must be "annotation", or else this method returns NULL
. The method will walk down the XML structure looking for elements that are in the RDF XML namespace, and remove any that conform to the syntax of a History element.
annotation | the XMLNode tree within which the RDF annotation is to be found and deleted. |
Takes a list of CVTerm objects and creates a complete SBML annotation around it.
This essentially takes the given SBML object, reads out the CVTerm objects attached to it, calls createRDFAnnotation() to create an RDF annotation to hold the terms, and finally callscreateAnnotation() to wrap the result as an SBML <annotation>
element.
obj | the SBML object to start from. |
Reads the model history and cvTerms stored in obj
and creates the XML structure for an SBML annotation representing that metadata if there is a model history stored in obj
.
obj | any SBase object. |
NULL
is returned even if CVTerms are present.
|
static |
Parses an annotation (given as an XMLNode tree) into a list of CVTerm objects.
This is used to take an annotation that has been read into an SBML model, identify the RDF elements within it, and create a list of corresponding CVTerm (controlled vocabulary term) objects.
annotation | XMLNode containing the annotation. |
CVTerms | list of CVTerm objects to be created. |
metaId | optional metaId, if set only the RDF annotation for this metaId will be returned. |
stream | optional XMLInputStream that facilitates error logging. |
|
static |
Parses an annotation into a ModelHistory class instance.
This is used to take an annotation that has been read into an SBML model, identify the RDF elements representing model history information, and create a list of corresponding CVTerm objects.
annotation | XMLNode containing the annotation. |
stream | optional XMLInputStream that facilitates error logging. |
metaId | optional metaId, if set only the RDF annotation for this metaId will be returned. |