Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

sbioncaoptions

Specify options to calculate noncompartmental analysis (NCA) parameters

Syntax

opt = sbioncaoptions

Description

example

opt = sbioncaoptions returns an NCA options object. Use dot notation to set the object properties for the options.

Examples

collapse all

Load a synthetic data set that contains the drug concentration measurements of four individuals after an IV bolus dose.

load(fullfile(matlabroot,'help','toolbox','simbio','examples','pkProfiles_1Comp.mat'))

Set the dose amounts to NaN at time points when no dose was administered.

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

Display the data.

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

Categorize the data columns using an NCA options object.

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

Compute NCA parameters for each individual.

ncaparameters = sbionca(data1,opt);

Display the first few columns of the table. Each row of ncaparameters table represents an individual (or group), and each column lists the corresponding NCA parameter value.

ncaparameters(:,1:15)
ans =

  4x15 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      

Output Arguments

collapse all

Options to calculate NCA parameters, returned as an NCA options object. The properties of the object are classified into two groups, data classification options and parameter calculation options.

Data Classification Options

PropertyDescription
IVDoseColumnNameName of the data column that contains the IV dose amount.
EVDoseColumnNameName of the data column that contains the extravascular (EV) dose amount.
concentrationColumnNameName of the data column that contains the measured concentrations.
timeColumnNameName of the data column that contains the time points.
groupColumnName

Name of the data column that contains the grouping information. You can specify grouping using two levels of hierarchy. Specify the outer level of grouping in this column. Specify the inner level of grouping (subgroups) in idColumnName.

For example, consider data that contains three groups, where each group contains four patients. The group column labels the three groups, and the ID column labels each patient.

idColumnName

Name of the data column that contains the grouping information. You can specify grouping using two levels of hierarchy. Specify the inner level of grouping (subgroups) in this column. Specify the outer level of grouping in groupColumnName.

infusionRateColumnNameName of the data column that contains the infusion rates.

Parameter Calculation Options

PropertyDescription
LOQLower limit of quantization, a threshold below which the values of dependent variable are truncated to zero.
AdministrationRouteDrug administration route. Three types of administration are supported: IVBolus, IVInfusion, and ExtraVascular.
TAUDosing interval for multiple-dosing data.
SparseDataBoolean that indicates whether or not the values of dependent variable are averaged between subgroups to further populate a profile for a group. Time values for each measurement across subgroups (IDs) within a group must be identical.
Lambda_Z_Time_Min_Max

Two-element row vector that specifies a custom time range to compute the terminal rate constant (Lambda_z). The time range applies to all groups; you cannot specify a different time range for each group. For details, see Noncompartmental Analysis.

PartialAreasTwo-element row vector that specifies the time range used to compute the partial AUC value. You can specify multiple time ranges as a cell array of vectors, where each vector corresponds to each group.
C_max_rangesTwo-element row vector that specifies the time range used to report the T_max,C_max pair within the specified time range. You can specify multiple time ranges as a cell array of vectors, where each vector corresponds to each group.

Introduced in R2017b

Was this topic helpful?