libSBML Python API
5.18.0
|
The CompSBMLDocumentPlugin class inherits from the SBMLDocumentPlugin class, and codifies the extensions to the SBMLDocument class defined in the SBML Level 3 Hierarchical Model Composition (“comp”) package. This extension allows multiple Model objects to be defined in a single SBMLDocument, stored in an optional child ListOfModelDefinitions object, as well as define references to Model objects in other files, stored in the optional child ListOfExternalModelDefinitions object. These model definitions, if present, allow Submodel objects to reference other Models to instantiate.
The presence of any ModelDefinition or ExternalModelDefinition in an SBMLDocument does not change the default Model in the file. If a SBMLDocument is submitted somewhere to be simulated, it is still the <model>
child of the <sbml>
element that should be simulated.
In addition, as all packages do, the CompSBMLDocumentPlugin defines a required flag named required
, which indicates whether “comp” constructs can be used to change the core mathematics of the <model>
child of the <sbml>
element. Because they can, this attribute must be set True
.
Public Member Functions | |
def | __init__ (self, args) |
This method has multiple variants; they differ in the arguments they accept. More... | |
def | addExternalModelDefinition (self, externalModelDefinition) |
Adds a copy of the given ExternalModelDefinition object to the ListOfExternalModelDefinitions. More... | |
def | addModelDefinition (self, modelDefinition) |
Adds a copy of the given ModelDefinition object to the ListOfModelDefinitions. More... | |
def | clone (self) |
Creates and returns a deep copy of this CompSBMLDocumentPlugin object. More... | |
def | createExternalModelDefinition (self) |
Creates a ExternalModelDefinition object, adds it to the end of the ExternalModelDefinition objects list and returns a pointer to the newly created object. More... | |
def | createModelDefinition (self) |
Creates a ModelDefinition object, adds it to the end of the ModelDefinition objects list and returns a pointer to the newly created object. More... | |
def | getElementByMetaId (self, metaid) |
Returns the first child element it can find with the given metaid , or itself if it has the given metaid , or None if no such object is found. More... | |
def | getElementBySId (self, id) |
Returns the first child element found that has the given id in the model-wide SId namespace, or None if no such object is found. More... | |
def | getElementNamespace (self) |
Returns the namespace URI of the package to which this plugin object belongs. More... | |
def | getExternalModelDefinition (self, args) |
This method has multiple variants; they differ in the arguments they accept. More... | |
def | getLevel (self) |
Returns the SBML Level of the package extension of this plugin object. More... | |
def | getListOfAllElements (self, filter=None) |
Returns an SBaseList of all child SBase objects, including those nested to an arbitrary depth. More... | |
def | getListOfExternalModelDefinitions (self, args) |
Returns the ListOf object that holds each ExternalModelDefinition. More... | |
def | getListOfModelDefinitions (self, args) |
Returns the ListOf object that holds each ModelDefinition. More... | |
def | getModel (self, args) |
Searches the model namespace of the document and returns the Model, ModelDefinition, or ExternalModelDefintion object with the given identifier. More... | |
def | getModelDefinition (self, args) |
This method has multiple variants; they differ in the arguments they accept. More... | |
def | getNumExternalModelDefinitions (self) |
Returns the number of ExternalModelDefinition objects for this SBMLDocumentPlugin. More... | |
def | getNumModelDefinitions (self) |
Returns the number of ModelDefinition objects for this SBMLDocumentPlugin. More... | |
def | getPackageName (self) |
Returns the short-form name of the package to which this plugin object belongs. More... | |
def | getPackageVersion (self) |
Returns the package version of the package extension of this plugin object. More... | |
def | getParentSBMLObject (self, args) |
Returns the parent object to which this plugin object is connected. More... | |
def | getPrefix (self) |
Returns the XML namespace prefix of the package to which this plugin object belongs. More... | |
def | getRequired (self) |
Returns the value of the 'required' attribute. More... | |
def | getSBMLDocument (self, args) |
Returns the SBMLDocument object containing this object instance. More... | |
def | getURI (self) |
Returns the XML namespace URI for the package to which this object belongs. More... | |
def | getVersion (self) |
Returns the Version within the SBML Level of the package extension of this plugin object. More... | |
def | isSetRequired (self) |
Returns the value of the 'required' attribute. More... | |
def | isValidTypeForList (self, item) |
def | removeExternalModelDefinition (self, args) |
This method has multiple variants; they differ in the arguments they accept. More... | |
def | removeModelDefinition (self, args) |
This method has multiple variants; they differ in the arguments they accept. More... | |
def | renameMetaIdRefs (self, oldid, newid) |
Replaces all uses of a given meta identifier attribute value with another value. More... | |
def | renameSIdRefs (self, oldid, newid) |
Replaces all uses of a given SIdRef type attribute value with another value. More... | |
def | renameUnitSIdRefs (self, oldid, newid) |
Replaces all uses of a given UnitSIdRef type attribute value with another value. More... | |
def | setElementNamespace (self, uri) |
Sets the XML namespace to which this object belongs. More... | |
def | setRequired (self, value) |
Sets the bool value of 'required' attribute of corresponding package in SBMLDocument element. More... | |
def | unsetRequired (self) |
Unsets the value of the 'required' attribute of this SBMLDocumentPlugin. More... | |
def libsbml.CompSBMLDocumentPlugin.__init__ | ( | self, | |
args | |||
) |
This method has multiple variants; they differ in the arguments they accept.
__init__(string uri, string prefix, CompPkgNamespaces compns) CompSBMLDocumentPlugin __init__(CompSBMLDocumentPlugin orig) CompSBMLDocumentPlugin
Each variant is described separately below.
CompSBMLDocumentPlugin(string uri, string prefix, CompPkgNamespaces compns)
Creates a new CompSBMLDocumentPlugin object using the given parameters.
'http://www.sbml.org/sbml/level3/version1/core'
. Individual SBML Level 3 packages define their own XML namespaces; for example, all elements belonging to the SBML Level 3 Layout Version 1 package must be placed in the XML namespace 'http://www.sbml.org/sbml/level3/version1/layout/version1/'
.uri | the URI of the SBML Level 3 package implemented by this libSBML package extension. |
prefix | the XML namespace prefix being used for the package. |
compns | the namespaces object for the package. |
CompSBMLDocumentPlugin(CompSBMLDocumentPlugin orig)
Copy constructor. Creates a copy of this CompSBMLDocumentPlugin object.
orig | the instance to copy. |
def libsbml.CompSBMLDocumentPlugin.addExternalModelDefinition | ( | self, | |
externalModelDefinition | |||
) |
Adds a copy of the given ExternalModelDefinition object to the ListOfExternalModelDefinitions.
addExternalModelDefinition(ExternalModelDefinition externalModelDefinition) int
externalModelDefinition | the ExternalModelDefinition object to be added to the ListOFExternalModelDefinitions. Fails if the added ExternalModelDefinition is None , does not match the level/version/package of the parent object, or cannot be added to the list of external model definitions. |
def libsbml.CompSBMLDocumentPlugin.addModelDefinition | ( | self, | |
modelDefinition | |||
) |
Adds a copy of the given ModelDefinition object to the ListOfModelDefinitions.
addModelDefinition(ModelDefinition modelDefinition) int
modelDefinition | the ModelDefinition object to be added to the ListOfModelDefinitions. Fails if the added ModelDefinition is None , does not match the level/version/package of the parent object, or cannot be added to the list of replaced elements. |
def libsbml.CompSBMLDocumentPlugin.clone | ( | self | ) |
Creates and returns a deep copy of this CompSBMLDocumentPlugin object.
clone() CompSBMLDocumentPlugin
def libsbml.CompSBMLDocumentPlugin.createExternalModelDefinition | ( | self | ) |
Creates a ExternalModelDefinition object, adds it to the end of the ExternalModelDefinition objects list and returns a pointer to the newly created object.
createExternalModelDefinition() ExternalModelDefinition
def libsbml.CompSBMLDocumentPlugin.createModelDefinition | ( | self | ) |
Creates a ModelDefinition object, adds it to the end of the ModelDefinition objects list and returns a pointer to the newly created object.
createModelDefinition() ModelDefinition
def libsbml.CompSBMLDocumentPlugin.getElementByMetaId | ( | self, | |
metaid | |||
) |
Returns the first child element it can find with the given metaid
, or itself if it has the given metaid
, or None
if no such object is found.
getElementByMetaId(string metaid) SBase
metaid | string representing the meta identifier of the object to find. |
metaid
. def libsbml.CompSBMLDocumentPlugin.getElementBySId | ( | self, | |
id | |||
) |
Returns the first child element found that has the given id
in the model-wide SId namespace, or None
if no such object is found.
getElementBySId(string id) SBase
id | string representing the identifier of the object to find. |
id
.
|
inherited |
Returns the namespace URI of the package to which this plugin object belongs.
getElementNamespace() string
def libsbml.CompSBMLDocumentPlugin.getExternalModelDefinition | ( | self, | |
args | |||
) |
This method has multiple variants; they differ in the arguments they accept.
getExternalModelDefinition(long n) ExternalModelDefinition getExternalModelDefinition(string sid) ExternalModelDefinition
Each variant is described separately below.
getExternalModelDefinition(long n)
Returns the ExternalModelDefinition with the given index.
n | the index number of the ExternalModelDefinition to get. |
None
is returned.getExternalModelDefinition(string sid)
Returns the model definition object based on its identifier.
sid | a string representing the identifier of the model definition to get. |
sid
or None
if no such ExternalModelDefinition exists.
|
inherited |
Returns the SBML Level of the package extension of this plugin object.
getLevel() long
|
inherited |
Returns an SBaseList of all child SBase objects, including those nested to an arbitrary depth.
getListOfAllElements(ElementFilter filter) SBaseList getListOfAllElements() SBaseList
def libsbml.CompSBMLDocumentPlugin.getListOfExternalModelDefinitions | ( | self, | |
args | |||
) |
Returns the ListOf object that holds each ExternalModelDefinition.
getListOfExternalModelDefinitions() ListOfExternalModelDefinitions
def libsbml.CompSBMLDocumentPlugin.getListOfModelDefinitions | ( | self, | |
args | |||
) |
Returns the ListOf object that holds each ModelDefinition.
getListOfModelDefinitions() ListOfModelDefinitions
def libsbml.CompSBMLDocumentPlugin.getModel | ( | self, | |
args | |||
) |
Searches the model namespace of the document and returns the Model, ModelDefinition, or ExternalModelDefintion object with the given identifier.
getModel(string sid) SBase
sid | a string representing the identifier of the model definition to get. |
sid
or None
if no such model exists. If no such model exists, this will return None
. def libsbml.CompSBMLDocumentPlugin.getModelDefinition | ( | self, | |
args | |||
) |
This method has multiple variants; they differ in the arguments they accept.
getModelDefinition(long n) ModelDefinition getModelDefinition(string sid) ModelDefinition
Each variant is described separately below.
getModelDefinition(long n)
Returns the ModelDefinition with the given index.
n | the index number of the ModelDefinition to get. |
n
is invalid, None
is returned.getModelDefinition(string sid)
Returns the model definition object based on its identifier.
sid | a string representing the identifier of the model definition to get. |
sid
or None
if no such ModelDefinition exists.def libsbml.CompSBMLDocumentPlugin.getNumExternalModelDefinitions | ( | self | ) |
Returns the number of ExternalModelDefinition objects for this SBMLDocumentPlugin.
getNumExternalModelDefinitions() long
def libsbml.CompSBMLDocumentPlugin.getNumModelDefinitions | ( | self | ) |
Returns the number of ModelDefinition objects for this SBMLDocumentPlugin.
getNumModelDefinitions() long
|
inherited |
Returns the short-form name of the package to which this plugin object belongs.
getPackageName() string
|
inherited |
Returns the package version of the package extension of this plugin object.
getPackageVersion() long
|
inherited |
Returns the parent object to which this plugin object is connected.
getParentSBMLObject() SBase
|
inherited |
Returns the XML namespace prefix of the package to which this plugin object belongs.
getPrefix() string
|
inherited |
Returns the value of the 'required' attribute.
getRequired() bool
<sbml>
element in an SBML file or data stream. The attribute, being in the namespace of the Level 3 package in question, must be prefixed by the XML namespace prefix associated with the package. The value of the 'required' attribute indicates whether constructs in that package may change the mathematical interpretation of constructs defined in SBML Level 3 Core. A 'required' value of True
indicates that the package may do so. The value of the attribute is set by the Level 3 package specification, and does not depend on the actual presence or absence of particular package constructs in a given SBML document: in other words, if the package specification defines any construct that can change the model's meaning, the value of the 'required' attribute must always be set to True
in any SBML document that uses the package.The XML namespace declaration for an SBML Level 3 package is an indication that a model makes use of features defined by that package, while the 'required' attribute indicates whether the features may be ignored without compromising the mathematical meaning of the model. Both are necessary for a complete reference to an SBML Level 3 package.
|
inherited |
Returns the SBMLDocument object containing this object instance.
getSBMLDocument() SBMLDocument
This method allows the caller to obtain the SBMLDocument for the current object.
|
inherited |
Returns the XML namespace URI for the package to which this object belongs.
getURI() string
'http://www.sbml.org/sbml/level3/version1/core'
. Individual SBML Level 3 packages define their own XML namespaces; for example, all elements belonging to the SBML Level 3 Layout Version 1 package must be placed in the XML namespace 'http://www.sbml.org/sbml/level3/version1/layout/version1/'
.This method first looks into the SBMLNamespaces object possessed by the parent SBMLDocument object of the current object. If this cannot be found, this method returns the result of getElementNamespace().
|
inherited |
Returns the Version within the SBML Level of the package extension of this plugin object.
getVersion() long
|
inherited |
Returns the value of the 'required' attribute.
isSetRequired() bool
<sbml>
element in an SBML file or data stream. The attribute, being in the namespace of the Level 3 package in question, must be prefixed by the XML namespace prefix associated with the package. The value of the 'required' attribute indicates whether constructs in that package may change the mathematical interpretation of constructs defined in SBML Level 3 Core. A 'required' value of True
indicates that the package may do so. The value of the attribute is set by the Level 3 package specification, and does not depend on the actual presence or absence of particular package constructs in a given SBML document: in other words, if the package specification defines any construct that can change the model's meaning, the value of the 'required' attribute must always be set to True
in any SBML document that uses the package.The XML namespace declaration for an SBML Level 3 package is an indication that a model makes use of features defined by that package, while the 'required' attribute indicates whether the features may be ignored without compromising the mathematical meaning of the model. Both are necessary for a complete reference to an SBML Level 3 package.
True
if the 'required' attribute of this SBMLDocument has been set to True
, False
otherwise.
|
inherited |
isValidTypeForList(SBase item) bool
def libsbml.CompSBMLDocumentPlugin.removeExternalModelDefinition | ( | self, | |
args | |||
) |
This method has multiple variants; they differ in the arguments they accept.
removeExternalModelDefinition(long index) ExternalModelDefinition removeExternalModelDefinition(string id) ExternalModelDefinition
Each variant is described separately below.
removeExternalModelDefinition(string id)
Removes the ExternalModelDefinition with the given id
.
A pointer to the ExternalModelDefinition that was removed is returned. If no ExternalModelDefinition has been removed, None
is returned.
id | the id of the ExternalModelDefinition object to remove. |
None
is returned if the given index is out of range.removeExternalModelDefinition(long index)
Removes the ExternalModelDefinition with the given index.
A pointer to the ExternalModelDefinition that was removed is returned. If no ExternalModelDefinition has been removed, None
is returned.
index | the index of the ExternalModelDefinition object to remove. |
None
is returned if the given index is out of range. def libsbml.CompSBMLDocumentPlugin.removeModelDefinition | ( | self, | |
args | |||
) |
This method has multiple variants; they differ in the arguments they accept.
removeModelDefinition(long index) ModelDefinition removeModelDefinition(string id) ModelDefinition
Each variant is described separately below.
removeModelDefinition(string id)
Removes the ModelDefinition with the given id
from the CompSBMLDocumentPlugin.
A pointer to the ModelDefinition that was removed is returned. If no ModelDefinition has been removed, None
is returned.
id | the id of the ModelDefinition object to remove. |
None
is returned if the given index is out of range.removeModelDefinition(long index)
Removes the ModelDefinition with the given index from the CompSBMLDocumentPlugin.
A pointer to the ModelDefinition that was removed is returned. If no ModelDefinition has been removed, None
is returned.
index | the index of the ModelDefinition object to remove. |
None
is returned if the given index is out of range.
|
inherited |
Replaces all uses of a given meta identifier attribute value with another value.
renameMetaIdRefs(string oldid, string newid)
ID
; the SBML object attribute itself is typically named metaid
. All attributes that hold values referring to values of type ID
are of the XML data type IDREF
. They are also sometimes informally referred to as 'metaid refs', in analogy to the SBML-defined type SIdRef
.This method works by looking at all meta-identifier attribute values, comparing the identifiers to the value of oldid
. If any matches are found, the matching identifiers are replaced with newid
. The method does not descend into child elements.
oldid | the old identifier. |
newid | the new identifier. |
|
inherited |
Replaces all uses of a given SIdRef
type attribute value with another value.
renameSIdRefs(string oldid, string newid)
SId
. In SBML Level 3, an explicit data type called SIdRef
was introduced for attribute values that refer to SId
values; in previous Levels of SBML, this data type did not exist and attributes were simply described to as 'referring to an identifier', but the effective data type was the same as SIdRef
in Level 3. These and other methods of libSBML refer to the type SIdRef
for all Levels of SBML, even if the corresponding SBML specification did not explicitly name the data type.This method works by looking at all attributes and (if appropriate) mathematical formulas in MathML content, comparing the referenced identifiers to the value of oldid
. If any matches are found, the matching values are replaced with newid
. The method does not descend into child elements.
oldid | the old identifier. |
newid | the new identifier. |
|
inherited |
Replaces all uses of a given UnitSIdRef
type attribute value with another value.
renameUnitSIdRefs(string oldid, string newid)
UnitSId
. In SBML Level 3, an explicit data type called UnitSIdRef
was introduced for attribute values that refer to UnitSId
values; in previous Levels of SBML, this data type did not exist and attributes were simply described to as 'referring to a unit identifier', but the effective data type was the same as UnitSIdRef
in Level 3. These and other methods of libSBML refer to the type UnitSIdRef
for all Levels of SBML, even if the corresponding SBML specification did not explicitly name the data type.This method works by looking at all unit identifier attribute values (including, if appropriate, inside mathematical formulas), comparing the referenced unit identifiers to the value of oldid
. If any matches are found, the matching values are replaced with newid
. The method does not descend into child elements.
oldid | the old identifier. |
newid | the new identifier. |
|
inherited |
Sets the XML namespace to which this object belongs.
setElementNamespace(string uri) int
'http://www.sbml.org/sbml/level3/version1/core'
. Individual SBML Level 3 packages define their own XML namespaces; for example, all elements belonging to the SBML Level 3 Layout Version 1 package must be placed in the XML namespace 'http://www.sbml.org/sbml/level3/version1/layout/version1/'
.uri | the URI to assign to this object. |
def libsbml.CompSBMLDocumentPlugin.setRequired | ( | self, | |
value | |||
) |
Sets the bool value of 'required' attribute of corresponding package in SBMLDocument element.
setRequired(bool value) int
The only legal value is 'true' for the Hierarchical Model Composition package.
value | the bool value of 'required' attribute of corresponding package in SBMLDocument element. |
|
inherited |
Unsets the value of the 'required' attribute of this SBMLDocumentPlugin.
unsetRequired() int