SimBiology.gsa.MPGSA

Объект, содержащий результаты мультипараметрического глобального анализа чувствительности (MPGSA)

Описание

The SimBiology.gsa.MPGSA объект содержит мультипараметрический глобальный анализ чувствительности [1] результаты, возвращенные sbiompgsa.

Создание

Создайте SimBiology.gsa.MPGSA использование объекта sbiompgsa.

Свойства

расширить все

Это свойство доступно только для чтения.

Выражения ответов модели, заданные как массив ячеек из векторов символов.

Типы данных: cell

Это свойство доступно только для чтения.

Статистика Колмогорова-Смирнова, указанная в виде таблицы. Размер таблицы [params, classifiers], где params количество параметров входа и classifiers количество классификаторов. Введите [i,j] содержит статистику Колмогорова-Смирнова, возвращенную kstest2 (Statistics and Machine Learning Toolbox), сравнивая два eCDF i-го параметра, принятого и отклоненного j-м классификатором. Если все выборки приняты или отклонены классификатором, введите [i,j] установлено в NaN.

The VariableNames свойство содержит выражения классификатора, заданные как вход в sbiompgsa. Длинные выражения усекаются сложением '(classifier i)', где i - индекс классификатора. The VariableDescriptions свойство содержит неограниченные выражения классификатора.

Типы данных: table

Это свойство доступно только для чтения.

Вычисленные данные eCDF, заданные как массив ячеек из числовых векторов. Размер массива [params,4,classifiers], где params - количество параметров входа, а classifiers - количество классификаторов.

Камеры [i,1:2,j] содержат f (Statistics and Machine Learning Toolbox) и x (Statistics and Machine Learning Toolbox) выходы из ecdf (Statistics and Machine Learning Toolbox) функция для выборок i параметра, принятых классификатором j.

Камеры [i,3:4,j] содержат соответствующие выходы для выборок i параметра, отклоненных классификатором j.

Если классификатор принимает все выборки или отклоняет все выборки, соответствующие данные eCDF являются пустыми.

Типы данных: cell

Это свойство доступно только для чтения.

Уровень значимости двустороннего критерия Колмогорова-Смирнова, заданный в виде скалярного значения в области значений (0,1). Для получения дополнительной информации см. kstest2 (Statistics and Machine Learning Toolbox).

Типы данных: double

Это свойство доступно только для чтения.

Асимптотические p-значения для тестов Колмогорова-Смирнова, приведены в виде таблицы. Размер таблицы [params, classifiers], где params количество параметров входа и classifiers количество классификаторов.

Введите [i,j] содержит p-значения, возвращенные kstest2 (Statistics and Machine Learning Toolbox), сравнивая два eCDF i-го параметра, принимаемого и отклоняемого j-м классификатором. Если все выборки приняты или отклонены классификатором, введите [i,j] установлено в NaN.

The VariableNames свойство содержит выражения классификатора, заданные как вход в sbiompgsa. Длинные выражения усекаются сложением '(classifier i)', где i - индекс классификатора. The VariableDescriptions свойство содержит неограниченные выражения классификатора.

Типы данных: table

Это свойство доступно только для чтения.

Флаги, указывающие, принимаются ли выборки классификаторами в виде таблицы. Размер таблицы [NumberSamples, classifiers], где NumberSamples - количество выборок параметров, а classifiers - количество классификаторов.

The VariableNames свойство содержит выражения классификатора, заданные как вход в sbiompgsa. Длинные выражения усекаются сложением '(classifier i)', где i - индекс классификатора. The VariableDescriptions свойство содержит неограниченные выражения классификатора.

Типы данных: table

Это свойство доступно только для чтения.

Имена ответов модели или наблюдаемых, заданные как массив ячеек из векторов символов.

Типы данных: char

Это свойство доступно только для чтения.

Выборочные значения параметров, заданные как таблица. Каждая строка представляет один набор параметров, и каждый столбец представляет один входной параметр. Для получения дополнительной информации смотрите Мультипараметрический глобальный анализ чувствительности (MPGSA).

Типы данных: table

Это свойство доступно только для чтения.

