S4BuyseTest-vcov

vcov,S4BuyseTest-method

Extract uncertainty about the summary statistics (net benefit, win ratio, ...) from GPC.

method

Implementation of the Generalized Pairwise Comparisons (GPC) as defined in Buyse (2010) <doi:10.1002/sim.3923> for complete observations, and extended in Peron (2018) <doi:10.1177/0962280216658320> to deal with right-censoring. GPC compare two groups of observations (intervention vs. control group) regarding several prioritized endpoints to estimate the probability that a random observation drawn from one group performs better/worse/equivalently than a random observation drawn from the other group. Summary statistics such as the net treatment benefit, win ratio, or win odds are then deduced from these probabilities. Confidence intervals and p-values are obtained based on asymptotic results (Ozenne 2021 <doi:10.1177/09622802211037067>), non-parametric bootstrap, or permutations. The software enables the use of thresholds of minimal importance difference, stratification, non-prioritized endpoints (O Brien test), and can handle right-censoring and competing-risks.

Brice Ozenne

BuyseTest

Generalized Pairwise Comparisons

Eva Cantagallo

William Anderson

Julien Peron

Johan Verbeeck

S4BuyseTest-vcov function

<dl><dt>object</dt>
<dd>a <code>S4BuyseTest</code> object, output of <code>BuyseTest</code>.</dd>
<dt>endpoint</dt>
<dd>[character] for which endpoint(s) the variance-covariance matrix should be output?
If <code>NULL</code> consider all endpoints.</dd>
<dt>statistic</dt>
<dd>[character] the statistic summarizing the pairwise comparison relative to which the variance is to be output: <code>"netBenefit"</code>, <code>"winRatio"</code>, <code>"favorable"</code>, <code>"unfavorable"</code>.
See the documentation of the <code>coef</code> method for further details.
Default value read from <code>BuyseTest.options()</code>.</dd>
<dt>strata</dt>
<dd>[character vector] the strata relative to which the variance-covariance matrix should be output.
Can also be <code>"global"</code> or <code>FALSE</code> to output the statistic pooled over all strata.</dd>
<dt>cumulative</dt>
<dd>[logical] should the summary statistic be cumulated over endpoints?
Otherwise display the contribution of each endpoint.</dd>
<dt>...</dt>
<dd>ignored.</dd></dl>

Arguments

Author

Extract Uncertainty from GPC — S4BuyseTest-vcov

<dl>

<dt>object</dt>
<dd>a <code>S4BuyseTest</code> object, output of <code>BuyseTest</code>.</dd>


<dt>endpoint</dt>
<dd>[character] for which endpoint(s) the variance-covariance matrix should be output?
If <code>NULL</code> consider all endpoints.</dd>


<dt>statistic</dt>
<dd>[character] the statistic summarizing the pairwise comparison relative to which the variance is to be output: <code>"netBenefit"</code>, <code>"winRatio"</code>, <code>"favorable"</code>, <code>"unfavorable"</code>.
See the documentation of the <code>coef</code> method for further details.
Default value read from <code>BuyseTest.options()</code>.</dd>


<dt>strata</dt>
<dd>[character vector] the strata relative to which the variance-covariance matrix should be output.
Can also be <code>"global"</code> or <code>FALSE</code> to output the statistic pooled over all strata.</dd>


<dt>cumulative</dt>
<dd>[logical] should the summary statistic be cumulated over endpoints?
Otherwise display the contribution of each endpoint.</dd>


<dt>...</dt>
<dd>ignored.</dd>

</dl>

S4BuyseTest-vcov: Extract Uncertainty from GPC

Description

Usage

Value

Arguments

Author

Details