help stdescribe dialog: stdescribe
-------------------------------------------------------------------------------
Title
[ST] stdescribe -- Describe survival-time data
Syntax
stdescribe [if] [in] [weight noshow]
You must stset your data before using stdescribe; see [ST] stset.
fweights, iweights, and pweights may be specified using stset; see [ST]
stset.
by is allowed; see [D] by.
Menu
Statistics > Survival analysis > Summary statistics, tests, and tables >
Describe survival-time data
Description
stdescribe produces a summary of the st data in a computer or data-based
sense rather than in an analytical or statistical sense.
stdescribe can be used with single- or multiple-record or single- or
multiple-failure st data.
Options
+------+
----+ Main +-------------------------------------------------------------
weight specifies that the summary use weighted rather than unweighted
statistics. weight does nothing unless you specified a weight when
you stset the data. The weight option and the ability to ignore
weights are unique to stdescribe. The purpose of stdescribe is to
describe the data in a computer sense -- the number of records, etc.
-- and for that purpose, the weights are best ignored.
noshow prevents stdescribe from showing the key st variables. This
option is seldom used because most people type stset, show or stset,
noshow to set whether they want to see these variables mentioned at
the top of the output of every st command; see [ST] stset.
Example with single-record survival data
Setup
. webuse page2
Describe survival-time data
. stdescribe
Example with multiple-record survival data
Setup
. webuse stan3
Prevent other st commands from showing st setting information
. stset, noshow
Describe survival-time data
. stdescribe
Describe survival-time data for patients not receiving a transplant
. stdescribe if !transplant
Describe survival-time data for patients receiving a transplant
. stdescribe if transplant
Example with multiple-failure data
Setup
. webuse mfail2
Describe survival-time data
. stdescribe
Saved results
stdescribe saves the following in r():
Scalars
r(N_sub) number of subjects
r(N_total) number of records
r(N_min) minimum number of records
r(N_mean) mean number of records
r(N_med) median number of records
r(N_max) maximum number of records
r(t0_min) minimum first entry time
r(t0_mean) mean first entry time
r(t0_med) median first entry time
r(t0_max) maximum first entry time
r(t1_min) minimum final exit time
r(t1_mean) mean final exit time
r(t1_med) median final exit time
r(t1_max) maximum final exit time
r(N_gap) number of subjects with gap
r(gap) total gap, if gap
r(gap_min) minimum gap, if gap
r(gap_mean) mean gap, if gap
r(gap_med) median gap, if gap
r(gap_max) maximum gap, if gap
r(tr) total time at risk
r(tr_min) minimum time at risk
r(tr_mean) mean time at risk
r(tr_med) median time at risk
r(tr_max) maximum time at risk
r(N_fail) number of failures
r(f_min) minimum number of failures
r(f_mean) mean number of failures
r(f_med) median number of failures
r(f_max) maximum number of failures
Also see
Manual: [ST] stdescribe
Help: [ST] stset, [ST] stsum, [ST] stvary
