Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

sbmlimport

Import SBML-formatted file

Syntax

modelObj = sbmlimport(File)

Description

modelObj = sbmlimport(File) imports File, a Systems Biology Markup Language (SBML)-formatted file, into MATLAB and creates a model object modelObj.

File is a character vector specifying a file name or a path and file name supported by your operating system. File extensions are .sbml or .xml.File can also be a URL, if you have the Java® programming language.

sbmlimport supports SBML Level 3 Version 1 and earlier.

For functional characteristics and limitations, see SBML Support.

  • sbmlimport adds an initial assignment rule when importing SBML models with the following conditions.

    • If an SBML model has a species s initialized to X using initialAmount and has the attribute setting hasOnlySubstanceUnits = false:

      • SimBiology sets the initial amount of s to X.

      • If the model does not already have an initial assignment or repeated assignment rule for s, SimBiology adds an initial assignment rule s = X / V, where V is the compartment volume (capacity). This rule ensures that the initial amount of s is a concentration unit.

      • If the model already has an initial assignment or repeated assignment rule for s, then SimBiology does not use the value X. Instead, SimBiology evaluates the rule and sets the appropriate initial amount.

    • If an SBML model has a species s initialized to X using initialConcentration and has the attribute setting hasOnlySubstanceUnits = true:

      • SimBiology sets the initial amount of s to X.

      • If the model does not already have an initial assignment or repeated assignment rule for s, SimBiology adds an initial assignment rule s = X * V, where V is the compartment volume (capacity). This rule ensures that the initial amount of s is an amount unit.

      • If the model already has an initial assignment or repeated assignment rule for s, then SimBiology does not use the value X. Instead, SimBiology evaluates the rule and sets the appropriate initial amount.

  • If a species s in an SBML model has the attribute setting hasOnlySubstanceUnits = true without any units defined, SimBiology issues a warning and sets the species amount unit to a default unit (mole) to ensure it is interpreted as an amount, not a concentration. The imported SimBiology model has the DimensionalAnalysis property set to false to prevent dimensional analysis errors.

Input Arguments

File

Character vector specifying either of the following:

  • File name or path and file name supported by your operating system

  • URL (if you have Java programming language)

Examples

Import SBML model:

sbmlobj = sbmlimport('oscillator.xml');

References

Finney, A., Hucka, M., (2003). Systems Biology Markup Language (SBML) Level 2: Structures and facilities for model definitions. SBML.org.

Introduced before R2006a

Was this topic helpful?