nmpkconvert: Expand additional dosing (ADDL) records for pharmacokinetic...

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

Expand additional dosing (ADDL) records for pharmacokinetic analysis

Description

Expands dosing records that contain additional doses (ADDL) using the specified interdose interval (II). Each additional dose is converted into an explicit record to provide a complete dosing history suitable for population pharmacokinetic modeling.

Usage

nmpkconvert(dat)

Arguments

dat	A data frame containing raw time–concentration data in the standard nlmixr2 format.

Details

Dosing records with ADDL greater than zero are expanded using the formula: TIME_new = TIME + n × II, where n ranges from 1 up to ADDL. Observation records (EVID = 0) are not modified.

Value

A data frame with expanded dosing records. The columns ADDL and II are reset to zero after expansion.

Examples

# Dataset with a single subject and additional dosing
dat <- data.frame(
  ID   = rep(1, 6),
  EVID = c(1, 0, 0, 1, 0, 0),
  ADDL = c(2, 0, 0, 0, 0, 0),
  TIME = c(0, 1, 2, 3, 4, 5),
  II   = c(24, 0, 0, 0, 0, 0),
  AMT  = c(100, 0, 0, 0, 0, 0)
)
nmpkconvert(dat)

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