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)
| File | Size | Uploaded | |
|---|---|---|---|
| dicom_image_tools-25.0.0.tar.gz | 39.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|