Информация о симуляции, такая как данные моделирования и выборки параметров, используемая для мультипараметрического глобального анализа чувствительности, заданная как структура. Структура содержит следующие поля.

  • SimFunctionSimFunction объект, используемый для симуляции откликов модели или наблюдаемых.

  • SimDataSimData массив размера [NumberSamples,1], где 'NumberSamples' количество выборок. Массив содержит результаты симуляции из ParameterSamples.

  • OutputTimes - Численный вектор-столбец, содержащий общий временной вектор всех SimData объекты.

  • Bounds - Числовая матрица размера [params,2]. params - количество параметров входа. Первый столбец содержит нижние границы, а второй - верхние границы для входов чувствительности.

    Для этого поля задано значение [] если вы предоставили значения выборки параметра в качестве входных параметров при вызове sbiompgsa.

  • DoseTables - Массив клеток из таблиц доз, используемых для SimFunction оценка. DoseTables - выход getTable(doseInput), где doseInput - значение, заданное для 'Doses' аргумент пары "имя-значение" в вызове sbiosobol или sbiompgsa. Если дозы не применяются, это поле устанавливается на [].

  • ValidSample - Логический вектор размера [NumberSamples,1] указывает, не удалось ли выполнить симуляцию для конкретной выборки. Повторная дискретизация данных моделирования (SimData) может привести к NaN значения, если данные экстраполированы. Такие SimData указаны как недопустимые.

  • InterpolationMethod - Имя метода интерполяции для SimData.

  • SamplingMethod - Имя метода выборки, используемого для рисования ParameterSamples. Когда вы звоните sbiompgsa с samples (выборочные величины модели) в качестве входов для этого поля соответствующего объекта результатов задано значение 'unknown'.

  • RandomState - Структура, содержащая состояние rng перед рисованием ParameterSamples. Когда вы звоните sbiompgsa с samples(выборочные значения параметра) как вход, это свойство соответствующего объекта результатов [].

Типы данных: struct

Функции объекта

plotDataПостройте сводные данные квантилей симуляций модели из анализа глобальной чувствительности (требует Statistics and Machine Learning Toolbox)
plotПостройте эмпирический CDF мультипараметрического глобального анализа чувствительности
barСоздайте штриховой график статистики многопараметрического глобального анализа чувствительности
histogramПостройте гистограмму результатов мультипараметрического глобального анализа чувствительности

Примеры

свернуть все

Загрузите модель диспозиции лекарственных средств, опосредованных мишенью (TMDD).

sbioloadproject tmdd_with_TO.sbproj

Получите активный конфигурационный набор и установите целевое заполнение (TO) как ответ.

cs = getconfigset(m1);
cs.RuntimeOptions.StatesToLog = 'TO';

Симулируйте модель и постройте график TO профиль.

sbioplot(sbiosimulate(m1,cs));

Figure contains an axes. The axes with title States versus Time contains an object of type line. This object represents TO.

Определите порог воздействия (область под кривой профиля ТО) для целевой заполненности.

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);

Figure contains an axes. The axes contains 12 objects of type line, patch. These objects represent model simulation, 90.0% region, mean value.

Постройте график эмпирических кумулятивных функций распределения (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];

Figure contains 4 axes. Axes 1 with title trapz(time,TO) <= 0.1 contains 2 objects of type stair. These objects represent accepted samples, rejected samples. Axes 2 contains 2 objects of type stair. These objects represent accepted samples, rejected samples. Axes 3 contains 2 objects of type stair. These objects represent accepted samples, rejected samples. Axes 4 contains 2 objects of type stair. These objects represent accepted samples, rejected samples.

Чтобы вычислить расстояние K-S между двумя eCDF, SimBiology использует двусторонний тест, основанный на нулевой гипотезе, что два распределения принятых и отклоненных выборок равны. См. kstest2 (Statistics and Machine Learning Toolbox) для получения дополнительной информации. Если расстояние K-S большое, то два распределения различаются, что означает, что классификация выборок чувствительна к изменениям в параметре входа. С другой стороны, если расстояние K-S мало, то изменения в параметре входа не влияют на классификацию выборок. Результаты предполагают, что классификация нечувствительна к параметру входа. Чтобы оценить значимость статистики K-S, отвергающей нулевую гипотезу, можно изучить p-значения.

bar(mpgsaResults)

Figure contains an axes. The axes with title trapz(time,TO) <= 0.1 contains 11 objects of type patch, line. These objects represent K-S Statistic, P-Value.

На столбиковую диаграмму показаны две полосы для каждого параметра: одна для расстояния 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];

Figure contains 4 axes. Axes 1 with title trapz(time,TO) <= 0.1 contains 2 objects of type histogram. These objects represent accepted samples, rejected samples. Axes 2 contains 2 objects of type histogram. These objects represent accepted samples, rejected samples. Axes 3 contains 2 objects of type histogram. These objects represent accepted samples, rejected samples. Axes 4 contains 2 objects of type histogram. These objects represent accepted samples, rejected samples.

Восстановите параметры предупреждения.

warning(warnSettings);

Подробнее о

расширить все

Ссылки

[1] Tiemann, Christian A., Joep Vanlier, Maaike H. Oosterveer, Albert K. Groen, Peter A. J. Hilbers, and Natal A. W. van Riel. «Анализ траектории параметра для выявления эффектов лечения фармакологических вмешательств». Под редакцией Скотта Маркела. PLoS Вычислительная биология 9, № 8 (1 августа 2013): e1003166. https://doi.org/10.1371/journal.pcbi.1003166.

См. также

| | | (Statistics and Machine Learning Toolbox) | (Statistics and Machine Learning Toolbox)

Введенный в R2020a