remove
Syntax
Description
___ = remove(
returns the simulation data in the specified data format.simdata
,query
,'Format',formatValue
)
Examples
Remove Subset of Simulation Data from SimData
Load the model of glucose-insulin response. For details about the model, see the Background section in Simulate the Glucose-Insulin Response.
sbioloadproject('insulindemo.sbproj','m1');
Suppress an information warning that is issued during simulations.
warnSettings = warning('off', 'SimBiology:DimAnalysisNotDone_MatlabFcn_Dimensionless');
Simulate a single meal for a normal subject for 7 hours.
singleMeal = sbioselect(m1,'Name','Single Meal'); cs = getconfigset(m1,'active'); cs.StopTime = 7; sd1 = sbiosimulate(m1,singleMeal)
SimBiology Simulation Data ModelName: Cobelli's Glucose-Insulin System Logged Data: Species: 15 Compartment: 0 Parameter: 24 Sensitivity: 0 Observable: 0
sbioplot(sd1);
Remove all parameter data logged in the SimData
object sd.
[t,x,names] = remove(sd1,{'Type','parameter'});
Remove all parameter data and return as a new SimData
object.
sd2 = remove(sd1,{'Type','parameter'}); sbioplot(sd2);
Remove the simulation data of a species by specifying its name.
sd3 = removebyname(sd2,["[Insulin secretion].[Ins Delay 2]"]);
sbioplot(sd3);
Restore the warning settings.
warning(warnSettings);
Input Arguments
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
.
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 rungetdata
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 newSimData
object or an array ofSimData
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 atimeseries
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 oftimeseries
objects. k is the size ofsimdata
, and m is the number of quantities or sensitivities in eachSimData
object insimdata
. In other words, the function returns an individual time series for each state or column and for eachSimData
object insimdata
.
'tslumped'
— This format returns the data as a cell array oftimeseries
objects, combining data from eachSimData
object into a single time series.
Output Arguments
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
.
sdOut
— Simulation results
SimData
object
Simulation results, returned as a SimData
object.
Version History
Introduced in R2020a
See Also
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
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.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)