Model Registration Developer Guide

Model registration aligns template meshes to patient surfaces and masks. The supported high-level entry point is physiomotion4d.WorkflowFitStatisticalModelToPatient.

Recommended Entry Point

import itk
import pyvista as pv

from physiomotion4d import WorkflowFitStatisticalModelToPatient

workflow = WorkflowFitStatisticalModelToPatient(
    template_model=pv.read("template_heart.vtu"),
    patient_models=[pv.read("lv.vtp"), pv.read("rv.vtp")],
    patient_image=itk.imread("patient_ct.nii.gz"),
)

result = workflow.run_workflow()

Lower-Level Classes

The workflow composes these lower-level registration classes:

• physiomotion4d.RegisterModelsICP

• physiomotion4d.RegisterModelsICPITK

• physiomotion4d.RegisterModelsDistanceMaps

• physiomotion4d.RegisterModelsPCA

Use these directly only when developing or testing a specific registration stage. Their constructors and return dictionaries are documented in Model Registration Modules.

Development Notes

• Prefer PyVista mesh objects at the public Python boundary.

• Convert volumetric meshes to surfaces before surface registration when needed.

• Treat ITK/PyVista coordinate transforms as high-risk and add focused tests.

• Keep synthetic test meshes small and deterministic.

See Also

• Model Registration Modules

• Workflow Development Guide