CompAREdesign (version 2.4.0)

simula_tte: Simulation of composite time-to-event endpoints

Description

This function simulates time-to-event components and their pertinent composite endpoint via copulas.

Usage

simula_tte(
  p0_e1,
  p0_e2,
  HR_e1,
  HR_e2,
  beta_e1 = 1,
  beta_e2 = 1,
  case,
  copula = "Frank",
  rho = 0.3,
  rho_type = "Spearman",
  followup_time = 1,
  sample_size
)

Value

A data.frame with 7 colums:

time_e1

time to event for endpoint 1

status_e1

The status indicator of endpoint 1, 0=censored, 1=event

time_e2

time to event for endpoint 2

status_e2

The status indicator of endpoint 2, 0=censored, 1=event

time_ce

time to event for composite endpoint

status_ce

The status indicator of the composite endpoint, 0=censored, 1=event

treated

0 if control arm and 1, otherwise

Arguments

p0_e1

numeric parameter between 0 and 1, expected proportion of observed events for the endpoint E1

p0_e2

numeric parameter between 0 and 1, expected proportion of observed events for the endpoint E2

HR_e1

numeric parameter between 0 and 1, expected cause specific hazard Ratio the endpoint E1

HR_e2

numeric parameter between 0 and 1, expected cause specific hazard Ratio the endpoint E2

beta_e1

numeric positive parameter, shape parameter (\(\beta_1\)) for a Weibull distribution for the endpoint E1 in the control group. See details for more info.

beta_e2

numeric positive parameter, shape parameter (\(\beta_2\)) for a Weibull distribution for the endpoint E2 in the control group. See details for more info.

case

integer parameter in {1,2,3,4}: (1) none of the endpoints is death; (2) endpoint 2 is death; (3) endpoint 1 is death; (4) both endpoints are death by different causes.

copula

character indicating the copula to be used: "Frank" (default), "Gumbel" or "Clayton". See details for more info.

rho

numeric parameter between -1 and 1, Spearman's correlation coefficient o Kendall Tau between the marginal distribution of the times to the two events E1 and E2. See details for more info.

rho_type

character indicating the type of correlation to be used: "Spearman" (default) or "Kendall". See details for more info.

followup_time

numeric parameter indicating the maximum follow up time (in any unit). Default is 1.

sample_size

sample size for each arm (treated and control)

Details

If sample_size is not an integer, it is rounded to the nearest integer.

Examples

# Simulate 10 times and censoring indicators for each arm
simula_tte(p0_e1   = .59, p0_e2   = .74, 
           HR_e1   = .91, HR_e2   = .77, 
           beta_e1 = 1,   beta_e2 = 2, 
           case    = 3,   rho     = .5,
           copula  = 'Frank', rho_type  = 'Spearman',
           sample_size = 10, followup_time = 2)