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

Plot of Predicted Survival Curves
---------------------------------

   ^stcoxplt^ [^if^ exp]^, x^var^(^xvar^)^ [^adj^ust^(^varlist^)^ ^m^odel
        ^nolo^g ^nosh^ow graph_options]


^stcoxplt^ plots the predicted survival curves estimated from the Cox
    Proportional Hazards model by categories of a nominal x variable (one
    survivor function); dummy variables are created from the x variable
    and renamed x2, x3, etc., with the lowest category the reference
    group; covariates are centered by default based on the observations
    used in the model, or can be set to specified values; optionally, the
    model is printed. You must have ^stset^ your data before using this
    command; see help @stset@.


Options required
----------------

^xvar(^xvar^)^ is a nominal independent variable; separate predicted survival 
     curves are plotted for categories of this variable. Dummy variables are 
     created with the lowest category defaulting to the reference group. These 
     variables are named ^x2^, ^x3^, etc.


Options allowed
---------------    

^adjust(^varlist^)^ 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^).

^model^ displays the output for the Cox model; by default, ^model^ results are 
     not displayed.
 
^nolog^ suppresses the iteration log.

^noshow^ prevents ^stcoxplt^ from showing the key ^st^ variables.
   
graph_options are most of the options available in ^graph^; the y-axis is labeled
     by the program; If ^symbol()^ and ^connect()^ are not specified, default 
     symbols are used and points are not connected.


Examples 
--------

 . ^stset weeks relapse^
 . ^stcoxplt, xvar(trtment) adj(wbcc) c(ll) model^

     Plots the survival curves for weeks to relapse for leukemia patients by
     categories of treatment adjusted for white blood cell count; connects
     curves with lines and default symbols; displays model


 . ^stset days died^
 . ^stcoxplt, xvar(celltype) adj(trt=1 severity) c(JJJJ) s(iiii)^ 

     Plots the survival curves for days until death for lung cancer patients
     by cancer cell type, adjusted for treatment=1 and the mean severity score;
     connects curves with step functions and no symbols; model not printed


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^, ^[R] st stcox^
On-line:  help for @st@, @sts@