plot_regions {movieROC}

Plot the classification regions underlying a ROC curve

Description

This function plots the classification regions for univariate markers. It works for objects of class ‘groc’ and ‘hroc’. Two graphics are displayed in the same figure: left, classification subsets for every false-positive rate (grey color by default); right, 90º rotated ROC curve.

Usage

## S3 method for class 'groc'
plot_regions(x, FPR = 0.15, plot.roc = TRUE, plot.auc = FALSE, 
  col = c("white", "grey"), col.FPR = "blue", lwd = 2, new.window = TRUE, 
  type.plotroc = "s", xlim = NULL, mar = c(5, 6, 4, 0.25), 
  cex.lab = 1.5, cex.axis = 1.5, cex.main = 1.75, main = NULL, 
  xlab = "", ylab = "False-Positive Rate", main.plotroc = "ROC curve", 
  legend = TRUE, cex.legend = 1, ...)
## S3 method for class 'hroc'
plot_regions(x, FPR = 0.15, plot.roc = TRUE, plot.auc = FALSE, 
  col = c('white','grey'), col.FPR = 'blue', lwd = 2, new.window = TRUE, 
  type.plotroc = 's', xlim = NULL, mar = c(5,6,4,0.25), 
  cex.lab = 1.5, cex.axis = 1.5, cex.main = 1.75, main = NULL, 
  xlab = "", ylab = "False-Positive Rate", main.plotroc = "ROC curve", 
  legend = TRUE, cex.legend = 1, verbose = FALSE, ...)

Arguments

x

An ROC curve object from a univariate marker. Possible classes are: ‘groc’ (output of gROC function) and ‘hroc’ (output of hROC function),

FPR

False-positive rate to be highlighted, both on the ROC curve (right plot) and classification subset (left plot). Default: 0.15.

plot.roc

If TRUE, the ROC curve is displayed. Default: TRUE.

plot.auc

If TRUE, the AUC is displayed on the plot of the bottomleft corner of the ROC curve plot. Default: FALSE.

col

Vector of length 2 with colors used for outside and inside of classification subsets, respectively. Default: c("white", "grey").

col.FPR

Color used to highlight the FPR chose. Default: "blue".

type.plotroc, lwd

Line type and width for the ROC curve. Default: type.plotroc = "s", lwd = 2.

new.window

If TRUE, graphics are displayed in a new window. Default: TRUE.

xlim

Range for x-axis on the left plot. Default: range of the marker values.

mar

A numerical vector of the form c(bottom, left, top, right) which gives the number of lines of margin to be specified on the four sides of the plot.

cex.lab, cex.axis, cex.main

The magnification to be used for labels, axis annotation and main titles, respectively, relative to the current setting of cex. Default: cex.lab = 1.5, cex.axis = 1.5, cex.main = 1.75.

xlab, ylab

Label for x- and y-axis on the left plot.

main, main.plotroc

Title for the left and the right plot, respectively.

legend

If TRUE, a legend with the meaning of colors is displayed on the left plot. Default: TRUE.

cex.legend

The magnification to be used for legend, relative to the current setting of cex. Default: 1.

verbose

If TRUE, a progress bar is displayed. Default: FALSE.

...

Other parameters to be passed. Not used.

Value

A plot of the classification regions underlying a ROC curve with the selected graphical parameters

Examples

data(HCC)
# 1. Standard ROC curve
roc_cg18384097 <- gROC(X = HCC$cg18384097, D = HCC$tumor)
plot_regions(roc_cg18384097, plot.auc = TRUE)
# 2. gROC curve
groc_cg18384097 <- gROC(X = HCC$cg18384097, D = HCC$tumor, side = "both")
plot_regions(groc_cg18384097, plot.auc = TRUE)
# 3. hROC curve with a restricted cubic splines transformation
hroc_cg18384097 <- hROC(X = HCC$cg18384097, D = HCC$tumor, 
    formula.lrm = "D ~ rcs(X,8)") 
plot_regions(hroc_cg18384097, plot.auc = TRUE)