RepeatDose object

Задайте протокол дозирования препарата

Описание

RepeatDose объект задает серию доз на сумму разновидности во время симуляции. TargetName свойство объекта дозы задает разновидность, которая получает дозу.

Каждая доза является той же суммой, как задано Amount свойство, и данный в равномерно распределенные времена, как задано Interval свойство. RepeatCount свойство задает количество инжекций в ряду, исключая начальную инжекцию. Rate свойство задает, как быстро каждая доза дана.

Чтобы использовать дозу возражают в симуляции, необходимо добавить объект дозы в объект модели и установить Active свойство дозы возражает против истины. Установите Active свойство к истине, если вы всегда хотите, чтобы доза была применена прежде, чем симулировать модель.

Предупреждение

Active свойство RepeatDose object будет удален в будущем релизе. Явным образом задайте дозу или массив доз как входной параметр, когда вы симулируете использование модели sbiosimulate.

То, когда существует несколько активных объектов RepeatDose на модели и если существуют дублирующиеся технические требования для значения свойства, последнее вхождение для значения свойства в массиве дозы, используется в процессе моделирования. Можно узнать, какая доза применяется в последний раз путем рассмотрения индексов объектов дозы, хранивших на модели.

Можно установить эти свойства дозы на параметры модели: AmountИнтервал, Rate, RepeatCountВремя начала, LagParameterName и DurationParameterName. Можно установить эти свойства, кроме LagParameterName и DurationParameterName, или к числовому значению или к имени ограниченного по объему моделью параметра (как вектор символов или строка). Параметризация свойств дозы обеспечивает больше гибкости для различных приложений дозирования, таких как масштабирование суммарной дозы массой тела. Для получения дополнительной информации смотрите Параметрированные и Адаптивные Дозы.

Сводные данные конструктора

sbiodoseСоздайте объект дозы

Сводные данные метода

Методы для RepeatDose объекты

copyobjСкопируйте объект SimBiology и его дочерние элементы
deleteОбъект Delete SimBiology
displayОтобразите сводные данные объекта SimBiology
getПолучите свойства объектов SimBiology
доступный (ScheduleDose, RepeatDose)Возвратите данные из объекта дозы SimBiology как таблица
renameПереименуйте выражения обновления и объект
setУстановите свойства объектов SimBiology
устанавливаемый (ScheduleDose, RepeatDose)Установите информацию о дозах от таблицы до объекта дозы

Сводные данные свойства

Свойства для RepeatDose объекты

ActiveУкажите на объект в использовании в процессе моделирования
AmountСумма дозы
AmountUnitsМодули суммарной дозы
DurationParameterNameОтрезок времени определения параметра, чтобы ввести дозу
EventModeОпределите, как события, которые изменяют параметры дозы, влияют на происходящее дозирование
IntervalВремя между дозами
LagParameterNameПараметр, задающий задержку для дозы
NameЗадайте имя объекта
NotesТекст HTML, описывающий объект SimBiology
ParentУкажите на родительский объект
RateУровень дозы
RateUnitsМодули для мощности дозы
RepeatCountПовторения дозы
StartTimeВремя начала в течение начального времени дозы
TagЗадайте метку для объекта SimBiology
TargetNameДоза получения разновидностей
TimeUnitsПокажите единицы измерения времени для дозирования и симуляции
TypeОтобразите тип объекта SimBiology
UserDataЗадайте данные, чтобы сопоставить с объектом

Примеры

свернуть все

Параметрируйте Amount свойство дозы масштабировать его массой тела пациента.

Создайте простую модель с линейным устранением и параметром суммы.

model                      = sbiomodel('simple model');
compartment                = addcompartment(model,'Central',1);
compartment.CapacityUnits  = 'liter';
species                    = addspecies(model,'drug');
species.InitialAmountUnits = 'milligram';

% Elimination rate
elimParam                  = addparameter(model,'kel',0.1);
elimParam.ValueUnits       = '1/hour';

% Elimination reaction
reaction                   = addreaction(model,'drug -> null');
reaction.ReactionRate      = 'kel*drug';
amountParam                = addparameter(model,'A',50);
amountParam.ConstantValue  = false;
amountParam.ValueUnits     = 'milligram'
amountParam = 
   SimBiology Parameter Array

   Index:    Name:    Value:    Units:   
   1         A        50        milligram

