[t,x,names] = select(simdata,query)
returns the simulation time points t, the simulation data
x, and corresponding names for the data columns
that match query.
SimBiology Simulation Data
ModelName: Cobelli's Glucose-Insulin System
Logged Data:
Species: 0
Compartment: 0
Parameter: 2
Sensitivity: 0
Observable: 0
sbioplot(newsd);
Compare data for the plasma glucose concentration (the species named Plasma Glu Conc)and insulin secretion rate (the parameter named Ins Secr). Use selectbyname to extract data by specifying the corresponding names.
simdata — Simulation data SimData object | array of SimData objects
Simulation data, specified as a SimData object or array of
SimData objects.
query — Search query cell array of character vectors | string vector
Search query, specified as a cell array of character vectors or a string vector. The
query consists of some combination of name-value pair arguments or
'Where' clauses. For a more complete description of the query
syntax, including 'Where' clauses and their supported condition
types, see sbioselect. However, the only boolean
operator that the function supports is and.
You can use any of the metadata fields available in the
DataInfo property of a SimData object in the
query. The fields include 'Type', 'Name',
'Units', 'Compartment' (for species only), and
'Reaction' (for parameters only).
Example: {'Type','species'}
Data Types: string | cell
formatValue — Simulation data format character vector | string
Simulation data format, specified as a character vector or string. Some formats require you to
specify only one output argument. The valid formats follow.
'num' — This format returns simulation time points and
simulation data in numeric arrays and the names of quantities and sensitivities
as a cell array. This format is the default when you run
getdata with multiple output arguments.
'nummetadata' — This format returns a cell array of
metadata structures instead of the names of quantities and sensitivities as the
third output argument.
'numqualnames' — This format returns qualified names in the
third output argument to resolve ambiguities.
You must specify only one output argument for the following formats.
'simdata' — This format returns data in a new
SimData object or an array of SimData
objects. This format is the default when you specify a single output
argument.
'struct' — This format returns a structure or structure
array that contains both data and metadata.
'ts' — This format returns data as a cell array.
If simdata is scalar, the cell array is an m-by-1 array, where each element is a timeseries object. m is the number of quantities and sensitivities logged during the simulation.
If simdata is not scalar, the cell array is
k-by-1, where each element of the cell array
is an m-by-1 cell array of
timeseries objects. k is the
size of simdata, and m is
the number of quantities or sensitivities in each
SimData object in simdata.
In other words, the function returns an individual time series for
each state or column and for each SimData object in
simdata.
'tslumped' — This format returns the data as a cell array
of timeseries objects, combining
data from each SimData object into a single time series.
t — Simulation time points numeric vector | cell array
Simulation time points, returned as a numeric vector or cell array. If
simdata is scalar, t is an
n-by-1 vector, where n is the number of time
points. If simdata is an array of objects, t
is a k-by-1 cell array, where k is the size of
simdata.
x — Simulation data numeric matrix | cell array
Simulation data, returned as a numeric matrix or cell array. If simdata
is scalar, x is an n-by-m
matrix, where n is the number of time points and m
is the number of quantities and sensitivities logged during the simulation. If
simdata is an array of objects, x is a
k-by-1 cell array, where k is the size of
simdata.
names — Names of quantities and sensitivities cell array
Names of quantities and sensitivities logged during the simulation, returned as a cell array.
If simdata is scalar, names is an
m-by-1 cell array. If simdata is an array of
objects, names is a k-by-1 cell array, where
k is the size of simdata.
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.