主要内容

RepeatDose对象

定义给药方案

描述

一个RepeatDose对象定义模拟过程中某种物质数量的一系列剂量。的TargetName属性定义接收剂量的种类。

每个剂量是相同的量,由定义属性,并以等间隔的时间给出,如时间间隔财产。的RepeatCount属性定义序列中注入的数量,不包括初始注入。的属性定义每个剂量给出的速度。

若要在模拟中使用剂量对象,必须将剂量对象添加到模型对象并设置活跃的属性将dose对象设置为true。设置活跃的如果始终希望在模拟模型之前施加剂量,则属性设为true。

警告

活跃的的属性RepeatDose对象将在将来的版本中删除。使用来模拟模型时,显式指定剂量或剂量数组作为输入参数sbiosimulate

如果模型上有多个活动RepeatDose对象,并且属性值有重复的规范,则在模拟期间使用剂量数组中最后出现的属性值。通过查看存储在模型上的剂量对象的索引,您可以找到最后使用的剂量。

您可以将这些剂量属性设置为模型参数:时间间隔RepeatCount开始时间LagParameterName而且DurationParameterName.您可以设置这些属性,除了LagParameterName而且DurationParameterName,转换为数值或模型作用域参数的名称(作为字符向量或字符串)。参数化剂量属性为不同的给药应用提供了更大的灵活性,例如按体重缩放剂量量。详细信息请参见参数化和自适应剂量

构造函数的总结

sbiodose 构建剂量对象

方法总结

的方法RepeatDose对象

copyobj 复制SimBiology对象及其子对象
删除 删除SimBiology对象
显示 显示SimBiology对象的摘要
得到 获取SimBiology对象属性
可以获得的(ScheduleDose RepeatDose) 从SimBiology剂量对象返回数据作为表
重命名 重命名对象并更新表达式
设置SimBiology对象属性
可变的(ScheduleDose RepeatDose) 从剂量对象的表中设置剂量信息

产权总结

属性RepeatDose对象

活跃的 在模拟过程中指示正在使用的对象
剂量
AmountUnits 剂量量单位
DurationParameterName 指定给药时间长度的参数
EventMode 确定改变剂量参数的事件如何影响正在进行的给药
时间间隔 剂量间隔时间
LagParameterName 参数指定剂量的时间延迟
的名字 指定对象的名称
笔记 描述HTML文本SimBiology对象
指示父对象
剂量率
RateUnits 剂量率单位
RepeatCount 剂量重复
开始时间 起始时间为初始剂量时间
标签 指定标签SimBiology对象
TargetName 接受剂量的物种
TimeUnits 显示给药和模拟的时间单位
类型 显示SimBiology对象类型
用户数据 指定要与对象关联的数据

例子

全部折叠

参数化的剂量的性质,以病人的体重来衡量。

创建一个简单的线性消去模型和一个数量参数。

模型= sbiommodel (简单的模型的);单元格= add单元格“中央”1);隔间。CapacityUnits =“升”;= addspecies(模型,“药物”);物种。InitialAmountUnits =毫克的淘汰率elimParam = addparameter(模型,“凯尔”, 0.1);elimParam。ValueUnits =“1 /小时”%消除反应反应=地址(模型,'drug -> null');的反应。ReactionRate =“凯尔*药物”;amountParam =添加参数“一个”, 50);amountParam。ConstantValue = false;amountParam。ValueUnits =毫克的
amountParam = SimBiology参数数组索引:名称:值:单位:1 A 50毫克

用它创建一个剂量属性设置为amount参数'一个“

剂量= adddose(模型,“自适应剂量”“重复”);剂量。一个mount =“一个”

设置其他剂量属性。

剂量。TargetName =“药物”;剂量。StartTime = 0;剂量。TimeUnits =“小时”;剂量。间隔= 24;剂量。RepeatCount = 7;

增加一个参数来表示体重。

weightParam = addparameter(模型,“重量”, 80);weightParam。ValueUnits =“公斤”

使用初始分配规则将剂量量按体重计算。

scaleParam = addparameter(模型,“doseAmountPerWeight”, 0.6);scaleParam。ValueUnits =毫克/公斤的;规则= addrule(模型,'A = weight*doseAmountPerWeight'“initialAssignment”);

模拟模型7天,并绘制结果。

Configset = getconfigset(模型);configset。StopTime = 7*24;configset。TimeUnits=“小时”;[time, drugAndAmount] = sbiosimulation(模型,剂量);情节(时间,drugAndAmount);传奇(“药物”“一个”);

图中包含一个轴对象。axis对象包含2个line类型的对象。这些物体代表药物,A。

创建一个具有线性消去、数量参数和速率参数的简单模型。

模型= sbiommodel (简单的模型的);单元格= add单元格“中央”1);隔间。CapacityUnits =“升”;= addspecies(模型,“药物”);物种。InitialAmountUnits =毫克的淘汰率elimParam = addparameter(模型,“凯尔”, 0.1);elimParam。ValueUnits =“1 /小时”%消除反应反应=地址(模型,'drug -> null');的反应。ReactionRate =“凯尔*药物”添加数量和速率参数amountParam =添加参数“一个”, 50);amountParam。ConstantValue = false;amountParam。ValueUnits =毫克的
amountParam = SimBiology参数数组索引:名称:值:单位:1 A 50毫克
rateParam =添加参数“R”10);rateParam。ValueUnits =“毫克/小时”
rateParam = SimBiology参数数组索引:名称:值:单位:1r 10毫克/小时

用它创建一个剂量而且属性分别设置为数量和速率参数“A”和“R”。

剂量= adddose(模型,“自适应剂量”“重复”);剂量。一个mount =“一个”;剂量。率=“R”

设置其他剂量属性。

剂量。TargetName =“药物”;剂量。StartTime = 0;剂量。TimeUnits =“小时”;剂量。间隔= 24;剂量。RepeatCount = 7;

准备配置集以模拟模型7天。

Configset = getconfigset(模型);configset。StopTime = 7*24;configset。TimeUnits=“小时”

添加一个事件,在时间>= 26时将剂量量重置为10。

事件= addevent(模型,'时间>= 26'' a = 10');

设置EventMode属性要“停止”。此设置可使任何正在进行的剂量事件在26小时后停止。

剂量。EventMode =“停止”

模拟模型。第二次剂量事件在26小时停止,随后的剂量事件继续,新的剂量量为10。

[time, drugAndAmount] = sbiosimulation(模型,剂量);figure plot(time, drugAndAmount);传奇(“药物”“一个”);

图中包含一个轴对象。axis对象包含2个line类型的对象。这些物体代表药物,A。

或者,您可以通过设置,在应用新的剂量量之前,允许正在进行的剂量事件结束EventMode“继续”。

剂量。EventMode =“继续”

模拟模型。在这种情况下,第二次剂量事件持续了26小时。

[time, drugAndAmount] = sbiosimulation(模型,剂量);figure plot(time, drugAndAmount);传奇(“药物”“一个”);

图中包含一个轴对象。axis对象包含2个line类型的对象。这些物体代表药物,A。

版本历史

在R2010a中引入