Package: simFastBOIN 2.1.0

simFastBOIN: Fast Simulation of Bayesian Optimal Interval Designs for Phase I Trials

Design and evaluate phase I dose-finding trials that use the Bayesian optimal interval (BOIN) design of Liu and Yuan (2015) <doi:10.1111/rssc.12089>. Functions are provided to tabulate the decision boundaries, to simulate trials, to estimate the dose-toxicity curve under a monotonicity constraint and to select the maximum tolerated dose. The simulation engine is written in C++ and draws one random variate per patient in enrollment order, which reproduces the reference implementation in the 'BOIN' package trial by trial for a given seed. The traditional 3+3 design is provided as a comparator, with operating characteristics obtained in closed form rather than by simulation. For toxicity that is observed late, the time-to-event BOIN design is provided with the two estimators of Yuan and colleagues (2018) <doi:10.1158/1078-0432.CCR-18-0246> and Lin and Yuan (2020) <doi:10.1093/biostatistics/kxz007>. Patients who arrive while the dose escalation waits can be backfilled to lower doses with the designs of Zhao and colleagues (2024) <doi:10.1158/1078-0432.CCR-23-2585> and Chen and colleagues (2026) <doi:10.1007/s43441-026-00994-0>, the latter with the suspension rules of Chen and colleagues (2025) <doi:10.1158/1078-0432.CCR-24-3669>. Trials of two drugs given together are handled by the drug-combination design of Lin and Yin (2017) <doi:10.1177/0962280215594494>.

Authors:Gosuke Homma [aut, cre]

simFastBOIN_2.1.0.tar.gz
simFastBOIN_2.1.0.zip(r-4.7-x86_64)simFastBOIN_2.1.0.zip(r-4.7-arm64)simFastBOIN_2.1.0.zip(r-4.6-x86_64)simFastBOIN_2.1.0.zip(r-4.6-arm64)simFastBOIN_2.1.0.zip(r-4.5-x86_64)
simFastBOIN_2.1.0.tgz(r-4.6-x86_64)simFastBOIN_2.1.0.tgz(r-4.6-arm64)simFastBOIN_2.1.0.tgz(r-4.5-x86_64)simFastBOIN_2.1.0.tgz(r-4.5-arm64)
simFastBOIN_2.1.0.tar.gz(r-4.7-arm64)simFastBOIN_2.1.0.tar.gz(r-4.7-x86_64)simFastBOIN_2.1.0.tar.gz(r-4.6-arm64)simFastBOIN_2.1.0.tar.gz(r-4.6-x86_64)
simFastBOIN_2.1.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
simFastBOIN/json (API)

