Learn R Programming

⚠️There's a newer version (2.1.2) of this package.Take me there.

RJafroc (version 1.3.2)

Analyzing Diagnostic Observer Performance Studies

Description

Implements software for assessing medical imaging systems, radiologists or computer aided detection algorithms. Models of observer performance are implemented, including the binormal model (BM), the contaminated binormal model (CBM), the correlated contaminated binormal model (CORCBM), and the radiological search model (RSM). The software and applications are described in a book - Chakraborty DP: Observer Performance Methods for Diagnostic Imaging - Foundations, Modeling, and Applications with R-Based Examples. Taylor-Francis LLC; 2017 - and its vignettes . Observer performance data collection paradigms are the receiver operating characteristic (ROC) and its location specific extensions, primarily free-response ROC (FROC) and the location ROC (LROC). ROC data consists of single ratings per images. A rating is the perceived confidence level that the image is that of a diseased patient. FROC data consists of a variable number (including zero) of mark-rating pairs per image, where a mark is the location of a clinically reportable suspicious region and the rating is the corresponding confidence level that it is a real lesion. LROC data consists of a rating and a forced localization of the most suspicious region on every image. RJafroc supersedes the Windows version of JAFROC software V4.2.1, :. Package functions are organized as follows. Data file related function names are preceded by Df, curve fitting functions by Fit, included data sets by dataset, plotting functions by Plot, significance testing functions by St, sample size related functions by Ss, data simulation functions by Simulate and utility functions by Util. Implemented are figures of merit (FOMs) for quantifying performance, functions for visualizing empirical operating characteristics: e.g., ROC, FROC, alternative FROC (AFROC) and weighted AFROC (wAFROC) curves. Four maximum likelihood curve-fitting algorithms are implemented: the binormal model (BM), the contaminated binormal model (CBM), the correlated contaminated binormal model (CORCBM) and the radiological search model (RSM). Unlike the binormal model, CBM, CORCBM and RSM predict "proper" ROC curves that do not cross the chance diagonal. RSM fitting additionally yields measures of search and lesion-classification performances. Search performance is the ability to find lesions while avoiding finding non-lesions. Lesion-classification performance is the ability to correctly classify found lesions from found non-lesions. For fully crossed study designs significance testing of reader-averaged FOM differences between modalities is implemented via both Dorfman-Berbaum-Metz and the Obuchowski-Rockette methods, including Hillis' extensions. Also implemented are single treatment analyses, which allow comparison of performance of a group of radiologists to a specified value, or comparison to CAD to a group of radiologists interpreting the same cases. Crossed-modality analysis is implemented wherein there are two crossed treatment factors and the desire is to determined performance in each treatment factor averaged over all levels of the other factor. Sample size estimation tools are provided for ROC and FROC studies; these use estimates of the relevant variances from a pilot study to predict required numbers of readers and cases in a pivotal study to achieve a desired power. Utility and data file manipulation functions allow data to be read in any of the currently used input formats, including Excel, and the results of the analysis can be viewed in text or Excel output files. The methods are illustrated with several included datasets from the author's international collaborations. This version corrects a few bugs noticed by users and extends the Excel file input format for greater flexibility in handling non-crossed datasets and the sample size routines have been rewritten for ease of use.

Copy Link

Version

Install

install.packages('RJafroc')

Monthly Downloads

282

Version

1.3.2

License

GPL-3

Maintainer

Dev Chakraborty

Last Published

March 6th, 2020

Functions in RJafroc (1.3.2)

ChisqrGoodnessOfFit

Compute the chisquare goodness of fit statistic for ROC fitting model
DfLroc2Roc

Convert an LROC dataset to a ROC dataset
DfLroc2Froc

Simulates an "AUC-equivalent" FROC dataset from an LROC dataset
SimulateRocDataset

Simulates a binormal model ROC dataset
DfExtractDataset

Extract a subset of treatments and readers from a dataset
DfFroc2Afroc

Convert an FROC dataset to an AFROC dataset
SsPowerGivenJKOrVarComp

Power given J, K and Obuchowski-Rockette variance components
UtilOutputReport

Generate a text formatted report file or an Excel file
PlotBinormalFit

Plot binormal fit
DfBinDataset

Returns a binned dataset
FitCorCbmRoc

Fit CORCBM to a paired ROC dataset
SsFrocNhRsmModel

