cardio 2025.10.0__tar.gz → 2025.12.0__tar.gz

{cardio-2025.10.0 → cardio-2025.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: cardio
-Version: 2025.10.0
+Version: 2025.12.0
 Summary: A simple web-based viewer for 3D and 4D ('cine') medical imaging data.
 Keywords: Medical,Imaging,3D,4D,Visualization
 Author: Davis Marc Vigneault
@@ -59,12 +59,11 @@ Description-Content-Type: text/markdown
 `cardio` is a simple web-based viewer for 3D and 4D ('cine') medical imaging data,
 built primarily on [trame](https://github.com/kitware/trame),
 [vtk](https://github.com/kitware/vtk), and
-[itk](https://github.com/insightsoftwareconsortium/itk).  `cardio` is able to
-render sequences of mesh files (e.g., `\*.obj` files), segmentation files (e.g.
-`\*nii.gz` files with discrete labels) and volume renderings of grayscale images
-(e.g. \*.nii.gz files with continuous values).  `cardio` is launched from the
-commandline and may be configured either directly from the commandline, via a static
-TOML configuration file, or a combination of the two.
+[itk](https://github.com/insightsoftwareconsortium/itk).  `cardio` can render sequences
+of mesh files (e.g., `\*.obj` files), segmentation files (e.g., `\*nii.gz` files with
+discrete labels) and volume renderings of grayscale images (e.g., `\*.nii.gz` files with
+continuous values).  `cardio` is launched from the commandline and may be configured via
+commandline arguments, a static TOML configuration file, or a combination of the two.
 
 ## Quickstart
 
@@ -76,7 +75,7 @@ $ uv init
 $ uv add cardio
 $ . ./.venv/bin/activate
 (project) cardio --version
-cardio 2025.10.0
+cardio 2025.12.0
 ```
 
 ### Developing

{cardio-2025.10.0 → cardio-2025.12.0}/README.md

@@ -3,12 +3,11 @@
 `cardio` is a simple web-based viewer for 3D and 4D ('cine') medical imaging data,
 built primarily on [trame](https://github.com/kitware/trame),
 [vtk](https://github.com/kitware/vtk), and
-[itk](https://github.com/insightsoftwareconsortium/itk).  `cardio` is able to
-render sequences of mesh files (e.g., `\*.obj` files), segmentation files (e.g.
-`\*nii.gz` files with discrete labels) and volume renderings of grayscale images
-(e.g. \*.nii.gz files with continuous values).  `cardio` is launched from the
-commandline and may be configured either directly from the commandline, via a static
-TOML configuration file, or a combination of the two.
+[itk](https://github.com/insightsoftwareconsortium/itk).  `cardio` can render sequences
+of mesh files (e.g., `\*.obj` files), segmentation files (e.g., `\*nii.gz` files with
+discrete labels) and volume renderings of grayscale images (e.g., `\*.nii.gz` files with
+continuous values).  `cardio` is launched from the commandline and may be configured via
+commandline arguments, a static TOML configuration file, or a combination of the two.
 
 ## Quickstart
 
@@ -20,7 +19,7 @@ $ uv init
 $ uv add cardio
 $ . ./.venv/bin/activate
 (project) cardio --version
-cardio 2025.10.0
+cardio 2025.12.0
 ```
 
 ### Developing

{cardio-2025.10.0 → cardio-2025.12.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "cardio"
-version = "2025.10.0"
+version = "2025.12.0"
 authors = [
     {name = "Davis Marc Vigneault", email = "davis.vigneault@gmail.com"}
 ]
@@ -62,7 +62,7 @@ repository = "https://github.com/sudomakeinstall/cardio"
 profile = "black"
 
 [tool.bumpver]
-current_version = "2025.10.0"
+current_version = "2025.12.0"
 version_pattern = "YYYY.MM.INC0"
 commit_message = "ENH: Bump version from {old_version} => {new_version}"
 commit = true

{cardio-2025.10.0 → cardio-2025.12.0}/src/cardio/__init__.py

@@ -26,4 +26,4 @@ __all__ = [
     "window_level",
 ]
 
-__version__ = "2025.10.0"
+__version__ = "2025.12.0"

{cardio-2025.10.0 → cardio-2025.12.0}/src/cardio/app.py

@@ -1,11 +1,9 @@
 #!/usr/bin/env python
 
-# Third Party
 import pydantic_settings as ps
 import trame as tm
 import trame.decorators
 
-# Internal
 from . import __version__
 from .logic import Logic
 from .scene import Scene

{cardio-2025.10.0 → cardio-2025.12.0}/src/cardio/blend_transfer_functions.py

@@ -1,7 +1,4 @@
-# System
 import numpy as np
-
-# Third Party
 import vtk
 
 

{cardio-2025.10.0 → cardio-2025.12.0}/src/cardio/color_transfer_function.py

@@ -1,8 +1,6 @@
-# Third Party
 import pydantic as pc
 import vtk
 
-# Internal
 from .types import RGBColor
 
 

{cardio-2025.10.0 → cardio-2025.12.0}/src/cardio/logic.py

@@ -8,6 +8,18 @@ from .screenshot import Screenshot
 
 
 class Logic:
+    def _get_visible_rotation_data(self):
+        """Get rotation sequence and angles for visible rotations only."""
+        rotation_sequence = getattr(self.server.state, "mpr_rotation_sequence", [])
+        rotation_angles = {}
+        for i in range(len(rotation_sequence)):
+            is_visible = getattr(self.server.state, f"mpr_rotation_visible_{i}", True)
+            if is_visible:
+                rotation_angles[i] = getattr(
+                    self.server.state, f"mpr_rotation_angle_{i}", 0
+                )
+        return rotation_sequence, rotation_angles
+
     def __init__(self, server, scene: Scene):
         self.server = server
         self.scene = scene
@@ -27,18 +39,17 @@ class Logic:
             {"text": "Radians", "value": "radians"},
         ]
 
-        # Initialize slice bounds (will be updated when active volume changes)
-        self.server.state.axial_slice_bounds = [0.0, 100.0]
-        self.server.state.sagittal_slice_bounds = [0.0, 100.0]
-        self.server.state.coronal_slice_bounds = [0.0, 100.0]
+        # Initialize MPR origin (will be updated when active volume changes)
+        self.server.state.mpr_origin = [0.0, 0.0, 0.0]
+        self.server.state.mpr_crosshairs_enabled = self.scene.mpr_crosshairs_enabled
 
         self.server.state.change("frame")(self.update_frame)
         self.server.state.change("playing")(self.play)
         self.server.state.change("theme_mode")(self.sync_background_color)
-        self.server.state.change("mpr_enabled")(self.sync_mpr_mode)
         self.server.state.change("active_volume_label")(self.sync_active_volume)
-        self.server.state.change("axial_slice", "sagittal_slice", "coronal_slice")(
-            self.update_slice_positions
+        self.server.state.change("mpr_origin")(self.update_slice_positions)
+        self.server.state.change("mpr_crosshairs_enabled")(
+            self.sync_crosshairs_visibility
         )
         self.server.state.change("mpr_window", "mpr_level")(
             self.update_mpr_window_level
@@ -140,6 +151,9 @@ class Logic:
         self.server.controller.save_rotation_angles = self.save_rotation_angles
         self.server.controller.reset_all = self.reset_all
         self.server.controller.close_application = self.close_application
+        self.server.controller.finalize_mpr_initialization = (
+            self.finalize_mpr_initialization
+        )
 
         # MPR rotation controllers
         self.server.controller.add_x_rotation = lambda: self.add_mpr_rotation("X")
@@ -150,10 +164,15 @@ class Logic:
 
         # Initialize MPR state
         self.server.state.mpr_enabled = self.scene.mpr_enabled
-        self.server.state.active_volume_label = self.scene.active_volume_label
-        self.server.state.axial_slice = self.scene.axial_slice
-        self.server.state.sagittal_slice = self.scene.sagittal_slice
-        self.server.state.coronal_slice = self.scene.coronal_slice
+        # Initialize active_volume_label to empty string (actual value set after UI ready)
+        self.server.state.active_volume_label = ""
+        # Store the actual volume label to set later, avoiding race condition
+        self._pending_active_volume = (
+            self.scene.volumes[0].label
+            if self.scene.volumes and not self.scene.active_volume_label
+            else self.scene.active_volume_label
+        )
+        self.server.state.mpr_origin = list(self.scene.mpr_origin)
         self.server.state.mpr_window = self.scene.mpr_window
         self.server.state.mpr_level = self.scene.mpr_level
         self.server.state.mpr_window_level_preset = self.scene.mpr_window_level_preset
@@ -236,6 +255,10 @@ class Logic:
         # Get or create MPR actors for the new frame
         mpr_actors = active_volume.get_mpr_actors_for_frame(frame)
 
+        # Get crosshair visibility state
+        crosshairs_visible = getattr(self.server.state, "mpr_crosshairs_enabled", True)
+        crosshairs = active_volume.crosshair_actors
+
         # Update each MPR renderer with the new frame's actors
         if self.scene.axial_renderWindow:
             axial_renderer = (
@@ -245,8 +268,11 @@ class Logic:
                 axial_renderer.RemoveAllViewProps()
                 axial_renderer.AddActor(mpr_actors["axial"]["actor"])
                 mpr_actors["axial"]["actor"].SetVisibility(True)
-                # Apply current slice position and window/level
-                self._apply_current_mpr_settings(active_volume, frame)
+                # Re-add crosshairs
+                if crosshairs and "axial" in crosshairs:
+                    for line_data in crosshairs["axial"].values():
+                        axial_renderer.AddActor2D(line_data["actor"])
+                        line_data["actor"].SetVisibility(crosshairs_visible)
                 axial_renderer.ResetCamera()
 
         if self.scene.coronal_renderWindow:
@@ -257,6 +283,11 @@ class Logic:
                 coronal_renderer.RemoveAllViewProps()
                 coronal_renderer.AddActor(mpr_actors["coronal"]["actor"])
                 mpr_actors["coronal"]["actor"].SetVisibility(True)
+                # Re-add crosshairs
+                if crosshairs and "coronal" in crosshairs:
+                    for line_data in crosshairs["coronal"].values():
+                        coronal_renderer.AddActor2D(line_data["actor"])
+                        line_data["actor"].SetVisibility(crosshairs_visible)
                 coronal_renderer.ResetCamera()
 
         if self.scene.sagittal_renderWindow:
@@ -267,28 +298,25 @@ class Logic:
                 sagittal_renderer.RemoveAllViewProps()
                 sagittal_renderer.AddActor(mpr_actors["sagittal"]["actor"])
                 mpr_actors["sagittal"]["actor"].SetVisibility(True)
+                # Re-add crosshairs
+                if crosshairs and "sagittal" in crosshairs:
+                    for line_data in crosshairs["sagittal"].values():
+                        sagittal_renderer.AddActor2D(line_data["actor"])
+                        line_data["actor"].SetVisibility(crosshairs_visible)
                 sagittal_renderer.ResetCamera()
 
+        # Apply current slice position and window/level to all views
+        self._apply_current_mpr_settings(active_volume, frame)
+
     def _apply_current_mpr_settings(self, active_volume, frame):
         """Apply current slice positions and window/level to MPR actors."""
         # Apply slice positions
-        axial_slice = getattr(self.server.state, "axial_slice", 0.5)
-        sagittal_slice = getattr(self.server.state, "sagittal_slice", 0.5)
-        coronal_slice = getattr(self.server.state, "coronal_slice", 0.5)
-
-        # Get rotation data
-        rotation_sequence = getattr(self.server.state, "mpr_rotation_sequence", [])
-        rotation_angles = {}
-        for i in range(len(rotation_sequence)):
-            rotation_angles[i] = getattr(
-                self.server.state, f"mpr_rotation_angle_{i}", 0
-            )
+        origin = getattr(self.server.state, "mpr_origin", [0.0, 0.0, 0.0])
+        rotation_sequence, rotation_angles = self._get_visible_rotation_data()
 
         active_volume.update_slice_positions(
             frame,
-            axial_slice,
-            sagittal_slice,
-            coronal_slice,
+            origin,
             rotation_sequence,
             rotation_angles,
         )
@@ -491,12 +519,13 @@ class Logic:
         metadata["volume_label"] = active_volume_label
         doc["metadata"] = metadata
 
-        # Slice positions section
-        slice_positions = tk.table()
-        slice_positions["axial"] = getattr(self.server.state, "axial_slice", 0.5)
-        slice_positions["sagittal"] = getattr(self.server.state, "sagittal_slice", 0.5)
-        slice_positions["coronal"] = getattr(self.server.state, "coronal_slice", 0.5)
-        doc["slice_positions"] = slice_positions
+        # Origin position section
+        origin = getattr(self.server.state, "mpr_origin", [0.0, 0.0, 0.0])
+        origin_table = tk.table()
+        origin_table["x"] = origin[0]
+        origin_table["y"] = origin[1]
+        origin_table["z"] = origin[2]
+        doc["origin"] = origin_table
 
         # Rotations section (array of tables)
         rotation_sequence = getattr(self.server.state, "mpr_rotation_sequence", [])
@@ -633,32 +662,32 @@ class Logic:
         if not active_volume:
             return
 
-        # Update slice bounds based on active volume
+        # Initialize origin to volume center (in LPS coordinates)
         try:
-            bounds = active_volume.get_physical_bounds()
-            self.server.state.axial_slice_bounds = [bounds[4], bounds[5]]  # Z bounds
-            self.server.state.sagittal_slice_bounds = [bounds[0], bounds[1]]  # X bounds
-            self.server.state.coronal_slice_bounds = [bounds[2], bounds[3]]  # Y bounds
-
-            # Initialize slice positions to volume center if they are currently 0.0 (scene defaults)
-            if self.server.state.axial_slice == 0.0:
-                self.server.state.axial_slice = (bounds[4] + bounds[5]) / 2  # Z center
-            if self.server.state.sagittal_slice == 0.0:
-                self.server.state.sagittal_slice = (
-                    bounds[0] + bounds[1]
-                ) / 2  # X center
-            if self.server.state.coronal_slice == 0.0:
-                self.server.state.coronal_slice = (
-                    bounds[2] + bounds[3]
-                ) / 2  # Y center
+            current_frame = getattr(self.server.state, "frame", 0)
+            volume_actor = active_volume.actors[current_frame]
+            image_data = volume_actor.GetMapper().GetInput()
+            center = image_data.GetCenter()
+
+            # Set origin to volume center if it's at default [0,0,0]
+            current_origin = getattr(self.server.state, "mpr_origin", [0.0, 0.0, 0.0])
+            if current_origin == [0.0, 0.0, 0.0]:
+                self.server.state.mpr_origin = list(center)
         except (RuntimeError, IndexError) as e:
-            print(f"Error: Cannot get bounds for volume '{active_volume_label}': {e}")
+            print(f"Error: Cannot get center for volume '{active_volume_label}': {e}")
             return
 
         # Create MPR actors for current frame
         current_frame = getattr(self.server.state, "frame", 0)
         mpr_actors = active_volume.get_mpr_actors_for_frame(current_frame)
 
+        # Create crosshair actors
+        crosshairs = active_volume.create_crosshair_actors(
+            colors=self.scene.mpr_crosshair_colors,
+            line_width=self.scene.mpr_crosshair_width,
+        )
+        crosshairs_visible = getattr(self.server.state, "mpr_crosshairs_enabled", True)
+
         # Add MPR actors to their respective renderers
         if self.scene.axial_renderWindow:
             axial_renderer = (
@@ -668,6 +697,10 @@ class Logic:
                 axial_renderer.RemoveAllViewProps()  # Clear existing actors
                 axial_renderer.AddActor(mpr_actors["axial"]["actor"])
                 mpr_actors["axial"]["actor"].SetVisibility(True)
+                # Add 2D crosshair overlay actors
+                for line_data in crosshairs["axial"].values():
+                    axial_renderer.AddActor2D(line_data["actor"])
+                    line_data["actor"].SetVisibility(crosshairs_visible)
                 axial_renderer.ResetCamera()
 
         if self.scene.coronal_renderWindow:
@@ -678,6 +711,10 @@ class Logic:
                 coronal_renderer.RemoveAllViewProps()
                 coronal_renderer.AddActor(mpr_actors["coronal"]["actor"])
                 mpr_actors["coronal"]["actor"].SetVisibility(True)
+                # Add 2D crosshair overlay actors
+                for line_data in crosshairs["coronal"].values():
+                    coronal_renderer.AddActor2D(line_data["actor"])
+                    line_data["actor"].SetVisibility(crosshairs_visible)
                 coronal_renderer.ResetCamera()
 
         if self.scene.sagittal_renderWindow:
@@ -688,6 +725,10 @@ class Logic:
                 sagittal_renderer.RemoveAllViewProps()
                 sagittal_renderer.AddActor(mpr_actors["sagittal"]["actor"])
                 mpr_actors["sagittal"]["actor"].SetVisibility(True)
+                # Add 2D crosshair overlay actors
+                for line_data in crosshairs["sagittal"].values():
+                    sagittal_renderer.AddActor2D(line_data["actor"])
+                    line_data["actor"].SetVisibility(crosshairs_visible)
                 sagittal_renderer.ResetCamera()
 
         # Apply current window/level settings to the MPR actors
@@ -718,26 +759,16 @@ class Logic:
         if not active_volume:
             return
 
-        # Get current slice positions
-        axial_slice = getattr(self.server.state, "axial_slice", 0.5)
-        sagittal_slice = getattr(self.server.state, "sagittal_slice", 0.5)
-        coronal_slice = getattr(self.server.state, "coronal_slice", 0.5)
+        # Get current origin and frame
+        origin = getattr(self.server.state, "mpr_origin", [0.0, 0.0, 0.0])
         current_frame = getattr(self.server.state, "frame", 0)
 
-        # Get rotation data
-        rotation_sequence = getattr(self.server.state, "mpr_rotation_sequence", [])
-        rotation_angles = {}
-        for i in range(len(rotation_sequence)):
-            rotation_angles[i] = getattr(
-                self.server.state, f"mpr_rotation_angle_{i}", 0
-            )
+        rotation_sequence, rotation_angles = self._get_visible_rotation_data()
 
         # Update slice positions with rotation
         active_volume.update_slice_positions(
             current_frame,
-            axial_slice,
-            sagittal_slice,
-            coronal_slice,
+            origin,
             rotation_sequence,
             rotation_angles,
         )
@@ -826,30 +857,16 @@ class Logic:
         if not active_volume:
             return
 
-        # Get current slice positions
-        axial_slice = getattr(self.server.state, "axial_slice", 0.5)
-        sagittal_slice = getattr(self.server.state, "sagittal_slice", 0.5)
-        coronal_slice = getattr(self.server.state, "coronal_slice", 0.5)
+        # Get current origin and frame
+        origin = getattr(self.server.state, "mpr_origin", [0.0, 0.0, 0.0])
         current_frame = getattr(self.server.state, "frame", 0)
 
-        # Get rotation data - include all visible rotations
-        rotation_sequence = getattr(self.server.state, "mpr_rotation_sequence", [])
-        rotation_angles = {}
-
-        # Include all visible rotations regardless of position
-        for i in range(len(rotation_sequence)):
-            is_visible = getattr(self.server.state, f"mpr_rotation_visible_{i}", True)
-            if is_visible:
-                rotation_angles[i] = getattr(
-                    self.server.state, f"mpr_rotation_angle_{i}", 0
-                )
+        rotation_sequence, rotation_angles = self._get_visible_rotation_data()
 
         # Update slice positions with rotation
         active_volume.update_slice_positions(
             current_frame,
-            axial_slice,
-            sagittal_slice,
-            coronal_slice,
+            origin,
             rotation_sequence,
             rotation_angles,
         )
@@ -857,6 +874,29 @@ class Logic:
         # Update all views
         self.server.controller.view_update()
 
+    def sync_crosshairs_visibility(self, **kwargs):
+        """Toggle crosshair visibility on all MPR views."""
+        if not getattr(self.server.state, "mpr_enabled", False):
+            return
+
+        active_volume_label = getattr(self.server.state, "active_volume_label", "")
+        if not active_volume_label:
+            return
+
+        # Find the active volume
+        active_volume = None
+        for volume in self.scene.volumes:
+            if volume.label == active_volume_label:
+                active_volume = volume
+                break
+
+        if not active_volume:
+            return
+
+        visible = getattr(self.server.state, "mpr_crosshairs_enabled", True)
+        active_volume.set_crosshairs_visible(visible)
+        self.server.controller.view_update()
+
     def add_mpr_rotation(self, axis):
         """Add a new rotation to the MPR rotation sequence."""
         import copy
@@ -902,6 +942,14 @@ class Logic:
         for i in range(len(rotation_sequence), self.scene.max_mpr_rotations):
             setattr(self.server.state, f"mpr_rotation_axis_{i}", f"Rotation {i + 1}")
 
+    def finalize_mpr_initialization(self, **kwargs):
+        """Set the active volume label after UI is ready to avoid race condition."""
+        if hasattr(self, "_pending_active_volume") and self._pending_active_volume:
+            self.server.state.active_volume_label = self._pending_active_volume
+            # Manually trigger sync_active_volume since state change may not fire during on_server_ready
+            self.sync_active_volume(self._pending_active_volume)
+            delattr(self, "_pending_active_volume")
+
     @asynchronous.task
     async def close_application(self):
         """Close the application by stopping the server."""

{cardio-2025.10.0 → cardio-2025.12.0}/src/cardio/mesh.py

@@ -1,12 +1,9 @@
-# System
 import enum
 import logging
 
-# Third Party
 import pydantic as pc
 import vtk
 
-# Internal
 from .object import Object
 from .property_config import Representation, vtkPropertyConfig
 
@@ -49,7 +46,7 @@ class Mesh(Object):
     """Mesh object with subdivision support."""
 
     pattern: str = pc.Field(
-        default="${frame}.obj", description="Filename pattern with $frame placeholder"
+        default="{frame}.obj", description="Filename pattern with $frame placeholder"
     )
     _actors: list[vtk.vtkActor] = pc.PrivateAttr(default_factory=list)
     properties: vtkPropertyConfig = pc.Field(

{cardio-2025.10.0 → cardio-2025.12.0}/src/cardio/object.py

@@ -1,10 +1,8 @@
-# System
 import functools
 import logging
 import pathlib as pl
 import re
 
-# Third Party
 import pydantic as pc
 import vtk
 
@@ -80,7 +78,6 @@ class Object(pc.BaseModel):
         if self.pattern is None:
             raise ValueError("Cannot use path_for_frame with static file_paths")
         filename = self.pattern.format(frame=frame)
-        print(filename)
         return self.directory / filename
 
     @functools.cached_property

{cardio-2025.10.0 → cardio-2025.12.0}/src/cardio/orientation.py

@@ -1,9 +1,7 @@
-# System
 from enum import Enum
 
-# Third Party
-import numpy as np
 import itk
+import numpy as np
 
 
 # DICOM LPS canonical orientation vector mappings

{cardio-2025.10.0 → cardio-2025.12.0}/src/cardio/piecewise_function.py

@@ -1,8 +1,6 @@
-# Third Party
 import pydantic as pc
 import vtk
 
-# Internal
 from .types import ScalarComponent
 
 

{cardio-2025.10.0 → cardio-2025.12.0}/src/cardio/property_config.py

@@ -1,12 +1,9 @@
-# System
 import enum
 import functools
 
-# Third Party
 import pydantic as pc
 import vtk
 
-# Internal
 from .types import RGBColor, ScalarComponent
 
 

{cardio-2025.10.0 → cardio-2025.12.0}/src/cardio/scene.py

@@ -1,15 +1,12 @@
-# System
 import logging
 import pathlib as pl
 import typing as ty
 
-# Third Party
 import numpy as np
 import pydantic as pc
 import pydantic_settings as ps
 import vtk
 
-# Internal
 from .mesh import Mesh
 from .segmentation import Segmentation
 from .types import RGBColor
@@ -107,24 +104,16 @@ class Scene(ps.BaseSettings):
     volumes: VolumeList = pc.Field(default_factory=list)
     segmentations: SegmentationList = pc.Field(default_factory=list)
     mpr_enabled: bool = pc.Field(
-        default=False,
+        default=True,
         description="Enable multi-planar reconstruction (MPR) mode with quad-view layout",
     )
     active_volume_label: str = pc.Field(
         default="",
         description="Label of the volume to use for multi-planar reconstruction",
     )
-    axial_slice: float = pc.Field(
-        default=0.0,
-        description="Axial slice position in physical coordinates (LAS Z axis)",
-    )
-    sagittal_slice: float = pc.Field(
-        default=0.0,
-        description="Sagittal slice position in physical coordinates (LAS X axis)",
-    )
-    coronal_slice: float = pc.Field(
-        default=0.0,
-        description="Coronal slice position in physical coordinates (LAS Y axis)",
+    mpr_origin: list = pc.Field(
+        default_factory=lambda: [0.0, 0.0, 0.0],
+        description="MPR origin position [x, y, z] in LPS coordinates",
     )
     mpr_window: float = pc.Field(
         default=800.0, description="Window width for MPR image display"
@@ -150,6 +139,20 @@ class Scene(ps.BaseSettings):
     coordinate_system: str = pc.Field(
         default="LAS", description="Coordinate system orientation (e.g., LAS, RAS, LPS)"
     )
+    mpr_crosshairs_enabled: bool = pc.Field(
+        default=False, description="Show crosshair lines indicating slice intersections"
+    )
+    mpr_crosshair_colors: dict = pc.Field(
+        default_factory=lambda: {
+            "axial": (0.0, 0.5, 1.0),
+            "sagittal": (1.0, 0.3, 0.3),
+            "coronal": (0.3, 1.0, 0.3),
+        },
+        description="RGB colors for crosshair lines (keyed by view name)",
+    )
+    mpr_crosshair_width: float = pc.Field(
+        default=1.5, description="Line width for crosshair lines"
+    )
 
     # Field validators for JSON string inputs
     @pc.field_validator("meshes", mode="before")

{cardio-2025.10.0 → cardio-2025.12.0}/src/cardio/segmentation.py

@@ -1,17 +1,14 @@
-# System
 import logging
 
-# Third Party
 import itk
 import numpy as np
 import pydantic as pc
 import vtk
 
-# Internal
+from .object import Object
 from .orientation import (
     reset_direction,
 )
-from .object import Object
 from .property_config import vtkPropertyConfig
 
 
@@ -19,7 +16,7 @@ class Segmentation(Object):
     """Segmentation object with multi-label mesh extraction using SurfaceNets."""
 
     pattern: str = pc.Field(
-        default="${frame}.nii.gz",
+        default="{frame}.nii.gz",
         description="Filename pattern with $frame placeholder",
     )
     _actors: list[vtk.vtkActor] = pc.PrivateAttr(default_factory=list)

{cardio-2025.10.0 → cardio-2025.12.0}/src/cardio/transfer_function_pair.py

@@ -1,8 +1,6 @@
-# Third Party
 import pydantic as pc
 import vtk
 
-# Internal
 from .color_transfer_function import ColorTransferFunctionConfig
 from .piecewise_function import PiecewiseFunctionConfig