addvariant (model)

Add variant to model

Syntax

variantObj = addvariant(modelObj, 'NameValue')
variantObj2 = addvariant(modelObj, variantObj)

Arguments

modelObjSpecify the model object to which you want add a variant.
variantObjVariant object to create and add to the model object.
NameValueName of the variant object. NameValue is assigned to the Name property of the variant object.

Description

variantObj = addvariant(modelObj, 'NameValue') creates a SimBiology® variant object (variantObj) with the name NameValue and adds the variant object to the SimBiology model object modelObj. The variant object Parent property is assigned the value of modelObj.

A SimBiology variant object stores alternate values for properties on a SimBiology model. For more information on variants, see Variant object.

variantObj2 = addvariant(modelObj, variantObj) adds a SimBiology variant object (variantObj) to the SimBiology model object and returns another variant object variantObj2. The variant object variantObj2 Parent property is assigned the value of modelObj.

View properties for a variant object with the get command, and modify properties for a variant object with the set command.

    Note:   Remember to use the addcontent method instead of using the set method on the Content property, because the set method replaces the data in the Content property, whereas addcontent appends the data.

To view the variants stored on a model object, use the getvariant method. To copy a variant object to another model, use copyobj. To remove a variant object from a SimBiology model, use the delete method.

Examples

  1. Create a model containing one species.

    modelObj = sbiomodel('mymodel');
    compObj = addcompartment(modelObj, 'comp1');
    speciesObj = addspecies(compObj, 'A');
  2. Add a variant object that varies the InitialAmount property of a species named A.

    variantObj = addvariant(modelObj, 'v1');
    addcontent(variantObj, {'species', 'A', 'InitialAmount', 5});
Was this topic helpful?