Published September 25, 2026 | Version 1.0.5
Software Open

PMR: memory-scalable full-resolution 4D-CT deformable registration on consumer GPUs

Authors/Creators

Description

<p><strong>PMR</strong> (phase-manifold registration) is a memory-scalable implementation of 4D-CT deformable image registration: the ten breathing phases are represented as a single anchored, 2&#960;-periodic curve, so loop closure is an algebraic identity rather than a penalty whose weight must be traded against the data term. Deformation parameters live on a coarse control grid composed with the phase weights before upsampling, which reduces the coefficient tensor by 519&#215; (tensor-size arithmetic, not a measured allocation) and lets a full-resolution 1 mm ten-phase series complete with a measured peak of 3.25 GiB on an 8 GB consumer card.</p>

<p>The package ships an executable verification suite that runs alongside training; it has caught <strong>fourteen documented defects in this codebase, eleven of them completely silent</strong>, with the full ledger maintained in the repository. It supports DIR-Lab and CREATIS, whose differing intensity-offset, image-origin and landmark-coverage conventions are handled explicitly and locked down by a regression test.</p>

<p><strong>Scope.</strong> This is about scalability, verification and reproducibility, not state-of-the-art accuracy; see LIMITATIONS.md. Ten-case mean TRE on DIR-Lab is 1.597 mm.</p>

<p>Version 1.0.5 ships the five data-dependent checks the entry point previously listed but did not include, so a fresh clone now exits zero with six checks executed and eight explicitly skipped; it also labels derived tensor-size figures as arithmetic, and records a larger-volume memory measurement that makes the fine-grid extrapolations lower bounds.</p>

<p>Source archived independently in Software Heritage: snapshot swh:1:snp:2871fbfe6e030ec739c82f1c5bdb3c855155fdf1. Neither dataset is redistributed here.</p>

Files

pmr-4dct-v1.0.5.zip

Files (209.1 kB)

Name Size Download all
md5:a15e2cc63bdf13fd5dff06a2447856d8
209.1 kB Preview Download

Additional details

Software

Repository URL
https://github.com/Sonnet-dawn/pmr-4dct
Programming language
Python
Development Status
Active

References

  • Castillo, R., Castillo, E., Guerra, R., Johnson, V. E., McPhail, T., Garg, A. K., & Guerrero, T. (2009). A framework for evaluation of deformable image registration spatial accuracy using large landmark point sets. Physics in Medicine and Biology, 54(7), 1849–1870. https://doi.org/10.1088/0031-9155/54/7/001 Vandemeulebroucke, J., Rit, S., Kybic, J., Clarysse, P., & Sarrut, D. (2011). Spatiotemporal motion estimation for respiratory‐correlated imaging of the lungs. Medical Physics, 38(1), 166–178. https://doi.org/10.1118/1.3523619 Delhay, B., Clarysse, P., & Magnin, I. E. (2007). Locally Adapted Spatio-temporal Deformation Model for Dense Motion Estimation in Periodic Cardiac Image Sequences. Functional Imaging and Modeling of the Heart, 393–402. https://doi.org/10.1007/978-3-540-72907-5_40 Ledesma-Carbayo, M., Kybic, J., Desco, M., Santos, A., Suhling, M., Hunziker, P., & Unser, M. (2005). Spatio-temporal nonrigid registration for ultrasound cardiac motion estimation. IEEE Transactions on Medical Imaging, 24(9), 1113–1126. https://doi.org/10.1109/tmi.2005.852050 Fechter, T., & Baltas, D. (2020). One-Shot Learning for Deformable Medical Image Registration and Periodic Motion Tracking. IEEE Transactions on Medical Imaging, 39(7), 2506–2517. https://doi.org/10.1109/tmi.2020.2972616 Austin, A. P. (2023). On trigonometric interpolation in an even number of points. ETNA - Electronic Transactions on Numerical Analysis, 58, 271–288. https://doi.org/10.1553/etna_vol58s271 Rueckert, D., Sonoda, L., Hayes, C., Hill, D., Leach, M., & Hawkes, D. (1999). Nonrigid registration using free-form deformations: application to breast MR images. IEEE Transactions on Medical Imaging, 18(8), 712–721. https://doi.org/10.1109/42.796284 Klein, S., Staring, M., Murphy, K., Viergever, M., & Pluim, J. (2010). elastix: A Toolbox for Intensity-Based Medical Image Registration. IEEE Transactions on Medical Imaging, 29(1), 196–205. https://doi.org/10.1109/tmi.2009.2035616 Balakrishnan, G., Zhao, A., Sabuncu, M. R., Guttag, J., & Dalca, A. V. (2019). VoxelMorph: A Learning Framework for Deformable Medical Image Registration. IEEE Transactions on Medical Imaging, 38(8), 1788–1800. https://doi.org/10.1109/tmi.2019.2897538 Mok, T. C. W., & Chung, A. C. S. (2020). Large Deformation Diffeomorphic Image Registration with Laplacian Pyramid Networks. Medical Image Computing and Computer Assisted Intervention – MICCAI 2020, 211–221. https://doi.org/10.1007/978-3-030-59716-0_21