HEDOS Extension

HEDOS Extension contains the code developed to extend the original HEDOS workflow. It automates patient preparation from DICOM (CT, RTSTRUCT, RTDOSE), groups DICOM handling functions into a single workflow, and provides workflows for single-plan and multi-plan blood dose simulations.

Usage

Simulation and patient parameters are configured in:

settings.py

Utility functions are located in:

utils/

The file utils/organs.py contains the ORGAN_RECIPES dictionary, which maps the organ names found in the RTSTRUCT to the standard organ names expected by HEDOS. Since ROI names vary between institutions and treatment planning systems, this dictionary may need to be updated when processing data from a new source.

Two execution scripts are provided:

• run_single.py – for a single RTDOSE plan.
• run_comparison.py – for comparing multiple RTDOSE plans.

For both scripts, the only required modification is the RTDOSE file path(s). Once updated, simply execute:

python run_single.py

or

python run_comparison.py

Most figures are automatically saved instead of displayed. The only interactive visualization retained is the 3D slice viewer.

Output

Results are written to:

results/

Temporary HEDOS input files generated during DICOM conversion are written to:

input/patient/

Acknowledgements

HEDOS Extension uses the HEDOS blood dose calculation framework developed by MGH Radiation Oncology.

HEDOS repository: https://github.com/kildealab/HEDOS