Calculates results for PKNCA analysis.

Usage

PKNCA_calculate_nca(pknca_data, blq_rule = NULL)

Arguments

pknca_data: Data object created using PKNCA::PKNCAdata() function.
blq_rule: A list defining the Below Limit of Quantification (BLQ) imputation rule using PKNCA format. The list should either contain three elements named: first, middle, and last or two elements named before.tmax and after.tmax. Each element can be a numeric value (substituting the BLQ value), or a string such as "drop" (ignores the value) or "keep" (keeps the value as 0). Default is NULL, which does not specify any BLQ function to use for imputation. It is required if blq is defined in the intervals impute column of the pknca_data object, as the function will be applied to those intervals during the NCA calculation.

Value

Results object with start and end times for each dose, from first dose and from most recent dose

Details

This function+ calculates results for PKNCA analysis using PKNCA::pk.nca(). It then joins the results with the dosing data, to create a full results data frame with the start and end times for each dose, from first and most recent dose.

Examples

example_data <- data.frame(
  STUDYID = rep("STUDY001", 6),
  PCSPEC = rep("Plasma", 6),
  ROUTE = rep("IV", 6),
  DOSETRT = rep("DrugA", 6),
  USUBJID = rep("SUBJ001", 6),
  ATPTREF = rep(1, 6),
  PARAM = rep("AnalyteA", 6),
  AVAL = c(0, 5, 10, 7, 3, 1),
  AVALU = rep("ng/mL", 6),
  DOSEA = rep(100, 6),
  DOSEU = rep("mg", 6),
  AFRLT = c(0, 1, 2, 3, 4, 6),
  ARRLT = c(0, 1, 2, 3, 4, 6),
  NFRLT = c(0, 1, 2, 3, 4, 6),
  ADOSEDUR = rep(0.5, 6),
  RRLTU = rep("hour", 6)
)

# Create a PKNCAdata object
pknca_data <- PKNCA_create_data_object(example_data)

# Perform NCA calculations
nca_results <- PKNCA_calculate_nca(pknca_data)