Read and extract images from a DICOM file using GDCM
Project description
mudicom
A python package that validates, reads, and extracts images from a DICOM file.
Requirements
Base:
Python <= 2.7
GDCM with python wrapper (https://github.com/neurosnap/mudicom/blob/master/docs/install.rst)
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
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()
# creates image object
img = mu.image()
# returns numpy array
img.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 https://github.com/neurosnap/mudicom/tree/master/docs (temporary)
Roadmap
Extract multiple images from one single DICOM file
Publish documentation online
Credits
Written by Eric Bower
Special thanks to Mathieu Malaterre (primary developer for GDCM), of whom without this package would not be possible.
Change Log
v0.0.6, 09-08-2014
Updated README for clarity
Created bried roadmap
v0.0.5, 08-14-2014
Updated MANIFEST.in to include .rst, I’m a dumbass
v0.0.4, 08-14-2014
Removed LICENSE.rst from setup.py
v0.0.3, 08-14-2014
PIP cannot read LICENSE.rst for some reason
v0.0.3, 08-14-2014
Weird permission issues with the egg
v0.0.2, 08-14-2014
Updated packaging description
v0.0.1, 04-04-2014
Initial release.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.