.-
help for ^binormroc^                                               (version 1.0)
.-

plot the binormal ROC curve for specified normal test value distributions
-------------------------------------------------------------------------

    ^binormroc^, ^mu_db(^#^) s_db(^#^) mu_d(^#^) s_d(^#^)^
            [^np^oints^(^#^)^ ^genr^oc^(^varname^)^ ^gent(^varname^)^ ^replace^ ]


Description
-----------

^binormroc^ plots the binormal ROC curve for the specified normal test value
distributions among diseased and control screening populations.  A plot of the
densities for the specified distributions is included.


Options
-------

^mu_db(^#^)^ : mean of the normal test value distribution among non-diseased population.

^s_db(^#^)^ : standard deviation of test value distribution among non-diseased.

^mu_d(^#^)^ : mean of the normal test value distribution among diseased population.

^s_d(^#^)^ : standard deviation of test value distribution among diseased.

^genroc(^varname^)^ and ^gent(^varname^)^ specify the names of new variables generated
    to contain the true positive and false positive coordinates of the ROC curve.

^npoints(^#^)^ : number of points to be used for plot of ROC, and to be included in the
    variables generated for these coordinates, if specified.  Default is 500.

^replace^ requests that if existing variables are specified for ^gensroc()^ or
    ^gent()^, they should be overwritten.


Remarks
-------

^binormroc^ allows for visual exploration/comparison of specified normal
distributions of screening test values and the corresponding binormal
ROC curve.

If ^genroc()^ and ^gent()^ are not specified, the existing dataset is unchanged.  If
specified, and if ^npoints(^#^)^ is greater than the number of observations, the
number of observations will be increased and missing values filled in for
existing variables.  If ^npoints(^#^)^ is less than the number of observations,
the new roc(t) and t variables will be filled in with missing values.


Author
------

        Gary Longton, Fred Hutchinson Cancer Research Ctr.
        glongton@@fhcrc.org


Also see
--------

 On line: help for @roctab@, and @emroc@, @aucbs@, @dfroc@ if installed