主要内容

SimData

仿真数据

描述

SimData对象包含仿真数据,包括时间和状态数据,以及元数据,比如登录状态的类型和名称或配置设置中使用模拟。

你可以访问时间数据、状态数据和元数据存储在对象通过对象属性。使用点符号查询对象属性或改变不是只读属性。您还可以使用得到命令。

你可以从多个模拟运行存储数据的数组SimData对象。您可以使用任何SimData函数的数组SimData对象。

创建

创建一个SimData对象的三种方式之一。

属性

全部展开

这个属性是只读的。

模拟数据,指定为一个——- - - - - -n矩阵。是时间的数量在模拟和步骤n是数量和敏感性的数量记录在模拟。查看相应的时间步骤通过访问时间财产,查看相应的记录数量信息访问DataInfo财产。

数据类型:

这个属性是只读的。

许多物种,隔间、参数和敏感性,指定为一个结构。包含的字段结构物种,,参数,灵敏度。每个字段的默认值0

数据类型:结构体

这个属性是只读的。

对仿真数据的元数据标签指定的作为n1单元阵列的结构。n是数量和敏感性的数量记录在模拟。的th细胞包含元数据标签列的矩阵数据财产。

可能的类型的结构。

类型 字段
物种

  • 类型,“物种”

  • 名称——物种名称

  • 室,室的物种

  • 单位-物种单位

参数

  • 类型,“参数”

  • 名称,参数名称

  • 反应-反应的名称,参数范围,或如果对模型参数范围

  • 单位-参数单位

  • 类型,“室”

  • 所有者——舱老板

  • 名称——室名称

  • 单位-舱单位

灵敏度

  • 类型,“敏感”

  • 名称——敏感的名字,例如,[tumor_weight] ' d / d (k2)”

  • OutputType灵敏度输出类型(“物种”“参数”)。

  • OutputName—灵敏度输出名称

  • OutputQualifier -灵敏度输出限定符。如果输出是一个物种,其输出限定符的名称间的物种。如果输出是一个model-scoped参数,其输出限定符。如果输出是一个reaction-scoped参数,其输出限定符的名字反应的参数范围。

  • InputType敏感性输入类型(“物种”,“参数”,或“室”)

  • InputName—敏感输入名称

  • InputQualifier——敏感输入限定符。如果输入是一个物种,其输入限定符的名称间的物种。如果输入是一个model-scoped参数,其输入限定符。如果输入是一个reaction-scoped参数,其输入限定符的名字反应的参数范围。如果输入是一个隔间,其输入限定符或父母间的名称。

  • 单位-敏感单位

可观测的

  • 标量,国旗,表示如果可以观察到的是纯量值或向量值。

  • 表达式——可观测的表达式

  • 类型,“可见”

  • 名称——可观测的名称

  • 单位-可观察到的单位

数据类型:细胞

这个属性是只读的。

对仿真数据标签指定的作为n1单元阵列的特征向量。n是记录的数量数量和敏感性。换句话说,DataNames属性包含的名称标签中的数据矩阵的列数据财产。

数据类型:细胞

这个属性是只读的。

纯量值可观测的结果表达式,指定为一个表。每个表变量对应于每一个可观察到的。一个变量的名称是一样的纯量值可观测的。然而,如果可观测的名字太长,截断,用作表变量名。一个后缀“_N””还补充说,其中N是一个正整数。的VariableDescriptions表包含untruncated名称的属性。

如果你指定的任何可观察到的单位,单位是复制到VariableUnits表的属性。

数据类型:

这个属性是只读的。

向量值可观测的结果表达式,指定为一个表。每个表变量对应于每一个可观察到的。一个变量的名称是一样的向量值可观测的。然而,如果可观测的名字太长,截断,用作表变量名。一个后缀“_N””还补充说,其中N是一个正整数。的VariableDescriptions表包含untruncated名称的属性。

如果你指定的任何可观察到的单位,单位是复制到VariableUnits表的属性。

数据类型:

这个属性是只读的。

模拟模型,名称指定为一个特征向量。

数据类型:字符

SimData对象名称、指定为一个字符或字符串向量。

