derive_allocation_rate

This function validates and adjusts the treatment allocation rate (<code>TAR</code>) to ensure it is correctly specified
for the given number of treatment arms (<code>n_arms</code>). If <code>TAR</code> is missing or NULL, it is assigned a default
vector of ones, ensuring equal allocation across all arms. The function also handles cases where <code>TAR</code>
is shorter than <code>n_arms</code>, contains NA values, or has invalid values.

internal

Sample size estimation for bio-equivalence trials is supported through a simulation-based approach
that extends the Two One-Sided Tests (TOST) procedure. The methodology provides flexibility in
hypothesis testing, accommodates multiple treatment comparisons, and accounts for correlated endpoints.
Users can model complex trial scenarios, including parallel and crossover designs, intra-subject variability,
and different equivalence margins. Monte Carlo simulations enable accurate estimation of power and type I error
rates, ensuring well-calibrated study designs. The statistical framework builds on established methods for
equivalence testing and multiple hypothesis testing in bio-equivalence studies, as described in Schuirmann (1987)
<doi:10.1007/BF01068419>, Mielke et al. (2018) <doi:10.1080/19466315.2017.1371071>, Shieh (2022)
<doi:10.1371/journal.pone.0269128>, and Sozu et al. (2015) <doi:10.1007/978-3-319-22005-5>.
Comprehensive documentation and vignettes guide users through implementation and interpretation of results.

Thomas Debray

SimTOST

Sample Size Estimation for Bio-Equivalence Trials Through
Simulation

Johanna Munoz

Dewi Amaliah

Wei Wei

Marian Mitroiu

Scott McDonald

Biogen Inc 

derive_allocation_rate function

<dl><dt>TAR</dt>
<dd>Optional numeric vector specifying the allocation rate for each treatment arm. If missing, a default
equal allocation rate is assigned.</dd>
<dt>arm_names</dt>
<dd>Character vector specifying the names of the treatment arms. Used to name the elements of <code>TAR</code>.</dd>
<dt>verbose</dt>
<dd>Logical, if <code>TRUE</code>, displays messages about the status of <code>TAR</code> derivation or assignment.</dd></dl>

Arguments

Thomas Debray <a href="/link/tdebray%40fromdatatowisdom.com?package=SimTOST&version=1.0.2" data-mini-rdoc="SimTOST::tdebray@fromdatatowisdom.com">tdebray@fromdatatowisdom.com</a>

Author

Derive and Validate Treatment Allocation Rate (TAR) — derive_allocation_rate

<dl>

<dt>TAR</dt>
<dd>Optional numeric vector specifying the allocation rate for each treatment arm. If missing, a default
equal allocation rate is assigned.</dd>


<dt>arm_names</dt>
<dd>Character vector specifying the names of the treatment arms. Used to name the elements of <code>TAR</code>.</dd>


<dt>verbose</dt>
<dd>Logical, if <code>TRUE</code>, displays messages about the status of <code>TAR</code> derivation or assignment.</dd>

</dl>

Thomas Debray <a href='mailto:tdebray@fromdatatowisdom.com'>tdebray@fromdatatowisdom.com</a>

derive_allocation_rate: Derive and Validate Treatment Allocation Rate (TAR)

Description

Usage

Value

Arguments

Author