Learn R Programming

RJafroc (version 2.1.2)

Artificial Intelligence Systems and Observer Performance

Description

Analyzing the performance of artificial intelligence (AI) systems/algorithms characterized by a 'search-and-report' strategy. Historically observer performance has dealt with measuring radiologists' performances in search tasks, e.g., searching for lesions in medical images and reporting them, but the implicit location information has been ignored. The implemented methods apply to analyzing the absolute and relative performances of AI systems, comparing AI performance to a group of human readers or optimizing the reporting threshold of an AI system. In addition to performing historical receiver operating receiver operating characteristic (ROC) analysis (localization information ignored), the software also performs free-response receiver operating characteristic (FROC) analysis, where lesion localization information is used. A book using the software has been published: Chakraborty DP: Observer Performance Methods for Diagnostic Imaging - Foundations, Modeling, and Applications with R-Based Examples, Taylor-Francis LLC; 2017: . Online updates to this book, which use the software, are at , and at . Supported data collection paradigms are the ROC, FROC and the location ROC (LROC). ROC data consists of single ratings per images, where a rating is the perceived confidence level that the image is that of a diseased patient. An ROC curve is a plot of true positive fraction vs. false positive fraction. FROC data consists of a variable number (zero or more) of mark-rating pairs per image, where a mark is the location of a reported suspicious region and the rating is the confidence level that it is a real lesion. LROC data consists of a rating and a location of the most suspicious region, for every image. Four models of observer performance, and curve-fitting software, 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 inappropriately cross the chance diagonal. Additionally, RSM parameters are related to search performance (not measured in conventional ROC analysis) and classification performance. Search performance refers to finding lesions, i.e., true positives, while simultaneously not finding false positive locations. Classification performance measures the ability to distinguish between true and false positive locations. Knowing these separate performances allows principled optimization of reader or AI system performance. This package supersedes Windows JAFROC (jackknife alternative FROC) 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 and functions for visualizing empirical or fitted operating characteristics: e.g., ROC, FROC, alternative FROC (AFROC) and weighted AFROC (wAFROC) curves. For fully crossed study designs significance testing of reader-averaged FOM differences between modalities is implemented via either Dorfman-Berbaum-Metz or the Obuchowski-Rockette methods. Also implemented is single treatment analysis, which allows comparison of performance of a group of radiologists to a specified value, or comparison of AI to a group of radiologists interpreting the same cases. Crossed-modality analysis is implemented wherein there are two crossed treatment factors and the aim is to determined performance in each treatment factor averaged over all levels of the second 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 the 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 collaborations. This update includes improvements to the code, some as a result of user-reported bugs and new feature requests, and others discovered during ongoing testing and code simplification.

Copy Link

Version

Install

install.packages('RJafroc')

Monthly Downloads

282

Version

2.1.2

License

GPL-3

Maintainer

Dev Chakraborty

Last Published

November 8th, 2022

Functions in RJafroc (2.1.2)

FitCorCbm

Fit CORCBM to a paired ROC dataset
DfReadCrossedModalities

Read a crossed-treatment data file
DfReadDataFile

Read a data file
RSM_pdfN

RSM predicted ROC-rating pdf for non-diseased cases
PlotRsmOperatingCharacteristics

RSM predicted operating characteristics, ROC pdfs and AUCs
RSM_xROC

RSM predicted ROC-abscissa as function of z
RJafroc-package

Artificial Intelligence Systems and Observer Performance
RSM_NLF

RSM predicted FROC abscissa
RSM_LLF

RSM predicted FROC ordinate
RSM_yROC

RSM predicted ROC-ordinate as function of z
PlotEmpiricalOperatingCharacteristics

Plot empirical operating characteristics, ROC, FROC or LROC
RSM_pdfD

RSM predicted ROC-rating pdf for diseased cases
RSM_wLLF

RSM predicted wAFROC ordinate
SsPowerGivenJKOrVarCom

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

Simulates an MRMC uncorrelated FROC dataset using the RSM
SimulateRocDataset

