Постройте сводные данные квантилей симуляций модели из анализа глобальной чувствительности (требует Statistics and Machine Learning Toolbox)
строит графики и моделирует характеристики моделируемых выборок и возвращает указатель на рисунок h
= plotData(resultsObj
)h
.
использует дополнительные опции, заданные одним или несколькими аргументами пары "имя-значение".h
= plotData(resultsObj
,Name,Value
)
Загрузка модели роста опухоли.
sbioloadproject tumor_growth_vpop_sa.sbproj
Получите вариант с предполагаемыми параметрами и дозой для применения к модели.
v = getvariant(m1);
d = getdose(m1,'interval_dose');
Получите активный набор настроек и установите вес опухоли как ответ.
cs = getconfigset(m1);
cs.RuntimeOptions.StatesToLog = 'tumor_weight';
Симулируйте модель и постройте график профиля роста опухоли.
sbioplot(sbiosimulate(m1,cs,v,d));
Выполните глобальный анализ чувствительности (GSA) на модели, чтобы найти параметры модели, к которым чувствителен рост опухоли.
Во-первых, найдите интересующие нас параметры модели, которые участвуют в фармакодинамике роста опухоли. Определите ответ модели как вес опухоли.
modelParamNames = {'L0','L1','w0','k1','k2'}; outputName = 'tumor_weight';
Затем выполните GSA, вычислив индексы Соболя первого и общего порядков с помощью sbiosobol
. Задайте 'ShowWaitBar'
на true
чтобы показать прогресс симуляции. По умолчанию функция использует 1000 выборок параметров, чтобы вычислить индексы Соболь [1].
sobolResults = sbiosobol(m1,modelParamNames,outputName,'Variants',v,'Doses',d,'ShowWaitBar',true)
sobolResults = Sobol with properties: Time: [444x1 double] SobolIndices: [5x1 struct] Variance: [444x1 table] Observables: {'[Tumor Growth Model].tumor_weight'} ParameterSamples: [1000x5 table] SimulationInfo: [1x1 struct]
Количество выборок можно изменить путем определения 'NumberSamples'
аргумент пары "имя-значение". Функция требует в общей сложности (number of input parameters + 2) * NumberSamples
Симуляции модели.
Покажите среднюю характеристику модели, результаты симуляции и затененную область, покрывающую 90% результатов симуляции.
plotData(sobolResults);
Можно настроить квантильную область на другой процент путем определения 'Alphas'
для нижнего и верхнего квантилей всех ответов модели. Для образца альфа- значения 0,1 графиков заштрихованную область между 100 * alpha
и 100 * (1 - alpha)
квантования всех моделируемых характеристик модели.
plotData(sobolResults,'Alphas',0.1);
Постройте график хода индексов Соболь первого и общего порядков.
h = plot(sobolResults);
% Resize the figure.
h.Position(:) = [100 100 1280 800];
Индекс Соболя первого порядка параметра входа приводит долю общего отклонения отклика, который можно отнести к изменениям только в параметре входа. Индекс общего порядка дает долю общего отклонения отклика, которая может быть атрибутирована любым изменениям параметра joint, которые включают изменения входного параметра.
Из графиков индексов Соболь, параметров L1
и w0
по-видимому, являются наиболее чувствительными параметрами к весу опухоли до применения дозы при t = 7. Но после применения дозы k1
и k2
стать более чувствительными параметрами и внести наибольший вклад в стадию дозы веса опухоли. График общего отклонения также показывает большое отклонение для стадии после дозы в t > 35, чем для стадии до дозы роста опухоли, что указывает на то, что k1
и k2
возможно, более важными параметрами для дальнейшего исследования. Доля необъяснимого отклонения показывает некоторое отклонение около t = 33, но график полного отклонения показывает небольшое отклонение при t = 33, что означает, что необъяснимое отклонение может быть незначительной. Доля необъяснимого отклонения вычисляется как 1 - (сумма всех индексов Соболя первого порядка), и общее отклонение вычисляется с помощью var(response)
, где response
- реакция модели в каждой временной точке.
Можно также отобразить величины чувствительности в столбиковую диаграмму.
bar(sobolResults)
Можно задать больше выборок, чтобы увеличить точность индексов Соболь, но для завершения симуляции может потребоваться больше времени. Использование addsamples
чтобы добавить больше выборки. Для примера, если вы задаете 1500 выборок, функция выполняет 1500 * (2 + number of input parameters)
симуляции.
gsaMoreSamples = addsamples(gsaResults,1500)
Свойство SimulationInfo объекта результата содержит различную информацию для вычисления индексов Соболь. Например, данные симуляции модели (SimData) для каждой симуляции с использованием набора выборок параметров хранятся в SimData
поле свойства. Это поле является массивом SimData
объекты.
sobolResults.SimulationInfo.SimData
SimBiology SimData Array : 1000-by-7 Index: Name: ModelName: DataCount: 1 - Tumor Growth Model 1 2 - Tumor Growth Model 1 3 - Tumor Growth Model 1 ... 7000 - Tumor Growth Model 1
Можно узнать, не удалось ли симуляция модели во время расчета, проверив ValidSample
область SimulationInfo
. В этом примере в поле не показаны ни одних неудачных запусков симуляции.
all(sobolResults.SimulationInfo.ValidSample)
ans = 1x7 logical array
1 1 1 1 1 1 1
SimulationInfo.ValidSample
- таблица логических значений. Он имеет тот же размер что и SimulationInfo.SimData
. Если ValidSample
указывает, что любые симуляции завершились неудачно, можно получить больше информации об этих запусках симуляции и выборках, используемых для этих запусков, путем извлечения информации из соответствующего столбца SimulationInfo.SimDat
А. Предположим, что четвертый столбец содержит один или несколько неудачных запуски симуляции. Получите данные моделирования и значения выборки, используемые для этой симуляции, используя getSimulationResults
.
[samplesUsed,sd,validruns] = getSimulationResults(sobolResults,4);
Можно добавить пользовательские выражения как наблюдаемые и вычислить индексы Соболь для добавленных наблюдаемых. Для примера можно вычислить индексы Соболя для максимального веса опухоли путем определения пользовательского выражения следующим образом.
% Suppress an information warning that is issued during simulation. warnSettings = warning('off', 'SimBiology:sbservices:SB_DIMANALYSISNOTDONE_MATLABFCN_UCON'); % Add the observable expression. sobolObs = addobservable(sobolResults,'Maximum tumor_weight','max(tumor_weight)','Units','gram');
Постройте график вычисленных результатов симуляции, показывающий 90% область квантиля.
h2 = plotData(sobolObs); h2.Position(:) = [100 100 1280 800];
Можно также удалить наблюдаемый, задав его имя.
gsaNoObs = removeobservable(sobolObs,'Maximum tumor_weight');
Восстановите параметры предупреждения.
warning(warnSettings);
Загрузите модель диспозиции лекарственных средств, опосредованных мишенью (TMDD).
sbioloadproject tmdd_with_TO.sbproj
Получите активный конфигурационный набор и установите целевое заполнение (TO
) как ответ.
cs = getconfigset(m1);
cs.RuntimeOptions.StatesToLog = 'TO';
Симулируйте модель и постройте график TO
профиль.
sbioplot(sbiosimulate(m1,cs));
Определите порог воздействия (область под кривой профиля ТО) для целевой заполненности.
classifier = 'trapz(time,TO) <= 0.1';
Выполните MPGSA, чтобы найти чувствительные параметры относительно TO. Измените значения параметров между предопределенными границами, чтобы сгенерировать 10000 выборок параметров.
% Suppress an information warning that is issued during simulation. warnSettings = warning('off', 'SimBiology:sbservices:SB_DIMANALYSISNOTDONE_MATLABFCN_UCON'); rng(0,'twister'); % For reproducibility params = {'kel','ksyn','kdeg','km'}; bounds = [0.1, 1; 0.1, 1; 0.1, 1; 0.1, 1]; mpgsaResults = sbiompgsa(m1,params,classifier,'Bounds',bounds,'NumberSamples',10000)
mpgsaResults = MPGSA with properties: Classifiers: {'trapz(time,TO) <= 0.1'} KolmogorovSmirnovStatistics: [4x1 table] ECDFData: {4x4 cell} SignificanceLevel: 0.0500 PValues: [4x1 table] SupportHypothesis: [10000x1 table] Observables: {'TO'} ParameterSamples: [10000x4 table] SimulationInfo: [1x1 struct]
Постройте график квантилей отклика моделируемой модели.
plotData(mpgsaResults);
Постройте график эмпирических кумулятивных функций распределения (eCDFs) принятых и отклоненных выборок. Кроме km
ни один из параметров не показывает значительного различия в eCDF для принятых и отклонённых выборок. The km
график показывает большое расстояние Колмогоров-Смирнов (К-С) между eCDF принятых и отклонённых выборок. Расстояние K-S является максимальным абсолютным расстоянием между двумя кривыми eCDFs.
h = plot(mpgsaResults);
% Resize the figure.
pos = h.Position(:);
h.Position(:) = [pos(1) pos(2) pos(3)*2 pos(4)*2];
Чтобы вычислить расстояние K-S между двумя eCDF, SimBiology использует двусторонний тест, основанный на нулевой гипотезе, что два распределения принятых и отклоненных выборок равны. См. kstest2
(Statistics and Machine Learning Toolbox) для получения дополнительной информации. Если расстояние K-S большое, то два распределения различаются, что означает, что классификация выборок чувствительна к изменениям в параметре входа. С другой стороны, если расстояние K-S мало, то изменения в параметре входа не влияют на классификацию выборок. Результаты предполагают, что классификация нечувствительна к параметру входа. Чтобы оценить значимость статистики K-S, отвергающей нулевую гипотезу, можно изучить p-значения.
bar(mpgsaResults)
На столбиковую диаграмму показаны две полосы для каждого параметра: одна для расстояния K-S (статистика K-S) и другая для соответствующего p-значения. Вы отвергаете нулевую гипотезу, если p-значение меньше уровня значимости. Крест (x
) показан для любого значения p, которое почти 0. Вы можете увидеть точное значение p, соответствующее каждому параметру.
[mpgsaResults.ParameterSamples.Properties.VariableNames',mpgsaResults.PValues]
ans=4×2 table
Var1 trapz(time,TO) <= 0.1
________ _____________________
{'kel' } 0.0021877
{'ksyn'} 1
{'kdeg'} 0.99983
{'km' } 0
Значения p km
и kel
меньше уровня значимости (0,05), что подтверждает альтернативную гипотезу о том, что принятые и отклоненные выборки происходят из различных распределений. Другими словами, классификация выборок чувствительна к km
и kel
но не к другим параметрам (kdeg
и ksyn
).
Можно также построить гистограммы принятых и отклонённых выборок. Исторические граммы позволяют вам увидеть тренды в принятых и отклонённых выборках. В этом примере гистограмма km
показывает, что существуют больше принятых выборок для больших km
значений, в то время как kel
гистограмма показывает, что отклонённых выборок меньше, чем kel
увеличивается.
h2 = histogram(mpgsaResults);
% Resize the figure.
pos = h2.Position(:);
h2.Position(:) = [pos(1) pos(2) pos(3)*2 pos(4)*2];
Восстановите параметры предупреждения.
warning(warnSettings);
resultsObj
- Результаты анализа глобальной чувствительностиSimBiology.gsa.Sobol
| объекта SimBiology.gsa.MPGSA
объектРезультаты анализа глобальной чувствительности, заданные как SimBiology.gsa.Sobol
или SimBiology.gsa.MPGSA
объект.
Задайте необязательные разделенные разделенными запятой парами Name,Value
аргументы. Name
- имя аргумента и Value
- соответствующее значение. Name
должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN
.
h = plotData(results,'ResponseLeap',10)
задает график для каждой 10-й характеристики модели. 'Observables'
- Моделируйте отклики или наблюдаемые для построения графикаМоделируйте отклики или наблюдаемые значения для построения, заданные как разделенная разделенными запятой парами, состоящая из 'Observables
и вектор символов, строка, строковый вектор, массив ячеек из векторов символов или вектор из положительных целых чисел, индексируемых в resultsObj.Observables
.
Пример: 'Observables','tumor_weight'
Типы данных: double
| char
| string
| cell
'Alphas'
- Размер затененной областиРазмер области квантиля на графике, заданный как разделенная разделенными запятой парами, состоящая из 'Alphas'
и положительная скалярная величина от 0 до 1 или числовой вектор. Процент области вычисляется как 100 * (1 - 2 * Alpha)
. Следовательно, значение альфа по умолчанию 0,05 соответствует 90% области квантования.
Можно задать несколько значений в качестве вектора для построения нескольких областей. Для образца, 'Alphas',[0.05 0.1]
показывает как 90%, так и 80% областей.
Пример: 'Alphas',0.1
Типы данных: double
'FaceColor'
- Цвет затененных областейЦвет затененных областей, заданный как разделенная разделенными запятой парами, состоящая из 'FaceColor'
и трехэлементный вектор-строка. По умолчанию функция использует первый MATLAB® цвет по умолчанию. Чтобы просмотреть порядок цвета по умолчанию, введите get(groot,'defaultAxesColorOrder')
или см. свойство ColorOrder.
Пример: 'FaceColor',[0.4 0.3 0.2]
Типы данных: double
'MeanColor'
- Цвет средней характеристики моделиЦвет средней характеристики модели, заданный как разделенная разделенными запятой парами, состоящая из 'MeanColor'
и трехэлементный вектор-строка. По умолчанию функция использует второй цвет по умолчанию MATLAB. Чтобы просмотреть порядок цвета по умолчанию, введите get(groot,'defaultAxesColorOrder')
или см. свойство ColorOrder.
Пример: 'MeanColor',[0.2 0.5 0.8]
Типы данных: double
'ResponseColor'
- Цвет характеристик модели[0.3 0.3 0.3]
(по умолчанию) | трехэлементный вектор-строкаЦвет откликов модели или симуляций, заданный как разделенная разделенными запятой парами, состоящая из 'ResponseColor'
и трехэлементный вектор-строка. По умолчанию функция использует серый цвет [0.3 0.3 0.3]
.
Пример: 'MeanColor',[0.4 0.3 0.3]
Типы данных: double
'ResponseLeap'
- Каждый n ответ на графикКаждый n ответ на график, заданный как разделенная разделенными запятой парами, состоящая из 'ResponseLeap'
и положительное целое число. По умолчанию графики функций 10% всех ответов модели.
Пример: 'ResponseLeap',15
Типы данных: double
h
- УказательУказатель на рисунок, заданный как указатель на рисунок.
[1] Салтелли, Андреа, Паола Аннони, Ивано Адзини, Франческа Камполонго, Марко Ратто и Стефано Тарантола. "Основанный на дисперсии анализ чувствительности выходов модели. Проект и оценка общего индекса чувствительности. " Компьютерная физика Коммуникации 181, № 2 (февраль 2010): 259-70. https://doi.org/10.1016/j.cpc.2009.09.018.
bar
| plot
| sbiosobol
| SimBiology.gsa.Sobol
У вас есть измененная версия этого примера. Вы хотите открыть этот пример с вашими правками?
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.