*! version 1.3 11jan2016

Title

stcomlist -- list cumulative incidence function (CIF) in presence of competing risks

Syntax

stcomlist [if] [in], compet1(numlist) [other_options]

required
compet1(numlist) failure value(s) for first competing risk

other options
compet2(numlist) failure value(s) for second competing risk

compet3(numlist) failure value(s) for third competing risk

compet4(numlist) failure value(s) for fourth competing risk

compet5(numlist) failure value(s) for fifth competing risk

compet6(numlist) failure value(s) for sixth competing risk

at(numlist) timepoint(s) at which to list CIF

by(varname) list CIF separately by groups defined by this variable

allignol alternative confidence interval estimation

level(#) set confidence level; default is level(95)

noci do not calculate standard errors and confidence intervals

saving(filename[, replace]) save results to filename; use replace to overwrite existing filename

You must stset your data before using stcomlist; see
[ST] stset.

Description

stcomlist uses the SSC command
stcompet to calculate
the cumulative incidence function (CIF) and confidence intervals in the presence of
competing risks. It then lists the CIF at specific time points analogously to the official
sts list command.

Options

compet1(numlist) is required and specifies the failure value(s) for the first
competing risk. The failure variable failvar and value(s) denoting the main outcome
of interest must have already been declared using [ST] stset. This option
specifies the value(s) that denote the first competing failure.

compet2-compet6 specify value(s) denoting additional competing failures.

at(numlist) specifies the timepoint(s) at which to list the CIF. The list must
contain positive numbers in ascending order. If not specified, the default is to list all
the timepoints at which the CIF increases

by(varname) calculates CIFs and confidence intervals for the groups defined by
varname

allignol alternative confidence interval estimation; see stcompet

level(#) specifies the confidence level, as a percentage

noci prevents the calculation of standard errors and confidence intervals, which
results in much faster execution

saving(filename[, replace]) saves the results in a Stata data
file (.dta file).

replace specifies that filename be overwritten if it exists.

Remarks

stcomlist is intended to be a "competing risks" version of the official
sts list command. It uses the SSC program
stcompet
to calculate cumulative incidence functions (CIFs) for each competing outcome, optionally
in groups, and reports the CIFs along with confidence intervals.

If the saving() option is used to save the results, the resulting dataset will
contain the CIFs for each competing outcome at each timepoint. The original failure event
specified in stset will be recorded with compet==0, and the competing outcomes
will be recorded with compet corresponding to the compet() option. For example,
with two possible failure types, the one specified using stset will have
compet==0 and the one specified by compet1() will have compet==1.

Example

. webuse hypoxia

. stset dftime, failure(failtype==1)

. stcomlist, compet1(2) at(1 5) by(pelvicln)

Author

Phil Clayton, ANZDATA Registry, Australia, phil@anzdata.org.au