Simulates a binormal model ROC dataset
SsFrocNhRsmModel

RSM fitted model for FROC sample size
SimulateCorCbmDataset

Simulate paired binned data for testing FitCorCbm
SsPowerTable

Generate a power table using the OR method
SsPowerGivenJKDbmVarCom

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

Statistical power for specified numbers of readers and cases
SimulateFrocFromLrocDataset

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

Simulates an uncorrelated FLROC FrocDataset using the RSM
UtilAucCBM

CBM AUC function
UtilAucPROPROC

PROPROC AUC function
StSignificanceTestingCadVsRad

Significance testing: standalone CAD vs. radiologists
StSignificanceTestingCrossedModalities

Perform significance testing using crossed treatments analysis
UtilDBM2ORVarCom

Convert from DBM to OR variance components
UtilLesionWeightsMatrix

Determine lesion weights distribution 2D matrix
UtilFigureOfMerit

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

Calculate mean squares for factorial dataset
StSignificanceTesting

Performs DBM or OR significance testing for factorial or split-plot A,C datasets
UtilOR2DBMVarCom

Convert from OR to DBM variance components
SsSampleSizeKGivenJ

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

Utility for estimating Obuchowski-Rockette variance components for factorial datasets
UtilIntrinsic2RSM

Convert from intrinsic to physical RSM parameters
UtilRSM2Intrinsic

Convert from physical to intrinsic RSM parameters
UtilVarComponentsDBM

Utility for Dorfman-Berbaum-Metz variance components
UtilOutputReport

Generate a text formatted report file or an Excel file
UtilLesionDistrVector

Get the lesion distribution vector of a dataset
UtilPseudoValues

Pseudovalues for given dataset and FOM
dataset10

Mark Ruschin ROC dataset
UtilAucBinormal

Binormal model AUC function
UtilAnalyticalAucsRSM

RSM ROC/AFROC/wAFROC AUC calculator
dataset06

Magnus FROC dataset
dataset02

Van Dyke ROC dataset
dataset04

Federica Zanca FROC dataset
dataset09

Nico Karssemeijer ROC dataset (CAD vs. radiologists)
dataset05

John Thompson FROC dataset
dataset01

TONY FROC dataset
dataset07

Lucy Warren FROC dataset
dataset08

Monica Penedo ROC dataset
dataset03

Franken ROC dataset
datasetCrossedModality

John Thompson crossed treatment FROC dataset
datasetCadSimuFroc

Simulated FROC CAD vs. RAD dataset
dataset14

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

Binned dataset suitable for checking FitCorCbm; seed = 123
dataset13

Dobbins 3 FROC dataset
datasetBinned124

Binned dataset suitable for checking FitCorCbm; seed = 124
datasetDegenerate

Simulated degenerate ROC dataset (for testing purposes)
isBinnedDataset

Determine if a dataset is binned
isValidDataset

Check the validity of a dataset
datasetBinned125

Binned dataset suitable for checking FitCorCbm; seed = 125
datasetCadLroc

Nico Karssemeijer LROC dataset (CAD vs. radiologists)
datasetROI

Simulated ROI dataset
datasetFROCSpC

Simulated FROC SPLIT-PLOT-C dataset
dataset12

Dobbins 2 ROC dataset
dataset11

Dobbins 1 FROC dataset
DfExtractCorCbmDataset

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

Create paired dataset for testing FitCorCbm
DfBinDataset

Returns a binned dataset
DfLroc2Roc

Convert an LROC dataset to a ROC dataset
ChisqrGoodnessOfFit

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

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

Convert ratings arrays to an RJafroc dataset
DfExtractDataset

Extract a subset of treatments and readers from a dataset
DfFroc2Lroc

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

Convert an FROC dataset to an ROC dataset
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
DfWriteExcelDataFile

Save dataset object as a JAFROC format Excel file
DfSaveDataFile

Save ROC dataset in different formats
FitRsmRoc

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

Plot binormal fit
PlotCbmFit

Plot CBM fitted curve