dcmrtstruct2nii
DICOM RT-Struct to nii-mask. This is a naïve approach to rasterizing rt-struct to masks in nii format. If there's holes in your RT-Struct then this approach will most likely not work. The RT-Struct needs to be within the bounds of the slices of the original DICOM. Rasterization is done on a slice-by-slice basis, interpolation between slices is currently unsupported.
Interpolation
Interpolation of the mask between slices is currently unsupported. Send us an algorithm or a pull requests and we'll happly add it.
Input file format
The DICOM and RT-Struct inputs need to be unzipped in a directory. Currently this is the only way to read the input files.
CLI Tool
# install using pip and show tool help
pip install dcmrtstruct2nii
dcmrtstruct2nii --help
# list structures in DICOM RT Struct
dcmrtstruct2nii ls -r /path/to/rtstruct/file
# convert help output
dcmrtstruct2nii convert --help
# convert DICOM RT Structs to .nii.gz masks
dcmrtstruct2nii convert -r /path/to/rtstruct/file.dcm -d /path/to/original/extracted/dicom -o /output/path
Python API
# install using pip and show tool help
pip install dcmrtstruct2nii
# lets test it
from dcmrtstruct2nii import dcmrtstruct2nii, list_rt_structs
print(list_rt_structs('/path/to/dicom/rtstruct/file.dcm'))
dcmrtstruct2nii('/path/to/dicom/rtstruct/file.dcm', '/path/to/original/extracted/dicom/files', '/output/path')
License and academic use
The software is licensed MIT License.
For academic use, use a presistent copy from
Please cite:
Thomas Phil, Thomas Albrecht, Skylar Gay, & Mathis Ersted Rasmussen. (2023). Sikerdebaard/dcmrtstruct2nii: dcmrtstruct2nii v5 (Version v5). Zenodo. https://doi.org/10.5281/zenodo.4037864
1 maintainer
Metadata
1 maintainer
Release files for dcmrtstruct2nii 5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| dcmrtstruct2nii-5.tar.gz | 14.7 kB | Without provenance | Details |
Release files / dcmrtstruct2nii-5.tar.gz
| Download URL | dcmrtstruct2nii-5.tar.gz |
|---|---|
| Size | 14.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1b337b83b562843fb31d3893df03387e2944bc3674af71b08a8f7ddf2e78c99f
|
|
BLAKE2b-256 checksum How to use checksums |
20ae7faa154fb999957f67c5bb21a404de74e30985a7cbe52755ee5fa6d364a1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.10.6
|
Security for dcmrtstruct2nii 5
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.
