calculate_log_dose: Add a Log(dose) (in base 10) Column to the Input 'data.frame'

In maomlab/BayesPharma: Tools for Bayesian Analysis of Non-Linear Pharmacology Models

Add a Log(dose) (in base 10) Column to the Input data.frame

Description

Given the dose as a column in a data.frame with a given molar concentration add a new column of the log base-10 dose, log_dose, in the data.frame and return it.

Usage

calculate_log_dose(data, dose_col = "dose", molar_concentration = 1)

Arguments

data	data.frame containing a column representing a dose in molar units.
dose_col	expression for dose column in the input data.frame (Default: "dose")
molar_concentration	numeric units of molar concentration of the dose column (Default: 1).

Value

input data.frame with an appended log_dose column which is the ⁠log10(<dose_col>) * molar_concentration⁠.

Examples

## Not run: 
# Consider observations at doses of 1 μM and 0.1 μM.
# If the doses are given in molar units (M) then
data <- data.frame(dose = c(1e-6, 1e-7)) |>
   BayesPharma::calculate_log_dose(dose_col = dose, molar_concentration = 1)
data$log_dose == c(-6, -7)

# If the doses are given with in units of nanomolar (nM) then
data <- data.frame(dose_nM = c(1000, 100)) |>
  BayesPharma::calculate_log_dose(
    dose_col = dose_nM,
    molar_concentration = 1e-9)
data$log_dose == c(-6, -7)

## End(Not run)

maomlab/BayesPharma documentation built on Aug. 24, 2024, 8:45 a.m.