exponenta event banner

график

Постройте результаты доверительного интервала параметра

Синтаксис

fh = plot(paraCI)
fh = plot(paraCI,Name,Value)

Описание

пример

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

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

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

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

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

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

Примеры

свернуть все

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

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

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

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

Создайте модель 2D отсека.

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 (для пробита, или логит преобразовывают), то никакие доверительные интервалы не построены для тех оценок параметра. Чтобы видеть последовательность цветов, введите get(groot,'defaultAxesColorOrder').

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

plot(ciParamUnpooled)

График с помощью одного цвета.

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

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

ciParamPooled = sbioparameterci(pooledFit);

Постройте доверительные интервалы. Название группы маркировано, как "объединено", чтобы указать на такую подгонку.

plot(ciParamPooled)

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

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

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

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 должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

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

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

Совет

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

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

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

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

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

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

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

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

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

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

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

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

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

свернуть все

Изобразите указатель графика, возвращенного как указатель фигуры.

Смотрите также

|

Введенный в R2017b