.-
help for ^stkap^                                    (STB-44: ssa12)
.-

Adjusted Kaplan-Meier Curves
----------------------------

   ^stkap^ [^if^ exp] [^,^ ^by(^varlist^) str^ata^(^varlist^) adj^ust^(^varlist^)^ graph_options]


^stkap^ graphs Kaplan-Meier survivor function by categories of one or more
    nominal X variables adjusted for covariates. The only difference between
    this and ^sts graph^ is the covariates are centered by default based
    on the observations used in the analysis, or can be set to specified
    values. If the ^adjust^ option is not specified, ^stkap^ reduces to
    unadjusted KM plots; You must have ^stset^ your data before using this
    command; see help @stset@.


Options
-------

^by(^varlist^)^ graphs a separate curve for each category of varlist; produces 
    separate survivor functions by making separate calculations for each group 
    identified by equal values of the ^by()^ variables.

^strata(^varlist^)^ graphs a separate curve for each category of varlist; 
    stratified estimates (equal coefficients across strata but baseline hazard 
    unique to each stratum) are then estimated. May be used with ^adjust()^ in 
    place of ^by()^.

^adjust(^covlist^)^ adjusts the estimates for covariates; any variables 
    listed are centered by default before estimation based on the observations 
    used in the model, or they may be set to a specified value (e.g., ^age=40^, 
    ^gender=1^).


Examples 
--------

 . ^stset weeks relapse^
 . ^stkap, strata(trtment) adj(wbcc)^

     Plots the Kaplan-Meier curves for weeks to relapse for leukemia patients
     by categories of treatment, adjusted for white blood cell count


 . ^stset days died^
 . ^stkap, by(celltype) adj(trt=1 severity)^ 

     Plots the Kaplan-Meier curves for days until death for lung cancer
     patients by cancer cell type, adjusted for treatment=1 and mean severity


Author
------

      Joanne M. Garrett
      University of North Carolina at Chapel Hill
      garrettj@@med.unc.edu


Also see
--------

    STB:  STB-44 ssa12
 Manual:  ^[R] st sts graph^
On-line:  help for @st@, @sts@