*! version 3.1 14aug2026
help midas_jsroc

Title

midas_jsroc -- Joint summary ROC curve with confidence and
prediction regions/ellipses (MIDAS suite post-estimation)

Syntax

midas_jsroc [if] [in]
[, options]

SROC curve
scurve draw the summary ROC curve; assumed if no other plot element is requested

curvecolor(colorstyle) line color for the SROC curve; default black

curveopts(line_options) override line options for the SROC curve entirely

noextrapolate draw the curve only within the range of observed specificities

Regions and ellipses
cregion shaded joint confidence region about the summary point

cellipse confidence ellipse (outline only); may not be combined with cregion

pregion shaded joint prediction region for a future study

pellipse prediction ellipse (outline only); may not be combined with pregion

confcolor(colorstyle) fill/line color for the confidence region; default blue

predcolor(colorstyle) fill/line color for the prediction region; default green

level(#) confidence level for regions and intervals; default level(95)

Data and summary point
data overlay observed study-level (sensitivity, specificity) pairs

weighted size observed points by study weights from e(studywgts)

labeldata label observed points with study numbers

mean display summary operating point and results table

summcolor(colorstyle) marker color for the summary point; default black

pointopts(marker_options) override marker options for observed data

summopts(marker_options) override marker options for the summary point

Legend and other
lgnd display legend; default is legend(off)

lgnpos(#) legend clock position; default lgnpos(6)

area compute region areas and heterogeneity indices

twoway_options other options passed to twoway

Description

midas_jsroc is a post-estimation command of the MIDAS suite. It must
be run after one of the midas estimation subcommands (midas mle,
qrsim, mh, hmc, or inla); all model-based
quantities are recovered from the stored e() results and the 2x2
counts in e(varlist). Nothing is refit.

Every plot element is opt-in: the Rutter-Gatsonis-equivalent summary ROC
curve (scurve), the joint level()% confidence region or
ellipse about the summary operating point, the joint prediction region or
ellipse for a future study, the observed study estimates (optionally
weighted and labeled), and the summary operating point. If no element is
requested, the SROC curve is drawn by default so that the command never
produces an empty plot. When the curve is drawn, the area under the
curve is reported (trapezoidal integration over the full curve, with a
Wilson-type confidence interval). With noextrapolate, the plotted
curve is clipped to the range of observed specificities; the AUC is still
computed over the full curve.

With area, the areas of the prediction and confidence regions are
computed by polygon integration, and heterogeneity indices (overlap
coefficient, heterogeneity area index, log area ratio, and standardized
area difference) are reported with a traffic-light interpretation.

Examples

. midas mle tp fp fn tn

. midas_jsroc, scurve data mean lgnd

Curve clipped to the observed data, custom color:

. midas_jsroc, scurve noextrapolate curvecolor(maroon) data mean lgnd

Shaded regions with areas and heterogeneity assessment:

. midas_jsroc, scurve cregion pregion data weighted mean lgnd area

Ellipse outlines only, custom colors and legend position:

. midas_jsroc, cellipse pellipse confcolor(navy) predcolor(dkgreen) mean lgnd lgnpos(7)

Stored results

midas_jsroc stores the following in r():

Scalars

r(AUC) area under the SROC curve

r(AUClo), r(AUChi) confidence limits for AUC

r(beta), r(alpha) HSROC shape and accuracy parameters

r(summ_sens), r(summ_spec) summary sensitivity and specificity (with mean)

r(summ_sens_lb), r(summ_sens_ub) limits for summary sensitivity

r(summ_spec_lb), r(summ_spec_ub) limits for summary specificity

r(pred_area), r(conf_area) region areas (with area)

r(area_ratio), r(overlap_coef) area ratio and overlap coefficient

r(het_area_index), r(log_area_ratio) heterogeneity area index and log area ratio

r(std_area_diff) standardized area difference

Author

Ben A. Dwamena, MD

Division of Nuclear Medicine and Molecular Imaging, Department of Radiology

University of Michigan, Ann Arbor

bdwamena@umich.edu

Also see

Online: midas, midas_bvsroc, integ