Learn R Programming

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

RJafroc (version 1.2.0)

Analyzing Diagnostic Observer Performance Studies

Description

Tools for quantitative assessment of medical imaging systems, radiologists or computer aided detection ('CAD') algorithms. Implements methods described in the book: 'Chakraborty' (2017) . Data collection paradigms include receiver operating characteristic ('ROC') and a location specific extension, namely free-response 'ROC' ('FROC'). 'ROC' data consists of a single rating per image, where the rating is the perceived confidence level the image is 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 relevant suspicious region and the rating is the corresponding confidence level that it is a true lesion. The name 'RJafroc' is derived from it being an enhanced R version of original Windows 'JAFROC' . Implemented are a number of figures of merit quantifying performance, functions for visualizing operating characteristics and three ROC ratings data curve-fitting algorithms: the 'binormal' model ('BM'), the contaminated 'binormal' model ('CBM') and the 'radiological' search model ('RSM') 'Chakraborty' (2006) <{doi:10.1088/0031-9155/51/14/012}> . Also implemented is maximum likelihood fitting of paired ROC data, utilizing the correlated 'CBM' model ('CORCBM') model. Unlike the 'BM', which predicts 'improper' ROC curves, 'CBM', 'CORCBM' and the 'RSM' predict proper ROC curves that do not cross the chance diagonal. 'RSM' fitting yields measures of search and lesion-classification performances, in addition to the usual case-classification performance measured by the area under the 'ROC' curve. Search performance is the ability to find lesions while avoiding finding non-lesions. Lesion-classification performance is the ability to discriminate between found lesions and non-lesions. A number of significance testing algorithms are implement. For fully-crossed factorial study designs, termed multiple-reader multiple-case, significance testing of reader-averaged figure-of-merit differences between 'modalities' is implemented using either 'pseudovalue'-based or figure of merit-based methods. Single treatment analysis allows comparison of performance of a group of radiologists to a specified value, or comparison of 'CAD' performance to a group of radiologists interpreting the same cases. Sample size estimation tools are provided for 'ROC' and 'FROC' studies that allow estimation of relevant variances from a pilot study, in order to predict required numbers of readers and cases in a pivotal study. 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.

Copy Link

Version

Install

install.packages('RJafroc')

Monthly Downloads

240

Version

1.2.0

License

GPL-3

Maintainer

Dev Chakraborty

Last Published

July 31st, 2019

Functions in RJafroc (1.2.0)

DfExtractCorCbmDataset

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

Convert an FROC dataset to an ROC dataset
Compare3ProperRocFits

Compare three proper-ROC curve fitting models
DfBinDataset

Returns a binned dataset
DfExtractDataset

Extract a subset of treatments and readers from a dataset
DfCreateCorCbmDataset

DfLroc2Roc

Convert an LROC dataset to a ROC dataset
ChisqrGoodnessOfFit

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

Convert ratings arrays to an RJafroc dataset
DfFroc2Afroc

Convert an FROC dataset to an AFROC dataset
PlotBinormalFit

Plot binormal fit
FitCbmRoc

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

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

Read a LROC data file
DfReadDataFile

Read a data file
DfReadCrossedModalities

Read a crossed-treatment data file
FitCorCbm

Fit CORCBM to a paired ROC dataset
RJafroc-package

Modeling, Analysis, Validation and Visualization of Observer Performance Studies in Diagnostic Radiology
SimulateCorCbmDataset

Simulate paired binned data for testing FitCorCbm
FitRsmRoc

Fit the radiological search model (RSM) to ROC data
UtilAucsRSM

RSM ROC/AFROC AUC calculator
UtilFigureOfMerit

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

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

Save ROC data file in a different format
PlotEmpiricalOperatingCharacteristics

Plot empirical operating characteristics for specified dataset, treatment and reader
StSignificanceTesting

Perform significance testing, DBMH or ORH
UtilAucCBM

CBM AUC function
PlotRsmOperatingCharacteristics

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

John Thompson FROC dataset
dataset10

Marc Ruschin ROC dataset
dataset04

Federica Zanca FROC dataset
UtilLesionDistribution

Lesion distribution matrix
UtilMeanSquares

Calculate mean squares
UtilLesionWeights

Lesion weights matrix
UtilIntrinsic2PhysicalRSM

Convert from intrinsic to physical RSM parameters
UtilAucPROPROC

PROPROC AUC function
dataset08

Monica Penedo ROC dataset
UtilOutputReport

Generate a text formatted report file or an Excel file
SimulateFrocDataset

Simulates an MRMC uncorrelated FROC dataset using the RSM
dataset11

Dobbins 1 FROC dataset
PlotCbmFit

Plot CBM fitted curve
dataset09

Nico Karssemeijer ROC dataset (CAD vs. radiologists)
datasetBinned124

datasetBinned125

SimulateRocDataset

Simulates an individual binormal model ROC dataset
UtilPhysical2IntrinsicRSM

Convert from physical to intrinsic RSM parameters
dataset03

Franken ROC dataset
SsPowerTable

Generate a power table
SsPowerGivenJK

Statistical power for specified numbers of readers and cases in an ROC study
dataset02

Van Dyke ROC dataset
StSignificanceTestingSingleFixedFactor

Perform significance testing for single fixed factor analysis
StSignificanceTestingCadVsRadiologists

Significance testing, CAD vs. radiologists
UtilPseudoValues

Calculate pseudovalues
dataset01

TONY FROC dataset
StSignificanceTestingCrossedModalities

Perform significance testing using crossed treatments analysis
dataset12

Dobbins 2 ROC dataset
dataset07

Lucy Warren FROC dataset
dataset06

Magnus FROC dataset
datasetCadLroc

Nico Karssemeijer LROC dataset (CAD vs. radiologists)
datasetCrossedModality

John Thompson crossed treatment FROC dataset
dataset13

Dobbins 3 FROC dataset
UtilAucBinormal

Binormal model AUC function
datasetBinned123

dataset14

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

Simulated degenerate ROC dataset (for testing purposes)
datasetROI

Simulated ROI dataset