Package: historicalborrow 1.1.0

William Michael Landau

historicalborrow: Non-Longitudinal Bayesian Historical Borrowing Models

Historical borrowing in clinical trials can improve precision and operating characteristics. This package supports a hierarchical model and a mixture model to borrow historical control data from other studies to better characterize the control response of the current study. It also quantifies the amount of borrowing through benchmark models (independent and pooled). Some of the methods are discussed by Viele et al. (2013) <doi:10.1002/pst.1589>.

Authors:William Michael Landau [aut, cre], Albert Man [rev], Eli Lilly and Company [cph]

historicalborrow_1.1.0.tar.gz
historicalborrow_1.1.0.tar.gz(r-4.5-noble)historicalborrow_1.1.0.tar.gz(r-4.4-noble)
historicalborrow_1.1.0.tgz(r-4.4-emscripten)historicalborrow_1.1.0.tgz(r-4.3-emscripten)
historicalborrow.pdf |historicalborrow.html✨
historicalborrow/json (API)

# Install 'historicalborrow' in R:
install.packages('historicalborrow', repos = 'https://cloud.r-project.org')

Bug tracker:https://github.com/wlandau/historicalborrow/issues0 issues

Pkgdown site:https://wlandau.github.io

Uses libs:
  • jags– Just Another Gibbs Sampler for Bayesian MCMC
  • c++– GNU Standard C++ Library v3

On CRAN:

Conda:

jagscpp

3.00 score 545 downloads 18 exports 46 dependencies

Last updated 7 months agofrom:a5b2315d34. Checks:3 OK. Indexed: no.

TargetResultLatest binary
Doc / VignettesOKMar 26 2025
R-4.5-linuxOKMar 26 2025
R-4.4-linuxOKMar 26 2025

Exports:hb_convergencehb_datahb_esshb_mcmc_hierarchicalhb_mcmc_independenthb_mcmc_mixturehb_mcmc_mixture_hyperparametershb_mcmc_poolhb_metricshb_plot_borrowhb_plot_grouphb_plot_tauhb_s_tauhb_sim_hierarchicalhb_sim_independenthb_sim_mixturehb_sim_poolhb_summary

Dependencies:abindbackportscheckmateclicodacolorspacecpp11distributionaldplyrfansifarvergenericsggplot2gluegtableisobandlabelinglatticelifecyclemagrittrMASSMatrixmatrixStatsmgcvmunsellnlmenumDerivpillarpkgconfigposteriorpurrrR6RColorBrewerrjagsrlangscalesstringistringrtensorAtibbletidyrtidyselectutf8vctrsviridisLitewithr

Methods

Rendered frommethods.Rmdusingknitr::rmarkdownon Mar 26 2025.

Last update: 2024-09-11
Started: 2022-09-13

Usage

Rendered fromusage.Rmdusingknitr::rmarkdownon Mar 26 2025.

Last update: 2024-09-11
Started: 2022-09-13

Citation

To cite package ‘historicalborrow’ in publications use:

Landau WM (2024). historicalborrow: Non-Longitudinal Bayesian Historical Borrowing Models. R package version 1.1.0, https://CRAN.R-project.org/package=historicalborrow.

Corresponding BibTeX entry: 

  @Manual{,
    title = {historicalborrow: Non-Longitudinal Bayesian Historical
      Borrowing Models},
    author = {William Michael Landau},
    year = {2024},
    note = {R package version 1.1.0},
    url = {https://CRAN.R-project.org/package=historicalborrow},
  }

Readme and manuals

historicalborrow

Historical borrowing in clinical trials can improve precision and operating characteristics. This package supports a hierarchical model and a mixture model to borrow historical control data from other studies to better characterize the response of the control arm of the current study. It also quantifies the amount of borrowing through benchmark models (independent and pooled). Some of the methods are discussed by Viele et al. (2013).

Installation

remotes::install_github("wlandau/historicalborrow")

Documentation

Thanks

Albert Man reviewed this package. Albert, Faith Bian, and Saptarshi Chatterjee contributed to the development of the methods prior to implementation. Phebe Kemmer, Heather Zhao, and Zhangchen Zhao reviewed and provided helpful feedback.

Code of Conduct

Please note that the historicalborrow project is released with a Contributor Code of Conduct. By contributing to this project, you agree to abide by its terms.

References

  • Viele, Kert and Berry, Scott and Neuenschwander, Beat et al. “Use of historical control data for assessing treatment effects in clinical trials.” Pharmaceutical Statistics 1(13), 2013.

Help Manual

Help pageTopics
historicalborrow: Bayesian historical borrowing models for clinical studies.historicalborrow-package
Check convergence diagnosticshb_convergence
Standardize datahb_data
Effective sample size (ESS)hb_ess
Hierarchical model MCMChb_mcmc_hierarchical
Independent-study model MCMChb_mcmc_independent
Mixture model MCMChb_mcmc_mixture
Mixture model MCMC hyperparametershb_mcmc_mixture_hyperparameters
Non-longitudinal pooled MCMChb_mcmc_pool
Plot a borrowing model response against the benchmark models.hb_plot_borrow
Plot the groups of a borrowing model and its benchmark models.hb_plot_group
Plot tauhb_plot_tau
Non-longitudinal hierarchical simulations.hb_sim_hierarchical
Non-longitudinal independent simulations.hb_sim_independent
Non-longitudinal mixture simulations.hb_sim_mixture
Non-longitudinal pooled simulations.hb_sim_pool
Model summaryhb_summary