extractDemog: Extract simulated demographic data from the "Demographic...

View source: R/extractDemog.R

extractDemogR Documentation

Extract simulated demographic data from the "Demographic Data" tab of a Simcyp Simulator ouptut Excel file

Description

Extract simulated demographic data from the "Demographic Data" tab of a Simcyp Simulator ouptut Excel file

Usage

extractDemog(sim_data_files = NA, demog_dataframe = NA, overwrite = FALSE)

Arguments

sim_data_files

a character vector of simulator output files, each in quotes and encapsulated with c(...), NA to extract concentration-time data for all the Excel files in the current folder, or "recursive" to extract concentration-time data for all the Excel files in the current folder and all subfolders. Example of acceptable input: c("sim1.xlsx", "sim2.xlsx"). The path should be included with the file names if they are located somewhere other than your working directory. If some of your Excel files are not regular simulator output, e.g. they are sensitivity analyses or a file where you were doing some calculations, those files will be skipped.

demog_dataframe

an existing data.frame of demographic data

overwrite

TRUE or FALSE for whether to overwrite any existing data

Value

a data.frame of demographic data for simulated subjects. Columns included: File (simulation results file), Trial, Individual, Population, Sex (M or F), Age (years), Weight_kg (weight in kg), Height_cm (height in cm), BSA_m2 (body surface area in meters squared), BrainWt_g (brain weight in g), KidneyWt_g (kidney weight in g), LiverWt_g (liver weight in g), BMI_kgm2 (body mass index in kg/meter squared), CardiacOut (cardiac output in L/h), Haematocrit (percent), HSA_gL (human serum albumin in g/L), AGP_gL (alpha-1-acid glycoprotein in g/L), Other_uM (user-defined value in uM), Creatinine_umolL (creatinine in umol/L), GFR_mLminm2 (glomerular filtration rate in mL/min/m squared of body surface area), RenalFunction (the GFR divided by the reference GFR, which is 130 mL/min/m2 for male subjects and 120 mL/min/m2 for female subjects), AllometricScalar (allometric scalar used), and Simulated (TRUE for simulated data).

Examples

# none yet


shirewoman2/Consultancy documentation built on Feb. 18, 2025, 10 p.m.