Description Usage Arguments Details Value Author(s) References See Also Examples

View source: R/pooledROCplot.R

Given a `metaObject`

with `$originalData`

populated, this function calculates and
plots a "pooled" ROC curve that represents the average of all the individual ROC
curves. This version of the function is for use with MetaIntegrator.

1 2 3 4 |

`metaObject` |
a metaObject which must have |

`filterObject` |
a metaFilter object containing the signature genes that will be used for calculating the score |

`points` |
number of points to simulate for the approximated ROC curves during the linear interpolation (default: 1000) |

`weighting` |
when calculating the mean AUC, if |

`title` |
title of the plot |

`size` |
size of the text/legend/etc (default: 14) |

`rounding` |
how many digits to round the AUC and CI to (default: 3) |

`smoothed` |
if TRUE, then a smoothed ROC curve is estimated using a modified version of the Kester and Buntinx Method |

`auc1.thresh` |
(if |

`bootReps` |
(if |

`minPoints` |
(if |

`numCores` |
(if |

`method` |
(if |

To make sure the input is correctly formatted, the input `metaObject`

should be checked with
`checkDataObject(metaObject, "Meta", "Pre-Analysis")`

before starting the meta-analysis.

By default, this average ROC curve is calculated by first using linear interpolation to create approximated versions of each given ROC curve that all have the same set of FPR values. A pooled ROC curve is then calculated by taking the weighted mean of the corresponding TPR values (weighting corresponds to the number of samples in each dataset). This pooled curve is represented as a black curve. In addition, the weighted standard deviation is calculated for each TPR, which is represented by a grey area on the plot. The pooled AUC is calculated by using the trapezoid method on the pooled ROC curve, and the 95% confidence interval of the pooled AUC is calculated using the pooled standard error of the individual ROC curves.

If `smoothed`

=TRUE, then a smoothed version of the pooled ROC curve will be
plotted instead, with the surrounding gray area representing the weighted
standard deviation of the pooled ROC curve. The statistics for this smoothed
curve are based on the Kester and Buntinx Method, from (Kester and Buntinx,
*Med Decis Making*, 2000). Methods have been added by Tim Sweeney (2015) for better
estimates in cases with low numbers of tpr/fpr values. Methods have also been
added by Aditya Rao (2018) to predict the curve's alpha parameter for a given
beta parameter and AUC, as well as to calculate the weighted standard deviation
of the given ROC curves.

Generates a plot with each individual ROC curve as well as the pooled ROC curve

Aditya M. Rao (with help from Hayley Warsinske and Francesco Vallania, original idea from Madeleine Scott, and some code adapted from Tim Sweeney)

Kester and Buntinx, *Med Decis Making*, 2000

1 2 | ```
pooledROCPlot(tinyMetaObject, filterObject =
tinyMetaObject$filterResults$pValueFDR0.05_es0_nStudies1_looaTRUE_hetero0)
``` |

```
```

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.