Build Units Table for PKNCA — PKNCA_build_units

This function generates a PKNCA units table including the potential unit segregating columns among the dose and/or concentration groups.

Usage

PKNCA_build_units_table(o_conc, o_dose)

Arguments

o_conc: A PKNCA concentration object (PKNCAconc).
o_dose: A PKNCA dose object (PKNCAdose).

Value

A data frame containing the PKNCA formatted units table.

Details

The function performs the following steps:

Ensures the unit columns (e.g., concu, timeu, doseu, amountu) exist in the inputs.
Joins the concentration and dose data based on their grouping columns.
Generates a PKNCA units table for each group, including conversion factors and custom units.
Returns a unique table with relevant columns for PKNCA analysis.

Examples

# Assuming `o_conc` and `o_dose` are valid PKNCA objects:
# 1) Sharing group variables in their formulas
# 2) Time units are the same within dose groups
# 3) Units are the same for subjects within the same concentration group

d_conc <- data.frame(
  subj = 1,
  analyte = rep(c("A", "B"), each = 2),
  concu = rep(c("ng/mL", "ug/mL"), each = 2),
  conc = c(0, 2, 0, 5),
  time = rep(0:1, 2),
  timeu = "h"
)
d_dose <- data.frame(
  subj = 1,
  dose = 100,
  doseu = "mg",
  time = 0,
  timeu = "h"
)
o_conc <- PKNCA::PKNCAconc(d_conc, conc ~ time | subj / analyte, concu = "concu")
o_dose <- PKNCA::PKNCAdose(d_dose, dose ~ time | subj, doseu = "doseu")
units_table <- PKNCA_build_units_table(o_conc, o_dose)