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.

sbionca

Compute noncompartmental analysis (NCA) parameters (requires Statistics and Machine Learning Toolbox)

Syntax

ncaparameters = sbionca(data,opt)

Description

example

ncaparameters = sbionca(data,opt) computes NCA parameters from the concentration-time data. The options object opt defines the data columns and other calculation options. ncaparameters is a table of calculated NCA parameter values for each group.

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      

Input Arguments

collapse all

Concentration-time data for NCA parameter computation, specified as a table or dataset.

Example: concData

Options object to define data columns and calculation options, specified as an NCA options object. Use sbioncaoptions to create this object and set the options.

Example: ncaopt

Output Arguments

collapse all

Calculated NCA parameters, returned as a table. For details on how the parameters are computed, see Noncompartmental Analysis.

Introduced in R2017b

Was this topic helpful?