run_pooled_nca: Performs non-compartmental analysis on pooled data

In nlmixr2autoinit: Automatic Generation of Initial Estimates for Population Pharmacokinetic Modeling

Performs non-compartmental analysis on pooled data

Description

Implements pooled concentration–time profiling followed by non-compartmental analysis (NCA) to derive pharmacokinetic parameters across single-dose, multiple-dose, or combined dosing scenarios under bolus, oral, or infusion routes.

Usage

run_pooled_nca(
  dat,
  route = c("bolus", "oral", "infusion"),
  dose_type = c("first_dose", "repeated_doses", "combined_doses"),
  pooled = NULL,
  pooled_ctrl = pooled_control(),
  nca_ctrl = nca_control()
)

Arguments

dat	A data frame containing raw time–concentration data in the standard nlmixr2 format.
route	Route of administration. Must be one of bolus, oral, or infusion.
dose_type	Classified as first_dose, repeated_doses, or combined_doses based on whether observed concentrations occur following the first administration, during repeated dosing, or across both contexts.
pooled	Optional pre-pooled data returned by get_pooled_data.
pooled_ctrl	Optional list of control parameters used by get_pooled_data() for pooling observations. Defaults to output from pooled_control().
nca_ctrl	List of options created by nca_control for NCA settings.

Details

The function first pools individual subject data into representative concentration–time profiles using get_pooled_data based on the settings in pooled_ctrl. The pooled profiles are then passed to getnca, which computes non-compartmental parameters using rules specified in nca_ctrl.

Value

A list containing NCA results according to the selected dose_type.

Author(s)

Zhonghui Huang

See Also

get_pooled_data, bin.time, getnca

Examples

out   <- processData(Bolus_1CPT)
dat   <- out$dat
route <- out$Datainfo$Value[out$Datainfo$Infometrics == "Dose Route"]

run_pooled_nca(
  dat       = dat,
  dose_type = "first_dose",
  route     = route
)$nca.fd.results

nlmixr2autoinit documentation built on Nov. 14, 2025, 1:07 a.m.