IntAUC: Calculate interval AUC

View source: R/IntAUC.R

IntAUCR Documentation

Calculate interval AUC

Description

It calculates interval AUC

Usage

IntAUC(x, y, t1, t2, Res, down = "Linear")

Arguments

x

vector values of independent variable, usually time

y

vector values of dependent variable, usually concentration

t1

start time for AUC

t2

end time for AUC

Res

result from sNCA function

down

either of "Linear" or "Log" to indicate the way to calculate AUC

Details

This calculates an interval (partial) AUC (from t1 to t2) with the given series of x and y. If t1 and/or t2 cannot be found within x vector, it interpolates according to the down option.

The rules are as follows. Within the observations the concentration at t1 or t2 is interpolated, and the area is calculated according to down. A trailing zero concentration is an observation like any other, so a time between the last positive concentration and that zero is interpolated linearly. After the last observation the concentration is predicted from the terminal regression, exp(b0 - LAMZ * t), and that part is integrated by the log trapezoidal rule whatever down is. Without LAMZ the result is NA. If both t1 and t2 are at or after the time of the last positive concentration (TLST), the whole interval is integrated by the log trapezoidal rule. A segment with a zero concentration at either end, or with the same concentration at both ends, is integrated by the linear trapezoidal rule in any case. Up to version 0.8.4 an interval starting after TLST returned NA.

Value

return interval AUC value (scalar)

Author(s)

Kyun-Seop Bae <k@acr.kr>

References

  1. Gabrielsson J, Weiner D. Pharmacokinetic and Pharmacodynamic Data Analysis - Concepts and Applications. 5th ed. 2016.

  2. Shargel L, Yu A. Applied Biopharmaceutics and Pharmacokinetics. 7th ed. 2015.

  3. Rowland M, Tozer TN. Clinical Pharmacokinetics and Pharmacodynamics - Concepts and Applications. 4th ed. 2011.

  4. Gibaldi M, Perrier D. Pharmacokinetics. 2nd ed. revised and expanded. 1982.

See Also

AUC, Interpol

Examples

Res = sNCA(Theoph[Theoph$Subject==1,"Time"], Theoph[Theoph$Subject==1, "conc"], 
           dose=320, concUnit="mg/L")
IntAUC(Theoph[Theoph$Subject==1, "Time"], Theoph[Theoph$Subject==1, "conc"], t1=0.5, t2=11, Res)

NonCompart documentation built on Nov. 15, 2026, 5:07 p.m.