# Install 'simFastBOIN' in R:
install.packages('simFastBOIN', repos = c('https://gosukehommaex.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/gosukehommaex/simfastboin/issues

Pkgdown/docs site:https://gosukehommaex.github.io

Uses libs:
  • c++– GNU Standard C++ Library v3

On CRAN:

Conda:

clinical-trialsdose-findingoncology-trialsphase1cpp

5.15 score 1 stars 465 downloads 34 exports 2 dependencies

Last updated from:7921ffaba7. Checks:15 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-arm64OK135
linux-devel-x86_64OK145
source / vignettesOK219
linux-release-arm64OK172
linux-release-x86_64OK170
macos-release-arm64OK157
macos-release-x86_64OK389
macos-oldrel-arm64OK114
macos-oldrel-x86_64OK325
windows-devel-arm64OK255
windows-devel-x86_64OK212
windows-release-arm64OK259
windows-release-x86_64OK178
windows-oldrel-x86_64OK143
wasm-releaseOK102

Exports:be_boin_simulatebf_boin_simulateboin_boundaryboin_decision_tableboin_isotonicboin_lambdaboin_p_toxboin_select_mtdboin_simulateboin_stopping_tablecomb_boin_nextcomb_boin_select_mtdcomb_boin_simulatedecision_table_3p3get_boin_boundaryget_boin_decisionget_boin_stopping_boundariesget_pts_and_toxisotonic_regressionoc_3p3select_mtdsim_3p3sim_be_boinsim_be_boin_multisim_bf_boinsim_bf_boin_multisim_boinsim_boin_multisim_comb_boinsim_comb_boin_multisim_tite_boinsim_tite_boin_multitite_boin_decision_tabletite_boin_simulate

Dependencies:IsoRcpp

Drug-combination trials with the BOIN design
The design | An example | Comparing scenarios | Design options | The decision table for the protocol | Running the trial | Working with the trial data | Agreement with the BOIN package | References
Rendered fromsimFastBOIN-combination.Rmdusingknitr::rmarkdown

Last update: 2026-10-13
Started: 2026-10-13

Getting started with simFastBOIN
What the package does | Decision boundaries | Operating characteristics for one scenario | Comparing scenarios | Design options | Working with the trial data | Comparing with the 3+3 design | Agreement with the BOIN package | References
Rendered fromsimFastBOIN-introduction.Rmdusingknitr::rmarkdown

Last update: 2026-10-13
Started: 2025-12-05

Backfilling with the BF-BOIN and BE-BOIN designs
Why backfill | The rules of BF-BOIN | Operating characteristics of BF-BOIN | Points the articles leave open | BE-BOIN | Agreement with the BOIN and TITE-BOIN designs | How the implementation is checked | References
Rendered fromsimFastBOIN-backfill.Rmdusingknitr::rmarkdown

Last update: 2026-10-02
Started: 2026-10-02

Late-onset toxicity with the TITE-BOIN design
Why a time-to-event design | The decision table | Operating characteristics | Agreement with the BOIN design | References
Rendered fromsimFastBOIN-tite.Rmdusingknitr::rmarkdown

Last update: 2026-09-30
Started: 2026-09-30

Readme and manuals

Help Manual

Help pageTopics
Coerce BOIN Decision Boundaries to a Data Frameas.data.frame.boin_boundary
Simulate BE-BOIN Trialsbe_boin_simulate
Simulate BF-BOIN Trialsbf_boin_simulate
Integer Decision Boundaries for the BOIN Designboin_boundary
Decision Table for the BOIN Designboin_decision_table
Isotonic Estimates of the DLT Probabilityboin_isotonic
Escalation and De-escalation Interval Boundariesboin_lambda
Toxic Threshold Giving a Required De-escalation Boundaryboin_p_tox
Select the MTD from Completed Trialsboin_select_mtd
Simulate BOIN Trialsboin_simulate
Safety Stopping Boundary as a Two-Row Tableboin_stopping_table
Next Dose Combination in a BOIN Drug-Combination Trialcomb_boin_next
Select the MTD Combination from Completed Drug-Combination Trialscomb_boin_select_mtd
Simulate BOIN Drug-Combination Trialscomb_boin_simulate
Decision Table for the 3+3 Designdecision_table_3p3
Exact Operating Characteristics of the 3+3 Designoc_3p3
Plot a BOIN Decision Tableplot.boin_decision_table
Plot the Next Dose Combination of a BOIN Drug-Combination Trialplot.comb_boin_next
Plot a 3+3 Decision Tableplot.decision_table_3p3
Plot a TITE-BOIN Decision Tableplot.tite_boin_decision_table
Print Operating Characteristics of a BOIN Design with Backfillingprint.backfill_oc
Print Operating Characteristics of a Backfill Design Across Scenariosprint.backfill_oc_multi
Print Simulated Trials of a BOIN Design with Backfillingprint.backfill_trials
Print BOIN Decision Boundariesprint.boin_boundary
Print a BOIN Decision Tableprint.boin_decision_table
Print Operating Characteristics of a BOIN Designprint.boin_oc
Print Operating Characteristics Across Scenariosprint.boin_oc_multi
Print Simulated BOIN Trialsprint.boin_trials
Print the Next Dose Combination of a BOIN Drug-Combination Trialprint.comb_boin_next
Print Operating Characteristics of the BOIN Drug-Combination Designprint.comb_boin_oc
Print Operating Characteristics of the BOIN Drug-Combination Design Across Scenariosprint.comb_boin_oc_multi
Print Simulated BOIN Drug-Combination Trialsprint.comb_boin_trials
Print a 3+3 Decision Tableprint.decision_table_3p3
Print Operating Characteristics of the 3+3 Designprint.oc_3p3
Print a TITE-BOIN Decision Tableprint.tite_boin_decision_table
Print Operating Characteristics of a TITE-BOIN Designprint.tite_boin_oc
Print Operating Characteristics of a TITE-BOIN Design Across Scenariosprint.tite_boin_oc_multi
Print Simulated TITE-BOIN Trialsprint.tite_boin_trials
Simulate the 3+3 Designsim_3p3
Operating Characteristics of a BE-BOIN Designsim_be_boin
Operating Characteristics of a BE-BOIN Design Across Several Scenariossim_be_boin_multi
Operating Characteristics of a BF-BOIN Designsim_bf_boin
Operating Characteristics of a BF-BOIN Design Across Several Scenariossim_bf_boin_multi
Operating Characteristics of a BOIN Designsim_boin
Operating Characteristics Across Several Scenariossim_boin_multi
Operating Characteristics of the BOIN Drug-Combination Designsim_comb_boin
Operating Characteristics of the BOIN Drug-Combination Design Across Scenariossim_comb_boin_multi
Operating Characteristics of a TITE-BOIN Designsim_tite_boin
Operating Characteristics of a TITE-BOIN Design Across Several Scenariossim_tite_boin_multi
Decision Table for the TITE-BOIN Designtite_boin_decision_table
Simulate TITE-BOIN Trialstite_boin_simulate