How gstt-csc/hazen works
hazen is a Python CLI for automated MRI phantom quality assurance. A user supplies DICOM data and selects a measurement task (or a batch/protocol); the application analyzes the images and emits structured numerical results, with optional report visualizations. The map preserves ACR, MagNET, and Caliber relaxometry capabilities documented in the README. Source excerpts show the CLI, discovery, orchestration, and shared analysis layers; some task-level links are documented rather than demonstrated in the excerpts.
Main entry points: types.py Result types · __init__.py CLI entry · tasks ACR measurements · HazenTask.py Task base
Components 21
Command entry
- CLI entry
hazenlib/__init__.py - Version resolution
hazenlib/_version.py
Workflow coordination
- Data discovery
hazenlib/discovery.py - Task orchestration
hazenlib/orchestration.py - ACR protocol
hazenlib/orchestration.py - Execution timing
hazenlib/execution.py
Phantom analysis
- ACR measurements
hazenlib/tasks - MagNET measurements
hazenlib/tasks - Caliber relaxometry
hazenlib/tasks/relaxometry.py - Relaxometry parameters
hazenlib/data/relaxometry_params.py
Analysis infrastructure
- Task base
hazenlib/HazenTask.py - ACR image model
hazenlib/ACRObject.py - DICOM utilities
hazenlib/utils.py - Logging
hazenlib/logger.py - Domain errors
hazenlib/exceptions.py
Results and reporting
- Result types
hazenlib/types.py - Output formatting
hazenlib/formatters.py - Measurement constants
hazenlib/constants.py
Other components
- QA analyst
- Terminal output
- Report images
Connections 29
- QA analyst → CLI entry: selects task
README.md - CLI entry → Task orchestration: runs batch
hazenlib/__init__.py - CLI entry → ACR protocol: starts protocol
hazenlib/__init__.py - CLI entry → Execution timing: times execution
hazenlib/__init__.py - CLI entry → Version resolution: reads version
hazenlib/__init__.py - Task orchestration → Data discovery: discovers jobs
hazenlib/discovery.py - Data discovery → ACR image model: classifies images
hazenlib/discovery.py - Data discovery → DICOM utilities: reads metadata
hazenlib/discovery.py - ACR protocol → ACR measurements: dispatches tasks
hazenlib/orchestration.py - Task orchestration → Result types: aggregates results
hazenlib/orchestration.py - ACR measurements → Task base: uses base
hazenlib/tasks/acr_geometric_accuracy.py - MagNET measurements → Task base: uses base
hazenlib/tasks/ghosting.py - Caliber relaxometry → Task base: uses base
hazenlib/tasks/relaxometry.py - Caliber relaxometry → Relaxometry parameters: uses parameters
hazenlib/tasks/relaxometry.py - ACR measurements → ACR image model: analyzes phantom
hazenlib/tasks/acr_geometric_accuracy.py - ACR measurements → DICOM utilities: processes images
hazenlib/tasks/acr_slice_thickness.py - MagNET measurements → DICOM utilities: processes images
hazenlib/tasks/ghosting.py - Caliber relaxometry → DICOM utilities: processes images
hazenlib/tasks/relaxometry.py - Task base → Result types: creates results
hazenlib/HazenTask.py - ACR measurements → Result types: records measurements
hazenlib/tasks/acr_geometric_accuracy.py - MagNET measurements → Result types: records measurements
hazenlib/tasks/ghosting.py - Caliber relaxometry → Result types: records measurements
hazenlib/tasks/relaxometry.py - Result types → Output formatting: formats results
hazenlib/formatters.py - Output formatting → Terminal output: writes output
README.md - Result types → Report images: includes visuals
README.md - CLI entry → Logging: configures logging
hazenlib/__init__.py - Task base → Logging: logs input
hazenlib/HazenTask.py - Result types → Measurement constants: validates fields
hazenlib/types.py - Result types → Domain errors: raises errors
hazenlib/types.py