READII
Radiomic Extraction and Analysis for DICOM Images
A package to extract radiomic features from DICOM CT images.
Installation
$ pip install readii
(recommended) Create new pixi environment for a project
mkdir my_project
cd my_project
pixi init
pixi add --pypi readii
(recommended) Create new conda virtual environment
conda create -n readii python=3.9
conda activate readii
pip install readii
Usage
readii is a tool to perform radiomic feature extraction on DICOM CT images with region of interest (ROI) segmentations as either DICOM SEG or RTSTRUCT.
$ readii [INPUT DIRECTORY] [OUTPUT DIRECTORY] \
--roi_names [str] \
--pyradiomics_setting [str] \
--negative_controls [str: shuffled_full,shuffled_roi,shuffled_non_roi,randomized_full,randomized_roi,randomized_non_roi,randomized_sampled_full,randomized_sampled_roi, randomized_sampled_non_roi] \
--parallel [flag]
--update [flag]
Negative control options
Negative controls are applied to one of three masks:
- full = voxels in the entire image
- roi = just voxels within the specified region of interest (ROI) in the segmentation
- non_roi = all voxels except the ROI.
The three transformations are:
- shuffle = shuffle all voxels in the specified mask
- randomized = randomly generate new values within the original range within the specified mask
- randomized_sampled = randomly sample original values with replacement to get new values within the specified mask
Contributing
Please use the following angular commit message format:
<type>(optional scope): short summary in present tense
(optional body: explains motivation for the change)
(optional footer: note BREAKING CHANGES here, and issues to be closed)
<type> refers to the kind of change made and is usually one of:
feat: A new feature.fix: A bug fix.docs: Documentation changes.style: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc).refactor: A code change that neither fixes a bug nor adds a feature.perf: A code change that improves performance.test: Changes to the test framework.build: Changes to the build process or tools.
scope is an optional keyword that provides context for where the change was made. It can be anything relevant to your package or development workflow (e.g., it could be the module or function - name affected by the change).
Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.
Serve Documentation Locally
pixi run -e docs doc-serve
License
readii was created by Katy Scott. It is licensed under the terms of the MIT license.
1 maintainer
Metadata
1 maintainer
Release files for readii 1.39.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 | |
|---|---|---|---|
| readii-1.39.0.tar.gz | 51.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| readii-1.39.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 118.2 kB
Release files / readii-1.39.0.tar.gz
| Download URL | readii-1.39.0.tar.gz |
|---|---|
| Size | 51.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f541d2cf3582896a908a35c9789fceda80180437647480b96fecc4cfefe71ffa
|
|
BLAKE2b-256 checksum How to use checksums |
5ffe006669166efa5cd70aa82d2ce673c962cb83649edbee9835dc055588f9d1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
Hatch/1.16.5 cpython/3.12.13 HTTPX/0.28.1
|
Release files / readii-1.39.0-py3-none-any.whl
| Download URL | readii-1.39.0-py3-none-any.whl |
|---|---|
| Size | 66.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d6ce5561aac8731a04bc6be6743d216cfc617bf1d59fd49cbd3f3b3f174a1381
|
|
BLAKE2b-256 checksum How to use checksums |
8f2e1841dc5ea85b40cad066461f92a52ee5aa6b500f064a02776590b944bf79
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
Hatch/1.16.5 cpython/3.12.13 HTTPX/0.28.1
|
