CardioForm v0.2.2 - Hotfix for Segmentation Label Handling

Release Notes: v0.2.2

Tag: v0.2.2
Title: CardioForm v0.2.2 - Hotfix for Segmentation Label Handling

Note: This release provides the CPU-only Docker images (cemrg/cardio-form:0.2.2, latest). The automated build for the GPU image remains temporarily disabled due to CI/CD resource limitations.

This release includes a critical bug fix for label map handling and maintains the core features of the v0.2.x series.

🚀 Major Features & Enhancements

• Full Docker Support: The entire pipeline is available as a universal CPU-based Docker container.
• New Command-Line Interface: A master entrypoint provides a clean, unified command-line interface with modes like segment, reconstruct, full, etc.
• User-Friendly Docker Wrapper: A run-docker.sh script simplifies running the container, automatically handling volume mounts and user permissions.
• Automated Builds with GitHub Actions: The CPU Docker image is automatically built and pushed to Docker Hub on release.
• Online Model Management: Lightweight Docker images are enabled by downloading models on first run.

🐛 Bug Fixes

• [Hotfix] Fixed a bug in filter_labels and merge_labels where segmentation data was not correctly handled as an integer type, potentially causing errors during label comparisons. (Commit 2e54aa2)
• Fixed an issue in the Docker entrypoint where modes were not being dispatched correctly. (Commit 3047e8b)

How to Use

1. Pull the Docker Image:

   # For CPU-only execution (works everywhere)
   docker pull cemrg/cardio-form:latest
   docker pull cemrg/cardio-form:0.2.2

2. Run via the Wrapper Script:

   ./run-docker.sh /path/to/my/subject001/ full \
       --input-dir /data \
       --output-dir /data/outputs \
       --output-prefix "subject001_run1"