object containing expression for post-凯发k8网页登录
object containing expression for post-simulation calculations
since r2020a
description
an observable object is a mathematical expression that lets you perform post-simulation calculations. for example, you can define an observable expression to compute the fraction of a ligand that is bound to a receptor at each time step, or compute some statistics such as area under the curve (auc) of a drug concentration profile. you can also use an observable object as a response in simulation, data fitting, and global sensitivity analysis.
the name of each observable object in a simbiology® model must be unique, meaning no observable object can have the same name as
another observable, species, compartment, parameter, reaction, variant, or dose in the model.
an observable object can reference any model quantities that are logged (in
statestolog
). it can also reference other active observable objects
provided that the expressions contain no algebraic loops. the object expression can reference
simulation time using the variable time. follow the recommended for
expression evaluations. for instance, if a quantity name is not a valid matlab® variable name, enclose the name in brackets []
when referring
to it in an expression.
simbiology evaluates the object expression using the entire time course of any referenced
states or observables. the result of an observable expression must be a numeric scalar or
vector. if it is a vector, it must be of the same length as the simulation time vector. the
result is stored in the returned simdata
object. specifically, if the
observable expression is scalar-valued, the result is stored in the
simdata.scalarobservables
property. otherwise, it is stored in
simdata.vectorobservables
.
note
make sure to correctly vectorize the expressions. for example, use
a./(a b)
instead ofa/(a b)
if a and b are matrices.avoid hardcoding expressions that expect any particular number of points or times. for example, instead of using
time(1:1000)
, usetime(1:min(1000,numel(time)))
.
creation
create an observable object using .
properties
object functions
copy simbiology object and its children | |
find out how observable object is used in simbiology model | |
get simbiology object properties | |
set simbiology object properties | |
delete simbiology object | |
display summary of simbiology object | |
rename object and update expressions |
examples
version history
introduced in r2020a
see also
| | |