Skip to main content

dicom2jpg

Converts DICOM to JPG/PNG/BMP/TIFF and numpy.ndarray

Installation

pip install dicom2jpg

Introdunction

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 numpy.ndarray for further use
img_data = dicom2jpg.dicom2img(dicom_img_01)

# 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) 

# convert DICOM ByteIO to numpy.ndarray
img_data = dicom2jpg.io2img(dicomIO)

dicom2jpg converts DICOM images to JPG/PNG/BMP/TIFF formats and to numpy.ndarray. It 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=None, multiprocessing=True, anonymous=False)

dicom2jpg.dicom2png(origin, target_root=None, multiprocessing=True, anonymous=False)

dicom2jpg.dicom2bmp(origin, target_root=None, multiprocessing=True, anonymous=False)

dicom2jpg.dicom2tiff(origin, target_root=None, multiprocessing=True, anonymous=False)

dicom2jpg.dicom2img(origin)

dicom2jpg.io2img(dicomIO)

  • 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

  • anonymous file paths are

    target_root/Today/Patient_SerialNum/ModalitySerialNum_Modality/Ser_Img.filetype

Image examples

CT MR CXR

Todo

  • Support multi-frame images
  • Image compression
  • Support overlays

Performance

  • Environment: Windows10, Jupyter Notebook, Python 3.8.10
  • 598MB 1873 files {'CT': 1528, 'CR': 52, 'MR': 174, 'DX': 36}
  • Intel(R) Core(TM) i7-7700 CPU @ 3.60GHz. 4 Cores (hyper-threading off)
  • Tested on Ramdisk (no physical HDD was tortured :P)
multiprocessing anonymous duration (seconds)
False True 154.6-159.7
True True 79.2-82.9
False False 157.9-162.8
True False 56-58.5

Metadata

Release files for dicom2jpg 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dicom2jpg 0.1.0
File Size Uploaded Provenance Actions
dicom2jpg-0.1.0.tar.gz 9.8 kB Without provenance Details for dicom2jpg-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for dicom2jpg 0.1.0
File Interpreter ABI Platform Actions
dicom2jpg-0.1.0-py3-none-any.whl Python 3 none any Details for dicom2jpg-0.1.0-py3-none-any.whl

Total release size: 19.1 kB

Release files / dicom2jpg-0.1.0.tar.gz

Download URL dicom2jpg-0.1.0.tar.gz
Size 9.8 kB
Tags Source
SHA-256 checksum
How to use checksums
23b7456dd155c7f80167f2ea146730d5cc1b1577c1d3f04bfeba53737e2d141c
BLAKE2b-256 checksum
How to use checksums
7118f13fae2d30bb0cf258ab80aedaa1c6f13993cced46a3986889f09b15c867
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.1 importlib_metadata/3.10.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.8.10

Release files / dicom2jpg-0.1.0-py3-none-any.whl

Download URL dicom2jpg-0.1.0-py3-none-any.whl
Size 9.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f5206e9f65c125d890e8034aa1c00803be80c83483feabd2b7f68f2d0596339b
BLAKE2b-256 checksum
How to use checksums
f71e2db53391f05b5a592112316e8e1a053bd5240da2ac5d778ee64c0e2468fc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.4.1 importlib_metadata/3.10.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.8.10

Security for dicom2jpg 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page