How areatu/sonoforge works
SonoForge is an offline-capable desktop echocardiography workstation for DICOM review, cardiac and Doppler measurements, AI-assisted analysis, and clinical reporting. The main user workflow is to open or retrieve an echo study, review cine frames, annotate and measure, then inspect or export results. Separate capabilities include strain analysis, synchronized multi-view review, reference-data construction, and portable presentation. The graph uses sampled orchestration and infrastructure references where available; README-described feature links without inspected implementation evidence are omitted or marked unverified.
Main entry points: app_controller.py Use-case controller · main_window.py Echo workstation · dicom_retrieve_service.py PACS services · models Clinical data models
Components 25
Desktop workflow
- Application startup
src/echo_personal_tool/main.py - Echo workstation
src/echo_personal_tool/presentation/main_window.py - Use-case controller
src/echo_personal_tool/application/app_controller.py - Frame loading
src/echo_personal_tool/application/workers/frame_loader_worker.py - Viewer state
src/echo_personal_tool/application/state_manager.py - DICOM reading
src/echo_personal_tool/infrastructure/dicom_reader.py - Multi-view review
src/echo_personal_tool/presentation/multiview_controller.py
Clinical analysis
- Clinical data models
src/echo_personal_tool/domain/models - Domain interfaces
src/echo_personal_tool/domain/ports.py - Cardiac measurements
src/echo_personal_tool/domain/calculations - Doppler analysis
src/echo_personal_tool/domain/services/doppler_calibration.py - AI segmentation
src/echo_personal_tool/domain/services/segmentation_service.py - ONNX inference
src/echo_personal_tool/infrastructure/onnx_engine.py - Strain tracking
src/echo_personal_tool/application/workers/speckle_worker.py - Study measurements
src/echo_personal_tool/application/study_measurement_session.py
DICOM connectivity
- PACS services
src/echo_personal_tool/application/services/dicom_retrieve_service.py - Study retrieval
src/echo_personal_tool/application/workers/orthanc_download_worker.py - DIMSE client
src/echo_personal_tool/infrastructure/dimse_client.py - C-MOVE receiver
src/echo_personal_tool/infrastructure/embedded_storage_scp.py
Reporting and extensions
- Clinical reporting
src/echo_personal_tool/domain/services/report_builder.py - Reference constructor
src/echo_personal_tool/constructor/constructor_widget.py - Reference storage
src/echo_personal_tool/constructor/storage/yaml_storage.py - Presenter mode
src/echo_personal_tool/__main_presenter__.py
Other components
- Clinician
- PACS server
Connections 24
- Clinician → Application startup: launches
- Application startup → Echo workstation: starts
src/echo_personal_tool/main.py - Echo workstation → Use-case controller: delegates
- Use-case controller → Frame loading: loads frames
src/echo_personal_tool/application/app_controller.py - Use-case controller → Viewer state: reads state
src/echo_personal_tool/application/app_controller.py - Frame loading → DICOM reading: decodes media
- Use-case controller → Cardiac measurements: computes results
src/echo_personal_tool/application/app_controller.py - Use-case controller → Study measurements: updates session
src/echo_personal_tool/application/app_controller.py - Use-case controller → Clinical data models: uses clinical data
src/echo_personal_tool/application/app_controller.py - Domain interfaces → Clinical data models: defines contracts
src/echo_personal_tool/domain/ports.py - ONNX inference → AI segmentation: implements inference
src/echo_personal_tool/infrastructure/onnx_engine.py - Use-case controller → AI segmentation: requests analysis
src/echo_personal_tool/application/app_controller.py - Use-case controller → Strain tracking: starts analysis
- Strain tracking → Clinical data models: produces results
src/echo_personal_tool/application/workers/speckle_worker.py - Use-case controller → Doppler analysis: calibrates Doppler
- Echo workstation → Multi-view review: offers synchronized review
- Study retrieval → PACS services: retrieves instances
src/echo_personal_tool/application/workers/orthanc_download_worker.py - PACS services → DIMSE client: uses DIMSE
src/echo_personal_tool/application/services/dicom_retrieve_service.py - PACS services → PACS server: requests studies
- DIMSE client → C-MOVE receiver: delivers C-MOVE data
- PACS server → C-MOVE receiver: sends instances
- Echo workstation → Clinical reporting: supports reporting
- Reference constructor → Reference storage: stores references
- Clinician → Presenter mode: presents studies