hce0.9.0 package

Design and Analysis of Hierarchical Composite Endpoints

summaryWO.data.frame

Win odds summary for a data frame

summaryWO.formula

Win odds summary using formula syntax

summaryWO.hce

Win odds summary for hce objects

summaryWO

A generic function for summarizing win odds

regWO

A generic function for win odds regression

simHCE

Simulate an hce object

simKHCE

Simulate a kidney disease hce dataset

propWINS

Proportion of wins/losses/ties given the win odds and the win ratio

as_hce.data.frame

Coerce a data frame to an hce object

as_hce.default

Coerce a data frame to an hce object

as_hce

A generic function for coercing data structures to hce objects

calcWINS.data.frame

Win statistics calculation using a data frame

calcWINS.formula

Win statistics calculation using formula syntax

calcWINS.hce

Win statistics calculation for hce objects

calcWINS

A generic function for calculating win statistics

calcWO.data.frame

Win odds calculation using a data frame

regWO.formula

Win Odds Regression Using a Formula Syntax

calcWO.formula

Win odds calculation using formula syntax

calcWO.hce

Win odds calculation for hce objects

calcWO

A generic function for calculating win odds

deltaWO.adhce

Win odds calculation based on a threshold for adhce objects

deltaWO

A generic function for calculating win odds based on a threshold

regWO.data.frame

Win Odds Regression Using a Data Frame

hce

Helper function for hce objects

IWP

Calculates patient-level individual win proportions

minWO

Minimum detectable or WO for alternative hypothesis for given power (n...

plot.hce_results

A print method for hce_results objects

plot.hce

A plot method for hce objects

powerWO

Power calculation for the win odds test (no ties)

print.hce_results

A print method for hce_results objects

simORD

Simulate ordinal variables for two treatment groups using categorizati...

simTTE

Simulate an adhce dataset with two correlated outcomes (illness - de...

sizeWO

Sample size calculation for the win odds test (no ties)

sizeWR

Sample size calculation for the win ratio test (with WR = 1 null hypot...

stratWO.data.frame

Stratified win odds with adjustment

stratWO

A generic function for stratified win odds with adjustment

summaryWO.adhce

Win odds summary for adhce objects

Simulate and analyze hierarchical composite endpoints. Includes implementation for the kidney hierarchical composite endpoint as defined in Heerspink HL et al (2023) “Development and validation of a new hierarchical composite end point for clinical trials of kidney disease progression” (Journal of the American Society of Nephrology 34 (2): 2025–2038, <doi:10.1681/ASN.0000000000000243>). Win odds, also called Wilcoxon-Mann-Whitney or success odds, is the main analysis method. Other win statistics (win probability, win ratio, net benefit) are also implemented in the univariate case, provided there is no censoring. The win probability analysis is based on the Brunner-Munzel test and uses the DeLong-DeLong-Clarke-Pearson variance estimator, as described by Brunner and Konietschke (2025) in “An unbiased rank-based estimator of the Mann–Whitney variance including the case of ties” (Statistical Papers 66 (1): 20, <doi:10.1007/s00362-024-01635-0>). Includes implementation of a new Wilson-type, compatible confidence interval for the win odds, as proposed by Schüürhuis, Konietschke, Brunner (2025) in “A new approach to the nonparametric Behrens–Fisher problem with compatible confidence intervals.” (Biometrical Journal 67 (6), <doi:10.1002/bimj.70096>). Stratification and covariate adjustment are performed based on the methodology presented by Koch GG et al. in “Issues for covariance analysis of dichotomous and ordered categorical data from randomized clinical trials and non-parametric strategies for addressing them” (Statistics in Medicine 17 (15-16): 1863–92). For a review, see Gasparyan SB et al (2021) “Adjusted win ratio with stratification: Calculation methods and interpretation” (Statistical Methods in Medical Research 30 (2): 580–611, <doi:10.1177/0962280220942558>).

  • Maintainer: Samvel B. Gasparyan
  • License: MIT + file LICENSE
  • Last published: 2026-01-29