Skip to contents

Creates a PKNCA::PKNCAdata object.

Usage

PKNCA_create_data_object(adnca_data)

Arguments

adnca_data

Data table containing ADNCA data.

Value

PKNCAdata object with concentration, doses, and units based on ADNCA data.

Details

This function creates a standard PKNCAdata object from ADNCA data. It requires the following columns in the ADNCA data:

  • STUDYID: Study identifier.

  • PCSPEC: Matrix.

  • ROUTE: Route of administration.

  • DRUG: Drug identifier.

  • USUBJID: Unique subject identifier.

  • DOSNO: Dose profile number.

  • ANALYTE: Analyte.

  • AVAL: Analysis value.

  • AVALU: AVAL unit.

  • DOSEA: Dose amount.

  • DOSEU: Dose unit.

  • AFRLT: Actual time from first dose.

  • ARRLT: Actual time from reference dose.

  • NFRLT: Nominal time from first dose.

  • ADOSEDUR: Duration of dose.

  • RRLTU: Time unit.

  1. Creating pk concentration data using format_pkncaconc_data().

  2. Creating dosing data using format_pkncadose_data().

  3. Creating PKNCAconc object using PKNCA::PKNCAconc(). with formula AVAL ~ TIME | STUDYID + PCSPEC + DRUG + USUBJID / ANALYTE.

  4. Creating PKNCAdose object using PKNCA::PKNCAdose(). with formula DOSEA ~ TIME | STUDYID + PCSPEC + DRUG + USUBJID.

  5. Creating PKNCAdata object using PKNCA::PKNCAdata().

  6. Updating units in PKNCAdata object so each analyte has its own unit.

Examples

adnca_data <- data.frame(
STUDYID = rep("STUDY001", 6),
PCSPEC = rep("Plasma", 6),
ROUTE = rep("IV", 6),
DRUG = rep("DrugA", 6),
USUBJID = rep("SUBJ001", 6),
DOSNO = rep(1, 6),
ANALYTE = 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)
)
PKNCA_create_data_object(adnca_data)
#> Formula for concentration:
#>  AVAL ~ TIME | STUDYID + PCSPEC + DRUG + USUBJID/ANALYTE
#> <environment: 0x55cb82946478>
#> Data are dense PK.
#> With 1 subjects defined in the 'USUBJID' column.
#> Nominal time column is: NFRLT
#> 
#> Data for concentration:
#>   STUDYID PCSPEC ROUTE  DRUG USUBJID DOSNO  ANALYTE AVAL AVALU DOSEA DOSEU
#>  STUDY001 Plasma    IV DrugA SUBJ001     1 AnalyteA    0 ng/mL   100    mg
#>  STUDY001 Plasma    IV DrugA SUBJ001     1 AnalyteA    5 ng/mL   100    mg
#>  STUDY001 Plasma    IV DrugA SUBJ001     1 AnalyteA   10 ng/mL   100    mg
#>  STUDY001 Plasma    IV DrugA SUBJ001     1 AnalyteA    7 ng/mL   100    mg
#>  STUDY001 Plasma    IV DrugA SUBJ001     1 AnalyteA    3 ng/mL   100    mg
#>  STUDY001 Plasma    IV DrugA SUBJ001     1 AnalyteA    1 ng/mL   100    mg
#>  AFRLT ARRLT NFRLT ADOSEDUR RRLTU
#>      0     0     0      0.5  hour
#>      1     1     1      0.5  hour
#>      2     2     2      0.5  hour
#>      3     3     3      0.5  hour
#>      4     4     4      0.5  hour
#>      6     6     6      0.5  hour
#>                                     conc_groups TIME     std_route IX
#>  STUDY001\nPlasma\nIV\nDrugA\nSUBJ001\nAnalyteA    0 intravascular  1
#>  STUDY001\nPlasma\nIV\nDrugA\nSUBJ001\nAnalyteA    1 intravascular  2
#>  STUDY001\nPlasma\nIV\nDrugA\nSUBJ001\nAnalyteA    2 intravascular  3
#>  STUDY001\nPlasma\nIV\nDrugA\nSUBJ001\nAnalyteA    3 intravascular  4
#>  STUDY001\nPlasma\nIV\nDrugA\nSUBJ001\nAnalyteA    4 intravascular  5
#>  STUDY001\nPlasma\nIV\nDrugA\nSUBJ001\nAnalyteA    6 intravascular  6
#>  is.excluded.hl is.included.hl REASON exclude_half.life exclude volume duration
#>           FALSE          FALSE     NA             FALSE    <NA>     NA        0
#>           FALSE          FALSE     NA             FALSE    <NA>     NA        0
#>           FALSE          FALSE     NA             FALSE    <NA>     NA        0
#>           FALSE          FALSE     NA             FALSE    <NA>     NA        0
#>           FALSE          FALSE     NA             FALSE    <NA>     NA        0
#>           FALSE          FALSE     NA             FALSE    <NA>     NA        0
#> Formula for dosing:
#>  DOSEA ~ TIME | STUDYID + PCSPEC + DRUG + USUBJID
#> Nominal time column is: NFRLT
#> 
#> Data for dosing:
#>   STUDYID PCSPEC ROUTE  DRUG USUBJID DOSNO  ANALYTE AVAL AVALU DOSEA DOSEU
#>  STUDY001 Plasma    IV DrugA SUBJ001     1 AnalyteA    0 ng/mL   100    mg
#>  AFRLT ARRLT NFRLT ADOSEDUR RRLTU
#>      0     0     0      0.5  hour
#>                                     conc_groups TIME     std_route IX exclude
#>  STUDY001\nPlasma\nIV\nDrugA\nSUBJ001\nAnalyteA    0 intravascular  1    <NA>
#> 
#> With 1 rows of interval specifications.
#> With units
#> With imputation: NA
#> No options are set differently than default.