https://github.com/neurosnap/mudicom

A python package that validates, reads, and extracts images from a DICOM file
https://github.com/neurosnap/mudicom

Last synced: about 1 month ago
JSON representation

A python package that validates, reads, and extracts images from a DICOM file

• Host: GitHub
• URL: https://github.com/neurosnap/mudicom
• Owner: neurosnap
• License: mit
• Created: 2014-04-04T15:17:16.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2022-06-21T21:13:23.000Z (over 2 years ago)
• Last Synced: 2024-10-29T20:57:55.428Z (about 2 months ago)
• Language: Python
• Homepage:
• Size: 10.2 MB
• Stars: 33
• Watchers: 3
• Forks: 14
• Open Issues: 4
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES.rst
  • License: LICENSE.rst

Awesome Lists containing this project

• awesome-medphys - mudicom -  A light-weight python package that validates, reads, and extracts images from a DICOM file. (Libraries)

README

        

mudicom

=======

A light-weight python package that validates, reads, and extracts images from a DICOM file.

Requirements

------------

Base:

- Python <= 2.7 (Should work with Python 3 but I haven't tested it)

- GDCM with python wrapper (http://mudicom.dcmdb.org/install.html)

Validator:

- dicom3tools (http://www.dclunie.com/dicom3tools.html)

Image:

- numpy (http://www.numpy.org/)

- PIL (https://github.com/python-pillow/Pillow); or

- Matplotlib (http://matplotlib.org/)

Quick How To

------------

.. code:: python

    import mudicom

    mu = mudicom.load("mudicom/tests/dicoms/ex1.dcm")

    # returns array of data elements as dicts

    mu.read()

    # returns dict of errors and warnings for DICOM

    mu.validate()

    # basic anonymization

    mu.anonymize()

    # save anonymization

    mu.save_as("dicom.dcm")

    # creates image object

    img = mu.image # before v0.1.0 this was mu.image()

    # returns numpy array

    img.numpy # before v0.1.0 this was mu.numpy()

    # using Pillow, saves DICOM image

    img.save_as_pil("ex1.jpg")

    # using matplotlib, saves DICOM image

    img.save_as_plt("ex1_2.jpg")

Documentation

-------------

Full documentation is available at http://mudicom.dcmdb.org/

Roadmap

-------

- Extract multiple images from one single DICOM file

- Detect corrupted DICOM files

- Ability to anonymize DICOM file

- Ability to set data elements

Credits

-------

Written by Eric Bower

Special thanks to `Mathieu Malaterre`_ (primary developer for GDCM),

of whom without this package would not be possible.

.. _Mathieu Malaterre: https://github.com/malaterre