gcecox: Fit Generalized Competing Event Model Based on Proportional...

Description Usage Arguments Details Value Author(s) References Examples

View source: R/gcecox.R

Description

Fit a generalized competing event model by using Cox proportational hazards regression model with coxph function in survival package.

Usage

1
gcecox(Time, Ind, Cov, N, M, t)

Arguments

Time

survival time for event(s) of interest.

Ind

the status indicators including the primary event(s) of interest, competing event(s) of interest, and all kind of event(s) of interest, normally 0 = alive, 1 = dead from the specific event(s) of interest.

Cov

a data frame containing all covariates.

N

the number of bootstrap replicates

M

the number of bins for ω or ω+ plots.

t

survival time point for ω or ω+ plots.

Details

The gcerisk package is designed to help investigators optimize risk-stratification methods for competing risks data, such as described in Carmona R, Gulaya S, Murphy JD, Rose BS, Wu J, Noticewala S, McHale MT, Yashar CM, Vaida F, Mell LK. Validated competing event model for the stage I-II endometrial cancer population. Int J Radiat Oncol Biol Phys. 2014;89:888-98. Standard risk models typically estimate the effects of one or more covariates on either a single event of interest (such as overall mortality, or disease recurrence), or a composite set of events (e.g., disease-free survival, which combines events of interest with death from any cause). This method is inefficient in stratifying patients who may be simultaneously at high risk for the event of interest but low risk for competing events, and who thus stand to gain the most from strategies to modulate the event of interest. Compared to standard risk models, GCE models better stratify patients at higher (lower) risk for an event of interest and lower (higher) risk of competing events. GCE models focus on differentiating subjects based on the ratio of the cumulative hazard (or cumulative hazard of the subdistribution) for the event of interest to the cumulative hazard (or cumulative hazard of the subdistribution) for all events (ω), and the ratio of the cumulative hazard (or cumulative hazard of the subdistribution) for the event of interest to the cumulative hazard (or cumulative hazard of the subdistribution) for competing events (ω+).

The gcecox function produces model estimates and confidence intervals from a generalized competing event model based on the Cox PH model for cause-specific hazards. The model assumes proportional hazards for the composite set of events.

The function returns ω and ω+ ratio estimates for the chosen covariates, with 95% confidence intervals, and plots ω and ω+ at time t within M ordered subsets of subjects as a function of increasing risk (based on the linear predictor, i.e. the inner product of a subject's data vector and the coefficient vector).

Value

$coef1

generalized competing event model coefficients (log (ω ratio))

$coef2

generalized competing event model coefficients (log (ω+ ratio))

$result1

result table for generalized competing event model containing exponential of coefficients (ω ratio) and 95% confidence intervals

$result2

result table for generalized competing event model containing exponential of coefficients (ω+ ratio) and 95% confidence intervals

$omegaplot1

ω plot for generalized competing event model

$omegaplot2

ω+ plot for generalized competing event model

$omegaplot3

plot of ω vs time

$omega

predicted ω values

$omegaplus

predicted ω+ values

$riskscore1

predicted risk scores for ω

$riskscore2

predicted risk scores for ω+

Author(s)

Hanjie Shen, Ruben Carmona, Loren Mell

References

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
# sample data to test
data(Sample)
test <- Sample
rm(list=setdiff(ls(), "test"))
test <- transform(test, LRF_OR_DF_FLAG = as.numeric(test$LRFFLAG | test$DFFLAG))
test <- transform(test, CMFLAG = as.numeric(test$OSFLAG & !test$LRFFLAG & !test$DFFLAG))
test <- transform(test, ACMFLAG = as.numeric(test$LRF_OR_DF_FLAG | test$CMFLAG))

Time <- test$OSMO/12
Ind <- data.frame(test$LRF_OR_DF_FLAG, test$CMFLAG, test$ACMFLAG)
Cov <- test[,c(3,4,6,15)]
N <- 100
M <- 5
t <- 5

fit <- gcecox(Time, Ind, Cov, N, M, t)

gcerisk documentation built on May 23, 2019, 9:03 a.m.

Related to gcecox in gcerisk...