BayesERbook: Exposure-response analysis with Bayesian approaches

Authors

Kenta Yoshida

Danielle Navarro

FranΓ§ois Mercier

Published

2026-06-30

Welcome

This book provides examples of exposure-response analysis with Bayesian methods.

Install necessary packages BayesERtools website

The examples utilizes BayesERtools package.

You can install the package as follows:

install.packages('BayesERtools')
# devtools::install_github("genentech/BayesERtools") # development version

Quick Example

library(BayesERtools)
library(dplyr)
library(ggplot2)
theme_set(theme_bw(base_size = 12))

# Data
data(d_sim_binom_cov)
df_er_ae_hgly2 <-
  d_sim_binom_cov |>
  mutate(AUCss_1000 = AUCss / 1000) |>
  filter(AETYPE == "hgly2")

# Fit a model
ermod <- dev_ermod_bin(
  data = df_er_ae_hgly2,
  var_resp = "AEFLAG",
  var_exposure = "AUCss_1000"
)

# Goodness-of-fit plot
plot_er_gof(ermod, var_group = "Dose_mg", show_coef_exp = TRUE) *
  coord_transform(x = "log10") *
  scale_x_continuous(
    breaks = xgxr::xgx_breaks_log10,
    minor_breaks = xgxr::xgx_minor_breaks_log10
  )

Model types supported by BayesERtools

Binary endpoint
Continuous endpoint
Linear (logit) Emax (logit) Linear Emax
backend rstanarm rstanemax rstanarm rstanemax
reference πŸ”— πŸ”— πŸ”— πŸ”—
develop model βœ… βœ… βœ… βœ…
simulate & plot ER βœ… βœ… βœ… βœ…
exposure metrics selection βœ… βœ… βœ… βœ…
covariate selection βœ… ❌ βœ… ❌
covariate forest plot βœ… ❌ βœ… ❌
βœ… Available, 🟑 In plan/under development, ❌ Not in a current plan

Note for developer

Run usethis::use_tidy_style(strict = FALSE) before committing to ensure that the code is formatted appropriately.

Session info

Show the code
devtools::session_info()
─ Session info ───────────────────────────────────────────────────────────────
 setting  value
 version  R version 4.5.2 (2025-10-31)
 os       macOS Tahoe 26.5.1
 system   aarch64, darwin20
 ui       X11
 language (EN)
 collate  C.UTF-8
 ctype    C.UTF-8
 tz       America/Los_Angeles
 date     2026-06-29
 pandoc   3.10 @ /opt/homebrew/bin/ (via rmarkdown)
 quarto   1.9.38 @ /Applications/quarto/bin/quarto

