Skip to content

DIDSR/LCD_CT

Repository files navigation

Low Contrast Detectability for CT Toolbox

Zenodo Data Access Documentation Status

Low Contrast Detectability for CT (LCD-CT) Toolbox provides a common interface to evaluate the low contrast detectability (LCD) performance of advanced nonlinear CT image reconstruction and denoising algorithms. The toolbox uses model observers (MO) to evaluate the LCD of targets with known locations in test images obtained with the MITA-LCD phantom. The model observer detection accuracy is measured by the area under the receiver operating characteristic curve (AUC) and the detectability signal-to-noise ratio (d’_{snr}). The LCD-CT toolbox can be used by CT developers to perform initial evaluation on image quality improvement or dose reduction potential of their reconstruction and denoising algorithms.

diagram.png

Features

  • Creating digital replica of the background and signal modules of the MITA-LCD phantom.
  • Simuating sinogram and generate fan-beam CT scans of the digital phantoms based on the publicly available Michigan Image Reconstruction Tolbox (MIRT).
  • Estimating low contrast detectability performance from the MITA-LCD phantom CT images using channelized Hoteling model observer with Laguerre-Gauss (LG) channels and two options of Difference-of-Gaussian (DOG) channels and Gabor channels.

Start Here

Requirements

  • Matlab (version > R2016a) or Octave (version > 4.4)
  • If the above Matlab or Octave requirements are not met, then conda is required to install Octave using the installation instructions.

If required versions of Matlab or Octave are not available on your system (see how to get matlab version or octave version) then see installation for how to setup an Octave environment to run LCD-CT.

Installation

  1. Git clone the LCD-CT Toolbox repository:
git clone https://github.com/DIDSR/LCD_CT
cd LCD_CT
  1. *If neither Matlab or Octave are installed or do not meet the version requirements, you can source install.sh to prepare a conda environment. Note: this can take about 10 minutes to complete.
source install.sh

Expected run time: 10-30 min

  1. Test the installation
  • From the bash command line octave test.m or matlab -batch test.m
  • From the Matlab or Octave interactive prompt
>> test

Expected run time (Octave): 1 min 30 s

How to Use the LCD-CT Toolkit

After installing review the LCD-CT Toolkit Documentation and explore the demos to learn how to use the tool to assess low contrast detectability:

Additional demos of tool usage can be found in additional_demos.

Accessing the Large Dataset

By default the supplied demos and test scripts will use the small dataset (155 images, 16 MB) included in the repository. The boolean use_large_dataset is set to False by default

use_large_dataset = false

Changing the variable to true followed by rerunning any of the scripts will download from Zenodo the large dataset (1.3 GB) and use it in subsequent analyses

The following AUC-vs-dose curves were generated by demo_03_tworecon_dosecurve_LCD.m using the large data set available at Zenodo and the LG channelized Hoteling model observer.

>> use_large_dataset = true
>> demo_03_tworecon_dosecurve_LCD

lcd_v_dose.png

Michigan Image Reconstruction Toolkit

The LCD Phantom Creation code uses functions from Michigan Image Reconstruction Toolkit (MIRT). It should be automatically downloaded and installed when 'demo_test_phantomcreation.m' is run. If the automatic download does not work (this can happen when the matlab/octave unzip() function does not successfully extract all the files), this can be done manually:

  1. download MIRT from https://github.com/JeffFessler/mirt;
  2. Unzip MIRT to a local directory;
  3. In Matlab, Run the file "setup.m" in the MIRT local directory to add all the MIRT subdirectories to the MATLAB workspace;

To test whether the setup is successful, run demo_test_phantomcreation.m.

Contribute

Issue Tracker | Source Code | Contributing Guide

Support

If you are having issues, please let us know.

Toolbox developers: Brandon Nelson (brandon.nelson@fda.hhs.gov), PhD, Rongping Zeng, PhD (rongping.zeng@fda.hhs.gov)

Disclaimer

This software and documentation (the "Software") were developed at the Food and Drug Administration (FDA) by employees of the Federal Government in the course of their official duties. Pursuant to Title 17, Section 105 of the United States Code, this work is not subject to copyright protection and is in the public domain. Permission is hereby granted, free of charge, to any person obtaining a copy of the Software, to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, or sell copies of the Software or derivatives, and to permit persons to whom the Software is furnished to do so. FDA assumes no responsibility whatsoever for use by other parties of the Software, its source code, documentation or compiled executables, and makes no guarantees, expressed or implied, about its quality, reliability, or any other characteristic. Further, use of this code in no way implies endorsement by the FDA or confers any advantage in regulatory decisions. Although this software can be redistributed and/or modified freely, we ask that any derivative works bear some notice that they are derived from it, and any modified versions bear some notice that they have been modified.

License

The project is licensed under `Creative Commons Zero v1.0 Universal LICENSE`_.

Additional Resources

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published