Skip to main content

ci codecov

Dicom Image Tools

The dicom image tools package was created for giving a framework handling DICOM image data. Adding functionality often used for programmatic image analysis.

The package is still in early development and more features will be added.

Install Dicom Image Tools

Install using pipenv by running:

$ pipenv install dicom-image-tools

Install using pip by running:

$ pip install dicom-image-tools

Only Python 3.10+ is supported.

See project wiki for more detailed documentation

Usage

When you've installed the package you import it as any other package using

import dicom_image_tools 

Importing DICOM images

There are two functions for importing DICOM images, import_dicom_file(file: pathlib.Path) and import_dicom_from_folder(folder: pathlib.Path, recursively: bool = True).

The latter function has an optional input argument for specifying if the folder given should be searched for DICOM files recursively, default = True

Both will return the image/-s in DicomStudy objects, the import_dicom_from_folder function returns a dictionary with the Study Instance UID as the key and the corresponding DicomStudy object as value.

You can then add additional files to the DicomStudy object through the DicomStudy.add_file which takes the file path as a pathlib.Path object as input.

The DicomStudy.Series is a list of all series belonging to the study that has been imported. Each DicomStudy.Series item is an object containing the image/image volume and metadata for each image. The image/image volume is accessed through the ImageVolume attribute of the DicomStudy.Series item, and the metadata in the CompleteMetadata attribute.

Metadata

Release files for dicom_image_tools 25.0.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 dicom_image_tools 25.0.0
File Size Uploaded
dicom_image_tools-25.0.0.tar.gz 39.4 kB Details

Built distribution (wheel)

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

Total release size: 89.1 kB

Release files / dicom_image_tools-25.0.0.tar.gz

Download URL dicom_image_tools-25.0.0.tar.gz
Size 39.4 kB
Tags Source
SHA-256 checksum
How to use checksums
90da104b0afe5918d01abbb5738ef710218d9c773286633ebf108739ae7568d7
BLAKE2b-256 checksum
How to use checksums
266708e95ce46af99939fe54de972d01bc307c58884c206f7436ebaea5931d0a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.7.7

Release files / dicom_image_tools-25.0.0-py3-none-any.whl

Download URL dicom_image_tools-25.0.0-py3-none-any.whl
Size 49.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d4867bfbd2201aae9ad24ffbd6f3d61f786ea4ba133978ee959f1e26ccec66e8
BLAKE2b-256 checksum
How to use checksums
0b1ab649321dbd0e1ce93bbc6ce740041ac54bb5f515ee25476e95871adc558c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.7.7

Release history Release notifications | RSS feed

This release

25.0.0 This release

2 release files

24.2.1

2 release files

24.2.0

2 release files

23.3.0

2 release files

23.1.4

2 release files

23.1.3

2 release files

23.1.2

2 release files

23.1.1

2 release files

22.3.2

2 release files

22.3.1

2 release files

20.2.0

2 release files

20.1.1

2 release files

20.1.0

2 release files

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