HARP-I (Harmonic Phase Interpolation) is a method that utilizes radial basis function interpolation to recover tissue motion from 2D and 3D tagged MR images.
HARP-I relies on the unwrapping algorithm implemented in the DENSEanalysis toolbox. However, any unwrapping procedure can be used. The unwrapping algorithm is available in the DENSEanalysis repository.
To install DENSEanalysis and access its unwrapping functionalities, follow these steps:
- Clone the repository:
git clone https://github.com/denseanalysis/denseanalysis.git
- Navigate to the DENSEanalysis folder:
cd denseanalysis/ - Open MATLAB and run:
DENSEsetup
To install HARP-I, follow these steps:
- Clone the repository:
git clone git@github.com:hmella/HARP-I.git
- Navigate to the HARP-I folder:
cd path/to/HARP-I - Open MATLAB and run:
HARPIsetup
DENSEanalysis ships an incompatible pixelstrain, and a copy of
parseinputs. MATLAB resolves a name to whichever directory comes first on
the search path, so adding DENSEanalysis after HARP-I makes the demos fail
with:
Error using pixelstrain
Invalid spline data.
HARPIsetup adds DENSEanalysis first and HARP-I last, and reports any
HARP-I function that is still shadowed. If you manage the path yourself:
harpi_paths % find DENSEanalysis
harpi_paths('DENSEanalysis', '/path/to/denseanalysis') % or give its locationHARP-I includes demo scripts showcasing its application to 2D and 3D tagged MR images. These can be found in the examples/ folder.
📁 Inside this folder, you will also find a README file that provides additional explanations about the demo scripts and their usage.
Anonymized 2D and 3D tagged MR images can be found in the data/ directory.
📢 Note: Due to size constraints, the data is hosted on an external cloud storage service. Please refer to the README within the data/ folder for the download link.
If you use HARP-I in your research, please cite the following publication:
📰 H. Mella et al., HARP-I: A Harmonic Phase Interpolation Method for the Estimation of Motion From Tagged MR Images in IEEE Transactions on Medical Imaging, vol. 40, no. 4, pp. 1240-1252, April 2021. doi: 10.1109/TMI.2021.3051092.
For questions, feedback, or collaboration opportunities, feel free to reach out:
🎓 Hernán Mella
📍 Pontificia Universidad Católica de Valparaíso
✉️ hernan.mella@pucv.cl
This source code is licensed under the Mozilla Public License, Version 2.0 (MPL-2.0). If a copy of the MPL was not distributed within this repository, you can obtain one at http://mozilla.org/MPL/2.0/.