CompExtension.h File Reference

Definition of CompExtension, the core module of comp package. More...

Include dependency graph for CompExtension.h:

This graph shows which files directly or indirectly include this file:

Classes
class	CompExtension
	{comp} The core module of the “comp” package extension. More...

Macros
#define	COMP_CREATE_NS(variable, sbmlns)   EXTENSION_CREATE_NS(CompPkgNamespaces,variable,sbmlns);

Typedefs
typedef SBMLExtensionNamespaces < CompExtension >	CompPkgNamespaces

Enumerations
enum	SBMLCompTypeCode_t {   SBML_COMP_SUBMODEL = 250,   SBML_COMP_MODELDEFINITION = 251,   SBML_COMP_EXTERNALMODELDEFINITION = 252,   SBML_COMP_SBASEREF = 253,   SBML_COMP_DELETION = 254,   SBML_COMP_REPLACEDELEMENT = 255,   SBML_COMP_REPLACEDBY = 256,   SBML_COMP_PORT = 257 }
	SBMLCompTypeCode_t is the enumeration of possible types from the 'comp' package. More...

Detailed Description

Definition of CompExtension, the core module of comp package.

Author

Lucian Smith

Macro Definition Documentation

#define COMP_CREATE_NS	(		variable,
			sbmlns
	)		EXTENSION_CREATE_NS(CompPkgNamespaces,variable,sbmlns);

Typedef Documentation

typedef SBMLExtensionNamespaces<CompExtension> CompPkgNamespaces

Enumeration Type Documentation

enum SBMLCompTypeCode_t

SBMLCompTypeCode_t is the enumeration of possible types from the 'comp' package.

LibSBML attaches an identifying code to every kind of SBML object. These are integer constants known as SBML type codes. The names of all the codes begin with the characters “SBML_”. The set of possible type codes for core elements is defined in the enumeration SBMLTypeCode_t, and in addition, libSBML plug-ins for SBML Level 3 packages define their own extra enumerations of type codes (e.g., SBMLLayoutTypeCode_t for the Level 3 Layout package). Note that different Level 3 package plug-ins may use overlapping type codes; to identify the package to which a given object belongs, call the getPackageName() method on the object.

Here follow some additional general information about SBML type codes:

• The codes are the possible return values (integers) for the following functions:
  • virtual int SBase::getTypeCode() const;
  • virtual int ListOf::getItemTypeCode() const;
  (In libSBML 5, the type of return values of these functions changed from an enumeration to an integer for extensibility in the face of different programming languages.)

• Each package extension must define similar sets of values for each SBase subclass (e.g. SBMLLayoutTypeCode_t for the SBML Level 3 Layout extension, SBMLFbcTypeCode_t for the SBML Level 3 Flux Balance Constraints extension, etc.).

• The value of each package-specific type code can be duplicated between those of different packages. (This is necessary because the development of libSBML extensions for different SBML packages may be undertaken by different developers at different times; requiring the developers to coordinate their use of type codes would be nettlesome and probably doomed to failure.)

• To distinguish between the type codes of different packages, both the return value of SBase::getTypeCode() and SBase::getPackageName() must be checked. This is particularly important for functions that take an SBML type code as an argument, such as SBase::getAncestorOfType(), which by default assumes you are handing it a core type, and will return NULL if the value you give it is actually from a package.

The following example code illustrates the combined use of SBase::getPackageName() and SBase::getTypeCode():

 void example (const SBase *sb)
 {
   cons std::string pkgName = sb->getPackageName();
   if (pkgName == "core")
   {
     switch (sb->getTypeCode())
     {
       case SBML_MODEL:
          ....
          break;
       case SBML_REACTION:
          ....
     }
   } 
   else if (pkgName == "layout")
   {
     switch (sb->getTypeCode())
     {
       case SBML_LAYOUT_LAYOUT:
          ....
          break;
       case SBML_LAYOUT_REACTIONGLYPH:
          ....
     }
   } 
   ...
 } 

See also

SBMLTypeCode_t

SBMLCompTypeCode_t

SBMLFbcTypeCode_t

SBMLLayoutTypeCode_t

SBMLQualTypeCode_t

Enumerator
SBML_COMP_SUBMODEL	Submodel
SBML_COMP_MODELDEFINITION	ModelDefinition
SBML_COMP_EXTERNALMODELDEFINITION	ExternalModelDefinition
SBML_COMP_SBASEREF	SBaseRef
SBML_COMP_DELETION	Deletion
SBML_COMP_REPLACEDELEMENT	ReplacedElement
SBML_COMP_REPLACEDBY	ReplacedBy
SBML_COMP_PORT	Port