Learn R Programming

nmw (version 0.3.0)

build_nm_dataset: Build a NONMEM-Format Dataset from DM/EX/PC

Description

Build a NONMEM-format dataset from cleaned DM/EX/PC tables. Time-varying covariates (VS, LB, ...) are NOT merged here. Use merge_cov_locf afterwards to add them. CRCL is added separately via add_crcl_cg. Molar conversion is done with nm_to_molar.

Usage

build_nm_dataset(
  DM,
  EX,
  PC,
  IDs = NULL,
  id_prefix = "",
  id_func = NULL,
  dose_cmt = 1L,
  verbose = FALSE
)

Value

data.frame with columns ID, SUBJID, DAT2, TIME, AMT, RATE, CMT, DV, MDV, <DM-columns ...>.

Arguments

DM

data.frame with one row per subject. Must contain SUBJID; any other columns are merged in as subject-level constants.

EX

dose records (see build_dose_records).

PC

observation records (see build_obs_records).

IDs

character vector of SUBJIDs to keep. NULL (default) is the intersect of EX and PC where DV > 0.

id_prefix

character. When id_func is NULL, ID = paste0(id_prefix, SUBJID).

id_func

function(SUBJID) -> character ID. Overrides id_prefix.

dose_cmt

default compartment for dose records lacking a CMT column.

verbose

print progress. Default FALSE.

Details

Records are sorted by SUBJID, DAT2, TIME, CMT, MDV, AMT. At tied (SUBJID, DAT2, TIME, CMT, MDV), AMT = 0 (observation) sorts before AMT > 0 (dose) so a pre-dose observation precedes the dose given at the same minute.