httk: scale_dosing – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

scale_dosing

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 Fgutabs, and scaling is currently avoided in the inhalation exposure case with a scale factor of 1

Usage

scale_dosing(dosing, parameters, route, output.units = "uM")

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", ...
`output.units`	Desired units (either "mg/L", "mg", "umol", or default "uM").

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

Author(s)

John Wambaugh

httk

High-Throughput Toxicokinetics

v2.0.4

GPL-3

Authors

John Wambaugh [aut, cre] (<https://orcid.org/0000-0002-4024-534X>), Robert Pearce [aut] (<https://orcid.org/0000-0003-3168-4049>), Caroline Ring [aut] (<https://orcid.org/0000-0002-0463-1251>), Greg Honda [aut] (<https://orcid.org/0000-0001-7713-9850>), Mark Sfeir [aut], Matt Linakis [aut] (<https://orcid.org/0000-0003-0526-2395>), Sarah Davidson [aut] (<https://orcid.org/0000-0002-2891-9380>), Miyuki Breen [ctb] (<https://orcid.org/0000-0001-8511-4653>), Shannon Bell [ctb], Xiaoqing Chang [ctb] (<https://orcid.org/0000-0003-0752-1848>), Jimena Davis [ctb], James Sluka [ctb] (<https://orcid.org/0000-0002-5901-1404>), Nisha Sipes [ctb] (<https://orcid.org/0000-0003-4203-6426>), Barbara Wetmore [ctb] (<https://orcid.org/0000-0002-6878-5348>), Woodrow Setzer [ctb] (<https://orcid.org/0000-0002-6709-9186>)

Initial release

2021-05-07