RSM fitted model for FROC sample size
DfReadLrocDataFile

Read a LROC data file
PlotRsmOperatingCharacteristics

RSM predicted operating characteristics, ROC pdfs and different FOMs possible with FROC data
FitRsmRoc

Fit the radiological search model (RSM) to an ROC dataset
datasetBinned124

DfCreateCorCbmDataset

UtilAucsRSM

RSM ROC/AFROC AUC calculator
DfFroc2Lroc

Simulates an "AUC-equivalent" LROC dataset from an FROC dataset
PlotEmpiricalOperatingCharacteristics

Plot empirical operating characteristics, ROC, FROC or LROC
SsPowerTable

Generate a power table
SsPowerGivenJK

Statistical power for specified numbers of readers and cases
DfExtractCorCbmDataset

Extract two arms of a pairing from an MRMC ROC dataset
StSignificanceTestingSingleFixedFactor

Perform significance testing for single fixed factor analysis
PlotCbmFit

Plot CBM fitted curve
UtilAucCBM

CBM AUC function
DfSaveDataFile

Save ROC data file in a different format
UtilLesionDistr

Lesion distribution matrix
SsPowerGivenJKDbmVarComp

Power given J, K and Dorfman-Berbaum-Metz variance components
UtilLesionWeightsDistr

Lesion weights distribution
StSignificanceTesting

Perform DBM or OR significance testing
UtilFigureOfMerit

Calculate empirical figures of merit (FOMs) for specified dataset
DfFroc2Roc

Convert an FROC dataset to an ROC dataset
FitBinormalRoc

Fit the binormal model to selected treatment and reader in an ROC dataset
DfReadDataFile

Read a data file
UtilIntrinsic2PhysicalRSM

Convert from intrinsic to physical RSM parameters
FitCbmRoc

Fit the contaminated binormal model (CBM) to selected treatment and reader in an ROC dataset
StSignificanceTestingCrossedModalities

Perform significance testing using crossed treatments analysis
UtilVarComponentsDBM

Utility for Dorfman-Berbaum-Metz variance components
UtilVarComponentsOR

Utility for Obuchowski-Rockette variance components
dataset09

Nico Karssemeijer ROC dataset (CAD vs. radiologists)
UtilAucPROPROC

PROPROC AUC function
SsSampleSizeKGivenJ

Number of cases, for specified number of readers, to achieve desired power
DfReadCrossedModalities

Read a crossed-treatment data file
dataset08

Monica Penedo ROC dataset
SimulateCorCbmDataset

Simulate paired binned data for testing FitCorCbmRoc
UtilMeanSquares

Calculate mean squares
RJafroc-package

RJafroc: Analyzing Diagnostic Observer Performance Studies
StSingleTreatmentRandomReader

Significance testing for single random factor
SimulateFrocDataset

Simulates an MRMC uncorrelated FROC dataset using the RSM
datasetBinned123

SimulateLrocDataset

Simulates an uncorrelated FLROC FrocDataset using the RSM
dataset01

TONY FROC dataset
UtilPseudoValues

Calculate pseudovalues
UtilPhysical2IntrinsicRSM

Convert from physical to intrinsic RSM parameters
StSignificanceTestingCadVsRadiologists

Significance testing: standalone CAD vs. radiologists
dataset02

Van Dyke ROC dataset
dataset05

John Thompson FROC dataset
datasetROI

Simulated ROI dataset
UtilAucBinormal

Binormal model AUC function
datasetDegenerate

Simulated degenerate ROC dataset (for testing purposes)
dataset07

Lucy Warren FROC dataset
dataset11

Dobbins 1 FROC dataset
datasetCadLroc

Nico Karssemeijer LROC dataset (CAD vs. radiologists)
datasetBinned125

dataset10

Marc Ruschin ROC dataset
dataset04

Federica Zanca FROC dataset
dataset03

Franken ROC dataset
dataset06

Magnus FROC dataset
dataset13

Dobbins 3 FROC dataset
datasetCadSimuFroc

Simulated FROC CAD vs. RAD dataset
dataset12

Dobbins 2 ROC dataset
dataset14

Federica Zanca real (as opposed to inferred) ROC dataset
datasetCrossedModality

John Thompson crossed treatment FROC dataset
Df2RJafrocDataset

Convert ratings arrays to an RJafroc dataset
Compare3ProperRocFits

Compare three proper-ROC curve fitting models