Skip to content

Improve qSPECT conversion and end-to-end validation reliability - #119

Merged
carluri merged 15 commits into
devfrom
plef-QSPECT-updates-tutorial
Aug 26, 2026
Merged

Improve qSPECT conversion and end-to-end validation reliability#119
carluri merged 15 commits into
devfrom
plef-QSPECT-updates-tutorial

Conversation

@plesqui

@plesqui plesqui commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

Summary

This PR strengthens the qSPECT DICOM conversion workflow and improves the reliability of the voxel dosimetry validation pipeline.

  • Uses RealWorldValueMappingSequence as the sole quantitative mapping for qSPECT images, preventing double scaling from conventional rescale tags.
  • Adds stricter validation and clearer errors for required DICOM metadata.
  • Normalizes Siemens and GE manufacturer values.
  • Adds an optional Siemens frame-duration fallback.
  • Corrects signed 16-bit pixel metadata after qSPECT quantization.
  • Improves injection activity decay correction and validates measurement chronology.
  • Replaces the legacy SPECT-to-SUV tutorial with an updated qSPECT workflow.
  • Updates the end-to-end validation test to use corrected RTSTRUCT assets from Zenodo.
  • Validates Zenodo downloads using expected file sizes and MD5 checksums.
  • Retries truncated RTSTRUCT and voxel-kernel downloads before failing.
  • Adds tests for qSPECT scaling, DICOM metadata handling, radioactive decay, and interrupted kernel downloads.

Testing

  • tests/test_dvk.py: 4 passed
  • Formatting checks passed.
  • git diff --check passed.
  • Run qSPECT (DicomModify) on prior data and quantification (activity in Bq/mL) per voxel was identical.

@plesqui
plesqui requested a review from carluri August 26, 2026 22:43

@carluri carluri left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you @plesqui

@carluri
carluri merged commit 726d1ec into dev Aug 26, 2026
2 checks passed
@carluri
carluri deleted the plef-QSPECT-updates-tutorial branch August 26, 2026 23:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants