Welcome to LCD for CT Toolbox’s documentation!¶
This documentation provides information regarding how to download, install, and use the LCD for CT Toolbox which is designed to low contrast detectactability in CT images.
Introduction¶
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 oberver 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 impprovement or dose reduction potential of their reconstruction and denoising algorithms.
Installation¶
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 (See step 2 below).
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.
Git clone the LCD-CT Toolbox repository:
git clone https://github.com/DIDSR/LCD_CT
cd LCD_CT
If neither Matlab or Octave are installed or do not meet the **version requirements*, you can source install.sh to prepare a conda environment. Or run the following lines in your command prompt:
conda create --name octave -y && conda activate octave
conda install -c conda-forge octave -y
conda install -c conda-forge cxx-compiler -y
octave --eval 'pkg install -forge image; pkg install https://github.com/apjanke/octave-tablicious/releases/download/v0.3.7/tablicious-0.3.7.tar.gz; pkg load image tablicious'
Note: this can take about 10-30 minutes to complete.
Test the installation
From the bash command line:
$ octave test.m
$ matlab -batch test.m
From the Matlab or Octave interactive prompt:
>> test
Users¶
Check out the Usage section for further information.
Developers¶
If you’d like to contribute to the code or documentation of this project, please check out our Contributing Guide page.