scale_dosing: Scale mg/kg body weight doses according to body weight and...
In httk: High-Throughput Toxicokinetics

scale_dosing

R Documentation

Scale mg/kg body weight doses according to body weight and units

Description

This function transforms the dose (in mg/kg) into the appropriate units. It handles single doses, matrices of doses, or daily repeated doses at varying intervals. Gut absorption is also factored in through the parameter Fabsgut, and scaling is currently avoided in the inhalation exposure case with a scale factor of 1

Usage

scale_dosing(
  dosing,
  parameters,
  route,
  input.units = NULL,
  output.units = "uM",
  vol = NULL,
  state = "liquid"
)

Arguments

`dosing`	List of dosing metrics used in simulation, which must include the general entries with names "initial.dose", "doses.per.day", "daily.dose", and "dosing.matrix". The "dosing.matrix" is used for more precise dose regimen specification, and is a matrix consisting of two columns or rows named "time" and "dose" containing the time and amount, in mg/kg BW, of each dose. The minimal usage case involves all entries but "initial.dose" set to NULL in value.
`parameters`	Chemical parameters from parameterize_pbtk function, overrides chem.name and chem.cas.
`route`	String specification of route of exposure for simulation: "oral", "iv", "inhalation", ...
`input.units`	Units of the dose values being scaled. (Default is NULL.) Currently supported units "mg/L", "ug/L","ug/mL", "uM", "umol/L", "ug/dL", "ug/g", "nmol/L", "nM", and "ppmw" (supported input.units subject to change).
`output.units`	Desired units (either "mg/L", "mg", "umol", or default "uM").
`vol`	Volume for the target tissue of interest. NOTE: Volume should not be in units of per BW, i.e. "kg".
`state`	Chemical state of matter (gas or default liquid).

Value

A list of numeric values for doses converted to output.units, potentially (depending on argument dosing) including:

`initial.dose`	The first dose given
`dosing.matrix`	A 2xN matrix where the first column is dose time and the second is dose amount for N doses
`daily.dose`	The total cumulative daily dose