exponenta event banner

sbioncaoptions

Задайте опции, чтобы вычислить неразделенный на отсеки анализ (NCA) параметры

Синтаксис

opt = sbioncaoptions

Описание

пример

opt = sbioncaoptions возвращает объект опций NCA. Используйте запись через точку, чтобы установить свойства объектов для опций.

Примеры

свернуть все

Загрузите синтетический набор данных, который содержит измерения концентрации препарата четырех человек после дозы шарика IV.

load data1.mat

Установите суммы дозы на NaN в моментах времени, когда никакая доза не была введена.

data1.Dose(data1.Dose(:) == 0) = NaN;

Отобразите данные.

sbiotrellis(data1,'ID','Time','DrugConc','Marker','o','LineStyle','--');

Категоризируйте столбцы данных с помощью объекта опций NCA.

opt = sbioncaoptions;
opt.groupColumnName         = 'ID';
opt.concentrationColumnName = 'DrugConc';
opt.timeColumnName          = 'Time';
opt.IVDoseColumnName        = 'Dose';

Вычислите параметры NCA для каждого человека.

ncaparameters = sbionca(data1,opt);

Отобразите первые несколько столбцов таблицы. Каждая строка таблицы ncaparameters представляет человека (или группа), и каждый списки столбцов соответствующее значение параметров NCA.

ncaparameters(:,1:15)
ans=4×15 table
    ID    doseSchedule    administrationRoute    Lambda_Z      R2       adjusted_R2    Num_points    AUC_0_last    Tlast    C_max     C_max_Dose    T_max     MRT      T_half    AUC_infinity
    __    ____________    ___________________    ________    _______    ___________    __________    __________    _____    ______    __________    _____    ______    ______    ____________

    1       'Single'           'IVBolus'         0.57893     0.99991       0.9999          11          143.61       48      74.412      1488.2        0      1.5408    1.1973       143.61   
    2       'Single'           'IVBolus'         0.66798     0.99998      0.99998          11          299.37       48      191.96      1919.6        0      1.3352    1.0377       299.37   
    3       'Single'           'IVBolus'         0.62124     0.99999      0.99999          11           766.5       48      411.06      1644.2        0      1.4476    1.1157        766.5   
    4       'Single'           'IVBolus'         0.58011     0.99995      0.99995          11          1301.8       48      648.33      1296.7        0      1.5721    1.1949       1301.8   

Можно также задать пользовательскую область значений времени, чтобы вычислить T_max и C_max в той области значений времени, сказать со времени = от 0 до 20. Можно сделать так путем установки свойства C_max_ranges как массива ячеек двухэлементного вектора - строки.

opt.C_max_ranges    = {[5.5 20]};
ncaparameters2       = sbionca(data1,opt);

Функция сообщает о T_max и значениях C_max в области значений путем добавления двух новых столбцов: T_max_5_5 __ 20 и C_max_5_5 __ 20. Обратите внимание на то, что на имена этих двух столбцов, последнему моменту времени предшествуют два последовательных символа нижнего подчеркивания (__).

ncaparameters2.T_max_5_5__20(:)
ans = 4×1

     6
     6
     6
     6

ncaparameters2.C_max_5_5__20(:)
ans = 4×1

    2.2719
    3.0213
   10.0233
   19.9006

Точно так же можно задать пользовательскую область значений времени, чтобы вычислить частичное значение AUC для каждой группы.

opt.PartialAreas    = {[0 20]};
ncaparameters3      = sbionca(data1,opt);
ncaparameters3.AUC_0__20(:)
ans = 4×1
103 ×

    0.1436
    0.2994
    0.7665
    1.3017

Можно также задать области значений нескольких времени для C_max_ranges и PartialAreas.

opt.C_max_ranges    = {[0 20],[0 10],[0 15]};
opt.PartialAreas    = {[0 12],[0 30]};
ncaparameters4      = sbionca(data1,opt);

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

свернуть все

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

Опции классификации данных

СвойствоОписание
IVDoseColumnNameИмя столбца данных, который содержит сумму дозы IV.
EVDoseColumnNameИмя столбца данных, который содержит extravascular (EV) сумма дозы.
concentrationColumnNameИмя столбца данных, который содержит измеренные концентрации.
timeColumnNameИмя столбца данных, который содержит моменты времени.
groupColumnName

Имя столбца данных, который содержит группирующуюся информацию. Можно задать группировку с помощью двух уровней иерархии. Задайте внешний уровень группировки в этом столбце. Задайте внутренний уровень группирующихся (подгруппы) в idColumnName.

Если вы задаете idColumnName, то необходимо также задать groupColumnName.

Например, рассмотрите данные, которые содержат три группы, где каждая группа содержит четырех пациентов. Столбец группы маркирует эти три группы, и столбец ID маркирует каждого пациента.

idColumnName

Имя столбца данных, который содержит группирующуюся информацию. Можно задать группировку с помощью двух уровней иерархии. Задайте внутренний уровень группирующихся (подгруппы) в этом столбце. Задайте внешний уровень группировки в groupColumnName.

Если вы задаете idColumnName, то необходимо также задать groupColumnName.

infusionRateColumnNameИмя столбца данных, который содержит уровни вливания.

Опции вычисления параметра

СвойствоОписание
LOQНижний предел квантования, порога, ниже которого значения зависимой переменной являются усеченными, чтобы обнулить.
AdministrationRouteМаршрут введения лекарства. Поддерживаются три типа администрирования: IVBolus, IVInfusion и ExtraVascular.
TAUДозирование интервала для нескольких дозирующих данных.
SparseDataБулевская переменная, которая указывает, усреднены ли значения зависимой переменной между подгруппами, чтобы далее заполнить профиль для группы. Временные стоимости для каждого измерения через подгруппы (идентификаторы) в группе должны быть идентичными.
Lambda_Z_Time_Min_Max

Двухэлементный вектор - строка, который задает пользовательскую область значений времени, чтобы вычислить терминальную константу скорости (Lambda_z). Область значений времени применяется ко всем группам; вы не можете задать различную область значений времени для каждой группы. Для получения дополнительной информации смотрите Неразделенный на отсеки Анализ.

PartialAreas

Массив ячеек одного или нескольких двухэлементных векторов - строк, которые задают области значений одного или нескольких времен, раньше вычислял частичные значения AUC. Можно задать несколько строк для специфичных для группы областей значений, где количество строк равняется количеству групп. Если существует только одна строка, те же области значений времени используются для всех групп.

C_max_ranges

Массив ячеек одного или нескольких двухэлементных векторов - строк, которые задают области значений одного или нескольких времен, раньше сообщал о парах T_max,C_max в заданных областях значений. Можно задать несколько строк для специфичных для группы областей значений, где количество строк равняется количеству групп. Если существует только одна строка, те же области значений времени используются для всех групп.

Введенный в R2017b