system_glp_scenario: Design GLP Study For a Scenario
In ubiquity: PKPD, PBPK, and Systems Pharmacology Modeling Tools

system_glp_scenario

R Documentation

Design GLP Study For a Scenario

Description

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)

Usage

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
)

Arguments

`cfg`	ubiquity system object
`output_Conc`	model output specified with `<O>` containing the concentration associated with drug exposure.
`output_AUC`	model output specified with `<O>` containing the cumulative exposure
`timescale`	system timescale specified with `<TS>` used for AUC comparisons and plotting
`units_Conc`	units of concentration (`''`)
`units_AUC`	units of AUC (`''`)
`study_scenario`	string containing a descriptive name for the tox study
`human_sim_times`	user-specified simulation output times for humans (same timescale as the system)
`study_name`	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.
`human_parameters`	list containing the human parameters
`human_bolus`	string containing the dosing state for human doses (specified with `<B:?>`)
`human_ndose`	number of human doses to simulate
`human_dose_interval`	dosing interval in humans (time units specified with `<B:?>`)
`human_Cmin`	target Cmin in humans (corresponding to output_Conc above)
`human_AUC`	target AUC in humans (corresponding to output_AUC above)
`human_sample_interval`	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)
`human_sim_doses`	optional list of doses into `human_bolus` to simulate (see Details below)
`human_sim_samples`	optional list of sample times in units specified by timescale above to label on plots of simulated doses (the default `NULL` will disable labels)
`tox_species`	optional name of the tox species (`"Tox"`)
`tox_sim_times`	user-specified simulation output times for the tox species (same timescale as the system)
`tox_parameters`	list containing the parameters for the tox species
`tox_bolus`	string containing the dosing state for tox species doses (specified with `<B:?>`)
`tox_ndose`	number of tox doses to simulate
`tox_dose_interval`	dosing interval in the tox species (time units specified with `<B:?>`)
`tox_Cmax_multiple`	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)
`tox_AUC_multiple`	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)
`tox_sample_interval`	interval to consider the AUC and Cmax for comparing the human prediction to the tox multiple
`tox_sim_doses`	optional list of doses into `tox_bolus` to simulate (see Details below)
`tox_sim_samples`	optional list of sample times in units specified by timescale above to label on plots of simulated doses (the default `NULL` will disable labels)
`annotate_plots`	Boolean switch to indicate if `human_sim_samples` and `tox_sim_samples` should be labeled on their respective plots (`TRUE`)

Details

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)