dicomcat 0.1

A simple python-based tool based on imgcat for displaying DICOM files in iTerm2.

DICOMcat

DICOMcat is a simple, pip-installable python package for displaying DICOM files in iTerm2 similar to imgcat for conventional images and niicat for nifti images. This might be useful for quickly viewing DICOMs on a remote server in your terminal.

Usage

DICOMcat can be used, either within a python script or from the terminal

To use in terminal, navigate to the DICOM folder/file and enter

$ dicomcat EXAMPLE_FILE

In a python script, use as follows

import dicomcat path='path/to/dicom' dicomcat.dicomcat(path)

There are additional options to change the number of rows, downscaling, or maximum number of slices shown (when displaying a directory of DICOM slices).

Examples/Testing

There are a number of example DICOMS to test with the repo. To run the examples, run python -m unittest in the package directory

Example Dicom Sources:

• LumbarDicomExample - Radiopedia.org, Case courtesy of Prof. Frank Galliard source
• Head - Head CT, courtesy of Visual Human Project source
• Knee - Knee CT, courtesy of Visual Human Project source
• BrainExample - Brain MRI, courtesy of Jeff Mather, Mathworks source