数据类型:字符|字符串

,您可以添加的额外信息SimData对象,指定为一个字符或字符串向量。

数据类型:字符|字符串

这个属性是只读的。

信息生成的模拟数据的模拟运行,指定为一个结构。结构包含以下字段。

  • Configset——一个结构体形式的配置设置中使用模拟。活跃configset对应设置的配置模型。默认值是[]

  • SimulationDate——日期和时间的模拟。默认值是

  • SimulationType——要么“单一运行”整体运行的,这取决于您创建对象使用sbiosimulatesbioensemblerun。默认值是

  • 变体——一个结构体形式的变体(s)中使用模拟。默认值是[]

数据类型:结构体

这个属性是只读的。

仿真时间步,指定为一个列向量。

数据类型:

这个属性是只读的。

仿真时间单位,指定为一个特征向量。

如果你使用创建模拟模型sbiomodel,默认的TimeUnits相应的价值SimData对象是“第二”

如果你使用创建模拟模型PKModelDesign,默认的TimeUnits值是“小时”

数据类型:字符

数据与对象,指定为任何受支持的数据类型。金宝app

对象的功能

addobservable 添加SimData可观察到的表情
updateobservable 更新可观测SimData表达式或单位
renameobservable 重命名中可见SimData
getdata 得到仿真数据SimData对象
getsensmatrix 得到三维灵敏度矩阵SimData对象
选择 选择模拟的数据SimData使用表达式对象
selectbyname 选择模拟数据的名字SimData对象
重新取样 重新取样模拟数据到新时间向量
得到 得到SimBiology对象属性
SimBiology设置对象属性
删除 删除SimBiology对象
显示 显示的总结SimBiology对象

例子

全部折叠

加载G蛋白模型。

sbioloadprojectgprotein.sbproj;

检查初始数量的物种。

m1.Species
ans = SimBiology物种数组索引:舱:名称:未具名的G值:单位:7000 2匿名Gd 3000 3未具名的Ga 0 4匿名RL 0 5不知名的6.022 L e + 17匿名R 10000 7匿名Gbg 3000

只选择物种作为模拟美国记录。

c = getconfigset (m1);allspecies = sbioselect (m1,“类型”,“物种”);cs.RuntimeOptions。StatesToLog =allspecies;

模拟模型。

sd = sbiosimulate (m1);

使用的数据属性SimData对象sd美国在最后时间点。是一个数据属性——- - - - - -n矩阵,数量的时间步骤和吗n是数量的数量记录。

finalData = sd.Data(结束:);

使用DataInfo属性的名字登录状态。

信息= sd.DataInfo;

循环通过物种和它们的初始值。

numSpecies =长度(信息);vObj = addvariant (m1,“initCond”);i = 1: numSpecies addcontent (vObj, {“物种”{我}. name,信息,“价值”finalData(我)});结束提交(vObj, m1);

验证该物种最初的数量。

m1.Species
ans = SimBiology物种数组索引:舱:名称:价值:单位:1不知名的8562.5 G 2匿名Gd 0.109565 3未具名的Ga 1437.39 4匿名RL 1820.54 5不知名的6.022 L e + 17 6未具名7匿名Gbg 1437.5 11.1125 R

加载Target-Mediated药物处置(TMDD)模型

sbioloadprojecttmdd_with_TO.sbproj

设置目标入住率()作为响应。

c = getconfigset (m1);cs.RuntimeOptions。StatesToLog =”到“;

获得定量的信息。

d = getdose (m1,“每天”);

扫描在不同剂量使用SimBiology.Scenarios对象。这样做,第一个参数化财产的剂量。然后使用的不同相应的参数值场景对象。

amountParam = addparameter (m1,“AmountParam”,“单位”,d.AmountUnits);d。数量=“AmountParam”;d。积极= 1;doseSamples = SimBiology.Scenarios (“AmountParam”linspace (0300、31));

创建一个SimFunction模拟模型。集模拟输出。

