PyNutil.read_alignment#

PyNutil.read_alignment(path, loader_name=None, apply_deformation=True, apply_damage=True, deformation_provider=None, damage_provider=None)[source]#

Load registration data with composable pipeline.

This is the main entry point for loading registration data. It supports mixing and matching different components.

Parameters:

  • path (str) – Path to the registration file.

  • loader_name (Optional[str]) – Explicit loader name, or None for auto-detection.

  • apply_deformation (bool) – Whether to apply deformation from the file. Set False to use only linear anchoring.

  • apply_damage (bool) – Whether to apply damage masks from the file.

  • deformation_provider (Optional[DeformationProvider]) – Custom deformation provider to use instead of the default (VisuAlign for QUINT files).

  • damage_provider (Optional[DamageProvider]) – Custom damage provider to use instead of the default (QCAlign for QUINT files).

Return type:

RegistrationData

Returns:

RegistrationData with all components applied.

Examples

# Standard QUINT workflow data = read_alignment(“alignment.json”)

# Linear only (no VisuAlign deformation) data = read_alignment(“alignment.json”, apply_deformation=False)

# Separate anchoring and damage files from .damage import QCAlignDamageProvider data = read_alignment(

“quicknii.json”, damage_provider=QCAlignDamageProvider(“qcalign_output.json”)

)