plot

Отобразите результаты доверительного интервала параметра

Описание

пример

fh = plot(paraCI) строит доверие интервалов от paraCI, а ParameterConfidenceInterval объект или вектор объектов.

  • Если состояние оценки доверия интервала (paraCI.Results.Status) success, plot функция использует первый цвет по умолчанию (синий), чтобы построить график линии и центрированную точку для каждой оценки параметра. Функция также строит график для указания доверительных интервалов.

  • Если состояние constrained или estimableфункция использует второй цвет по умолчанию (красный) и строит график линии, центрированной точки и рамки, чтобы указать доверительные интервалы.

  • Если состояние not estimableграфики функций график линии и центрированный крест красным цветом.

  • Если существуют какие-либо преобразованные параметры с оценочными значениями, которые равны 0 (для log преобразование) и 0 или 1 (для probit или logit transform), никакое доверие интервалы не строятся для этих оценок параметра.

fh = plot(paraCI,Name,Value) использует дополнительные опции, заданные одним или несколькими Name,Value аргументы в виде пар.

Примеры

свернуть все

Загрузка данных

Загрузите выборочные данные в соответствии.

load data10_32R.mat
gData = groupedData(data);
gData.Properties.VariableUnits = {'','hour','milligram/liter','milligram/liter'};
sbiotrellis(gData,'ID','Time',{'CentralConc','PeripheralConc'},'Marker','+',...
            'LineStyle','none');

Создайте модель

Создайте модель с двумя отсеками.

pkmd                 = PKModelDesign;
pkc1                 = addCompartment(pkmd,'Central');
pkc1.DosingType      = 'Infusion';
pkc1.EliminationType = 'linear-clearance';
pkc1.HasResponseVariable = true;
pkc2                 = addCompartment(pkmd,'Peripheral');
model                = construct(pkmd);
configset            = getconfigset(model);
configset.CompileOptions.UnitConversion = true;

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

Определите капельное внутривенное введение.

dose             = sbiodose('dose','TargetName','Drug_Central');
dose.StartTime   = 0;
dose.Amount      = 100;
dose.Rate        = 50;
dose.AmountUnits = 'milligram';
dose.TimeUnits   = 'hour';
dose.RateUnits   = 'milligram/hour';

Определите параметры

Определите параметры для оценки.

responseMap = {'Drug_Central = CentralConc','Drug_Peripheral = PeripheralConc'};
paramsToEstimate   = {'log(Central)','log(Peripheral)','Q12','Cl_Central'};
estimatedParam     = estimatedInfo(paramsToEstimate,...
                                   'InitialValue',[1 1 1 1],...
                                   'Bounds',[0.1 3;0.1 10;0 10;0.1 2]);

Подгонка модели

Выполните неохлажденную подгонку, то есть один набор предполагаемых параметров для каждого пациента.

unpooledFit = sbiofit(model,gData,responseMap,estimatedParam,dose,'Pooled',false);

Выполните объединенную подгонку, то есть один набор предполагаемых параметров для всех пациентов.

pooledFit = sbiofit(model,gData,responseMap,estimatedParam,dose,'Pooled',true);

Вычисление доверительных интервалов для предполагаемых параметров

Вычислите 95% доверительные интервалы для каждого оцененного параметра в неохлажденной подгонке с помощью Гауссова приближения.

ciParamUnpooled = sbioparameterci(unpooledFit);

Постройте график доверительных интервалов. Если статус оценки доверия интервала success, он нанесен синим цветом (первый цвет по умолчанию). В противном случае он нанесен красным цветом (второй цвет по умолчанию), что указывает на необходимость дальнейшего исследования установленных параметров. Если доверительный интервал not estimable, затем функция строит график красной линии и центрированного креста. Если существуют какие-либо преобразованные параметры с оценочными значениями, которые являются 0 (для преобразования журнала) и 1 или 0 (для преобразования probit или logit), то никакое доверие интервалы не строятся для этих оценок параметра. Чтобы увидеть порядок цвета, введите get(groot,'defaultAxesColorOrder').

Группы отображаются слева направо в том же порядке, в котором они появляются в GroupNames свойство объекта, которое используется для маркировки оси X. Y-метки являются преобразованными именами параметров.

plot(ciParamUnpooled)

Постройте график с использованием одного цвета.

plot(ciParamUnpooled,'Color',[0 0 0])

Вычислите доверительные интервалы для объединенной подгонки.

ciParamPooled = sbioparameterci(pooledFit);

Постройте график доверительных интервалов. Имя группы помечено как «объединенное» для указания такой подгонки.

plot(ciParamPooled)

Постройте график всех результатов доверительного интервала вместе. По умолчанию доверительный интервал для каждой оценки параметра строится в отдельных осях. Вертикальные пунктирные линии группируют доверительные интервалы оценок параметров, которые были вычислены в общей подгонке. Границы параметра, заданные в исходной подгонке, отмечены квадратными скобками (если они видны в нанесённой области значений параметров).

ciAll = [ciParamUnpooled;ciParamPooled];
plot(ciAll)

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

