Please cite ROMEO bioRxiv if you use it! The link will update to the peer reviewed version after it is published.

This repository contains ROMEO 3D/4D unwrapping on arrays.
For MR data in the NIfTI format, a compiled command line tool is available under ROMEO (windows and linux binaries; does not require a Julia installation) and otherwise, for opening NIfTI files in Julia NIfTI.jl or MriResearchTools.jl can be helpful.

using ROMEO
unwrapped = unwrap(phasedata3D; mag=magdata3D)

or via MriResearchTools:

using MriResearchTools
phase4D = readphase("Phase.nii") # 4D phase in NIfTI format
unwrapped = unwrap(phase4D; TEs=[4,8,12])

If multi-echo data is available, supplying ROMEO with multi-echo information should improve the unwrapping accuracy. The same is true for magnitude information.

If the multi-echo data contains large phase offsets (phase at echo time zero), default template unwrapping might fail. Setting the individual-unwrapping flag is a solution, as it performs spatial unwrapping for each echo instead. The computed B0 map is in the current version not corrected for remaining phase offsets.

This project is licensed under the MIT License - see the LICENSE for details