RJafroc
is the software package that provides the common thread on which the other three online books depend;RJafrocQuickStart
is an online book for those already somewhat familiar running Windows JAFROC. The obsolete Windows program has been replaced by RJafroc
. This book dives into how to use RJafroc
to analyze ROC or FROC datasets.RJafrocRocBook
is an online book providing background on the ROC paradigm, modeling and analysis.RJafrocFrocBook
is an online book providing a detailed exposition of the FROC paradigm, modeling and analysis.The first CRAN-posted version of RJafroc
was used to support the R-code examples in the book: Chakraborty DP: Observer Performance Methods for Diagnostic Imaging - Foundations, Modeling, and Applications with R-Based Examples, Taylor-Francis LLC, 2017.
Since its publication in 2017 RJafroc
, on which the R
code examples in the print book depend, has evolved considerably, causing many of the examples to “break” if one uses the most current version of RJafroc
. The code will still run if one uses RJafroc
0.0.1 but this is inconvenient and misses out on many of the software improvements made since the print book appeared.
This, and other considerations, led me to conclude that an update to the book is needed. This website contains the updated software and three online books that use the software and extend the 2017-book.
HTML documentation for RJafroc
(functions, vignettes and update history) is available here. The software is fairly stable and undergoing occasional updates.
The HTML online book RJafrocQuickStart
is available here. A link is provided there to download the pdf book. Both are being continually updated (as of December 2021).
The HTML online book RJafrocRocBook
is available here. A link is provided there to download the pdf book. Both of them are being continually updated.
The HTML online book RJafrocFrocBook
is available here. A link is provided there to download the pdf book. Both are being continually updated.
While most of the applications in this package are geared toward analyzing radiologist performance in search tasks such as finding lesions in medical images, the software applies to any task involving detection and localization of targets in images. For example, the functions in RJafroc
can be used to analyze the performance of artificial intelligence (AI) algorithms. Two applications to AI are here, specifically:
The radiological search model (RSM), described here is implemented in RJafroc
. A fitting function RJafroc::FitRsmRoc
estimates RSM parameters from ROC data These parameters are related to search and classification performances:
Knowing the individual performances allows principled optimization of reader or AI algorithm performance.
RJafroc
extends Windows JAFROC
software and runs on multiple platforms.RJafroc
and the online book available here should allow one to quickly transition to RJafroc
.JAFROC
software it is still available here.GitHub
version is 2.1.2.9000 on the master
branch.CRAN
version is 2.1.2.RJafroc
branch designations
master
branch.developer
branch is for development/experimental work.Three options are given below in increasing order of complexity. + The first method downloads the package from CRAN. + The second downloads the package from the master
branch on GitHub
. + The third downloads all source files from the master
branch on GitHub
and then installs the software. I recommend the second method as the CRAN package is behind the master
branch.
R
and RStudio
.myProject
. In my computer it is /Users/Dev/Downloads/myProject
.RStudio
by clicking on the myProject.Rproj
file.RStudio
> Packages
> Install
> RJafroc
.library(RJafroc)
.cran2
branch become available.RStudio
and the above website) simultaneously.master
branch. To access them use the next suggested method, below.cbmPlot <- PlotCbmFit(c(1, 2), c(0.5, 0.5))
print(cbmPlot)
Plots
window.devtools
R
and RStudio
.myProject
. In my computer it is /Users/Dev/Downloads/myProject
.RStudio
by clicking on the myProject.Rproj
file.RStudio
> File
> New Project
> Existing Directory
> Select myProject
> Create Project
.myProject.RProj
in the Files menu.devtools
package as shown below:RStudio
> Packages
> Install
> devtools
.devtools
as shown below:library(devtools)
RJafroc
directly from GitHub
(this is where devtools
is used):install_github("dpc10ster/RJafroc")
RJafroc
as shown below:library(RJafroc)
cbmPlot <- PlotCbmFit(c(1, 2), c(0.5, 0.5))
print(cbmPlot)
Plots
window.myProject
.RJafroc
source files and install from the downloaded files
/Users/Dev/Downloads/RJafroc
. Rename the folder if necessary to match my example.Git
.R
and RStudio
.RJafroc
directory.RJafroc.Rproj
. This will open RStudio
.File
menu (lower-right window) and click on DESCRIPTION file.install.packages(c("openxlsx", "ggplot2"))
library(RJafroc)
RJafroc
has been installed to your computer and is visible to any other R
project in any directory.RJafroc
folder again (unless you reinstall a new version of the software).RJafroc
directory!myProject
, outside of the RJafroc
folder. In my computer it is /Users/Dev/Downloads/myProject
.RStudio
> File
> New Project
> Existing Directory
> myProject
> Create Project
.myProject.RProj
in the Files menu.Packages
and scroll down to find RJafroc
, and check the box next to it. This results in RJafroc
being loaded to the current workspace. The following line appears in the Console window (this is the hidden directory referrred to above). library("RJafroc", lib.loc="/Library/Frameworks/R.framework/Versions/3.5/Resources/library")
RJafroc
in the packages window. A help window opens up. I find it convenient to put this in its own window by clicking the “out” arrow button (hover message: Show in new window). You can access all documentation from here.cbmPlot <- PlotCbmFit(c(1, 2), c(0.5, 0.5))
print(cbmPlot)
Plots
window.devtools
GitHub
page.)
As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.
Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.