How q-cardia/qcardia works
qcardia is a cardiac-MR analysis package family: data preparation and model components support training, while qcardia classifies and disambiguates DICOM series, builds series objects, and runs inference. The desktop app loads a study, presents series in configurable cardiac-MR layouts, and displays analysis and segmentation results. README statements establish package-level dependencies; sampled source supports several app calls. Some documented app capabilities have unsampled implementations, so their internal links are omitted.
Main entry points: dicom_model.py DICOM study model · dicom_controller.py Study controller · series.py Series loading and inference · main.py App startup and sessions
Components 26
Training data
- Dataset setup
packages/qcardia-data/src/qcardia_data/setup - Dataset reformatting
packages/qcardia-data/src/qcardia_data/setup/reformat/reformat.py - Data splitting
packages/qcardia-data/src/qcardia_data/pipeline/data_split.py - Transforms and caching
packages/qcardia-data/src/qcardia_data/pipeline - Data prediction pipeline
packages/qcardia-data/src/qcardia_data/pipeline/data_predictor.py
Training models
- Model architectures
packages/qcardia-models/src/qcardia_models/models/networks/u_net2d.py - Network building blocks
packages/qcardia-models/src/qcardia_models/models/building_blocks.py - Losses and metrics
packages/qcardia-models/src/qcardia_models/losses
Analysis and inference
- CardiSort classification
packages/qcardia/src/qcardia/cardisort.py - Series disambiguation
packages/qcardia/src/qcardia/disambiguate.py - Series loading and inference
packages/qcardia/src/qcardia/series.py - Inference configuration
packages/qcardia/src/qcardia/inference
Desktop viewer
- App startup and sessions
packages/qcardia-app/src/qcardia_app/main.py - Study configuration
packages/qcardia-app/src/qcardia_app/utils/app_config.py - Study controller
packages/qcardia-app/src/qcardia_app/controllers/dicom_controller.py - Background worker
packages/qcardia-app/src/qcardia_app/model/background_worker.py - DICOM study model
packages/qcardia-app/src/qcardia_app/model/dicom_model.py - Hanging protocols
packages/qcardia-app/src/qcardia_app/utils/hanging_protocols.py - Study logging
packages/qcardia-app/src/qcardia_app/utils/study_log.py
Viewer interface
- Main window
packages/qcardia-app/src/qcardia_app/view/main_window.py - Series browser
packages/qcardia-app/src/qcardia_app/view/series_browser_widget.py - Image display area
packages/qcardia-app/src/qcardia_app/view/central_display_area_widget.py - Image interaction
packages/qcardia-app/src/qcardia_app/view/custom_graphics_view.py - Cardiac-MR viewing
packages/qcardia-app/src/qcardia_app/view
Other components
- Trained weights
- Viewer user
Connections 31
- Dataset setup → Dataset reformatting: prepares datasets
packages/qcardia-data/src/qcardia_data/setup/reformat/reformat.py - Dataset reformatting → Transforms and caching: reformats data
- Data splitting → Data prediction pipeline: splits data
packages/qcardia-data/src/qcardia_data/pipeline/data_predictor.py - Transforms and caching → Data prediction pipeline: transforms data
packages/qcardia-data/src/qcardia_data/pipeline/data_predictor.py - Model architectures → Network building blocks: uses blocks
packages/qcardia-models/src/qcardia_models/models/networks/u_net2d.py - Transforms and caching → Trained weights: supports training
- Model architectures → Trained weights: supports training
- Losses and metrics → Trained weights: supports training
- Trained weights → CardiSort classification: provides weights
- CardiSort classification → Series disambiguation: classifies candidates
packages/qcardia/src/qcardia/disambiguate.py - Series disambiguation → Series loading and inference: resolves series
packages/qcardia/run.py - Trained weights → Series loading and inference: provides weights
- Inference configuration → Series loading and inference: configures inference
packages/qcardia/src/qcardia/series.py - Viewer user → Main window: starts study
- App startup and sessions → Main window: creates window
packages/qcardia-app/src/qcardia_app/main.py - App startup and sessions → Study controller: creates controller
packages/qcardia-app/src/qcardia_app/main.py - App startup and sessions → DICOM study model: creates model
packages/qcardia-app/src/qcardia_app/main.py - App startup and sessions → Study logging: starts session logs
packages/qcardia-app/src/qcardia_app/main.py - Study controller → Background worker: starts load worker
packages/qcardia-app/src/qcardia_app/controllers/dicom_controller.py - Background worker → DICOM study model: calls load patient
packages/qcardia-app/src/qcardia_app/controllers/dicom_controller.py - DICOM study model → CardiSort classification: classifies studies
packages/qcardia-app/src/qcardia_app/model/dicom_model.py - DICOM study model → Series disambiguation: resolves candidates
packages/qcardia-app/src/qcardia_app/model/dicom_model.py - DICOM study model → Series loading and inference: loads and analyzes
packages/qcardia-app/src/qcardia_app/model/dicom_model.py - Study controller → Study logging: records load events
packages/qcardia-app/src/qcardia_app/controllers/dicom_controller.py - Study controller → Image display area: updates display
packages/qcardia-app/src/qcardia_app/controllers/dicom_controller.py - Study controller → Series browser: builds browser cards
packages/qcardia-app/src/qcardia_app/controllers/dicom_controller.py - Main window → Series browser: hosts browser
packages/qcardia-app/src/qcardia_app/view/main_window.py - Image display area → Hanging protocols: uses presets
packages/qcardia-app/src/qcardia_app/view/central_display_area_widget.py - Image display area → Image interaction: renders panels
packages/qcardia-app/src/qcardia_app/view/central_display_area_widget.py - Main window → Cardiac-MR viewing: presents viewing tools
packages/qcardia-app/src/qcardia_app/view/main_window.py - Series loading and inference → DICOM study model: feeds viewer
packages/qcardia-app/src/qcardia_app/model/dicom_model.py