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');
Измените поведение дозы в ответ на изменения в параметрах модели
Создайте простую модель с линейным устранением, параметром суммы и параметром уровня.
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');
В качестве альтернативы можно позволить продолжающемуся событию дозы заканчиваться прежде, чем применить новую суммарную дозу установкой EventMode 'продолжаться'.
dose.EventMode = 'continue';Симулируйте модель. В этом случае второе событие дозы продолжается к 26 часам.
[time, drugAndAmount] = sbiosimulate(model,dose); figure plot(time, drugAndAmount); legend('drug','A');
Смотрите также
Model object | ScheduleDose object | sbiodose | sbiosimulate