exponenta event banner

график

Результаты доверительного интервала параметров графика

Описание

пример

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

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

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

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

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

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 (для пробита или логитового преобразования), то для этих оценок параметров не строятся доверительные интервалы. Для просмотра порядка цветов введите 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 зависит от того, будет ли параметр преобразован (масштаб log, probit или logit) или нет (линейный масштаб).

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 зависит от того, будет ли параметр преобразован (масштаб log, probit или logit) или нет (линейный масштаб).

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

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

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

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

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

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

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

свернуть все

Фигурная ручка графика, возвращенная как фигурная ручка.

Представлен в R2017b