─ Packages ───────────────────────────────────────────────────────────────────
 package        * version   date (UTC) lib source
 abind            1.4-8     2024-09-12 [1] CRAN (R 4.5.0)
 backports        1.5.1     2026-04-03 [1] CRAN (R 4.5.2)
 base64enc        0.1-6     2026-02-02 [1] CRAN (R 4.5.2)
 BayesERtools   * 0.2.6     2026-06-13 [1] local
 bayesplot      * 1.15.0    2025-12-12 [1] CRAN (R 4.5.2)
 boot             1.3-32    2025-08-29 [1] CRAN (R 4.5.2)
 cachem           1.1.0     2024-05-16 [1] CRAN (R 4.5.0)
 checkmate        2.3.4     2026-02-03 [1] CRAN (R 4.5.2)
 cli              3.6.6     2026-04-09 [1] CRAN (R 4.5.2)
 codetools        0.2-20    2024-03-31 [1] CRAN (R 4.5.2)
 colorspace       2.1-2     2025-09-22 [1] CRAN (R 4.5.0)
 colourpicker     1.3.0     2023-08-21 [1] CRAN (R 4.5.0)
 crosstalk        1.2.2     2025-08-26 [1] CRAN (R 4.5.0)
 curl             7.1.0     2026-04-22 [1] CRAN (R 4.5.2)
 devtools         2.4.6     2025-10-03 [1] CRAN (R 4.5.0)
 digest           0.6.39    2025-11-19 [1] CRAN (R 4.5.2)
 distributional   0.7.1     2026-06-11 [1] CRAN (R 4.5.2)
 dplyr          * 1.2.1     2026-04-03 [1] CRAN (R 4.5.2)
 DT               0.34.0    2025-09-02 [1] CRAN (R 4.5.0)
 dygraphs         1.1.1.6   2018-07-11 [1] CRAN (R 4.5.0)
 ellipsis         0.3.2     2021-04-29 [1] CRAN (R 4.5.0)
 evaluate         1.0.5     2025-08-27 [1] CRAN (R 4.5.0)
 farver           2.1.2     2024-05-13 [1] CRAN (R 4.5.0)
 fastmap          1.2.0     2024-05-15 [1] CRAN (R 4.5.0)
 forcats        * 1.0.1     2025-09-25 [1] CRAN (R 4.5.0)
 fs               2.1.0     2026-04-18 [1] CRAN (R 4.5.2)
 generics         0.1.4     2025-05-09 [1] CRAN (R 4.5.0)
 ggdist         * 3.3.3     2025-04-23 [1] CRAN (R 4.5.0)
 ggplot2        * 4.0.3     2026-04-22 [1] CRAN (R 4.5.2)
 glue             1.8.1     2026-04-17 [1] CRAN (R 4.5.2)
 gridExtra        2.3       2017-09-09 [1] CRAN (R 4.5.0)
 gt             * 1.3.0     2026-01-22 [1] CRAN (R 4.5.2)
 gtable           0.3.6     2024-10-25 [1] CRAN (R 4.5.0)
 gtools           3.9.5     2023-11-20 [1] CRAN (R 4.5.0)
 here           * 1.0.2     2025-09-15 [1] CRAN (R 4.5.0)
 hms              1.1.4     2025-10-17 [1] CRAN (R 4.5.0)
 htmltools        0.5.9     2025-12-04 [1] CRAN (R 4.5.2)
 htmlwidgets      1.6.4     2023-12-06 [1] CRAN (R 4.5.0)
 httpuv           1.6.17    2026-03-18 [1] CRAN (R 4.5.2)
 igraph           2.3.2     2026-05-29 [1] CRAN (R 4.5.2)
 inline           0.3.21    2025-01-09 [1] CRAN (R 4.5.0)
 jsonlite         2.0.0     2025-03-27 [1] CRAN (R 4.5.0)
 knitr            1.51      2025-12-20 [1] CRAN (R 4.5.2)
 later            1.4.8     2026-03-05 [1] CRAN (R 4.5.2)
 lattice          0.22-7    2025-04-02 [1] CRAN (R 4.5.2)
 lifecycle        1.0.5     2026-01-08 [1] CRAN (R 4.5.2)
 lme4             2.0-1     2026-03-05 [1] CRAN (R 4.5.2)
 loo            * 2.9.0     2025-12-23 [1] CRAN (R 4.5.2)
 lubridate      * 1.9.4     2024-12-08 [1] CRAN (R 4.5.0)
 magrittr         2.0.5     2026-04-04 [1] CRAN (R 4.5.2)
 markdown         2.0       2025-03-23 [1] CRAN (R 4.5.0)
 MASS             7.3-65    2025-02-28 [1] CRAN (R 4.5.2)
 Matrix           1.7-4     2025-08-28 [1] CRAN (R 4.5.2)
 matrixStats      1.5.0     2025-01-07 [1] CRAN (R 4.5.0)
 memoise          2.0.1     2021-11-26 [1] CRAN (R 4.5.0)
 mime             0.13      2025-03-17 [1] CRAN (R 4.5.0)
 miniUI           0.1.2     2025-04-17 [1] CRAN (R 4.5.0)
 minqa            1.2.8     2024-08-17 [1] CRAN (R 4.5.0)
 nlme             3.1-168   2025-03-31 [1] CRAN (R 4.5.2)
 nloptr           2.2.1     2025-03-17 [1] CRAN (R 4.5.0)
 otel             0.2.0     2025-08-29 [1] CRAN (R 4.5.0)
 pillar           1.11.1    2025-09-17 [1] CRAN (R 4.5.0)
 pkgbuild         1.4.8     2025-05-26 [1] CRAN (R 4.5.0)
 pkgconfig        2.0.3     2019-09-22 [1] CRAN (R 4.5.0)
 pkgload          1.5.2     2026-04-22 [1] CRAN (R 4.5.2)
 plyr             1.8.9     2023-10-02 [1] CRAN (R 4.5.0)
 posterior      * 1.7.0     2026-04-01 [1] CRAN (R 4.5.2)
 promises         1.5.0     2025-11-01 [1] CRAN (R 4.5.0)
 purrr          * 1.2.2     2026-04-10 [1] CRAN (R 4.5.2)
 QuickJSR         1.10.0    2026-05-17 [1] CRAN (R 4.5.2)
 R6               2.6.1     2025-02-15 [1] CRAN (R 4.5.0)
 rbibutils        2.4.1     2026-01-21 [1] CRAN (R 4.5.2)
 RColorBrewer     1.1-3     2022-04-03 [1] CRAN (R 4.5.0)
 Rcpp           * 1.1.1-1.1 2026-04-24 [1] CRAN (R 4.5.2)
 RcppParallel     5.1.11-2  2026-03-05 [1] CRAN (R 4.5.2)
 Rdpack           2.6.6     2026-02-08 [1] CRAN (R 4.5.2)
 readr          * 2.2.0     2026-02-19 [1] CRAN (R 4.5.2)
 reformulas       0.4.4     2026-02-02 [1] CRAN (R 4.5.2)
 remotes          2.5.0     2024-03-17 [1] CRAN (R 4.5.0)
 reshape2         1.4.5     2025-11-12 [1] CRAN (R 4.5.0)
 rlang            1.2.0     2026-04-06 [1] CRAN (R 4.5.2)
 rmarkdown        2.31      2026-03-26 [1] CRAN (R 4.5.2)
 rprojroot        2.1.1     2025-08-26 [1] CRAN (R 4.5.0)
 rstan            2.32.7    2025-03-10 [1] CRAN (R 4.5.0)
 rstanarm         2.32.2    2025-09-30 [1] CRAN (R 4.5.0)
 rstanemax      * 0.1.10    2026-06-13 [1] local
 rstantools       2.6.0     2026-01-10 [1] CRAN (R 4.5.2)
 S7               0.2.2     2026-04-22 [1] CRAN (R 4.5.2)
 scales           1.4.0     2025-04-24 [1] CRAN (R 4.5.0)
 sessioninfo      1.2.3     2025-02-05 [1] CRAN (R 4.5.0)
 shiny            1.13.0    2026-02-20 [1] CRAN (R 4.5.2)
 shinyjs          2.1.1     2026-01-15 [1] CRAN (R 4.5.2)
 shinystan        2.7.0     2025-12-12 [1] CRAN (R 4.5.2)
 shinythemes      1.2.0     2021-01-25 [1] CRAN (R 4.5.0)
 StanHeaders      2.32.10   2024-07-15 [1] CRAN (R 4.5.0)
 stringi          1.8.7     2025-03-27 [1] CRAN (R 4.5.0)
 stringr        * 1.6.0     2025-11-04 [1] CRAN (R 4.5.0)
 survival         3.8-3     2024-12-17 [1] CRAN (R 4.5.2)
 tensorA          0.36.2.1  2023-12-13 [1] CRAN (R 4.5.0)
 threejs          0.3.4     2025-04-21 [1] CRAN (R 4.5.0)
 tibble         * 3.3.1     2026-01-11 [1] CRAN (R 4.5.2)
 tidyr          * 1.3.2     2025-12-19 [1] CRAN (R 4.5.2)
 tidyselect       1.2.1     2024-03-11 [1] CRAN (R 4.5.0)
 tidyverse      * 2.0.0     2023-02-22 [1] CRAN (R 4.5.0)
 timechange       0.3.0     2024-01-18 [1] CRAN (R 4.5.0)
 tzdb             0.5.0     2025-03-15 [1] CRAN (R 4.5.0)
 usethis          3.2.1     2025-09-06 [1] CRAN (R 4.5.0)
 V8               8.2.0     2026-04-21 [1] CRAN (R 4.5.2)
 vctrs            0.7.3     2026-04-11 [1] CRAN (R 4.5.2)
 withr            3.0.2     2024-10-28 [1] CRAN (R 4.5.0)
 xfun             0.58      2026-06-01 [1] CRAN (R 4.5.2)
 xml2             1.5.2     2026-01-17 [1] CRAN (R 4.5.2)
 xtable           1.8-8     2026-02-22 [1] CRAN (R 4.5.2)
 xts              0.14.2    2026-02-28 [1] CRAN (R 4.5.2)
 yaml             2.3.12    2025-12-10 [1] CRAN (R 4.5.2)
 zoo              1.8-15    2025-12-15 [1] CRAN (R 4.5.2)

 [1] /Library/Frameworks/R.framework/Versions/4.5-arm64/Resources/library
 * ── Packages attached to the search path.

──────────────────────────────────────────────────────────────────────────────