simulate_trial

arm0

arm1

number of required events to trigger end of study; overrides
study duration defined within <code>arm0</code> and <code>arm1</code>.

events

time from first-patient-in to trigger end of study; overrides
study duration defined within <code>arm0</code> and <code>arm1</code>. If both <code>events</code>
and <code>duration</code> are specified, end of study is triggered by either criteria,
whichever occurs first.

duration

Simulate a single- or two-arm clinical trial, where end of study (EOS)
is triggered after a number of events has been observed or a certain time
has elapsed. Whereas <code>simulate_arm</code> provides complete data for patients,
including time to event and loss of follow-up, <code>simulate_trial</code> mimicks
an actual survival study by providing only the observed time (minimum of time
to event or censoring) and censoring indicator.

A number of statistical tests have been proposed to compare two
survival curves, including the difference in (or ratio of) t-year
survival, difference in (or ratio of) p-th percentile survival, difference in
(or ratio of) restricted mean survival time, and the weighted log-rank test.
Despite the multitude of options, the convention in survival studies is to assume
proportional hazards and to use the unweighted log-rank test for design and
analysis. This package provides sample size and power
calculation for all of the above statistical tests with allowance for
flexible accrual, censoring, and survival (eg. Weibull, piecewise-exponential,
mixture cure). It is the companion R package to the paper by Yung and Liu (2019)
<doi:10.1111/biom.13196>. Specific to the weighted log-rank test, users may
specify which approximations they wish to use to estimate the large-sample mean
and variance. The default option has been shown to provide substantial
improvement over the conventional sample size and power equations based on Schoenfeld
(1981) <doi:10.1093/biomet/68.1.316>.

Godwin Yung

npsurvSS

Sample Size and Power Calculation for Common Non-Parametric
Tests in Survival Analysis

Yi Liu

simulate_trial function

<dl><dt>arm0</dt>
<dd>object of class 'arm'.</dd>
<dt>arm1</dt>
<dd>object of class 'arm'.</dd>
<dt>events</dt>
<dd>number of required events to trigger end of study; overrides
study duration defined within <code>arm0</code> and <code>arm1</code>.</dd>
<dt>duration</dt>
<dd>time from first-patient-in to trigger end of study; overrides
study duration defined within <code>arm0</code> and <code>arm1</code>. If both <code>events</code>
and <code>duration</code> are specified, end of study is triggered by either criteria,
whichever occurs first.</dd></dl>

Arguments

Simulate a clinical trial — simulate_trial

<dl>

<dt>arm0</dt>
<dd>object of class 'arm'.</dd>


<dt>arm1</dt>
<dd>object of class 'arm'.</dd>


<dt>events</dt>
<dd>number of required events to trigger end of study; overrides
study duration defined within <code>arm0</code> and <code>arm1</code>.</dd>


<dt>duration</dt>
<dd>time from first-patient-in to trigger end of study; overrides
study duration defined within <code>arm0</code> and <code>arm1</code>. If both <code>events</code>
and <code>duration</code> are specified, end of study is triggered by either criteria,
whichever occurs first.</dd>

</dl>

simulate_trial: Simulate a clinical trial

Description

Usage

Value

Arguments

See Also

Examples