exponenta event banner

Объект RepeatDose

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

Описание

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

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

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

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

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

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

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

Можно также в интерактивном режиме изменить свойства дозы с помощью рабочего стола SimBiology.

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

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

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

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

copyobj (любой объект)Скопируйте объект SimBiology и его дочерние элементы
доберитесь (любой объект)Получите свойства объектов
доступный (ScheduleDose, RepeatDose)Возвратите данные из объекта дозы SimBiology как таблица
установите (любой объект)Установите свойства объектов
устанавливаемый (ScheduleDose, RepeatDose)Установите информацию о дозировании от таблицы до объекта дозы

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

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

АктивныйУкажите на объект в использовании во время симуляции
СуммаСумма дозы
AmountUnitsМодули суммы дозы
DurationParameterNameОтрезок времени определения параметра, чтобы ввести дозу
EventModeОпределите, как события, которые изменяют параметры дозы, влияют на происходящее дозирование
ИнтервалВремя между дозами
LagParameterNameПараметр, задающий задержку для дозы
ИмяЗадайте имя объекта
ПримечанияТекст HTML, описывающий объект SimBiology
Родительский элементУкажите на родительский объект
УровеньУровень дозы
RateUnitsМодули для мощности дозы
RepeatCountПовторения дозы
Время началаВремя начала в течение начального времени дозы
ТегЗадайте метку для объекта SimBiology
TargetNameДоза получения разновидностей
Единицы измерения времениПокажите единицы измерения времени для дозирования и симуляции
ВводОтобразите тип объекта 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'
   SimBiology Parameter Array

   Index:    Name:    Value:    ValueUnits:
   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');

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

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'
   SimBiology Parameter Array

   Index:    Name:    Value:    ValueUnits:
   1         A        50        milligram
rateParam                  = addparameter(model,'R',10);
rateParam.ValueUnits       = 'milligram/hour'
   SimBiology Parameter Array

   Index:    Name:    Value:    ValueUnits:
   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');

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

dose.EventMode = 'continue';

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

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

Представленный в R2010a