dicom2jpg 0.0.7

DICOM -> JPG/PNG/BMP

dicom2jpg

Converts DICOM to JPG/PNG/BMP

import dicom2jpg

dicom_img_01 = "/Users/user/Desktop/img01.dcm"
dicom_dir = "/Users/user/Desktop/Patient_01"
export_location = "/Users/user/Desktop/BMP_files"

# convert single DICOM file to jpg format
dicom2jpg.dicom2jpg(dicom_img_01)  

# convert all DICOM files in dicom_dir folder to png format
dicom2jpg.dicom2png(dicom_dir)  

# convert all DICOM files in dicom_dir folder to bmp, to a specified location
dicom2jpg.dicom2bmp(dicom_dir, target_root=export_location) 

dicom2jpg converts DICOM images to JPG/PNG/BMP formats. It also applies window center(level) and window width adjustment, or VOI LUT function to the images, which makes output files looks like what we see on standard DICOM viewers.

dicom2jpg.dicom2jpg(origin, target_root)

dicom2jpg.dicom2png(origin, target_root)

dicom2jpg.dicom2bmp(origin, target_root)

• origin can be a single DICOM file or folder contains DICOM files
• target_root is would be the same root folder of the origin if not specified
• exported files will be in target_root/Today/PatientID_filetype/StudyDate_StudyTime_Modality_AccNum/Ser_Img.filetype

Image examples

CT	MR	CXR

Installation

pip install dicom2jpg

Known issue

• converting multi-frame such as fluoroscopic image array would result in error

error: OpenCV(4.0.1) C:\ci\opencv-suite_1573470242804\work\modules\imgcodecs\src\loadsave.cpp:667: error: (-215:Assertion failed) image.channels() == 1 || image.channels() == 3 || image.channels() == 4 in function 'cv::imwrite_'

Todo

• Multiprocessing for speeding up
• Support multi-frame images
• Support TIFF format