.-
help for ^lrreg^
.-
Diagnostic Likelihood Ratio regression
--------------------------------------
^lrreg^ testvar disvar eqlrp [eqlrn], [^if^ exp] [^in^ range]
[^, e^form ^r^obust ^cl^uster^(^varname^) l^evel^(^#^)^ maximize_options]
^lrreg^ shares the features of all estimation commands; see help @est@.
^lrreg^, typed without arguments, redisplays previous results.
Description
-----------
^lrreg^ estimates maximum-likelihood diagnostic likelihood ratio (DLR) regression
models for binary medical diagnostic tests.
testvar : the binary test outcome variable where
testvar==1 ==> a positive test outcome
testvar==0 ==> a negative outcome
disvar : the binary disease variable where
disvar==1 ==> the presence of disease
disvar==0 ==> the absence of disease
eqlrp: the name of a previously (user) defined equation
(see help @eq@) to be estimated in association with the DLR+.
eqlrn: an equation to be estimated in association with the DLR-.
If a single equation name is included, the same equation will
be used for estimation of both the DLR+ and DLR-.
In this case, subsequent access to coefficient estimates will
require reference to new equation names LRpos and LRneg.
Options
-------
^eform^ reports the exponentiated estimated coefficients, i.e., exp(b) rather
than b. Standard errors and confidence intervals are similarly
transformed. This option affects how results are displayed, not
how they are estimated. ^eform^ may be specified at estimation or when
redisplaying previously estimated results. Note that this transformation
does not result in predicted DLR's, rather the relative DLR's for
conditions represented by the associated covariate are obtained.
^robust^ specifies that the Huber/White/sandwich estimator of variance is to
be used in place of the traditional calculation; see ^[U] 26.10 Obtaining
robust variance estimates^. ^robust^ combined with ^cluster()^ allows
observations which are not independent within cluster (although they may
be independent between clusters).
^cluster(^varname^)^ specifies that the observations are independent across groups
(clusters) but not necessarily within groups. varname specifies to which
group each observation belongs; e.g., ^cluster(personid)^ in data with
repeated observations on individuals. See ^[U] 26.10 Obtaining robust^
^variance estimates^. ^cluster()^ can used with @pweight@s to produce estimates
for unstratified cluster-sampled data, but see help @svylogit@ for a command
especially designed for survey data. Specifying ^cluster()^ implies ^robust^.
^level(^#^)^ specifies the confidence level, in percent, for calculation of
confidence intervals of the odds ratios.
Remarks
-------
The DLR+ can be thought of as the odds of disease given a positive test outcome
relative to the odds of disease in the absence of test information. This
regression method allows for specification of different regression models for
the postive and negative DLR's.
At least one equation must be defined and included as an argument to ^lrreg^.
In order to estimate the DLR+ and/or DLR- without covariate effects (i.e.
constant term only), define an empty equation.
eg.
.^eq lreqn:^
.^lrreg test disease lreqn^
Predicted DLR's and associated confidence intervals may be obtained for
particular covariate values using @lincom@ with the ^rr^ option.
Similarly, @predict@ may be used to generate estimated linear
predictor.
Examples
--------
. ^eq lrpos: age gender^
. ^eq lrneg: age^
. ^lrreg test disease lrpos lrneg, e cluster(subj_id)^
. ^lincom [lrpos]_cons + [lrpos]gender, rr^
Authors
-------
Wendy Leisenring: wendy@@fhcrc.org
Gary Longton: glongton@@fhcrc.org
References
----------
Leisenring W, and Pepe M. Regression Modelling of Diagnostic
Likelihood Ratios for the Evaluation of Medical Diagnostic Tests.
Biometrics 54:444-52. 1998.
Also see
--------
Manual: ^[U] 26 Estimation and post-estimation commands^
^[U] 35 Overview of model estimation^
On-line: help for @est@, @eq@, @predict@, @lrtest@, @lincom@, @vce@