%抑制信息发布警告,在模拟。警告(“关闭”,“SimBiology: SimFunction: DOSES_NOT_EMPTY”);f = createSimFunction (m1, doseSamples”到“d)
f = SimFunction参数:名称值类型单位售予_____ _________________ _______ {‘AmountParam} 1{“参数”}{‘nanomole}可见:名称类型单位______ _________________ _________________{' '}{“参数”}{的无量纲}给:TargetName TargetDimension数量AmountValue AmountUnits售予___________________________________售予___________ _______{的等离子体。药物”}{的数量(例如,摩尔或分子)}{‘AmountParam} 1 {' nanomole '}
警告(“上”,“SimBiology: SimFunction: DOSES_NOT_EMPTY”);

使用剂量模拟模型生成的场景对象。在这种情况下,对象生成31不同剂量;因此,模型模拟的31次,生成一个SimData数组中。

doseTable =可以获得的(d);sd = f (doseSamples cs.StopTime doseTable)
SimBiology仿真数据数组:31-by-1 ModelName: TMDD记录数据:物种:0隔间:0参数:1敏感性:0可见:0

仿真结果。同时添加两个参考线,代表的安全性和有效性的阈值。在这个例子中,假设任何值高于0.85是不安全的,任何值低于0.15没有功效。

h = sbioplot (sd);时间= sd (1) .Time;h。NextPlot =“添加”;safetyThreshold =情节(h, [min(时间),max ()], [0.85, 0.85],“DisplayName的”,“安全阈值”);efficacyThreshold =情节(h, [min(时间),max ()], [0.15, 0.15],“DisplayName的”,“功效阈值”);

图包含一个轴。与标题和时间轴包含33线类型的对象。这些对象代表运行1 - 2 -运行,运行3 -,4 -运行,运行5 - 6至运行,运行7 - 8 -运行,运行9 - 10 -运行,运行11 - 12 -运行,运行13到14 -运行,运行15 - 16 -运行,运行17 - 18 -运行,运行19 - 20到运行,运行21 - 22 -运行,23——运行,运行24 - 25到运行,运行26 - 27 -运行,运行28 - 29 -运行,运行30 - 31 -运行,安全阈值,阈值效果。

后处理仿真结果。找出哪些剂量量是有效的,对应反应在安全性和有效性阈值。为此,添加一个可观测的表达式来仿真数据。

%抑制信息发布警告,在模拟。警告(“关闭”,“SimBiology: sbservices: SB_DIMANALYSISNOTDONE_MATLABFCN_UCON”);newSD = addobservable (sd,“stat1”,max () < 0.85 & min() > 0.15的,“单位”,无量纲的)
SimBiology仿真数据数组:31-by-1 ModelName: TMDD记录数据:物种:0隔间:0参数:1敏感性:0可见:1

addobservable函数评估新的可观测的表达式SimDatasd并返回评估结果作为一个新的SimData数组,newSD已添加的可观察到的(stat1)。

SimBiology可观测的结果存储在两个不同的属性SimData对象。如果结果是纯量值,它们存储在SimData.ScalarObservables。否则,它们存储在SimData.VectorObservables。在这个例子中,stat1可观察到的表情是纯量值。

提取标量观测值,并把它们与剂量。

scalarObs = vertcat (newSD.ScalarObservables);doseAmounts =生成(doseSamples);图绘制(doseAmounts.AmountParam scalarObs.stat1,“o”,“MarkerFaceColor”,“b”)

图包含一个轴。轴包含一个类型的对象。

情节显示剂量从50到180 nanomoles提供反应目标内的疗效和安全性阈值。

你可以用不同的阈值更新可观测的表达式。重新计算的函数表达式,并返回结果在一个新的SimData对象数组。

newSD2 = updateobservable (newSD,“stat1”,max () < 0.75 & min() > 0.30的);

重命名的表达式。函数重命名的,更新的任何表达式引用改名后的可观测(如适用),并返回结果在一个新的SimData对象数组。

newSD3 = renameobservable (newSD2,“stat1”,“EffectiveDose”);

恢复设置的警告。

警告(“上”,“SimBiology: sbservices: SB_DIMANALYSISNOTDONE_MATLABFCN_UCON”);

另请参阅

||||

介绍了R2007b