Добавьте значения количества, дозы или варианты к SimBiology.Scenarios
объект
задает, чтобы сгенерировать значения выборки для одной или нескольких величин модели sObj
= add(sObj
,combination
,quantityNames
,probDist
,Name,Value
)quantityNames
от совместного распределения вероятностей probDist
. Задайте дополнительные опции для распределений вероятностей и метода дискретизации, используя один или несколько аргументы пары "имя-значение". Чтобы использовать распределения вероятностей, вы должны иметь Statistics and Machine Learning Toolbox™.
добавляет записи из sObj
= add(sObj
,combination
,sObj2
)SimBiology.Scenarios
sObj2 объекта
на sObj
. Функция объединяет записи из sObj2
с существующими записями из sObj
использование заданной combination
способ.
Загрузите модель глюкозо-инсулиновой реакции. Для получения дополнительной информации о модели смотрите раздел «Фон» в Симуляции ответа глюкозы-инсулина.
sbioloadproject('insulindemo','m1');
Модель содержит различные значения параметров и начальные условия, которые представляют различные нарушения инсулина (такие как диабет 2 типа, низкая чувствительность к инсулину и так далее), сохраненные в пяти вариантах.
variants = getvariant(m1)
variants = SimBiology Variant Array Index: Name: Active: 1 Type 2 diabetic false 2 Low insulin se... false 3 High beta cell... false 4 Low beta cell ... false 5 High insulin s... false
Подавить информационное предупреждение, которое выдается во время симуляций.
warnSettings = warning('off','SimBiology:DimAnalysisNotDone_MatlabFcn_Dimensionless');
Выберите дозу, которая представляет один прием пищи 78 граммов глюкозы.
singleMeal = sbioselect(m1,'Name','Single Meal');
Создайте Scenarios
объект для представления различных начальных условий в сочетании с дозой. То есть создайте scenario
объект, где каждый вариант спарен (или объединен) с дозой, для в общей сложности пяти сценариев симуляции.
sObj = SimBiology.Scenarios; add(sObj,'cartesian','variants',variants); add(sObj,'cartesian','dose',singleMeal)
ans = Scenarios (5 scenarios) Name Content Number ________ ___________________ ______ Entry 1 variants SimBiology variants 5 x Entry 2 dose SimBiology dose 1 See also Expression property.
sObj
содержит две записи. Используйте generate
функция для объединения записей и генерации пяти сценариев. Функция возвращает таблицу сценариев, где каждая строка представляет сценарий, а каждый столбец представляет запись Scenarios
объект.
scenariosTbl = generate(sObj)
scenariosTbl=5×2 table
variants dose
________________________ ___________________________
[1x1 SimBiology.Variant] [1x1 SimBiology.RepeatDose]
[1x1 SimBiology.Variant] [1x1 SimBiology.RepeatDose]
[1x1 SimBiology.Variant] [1x1 SimBiology.RepeatDose]
[1x1 SimBiology.Variant] [1x1 SimBiology.RepeatDose]
[1x1 SimBiology.Variant] [1x1 SimBiology.RepeatDose]
Измените имя записи первой записи.
rename(sObj,1,'Insulin Impairements')
ans = Scenarios (5 scenarios) Name Content Number ____________________ ___________________ ______ Entry 1 Insulin Impairements SimBiology variants 5 x Entry 2 dose SimBiology dose 1 See also Expression property.
Создайте SimFunction
объект для симуляции сгенерированных сценариев. Используйте Scenarios
объект в качестве входов и определения концентраций глюкозы и инсулина в плазме в качестве репонсов (выходы функции, которая будет нанесена). Задайте []
для входного параметра дозы с момента Scenarios
объект уже имеет информацию о дозах.
f = createSimFunction(m1,sObj,{'[Plasma Glu Conc]','[Plasma Ins Conc]'},[])
f = SimFunction Parameters: Name Value Type Units ____________________________ ______ _____________ ___________________________________________ {'Plasma Volume (Glu)' } 1.88 {'parameter'} {'deciliter' } {'k1' } 0.065 {'parameter'} {'1/minute' } {'k2' } 0.079 {'parameter'} {'1/minute' } {'Plasma Volume (Ins)' } 0.05 {'parameter'} {'liter' } {'m1' } 0.19 {'parameter'} {'1/minute' } {'m2' } 0.484 {'parameter'} {'1/minute' } {'m4' } 0.1936 {'parameter'} {'1/minute' } {'m5' } 0.0304 {'parameter'} {'minute/picomole' } {'m6' } 0.6469 {'parameter'} {'dimensionless' } {'Hepatic Extraction' } 0.6 {'parameter'} {'dimensionless' } {'kmax' } 0.0558 {'parameter'} {'1/minute' } {'kmin' } 0.008 {'parameter'} {'1/minute' } {'kabs' } 0.0568 {'parameter'} {'1/minute' } {'kgri' } 0 {'parameter'} {'1/minute' } {'f' } 0.9 {'parameter'} {'dimensionless' } {'a' } 0 {'parameter'} {'1/milligram' } {'b' } 0.82 {'parameter'} {'dimensionless' } {'c' } 0 {'parameter'} {'1/milligram' } {'d' } 0.01 {'parameter'} {'dimensionless' } {'Stomach Glu After Dosing'} 78 {'parameter'} {'gram' } {'kp1' } 2.7 {'parameter'} {'milligram/minute' } {'kp2' } 0.0021 {'parameter'} {'1/minute' } {'kp3' } 0.009 {'parameter'} {'(milligram/minute)/(picomole/liter)' } {'kp4' } 0.0618 {'parameter'} {'(milligram/minute)/picomole' } {'ki' } 0.0079 {'parameter'} {'1/minute' } {'[Ins Ind Glu Util]' } 1 {'parameter'} {'milligram/minute' } {'Vm0' } 2.5129 {'parameter'} {'milligram/minute' } {'Vmx' } 0.047 {'parameter'} {'(milligram/minute)/(picomole/liter)' } {'Km' } 225.59 {'parameter'} {'milligram' } {'p2U' } 0.0331 {'parameter'} {'1/minute' } {'K' } 2.28 {'parameter'} {'picomole/(milligram/deciliter)' } {'alpha' } 0.05 {'parameter'} {'1/minute' } {'beta' } 0.11 {'parameter'} {'(picomole/minute)/(milligram/deciliter)'} {'gamma' } 0.5 {'parameter'} {'1/minute' } {'ke1' } 0.0005 {'parameter'} {'1/minute' } {'ke2' } 339 {'parameter'} {'milligram' } {'Basal Plasma Glu Conc' } 91.76 {'parameter'} {'milligram/deciliter' } {'Basal Plasma Ins Conc' } 25.49 {'parameter'} {'picomole/liter' } Observables: Name Type Units _____________________ ___________ _______________________ {'[Plasma Glu Conc]'} {'species'} {'milligram/deciliter'} {'[Plasma Ins Conc]'} {'species'} {'picomole/liter' } Dosed: TargetName TargetDimension __________ _____________________ {'Dose'} {'Mass (e.g., gram)'}
Симулируйте модель в течение 24 часов и постройте график данных моделирования. Данные содержат пять запуски, где каждый запуск представляет сценарий в объекте Scenarios.
sd = f(sObj,24); sbioplot(sd)
ans = Axes (SbioPlot) with properties: XLim: [0 30] YLim: [0 450] XScale: 'linear' YScale: 'linear' GridLineStyle: '-' Position: [0.0951 0.1100 0.2521 0.8150] Units: 'normalized' Show all properties
Если у вас есть Statistics and Machine Learning Toolbox™, можно также нарисовать выборку значения для величин модели из различных распределений вероятностей. Например, предположим, что параметры Vmx
и kp3
, которые известны низкой и высокой чувствительностью к инсулину, следуют логнормальному распределению. Можно сгенерировать значения выборки для этих параметров из такого распределения и выполнить скан, чтобы исследовать поведение модели.
Задайте объект лагнормального распределения вероятностей для Vmx
.
pd_Vmx = makedist('lognormal')
pd_Vmx = LognormalDistribution Lognormal distribution mu = 0 sigma = 1
По определению, параметр mu
- среднее значение логарифмических значений. Чтобы изменить значение параметров вокруг базового (модельного) значения параметра, установите mu
на log(
model_value
)
. Установите стандартное отклонение (сигма) равным 0,2. Для небольшого значения сигмы среднее значение логнормального распределения приблизительно равно log(
model_value
)
. Для получения дополнительной информации смотрите Lognormal Distribution (Statistics and Machine Learning Toolbox).
Vmx = sbioselect(m1,'Name','Vmx'); pd_Vmx.mu = log(Vmx.Value); pd_Vmx.sigma = 0.2
pd_Vmx = LognormalDistribution Lognormal distribution mu = -3.05761 sigma = 0.2
Точно так же задайте распределение вероятностей для kp3.
pd_kp3 = makedist('lognormal'); kp3 = sbioselect(m1,'Name','kp3'); pd_kp3.mu = log(kp3.Value); pd_kp3.sigma = 0.2
pd_kp3 = LognormalDistribution Lognormal distribution mu = -4.71053 sigma = 0.2
Теперь задайте совместное распределение вероятностей, чтобы нарисовать выборочные значения для Vmx и kp3 с ранговой корреляцией, чтобы задать некоторую корреляцию между этими двумя параметрами. Обратите внимание, что это предположение корреляции предназначено только для иллюстративных целей этого примера и может не иметь биологического значения.
Сначала удалите запись вариантов (запись 1) из sObj
.
remove(sObj,1)
ans = Scenarios (1 scenarios) Name Content Number ____ _______________ ______ Entry 1 dose SimBiology dose 1 See also Expression property.
Добавьте запись, которая задает совместное распределение вероятностей с матрицей ранговой корреляции.
add(sObj,'cartesian',["Vmx","kp3"],[pd_Vmx, pd_kp3],'RankCorrelation',[1,0.5;0.5,1])
ans = Scenarios (2 scenarios) Name Content Number ____ ______________________ ___________ Entry 1 dose SimBiology dose 1 x (Entry 2.1 Vmx Lognormal distribution 2 (default) + Entry 2.2) kp3 Lognormal distribution 2 (default) See also Expression property.
По умолчанию количество выборок, полученных из распределения соединений, устанавливается равным 2. Увеличьте количество выборок.
updateEntry(sObj,2,'Number',50)
ans = Scenarios (50 scenarios) Name Content Number ____ ______________________ ______ Entry 1 dose SimBiology dose 1 x (Entry 2.1 Vmx Lognormal distribution 50 + Entry 2.2) kp3 Lognormal distribution 50 See also Expression property.
Проверьте, что Scenarios
объект может быть симулирован с помощью модели. The verify
функция выдает ошибку, если какая-либо запись не разрешается однозначно для объекта в модели или содержимое записи имеет несогласованные длины (размеры выборки). Функция выдает предупреждение, если несколько записей разрешаются к одному и тому же объекту в модели.
verify(sObj,m1)
Сгенерируйте сценарии симуляции. Постройте график значений выборки с помощью plotmatrix
. Вы можете увидеть значение Vmx
изменяется вокруг значения модели 0.047 и значения модели kp3
около 0,009.
sTbl = generate(sObj); [s,ax,bigax,h,hax] = plotmatrix([sTbl.Vmx,sTbl.kp3]); ax(1,1).YLabel.String = "Vmx"; ax(2,1).YLabel.String = "kp3"; ax(2,1).XLabel.String = "Vmx"; ax(2,2).XLabel.String = "kp3";
Симулируйте сценарии с помощью той же SimFunction, что вы создали ранее. Вам не нужно создавать новый объект SimFunction, даже если объект Scenarios был обновлен.
sd2 = f(sObj,24); sbioplot(sd2);
По умолчанию SimBiology использует метод случайной выборки. Можно изменить его на латинскую выборку гиперкуба (или соболь или галтон) для более систематического подхода заполнения пространства.
entry2struct = getEntry(sObj,2)
entry2struct = struct with fields:
Name: {'Vmx' 'kp3'}
Content: [2x1 prob.LognormalDistribution]
Number: 50
RankCorrelation: [2x2 double]
Covariance: []
SamplingMethod: 'random'
entry2struct.SamplingMethod = 'lhs'
entry2struct = struct with fields:
Name: {'Vmx' 'kp3'}
Content: [2x1 prob.LognormalDistribution]
Number: 50
RankCorrelation: [2x2 double]
Covariance: []
SamplingMethod: 'lhs'
Теперь можно использовать обновленную структуру для изменения записи 2.
updateEntry(sObj,2,entry2struct)
ans = Scenarios (50 scenarios) Name Content Number ____ ______________________ ______ Entry 1 dose SimBiology dose 1 x (Entry 2.1 Vmx Lognormal distribution 50 + Entry 2.2) kp3 Lognormal distribution 50 See also Expression property.
Визуализация выборочных значений.
sTbl2 = generate(sObj); [s,ax,bigax,h,hax] = plotmatrix([sTbl2.Vmx,sTbl2.kp3]); ax(1,1).YLabel.String = "Vmx"; ax(2,1).YLabel.String = "kp3"; ax(2,1).XLabel.String = "Vmx"; ax(2,2).XLabel.String = "kp3";
Моделируйте сценарии.
sd3 = f(sObj,24); sbioplot(sd3);
Восстановите параметры предупреждения.
warning(warnSettings);
sObj
- Сценарии симуляцииSimBiology.Scenarios
объектСценарии симуляции, заданные как SimBiology.Scenarios
объект.
sObj2
- Сценарии симуляцииSimBiology.Scenarios
объектСценарии симуляции, заданные как SimBiology.Scenarios
объект.
name
- Имя записиИмя записи, заданное как вектор символов или строка.
Вы можете задать имя записи как имя величины модели (вид, параметр или отсек). Кроме того, можно задать имя для группы доз или вариантов, которые будут включены в генерацию выборки (сценариев).
Пример: "k1"
Типы данных: char
| string
content
- Моделируйте значения количества или вектор доз или вариантовRepeatDose
или ScheduleDose
объекты | вектор вариантов объектовМоделируйте значения величины или вектор доз или вариантов, заданный в виде числового вектора, вектора RepeatDose
или ScheduleDose
объекты или вектор variant
объекты.
Если вы задаете имя количества для name
входной параметр, задайте content
в числовой вектор.
Если вы задаете имя для группы доз или вариантов, задайте content
в вектор объектов дозы или вектор объектов варианта.
Пример: [0.5,1,1.5]
combination
- Метод для объединения записей'cartesian'
| 'elementwise'
Метод для объединения записей, заданный как один из следующих:
'cartesian'
- Объедините записи путем взятия Декартова продукта соответствующих значений выборки. Это обозначается крестиком x
.
'elementwise'
- Объедините записи один к одному (элементарно), то есть первый элемент из первой записи соединяется в пару с первым элементом из второй записи и так далее. Это обозначается символом плюс +
. Значения должны иметь одинаковое количество выборочных значений (элементов) для этого метода.
Для получения дополнительной информации смотрите Объединить сценарии симуляции в SimBiology.
quantityNames
- Имена величин моделиИмена величин модели для генерации выборки (сценария), заданные как вектор символов, строка, строковый вектор или массив ячеек из векторов символов.
Пример: ["k12","k21"]
Типы данных: char
| string
| cell
probDist
- Распределения вероятностейВероятностные распределения для генерации выборочных значений для величин модели, заданных как вектор объектов распределения вероятностей, вектора символов, строки, строкового вектора или массива ячеек из векторов символов, содержащих имена поддерживаемых вероятностных распределений. Чтобы задать распределения вероятностей, вы должны иметь Statistics and Machine Learning Toolbox.
Используйте makedist
(Statistics and Machine Learning Toolbox) для создания объектов распределения. Список поддерживаемых распределений см. в разделе distname (Statistics and Machine Learning Toolbox).
Пример: [pd1,pd2]
Задайте необязательные разделенные разделенными запятой парами Name,Value
аргументы. Name
- имя аргумента и Value
- соответствующее значение. Name
должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN
.
'Number',10
задает, чтобы сгенерировать 10 выборки.'Number'
- Количество выборок[]
(по умолчанию) | положительная скалярная величинаКоличество выборок для извлечения из распределений вероятностей, заданное как разделенная разделенными запятой парами, состоящая из 'Number'
и положительная скалярная величина. Значение по умолчанию []
означает, что функция выводит количество выборок из других записей. Если номер не может быть выведен, номер устанавливается на 2
.
Пример: 'Number',5
'RankCorrelation'
- Ранговая матрица корреляции[]
(по умолчанию) | числовую матрицуРанговая матрица корреляции для совместного распределения вероятностей, заданная как разделенная разделенными запятой парами, состоящая из 'RankCorrelation'
и числовую матрицу. Поведение по умолчанию является таким, когда оба 'RankCorrelation'
и 'Covariance'
заданы как []
, SimBiology.Scenarios
черпает некоррелированные выборки из распределения вероятностей соединений.
Вы не можете задать 'RankCorrelation'
если 'Covariance'
задан. Количество столбцов в матрице должно совпадать с количеством заданных распределений. Матрица должна быть симметричной с диагональными значениями 1. Все его собственные значения также должны быть положительными.
Пример: 'RankCorrelation',[1 0.3;0.3 1]
'Mean'
- Средние значенияСредние значения величин, заданные как разделенная разделенными запятой парами, состоящая из 'Mean'
и числовой вектор.
Можно задать средние значения только для нормальных распределений. Количество средних значений должно равняться количеству заданных распределений вероятностей.
Пример: 'Mean',[0.5,1.5]
'Covariance'
- Ковариационная матрица[]
(по умолчанию) | числовую матрицуКовариационная матрица для совместного распределения вероятностей, заданная как разделенная разделенными запятой парами, состоящая из 'Covariance'
и числовую матрицу. Поведение по умолчанию является таким, если оба 'RankCorrelation'
и 'Covariance'
заданы как []
, SimBiology.Scenarios
черпает некоррелированные выборки из распределения вероятностей соединений. Вы не можете задать 'Covariance'
если вы задаете 'RankCorrelation'
.
Можно задать матрицу ковариации только для нормальных распределений. Количество столбцов в матрице должно совпадать с количеством заданных распределений. Все его собственные значения также должны быть неотрицательными.
Пример: 'Covariance',[0.25 0.15;0.15 0.25]
'SamplingMethod'
- Метод отбора проб'random'
(по умолчанию) | 'lhs'
| 'copula'
| 'sobol'
| 'halton'
Метод дискретизации, заданный как разделенная разделенными запятой парами, состоящая из 'SamplingMethod'
и вектор символов или строка. В зависимости от того, распределяются ли вероятности с 'RankCorrelation'
или нормальные распределения с 'Covariance'
заданы, методы дискретизации различаются.
Если запись содержит (соединение) нормальное распределение с Covariance
указаны следующие методы дискретизации:
'random'
- Нарисуйте случайные выборки из заданного нормального распределения с помощью mvnrnd
(Statistics and Machine Learning Toolbox).
'lhs'
- Нарисуйте латинские выборки гиперкуба из заданных нормальных распределений с помощью lhsnorm
(Statistics and Machine Learning Toolbox). Для получения дополнительной информации смотрите Генерация квазислучайных чисел (Statistics and Machine Learning Toolbox).
Если запись содержит распределение (joint) без Covariance
указаны следующие методы дискретизации:
'random'
- Нарисуйте случайные выборки из заданных распределений вероятностей, используя random
(Statistics and Machine Learning Toolbox).
'lhs'
- Нарисуйте латинские выборки гиперкуба из заданных распределений вероятностей с помощью алгоритма, аналогичного lhsdesign
(Statistics and Machine Learning Toolbox). Этот подход является более систематическим подходом к заполнению пространства, чем случайная выборка. Для получения дополнительной информации смотрите Генерация квазислучайных чисел (Statistics and Machine Learning Toolbox).
'copula'
- Нарисуйте случайные выборки с помощью копулы (Statistics and Machine Learning Toolbox). Используйте эту опцию, чтобы наложить корреляции между выборками с помощью копул.
'sobol'
- Используйте последовательность соболя (sobolset
(Statistics and Machine Learning Toolbox)), который преобразуется с помощью функции обратного совокупного распределения (icdf
(Statistics and Machine Learning Toolbox)) заданных вероятностных распределений. Используйте этот метод для высоко систематического заполнения пространства. Для получения дополнительной информации смотрите Генерация квазислучайных чисел (Statistics and Machine Learning Toolbox).
'halton'
- Используйте галтонную последовательность (haltonset
(Statistics and Machine Learning Toolbox)), который преобразуется с помощью функции обратного совокупного распределения (icdf
(Statistics and Machine Learning Toolbox)) заданных вероятностных распределений. Для получения дополнительной информации смотрите Генерация квазислучайных чисел (Statistics and Machine Learning Toolbox).
Если нет Covariance
задан, SimBiology.Scenarios
по существу выполняет два шага. Первый этап состоит в том, чтобы сгенерировать выборки с помощью одного из вышеописанных методов дискретизации. Для lhs
, sobol
, и halton
методы, сгенерированные единообразные выборки преобразуются в выборки из заданного распределения с помощью функции обратного совокупного распределения icdf
(Statistics and Machine Learning Toolbox). Затем, в качестве второго шага, выборки коррелируются с помощью алгоритма Iman-Conover, если RankCorrelation
задан. Для random
выборки берутся непосредственно из заданных распределений, а выборки затем коррелируются с помощью алгоритма Имана-Коновера.
Пример: 'SamplingMethod','lhs'
sObj
- Сценарии симуляцииScenarios
объектСценарии симуляции, возвращенные как Scenarios
объект.
У вас есть измененная версия этого примера. Вы хотите открыть этот пример с вашими правками?
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.