Создайте дозу с ее Amount набор свойств к параметру суммы 'A'.

dose                       = adddose(model,'adaptive dose','repeat');
dose.Amount                = 'A';

Установите другие свойства дозы.

dose.TargetName            = 'drug';
dose.StartTime             = 0;
dose.TimeUnits             = 'hour';
dose.Interval              = 24;
dose.RepeatCount           = 7;

Добавьте параметр, чтобы представлять массу тела.

weightParam            = addparameter(model,'weight', 80);
weightParam.ValueUnits = 'kilogram';

Масштабируйте суммарную дозу массой тела, использующей первоначальное правило присвоения.

scaleParam             = addparameter(model,'doseAmountPerWeight',0.6);
scaleParam.ValueUnits  = 'milligram/kilogram';
rule                   = addrule(model,'A = weight*doseAmountPerWeight','initialAssignment');

Симулируйте модель в течение 7 дней и постройте результаты.

configset               = getconfigset(model);
configset.StopTime      = 7*24;
configset.TimeUnits     = 'hour';
[time, drugAndAmount]   = sbiosimulate(model,dose);
plot(time, drugAndAmount);
legend('drug','A');

Figure contains an axes. The axes contains 2 objects of type line. These objects represent drug, A.

Создайте простую модель с линейным устранением, параметром суммы и параметром уровня.

model                      = sbiomodel('simple model');
compartment                = addcompartment(model,'Central',1);
compartment.CapacityUnits  = 'liter';
species                    = addspecies(model,'drug');
species.InitialAmountUnits = 'milligram';

% Elimination rate
elimParam                  = addparameter(model,'kel',0.1);
elimParam.ValueUnits       = '1/hour';

% Elimination reaction
reaction                   = addreaction(model,'drug -> null');
reaction.ReactionRate      = 'kel*drug';

% Add amount and rate parameters
amountParam                = addparameter(model,'A',50);
amountParam.ConstantValue  = false;
amountParam.ValueUnits     = 'milligram'
amountParam = 
   SimBiology Parameter Array

   Index:    Name:    Value:    Units:   
   1         A        50        milligram

rateParam                  = addparameter(model,'R',10);
rateParam.ValueUnits       = 'milligram/hour'
rateParam = 
   SimBiology Parameter Array

   Index:    Name:    Value:    Units:        
   1         R        10        milligram/hour

Создайте дозу с ее Amount и Rate набор свойств к сумме и параметрам уровня и 'R', соответственно.

dose                       = adddose(model,'adaptive dose','repeat');
dose.Amount                = 'A';
dose.Rate                  = 'R';

Установите другие свойства дозы.

dose.TargetName            = 'drug';
dose.StartTime             = 0;
dose.TimeUnits             = 'hour';
dose.Interval              = 24;
dose.RepeatCount           = 7;

Подготовьте конфигурацию модели, чтобы симулировать модель в течение 7 дней.

configset           = getconfigset(model);
configset.StopTime  = 7*24;
configset.TimeUnits = 'hour';

Добавьте событие к сбросу суммарная доза к 10 во время> = 26.

event = addevent(model,'time >= 26','A = 10');

Установите EventMode свойство 'остановиться'. Эта установка заставляет любое продолжающееся событие дозы останавливаться в 26 часов.

dose.EventMode = 'stop';

Симулируйте модель. Вторые остановки события дозы в 26 часов и последующие события дозы продолжают новую суммарную дозу 10.

[time, drugAndAmount] = sbiosimulate(model,dose);
figure
plot(time, drugAndAmount); 
legend('drug','A');

Figure contains an axes. The axes contains 2 objects of type line. These objects represent drug, A.

В качестве альтернативы можно позволить продолжающемуся событию дозы заканчиваться прежде, чем применить новую суммарную дозу установкой EventMode 'продолжаться'.

dose.EventMode = 'continue';

Симулируйте модель. В этом случае второе событие дозы продолжается к 26 часам.

[time, drugAndAmount] = sbiosimulate(model,dose);
figure
plot(time, drugAndAmount); 
legend('drug','A');

Figure contains an axes. The axes contains 2 objects of type line. These objects represent drug, A.

Введен в R2010a