How echonet/dynamic works
EchoNet-Dynamic turns apical-4-chamber echocardiogram videos into left-ventricle segmentations and clip-level ejection-fraction estimates, then combines those outputs for beat-by-beat assessment of cardiac function and cardiomyopathy. The Python CLI exposes the segmentation and video-model workflows; the Echo dataset handles labels, traces, and clip sampling, while shared utilities decode videos and compute metrics. The README also documents DICOM-to-AVI preprocessing. The beat-analysis relationship is documented, but its implementation is not sampled; other unsampled wiring is omitted rather than inferred.
Main entry points: __init__.py Command-line app · echo.py Echo dataset · beat_by_beat_analysis.R Beat assessment · segmentation.py LV segmentation
Components 13
CLI and configuration
- Command-line app
echonet/__init__.py - Module entry
echonet/__main__.py - Data configuration
echonet/config.py - Package version
echonet/__version__.py
Video data
- DICOM preprocessing
scripts/ConvertDICOMToAVI.ipynb - Echo dataset
echonet/datasets/echo.py - Video I/O
echonet/utils/__init__.py
Model workflows
- LV segmentation
echonet/utils/segmentation.py - Clip EF prediction
echonet/utils/video.py
Beat analysis
- Beat assessment
scripts/beat_by_beat_analysis.R - Segmentation outputs
echonet/utils/segmentation.py - Clip EF outputs
echonet/utils/video.py
Other components
- Researcher
Connections 11
- Researcher → Command-line app: runs commands
README.md - Module entry → Command-line app: calls main
echonet/__main__.py - Command-line app → LV segmentation: registers command
echonet/__init__.py - Command-line app → Clip EF prediction: registers command
echonet/__init__.py - Echo dataset → Data configuration: uses default path
echonet/datasets/echo.py - Echo dataset → Video I/O: loads video
echonet/datasets/echo.py - Researcher → DICOM preprocessing: converts DICOM
README.md - LV segmentation → Segmentation outputs: writes documented outputs
README.md - Clip EF prediction → Clip EF outputs: writes documented outputs
README.md - Beat assessment → Segmentation outputs: reads size.csv
README.md - Beat assessment → Clip EF outputs: reads predictions
README.md