exponenta event banner

RepeatDose object

Определите протокол дозирования лекарств

Описание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ActiveУкажите объект, используемый во время симуляции
AmountКоличество дозы
AmountUnitsМодули суммарной дозы
DurationParameterNameПараметр, определяющий продолжительность времени для введения дозы
EventModeОпределите, как события, которые изменяют параметры дозы, влияют на текущую дозировку
IntervalВремя между дозами
LagParameterNameПараметр, задающий временную задержку для дозы
NameЗадайте имя объекта
NotesHTML, описывающий объект 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 свойства устанавливаются в параметры величины и скорости 'A' и '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 свойство для 'stop'. Эта установка заставляет любое событие продолжающейся дозы останавливаться в 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