Skip to content

janpipek/pydiq

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

64 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Latest Version License DOI

pydiq

Simple open-source multi-platform DICOM browser/viewer in Python and Qt.

NOTE This project has not been updated for a long time. Currently, I have no capacity to improve it. If you feel like contributing, I'll be happy to accept your enhancements / bug fixes. The UI seems not to be entirely working...

Vertebrae

Features

  • Easy (and fast) viewing of all images in a directory
  • Zooming (1:N and N:1)
  • Mouse control of window center and width (as in Aeskulap Viewer)
  • Proper measurement of Hounsfield units and position by mouse
  • PNG image export

To Do

  • Better zooming
  • Better MRI images support
  • RT dose images support
  • View in different planes (rectangular + others)
  • Coordinate mapping (using translation and rotation matrix)
  • Integration of anonymization features (see https://github.com/janpipek/anonymize_dicom )
  • Information from the DICOM file in user-friendly display

Dependencies

  • Python 3.6+
  • qtpy (and therefore PyQt4 / PyQt5 / PySide - not automatically installed by pip!)
  • pydicom (1.3)

Tested on Linux and Windows.

Installation

The easiest way is pip install pydiq.

Usage

Usage: pydiq [OPTIONS] [PATH]

Options:
  --help  Show this message and exit.

Limitations

Currently, the viewer supports only Computed Radiography (CR), Computed Tomography (CT) and Magnetic Resonance Imaging (MRI) images with normal orientation (x, y, z) in one-slice-per-file format.