Identifies the top dose required in a GLP tox study in order to match human metrics (Cmax and AUCs) within a specified multiplier.
For a given set of human parameters the human doses required to hit the target Cmin and AUC (both or one) will be identified. The Cmax and AUC associated with the largest of those doses will be determined and the corresponding doses for a tox species (and provided parameters) will be determined for specific tox multipliers.
Optionally, simulations can be be run by specifying doses for either/or the human or tox species. Sample times can also be specified to generate annotated figures and tables to be given to analysts to facilitate assay design.
The system file requires the following components:
- Output for the drug concentration
- Output for the cumulative AUC
- Bolus dosing defined in a specific compartment
- Timescale specified for the system timescale (e.g. if the timescale is hours then you need <TS> hours = 1.0)
system_glp_scenario(
cfg,
output_Conc = NULL,
output_AUC = NULL,
timescale = NULL,
units_Conc = "",
units_AUC = "",
study_scenario = "Tox Study",
human_sim_times = NULL,
study_name = "default",
human_parameters = NULL,
human_bolus = NULL,
human_ndose = 1,
human_dose_interval = 1,
human_Cmin = NULL,
human_AUC = NULL,
human_sample_interval = NULL,
human_sim_doses = NULL,
human_sim_samples = NULL,
tox_species = "Tox",
tox_sim_times = NULL,
tox_parameters = NULL,
tox_bolus = NULL,
tox_ndose = 1,
tox_dose_interval = 1,
tox_Cmax_multiple = 10,
tox_AUC_multiple = 10,
tox_sample_interval = NULL,
tox_sim_doses = NULL,
tox_sim_samples = NULL,
annotate_plots = TRUE
)cfg ubiquity system object with the scenario added if successful
ubiquity system object
model output specified with <O> containing the concentration associated with drug exposure.
model output specified with <O> containing the cumulative exposure
system timescale specified with <TS> used for AUC comparisons and plotting
units of concentration ('')
units of AUC ('')
string containing a descriptive name for the tox study
user-specified simulation output times for humans (same timescale as the system)
name of the study to append the scenario to set with 'system_glp_init()' ('default'):
When a report is initialized using system_rpt_read_template the report name is 'default' unless otherwise specified. To disable reporting set this to NULL, and to use a different report specify the name here.
list containing the human parameters
string containing the dosing state for human doses (specified with <B:?>)
number of human doses to simulate
dosing interval in humans (time units specified with <B:?>)
target Cmin in humans (corresponding to output_Conc above)
target AUC in humans (corresponding to output_AUC above)
time interval in units specified by timescale above to evaluate the trough concentration and AUC (e.g c(1.99, 4.001) would consider the interval between 2 and 4)
optional list of doses into human_bolus to simulate (see Details below)
optional list of sample times in units specified by timescale above to label on plots of simulated doses (the default NULL will disable labels)
optional name of the tox species ("Tox")
user-specified simulation output times for the tox species (same timescale as the system)
list containing the parameters for the tox species
string containing the dosing state for tox species doses (specified with <B:?>)
number of tox doses to simulate
dosing interval in the tox species (time units specified with <B:?>)
for each target (Cmin and AUC) the dose in the tox species will be found to cover this multiple over the projected Cmax in humans (10)
for each target (Cmin and AUC) the dose in the tox species will be found to cover this multiple over the projected AUC in humans (10)
interval to consider the AUC and Cmax for comparing the human prediction to the tox multiple
optional list of doses into tox_bolus to simulate (see Details below)
optional list of sample times in units specified by timescale above to label on plots of simulated doses (the default NULL will disable labels)
Boolean switch to indicate if human_sim_samples and tox_sim_samples should be labeled on their respective plots (TRUE)
Both human_sim_doses and tox_sim_doses are lists with names
corresponding to the label of the dose. Each element has an AMT and TIME
element which corresponds to the dosing times and amounts in the units
specified with <B:?> in the system file.
For example if you wanted to simulate four weekly doses of 20 mg to a 70 kg person and the units of bolus doses were days and mg/kg for the times and amounts you would do the following:
human_sim_doses = list()
human_sim_doses[["20 mg QW"]]$TIME = c( 0, 7, 14, 21)
human_sim_doses[["20 mg QW"]]$AMT = c(0.2857, 0.2857, 0.2857, 0.2857)