RJafroc (version 1.3.2)

DfReadCrossedModalities: Read a crossed-treatment data file

Description

Read an crossed-treatment data file, in which the two treatment factors are crossed

Usage

DfReadCrossedModalities(fileName, sequentialNames = FALSE)

Arguments

fileName

A string specifying the name of the file that contains the dataset, which must be an extended-JAFROC format data file containing an additional treatment factor.

sequentialNames

If TRUE, consecutive integers (starting from 1) will be used as the treatment and reader IDs. Otherwise, treatment and reader IDs in the original data file will be used. The default is FALSE.

Value

A dataset with the specified structure, similar to a standard RJafroc(see RJafroc-package). Because of the extra treatment factor, NL and LL are each five dimensional arrays. There are also two treatment IDS: modalityID1 and modalityID2.

Details

The data format is similar to the JAFROC format (see RJafroc-package). The notable difference is that there are two treatment factors. A sample crossed treatment file "CrossedModalitiesData.xlsx" is in the inst\extdata subdirectory of RJafroc.

References

Thompson JD, Chakraborty DP, Szczepura K, et al. (2016) Effect of reconstruction methods and x-ray tube current-time product on nodule detection in an anthropomorphic thorax phantom: a crossed-treatment JAFROC observer study. Medical Physics. 43(3):1265-1274.

Chakraborty DP (2017) Observer Performance Methods for Diagnostic Imaging - Foundations, Modeling, and Applications with R-Based Examples, CRC Press, Boca Raton, FL. https://www.crcpress.com/Observer-Performance-Methods-for-Diagnostic-Imaging-Foundations-Modeling/Chakraborty/p/book/9781482214840

Examples

# NOT RUN {
# }
# NOT RUN {
crossedFileName <- system.file("extdata", 
   "CrossedModalitiesData.xlsx", package = "RJafroc", mustWork = TRUE)
crossedData <- DfReadCrossedModalities(crossedFileName)
str(crossedData)
# }
# NOT RUN {
# }