plot(ciAll,'Layout','Grouped')

В этом размещении можно указать на маркер центра каждого доверительного интервала, чтобы увидеть имя группы. Каждый оценочный параметр разделяется вертикальной черной линией. Вертикальные пунктирные линии группируют доверительные интервалы оценок параметров, которые были вычислены в общей подгонке. Границы параметра, заданные в исходной подгонке, отмечены квадратными скобками (если они видны в нанесённой области значений параметров). Обратите внимание на различные шкалы на оси Y из-за преобразований параметров. Для образца ось Y Q12 находится в линейной шкале, но в Central находится в шкале журнала из-за ее журнала преобразования.

Вычисление доверительных интервалов с использованием вероятности профиля

Вычислите 95% доверительные интервалы для каждого оцененного параметра в неохлажденной подгонке с помощью подхода вероятности профиля.

ciParamUnpooledProf = sbioparameterci(unpooledFit,'Type','profilelikelihood');

Вычислите доверительные интервалы для объединенной подгонки.

ciParamPooledProf = sbioparameterci(pooledFit,'Type','profilelikelihood');

Постройте график кривых вероятности профиля для неохлажденной подгонки. Границы параметров, заданные в исходной подгонке, отображаются вертикальными пунктирными линиями (если они видны в нанесённой области значений параметров). Интервал доверия обозначается двумя крестами и линией между ними. Центральная точка обозначает оценку параметра. Вероятность профиля всегда строится в шкале журнала. Шкала оси X зависит от того, преобразуется ли параметр (логарифмическая, пробитная или логитная шкала) или нет (линейная шкала).

plot(ciParamUnpooledProf,'ProfileLikelihood',true);

Каждая группа нанесена на график в отдельной строке, и каждый параметр нанесен на график в отдельном столбце.

Постройте график кривых для объединенной подгонки.

plot(ciParamPooledProf,'ProfileLikelihood',true);

Постройте график всего доверия интервала на одном рисунке.

plot([ciParamUnpooledProf;ciParamPooledProf],'ProfileLikelihood',true);

Входные параметры

свернуть все

Результаты доверительного интервала параметра, заданные как ParameterConfidenceInterval объект или вектор объектов.

Аргументы в виде пар имя-значение

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: 'ProfileLikelihood',true задает график графика кривых правдоподобия профиля.

Триплет красных-зеленых-синих цветов, заданный как разделенная разделенными запятой парами, состоящая из 'Color' и трехэлементный вектор-строка. По умолчанию доверительные интервалы, которые не ограничены границами параметров, заданными в исходной подгонке, строятся с использованием первого цвета по умолчанию (синего), а те, которые ограничены границами, строятся с использованием второго цвета по умолчанию (красного). Если доверительный интервал не оценивается, он также нанесен красным цветом. Чтобы увидеть порядок цвета по умолчанию, введите get(groot,'defaultAxesColorOrder') или см. свойство ColorOrder.

Совет

Используйте эту пару "имя-значение", когда необходимо создать графики с одним цветом, например, в целях публикации.

Пример: 'Color',[0 0 0]

Логический скаляр для отображения кривых правдоподобия профиля для profileLikelihood доверительные интервалы, заданные как разделенная разделенными запятой парами, состоящая из 'ProfileLikelihood' и true или false.

Интервал доверия обозначается двумя крестами с линией между ними. Центральная точка обозначает оценку параметра. plot функция использует первый цвет по умолчанию (синий) для успешно вычисленных доверительных интервалов. В противном случае функция использует второй цвет по умолчанию (красный). Вертикальная пунктирная линия помечает границы параметров, заданные в исходной подгонке.

Если групп несколько, каждая группа строится в отдельной строке, и каждый параметр строится в отдельном столбце. Метки для оси X являются преобразованными именами параметров (TransformedName свойство estimatedInfo объект, используемый в исходной подгонке). Метки для оси Y являются именами групп (GroupNames свойство объекта интервала доверия) и уровня доверия.

Кривая правдоподобия профиля всегда строится в журнал масштабе. Шкала оси X зависит от того, преобразуется ли параметр (логарифмическая, пробитная или логитная шкала) или нет (линейная шкала).

Пример: 'ProfileLikelihood',true

Размещение Оси для отображения доверительных интервалов параметра, заданный как разделенная разделенными запятой парами, состоящая из 'Layout' и вектор символов 'split' (по умолчанию) или 'grouped'.

The 'split' размещение отображает доверительный интервал для каждой оценки параметра на отдельных осях.

The 'grouped' В размещении отображаются все доверительные интервалы на одной оси, сгруппированной по оценкам параметров. Каждый оценочный параметр разделяется вертикальной черной линией.

В обоих случаях границы параметров, заданные в исходной подгонке, отмечены квадратными скобками. Функция использует вертикальные пунктирные линии, чтобы сгруппировать доверительные интервалы оценок параметров, которые были вычислены в общей подгонке.

Пример: 'Layout','grouped'

Выходные аргументы

свернуть все

Рисунок указателя на график, возвращенный как указатель на фигуру.

Введенный в R2017b