LoginSign Up
← Back to all sparks
R

regfusionr

ANALYTICS
Velocity3.8

R package regfusionr by dfsp-spirit — release notes from GitHub.

github.com/dfsp-spirit/regfusionr ↗

Registration fusion mapping goes bidirectional, and a vertex-indexing bug that silently returned wrong coordinates is fixed

neuroimagingcoordinate-mappingfreesurferr-packagebreaking-change
◆Current state
regfusionr maps coordinates between volumetric brain templates (MNI152, Colin27) and the fsaverage surface. After four dormant years it returned in July 2026 with a release that fixes a coordinate-indexing bug, unblocks a previously disabled function, and completes the template-by-method matrix so all four combinations answer point queries. It also breaks compatibility by switching to the standard FREESURFER_HOME environment variable.
◆Where it's heading
The package moved from a partial implementation to a complete one in a single release. Before this, vol_coords_to_fsaverage returned coordinates indexed by query position rather than by vertex index — results that looked plausible and were wrong — and fsaverage_to_vol was guarded behind a stop(). Both are now resolved, and the new Colin27 and MNI152 convenience functions make the mapping bidirectional. The sibling package haze shipped a maintenance release 56 minutes later, marking this as a coordinated sweep across the maintainer's neuroimaging stack.
◆Prediction
With the four template-by-method combinations closed and the coordinate bug fixed, the next release is more likely to be CRAN-adjacent packaging or documentation than new mapping capability.

◆Recent moves

  1. 18d ago

    Version 0.3.0 -- vol_to_fsaverage, many convenience functions and fixes

    ⚡ SPARK

    The release that makes regfusionr trustworthy: the vertex-indexing bug is corrected, fsaverage_to_vol is unblocked, a .txt fallback closes the gaps where .mgz vertex maps do not exist, and three new functions make Colin27 and MNI152 mapping bidirectional. The FREESURFER_HOME switch breaks existing setups that used FS_HOME.

    View source ↗
  2. 4y ago

    v0.2.0 -- surface to volume data projection

    fsaverage_to_vol arrives, adding surface-to-volume projection to the existing volume-to-surface direction, and the package pins haze v0.2.0 for the k-d tree functions it needs. That dependency edge is why the two packages move together.

    View source ↗
  3. 4y ago

    v0.1.0: Initial release

    The founding release, with MNI152-to-fsaverage mapping in both directions and volume-data projection onto the surface. As with haze, the size ceiling puts CRAN out of reach.

    View source ↗