The RJafroc Book
2021-12-18
Preface
- This book is currently (as of April 2021) in preparation.
- It is intended as an online update to my “physical” book (Chakraborty 2017). Since its publication in 2017 the
RJafroc
package, on which theR
code examples in the book depend, has evolved considerably, causing many of the examples to “break”. This also gives me the opportunity to improve on the book and include additional material. - The physical book chapters are labeled (book), to distinguish them from the chapters in this online book.
TBA How much finished
10%
The pdf file of the book
Go here and then click on Download
to get the RJafrocBook.pdf
file.
A note on the online distribution mechanism of the book
- In the hard-copy version of my book (Chakraborty 2017) the online distribution mechanism was
BitBucket
. BitBucket
allows code sharing within a closed group of a few users (e.g., myself and a grad student).- Since the purpose of open-source code is to encourage collaborations, this was, in hindsight, an unfortunate choice. Moreover, as my experience with R-packages grew, it became apparent that the vast majority of R-packages are shared on
GitHub
, notBitBucket
. - For these reasons I have switched to
GitHub
. All previous instructions pertaining toBitBucket
are obsolete. - In order to access
GitHub
material one needs to create a (free)GitHub
account. - Go to this link and click on
Sign Up
.
Structure of the book
The book is divided into parts as follows:
- Part I: Quick Start: intended for existing Windows
JAFROC
users who are seeking a quick-and-easy transition from WindowsJAFROC
toRJafroc
. - Part II: Basics: this covers the basics of ROC methods
- Part III: Significance Testing: TBA
- Part IV: FROC paradigm: TBA
Contributing to this book
- I appreciate constructive feedback on this document, e.g., corrections, comments, etc.
- To do this raise an
Issue
on theGitHub
interface. - Click on the
Issues
tab underdpc10ster/RJafrocBook
, then click onNew issue
. - When done this way, contributions from users automatically become part of the
GitHub
documentation/history of the book.
Is this book relevant to you and what are the alternatives?
- Diagnostic imaging system evaluation
- Detection
- Detection combined with localization
- Detection combined with localization and classification
- Optimization of Artificial Intelligence (AI) algorithms
- CV
- Alternatives
ToDos TBA
- Check Bamber theorem derivation.
- Parts labeled TBA and TODOLAST need to be updated on final revision.
- Change third person to first person in references to myself.
Chapters needing heavy edits
- 12-froc.
- 13-froc-empirical.
- 13-froc-empirical-examples.
Shelved vs. removed vs. parked folders needing heavy edits
- TBA
- Temporarily shelved 17c-rsm-evidence.Rmd in removed folder
- Now 17-b is breaking; possibly related to changes in RJafroc: had to do with recent changes to RJafroc code - RSM_xFROC etc requiring intrinsic parameters; fixed 17-b
- parked has dependence of ROC/FROC performance on threshold
Coding aids
- sprintf(“%.4f”, proper formatting of numbers
- OpPtStr(, do:
- kbl(dfA, caption = “….”, booktabs = TRUE, escape = FALSE) %>% collapse_rows(columns = c(1, 3), valign = “middle”) %>% kable_styling(latex_options = c(“basic”, “scale_down”, “HOLD_position”), row_label_position = “c”)
- ```{r, attr.source = “.numberLines”}
- kbl(x12, caption = “Summary of optimization results using wAFROC-AUC.”, booktabs = TRUE, escape = FALSE) %>% collapse_rows(columns = c(1), valign = “middle”) %>% kable_styling(latex_options = c(“basic”, “scale_down”, “HOLD_position”), row_label_position = “c”)
References
Chakraborty, Dev P. 2017. Observer Performance Methods for Diagnostic Imaging: Foundations, Modeling, and Applications with R-Based Examples. Boca Raton, FL: CRC Press.