25.2.1 (October 22, 2025)

Patch release in the 25.2.x series.

Fixes an issue where when both T1w and T2w anatomical images were present, there was a potential incorrect count of T2w images - leading to downstream crashes.

- Bug Fixes
  * FIX: Incorrect number of found T2w scans (#498)

25.2.0 (September 25, 2025)

The first release of the 25.2.x series.

This release synchronizes with downstream dependencies, as well as
leverages TemplateFlow to retrieve intermediate transforms used during multi-step registration.

If you are reusing a previous TemplateFlow cache (which may be the case if running with
Apptainer / Singularity), you will need to clear or update your cache to ensure these new files
are available.

Thanks to @LuciMoore for the contribution!

Documentation
  * DOC: MCRIBS and surf recon methods chosen based on age (#485)

Enhancements
  * ENH: Retrieve transforms with templateflow (#486)
  * ENH: Save cortex mask (#487)
  * ENH: Add multiverse output layout (#481)

Bug Fixes
  * FIX: Default to grid-constant when resampling BOLD to output spaces
  * FIX: Propagate error code if pipeline run is unsuccessful

25.2.0rc2 (September 23, 2025)

Second release candidate

25.2.0rc1 (September 19, 2025)

First release candidate for the 25.2.x series.

This release synchronizes with downstream dependencies, as well as
leverages TemplateFlow to retrieve intermediate xfms used during multi-step registration.

Thanks to @LuciMoore for the contribution!

  * DOC: MCRIBS and surf recon methods chosen based on age (#485)

  * ENH: Retrieve transforms with templateflow (#486)
  * ENH: Save cortex mask (#487)
  * ENH: Add multiverse output layout (#481)

  * FIX: Default to grid-constant when resampling BOLD to output spaces

25.1.2 (August 28, 2025)

A patch release in the 25.1.x series.

Fixes compatibility with Python 3.12 when running MCRIBS.

- Bug Fixes
  * FIX: MCRIBS compatibility (#483)

- Internals / Maintenance
  * MAINT: Fix outputs check (#479)

25.1.1 (July 2, 2025)

A patch release in the 25.1.x series.

Includes a fix to the fieldmap reference orientation to match the B-spline coefficients.

Thanks to @joey-scanga for the contribution!

- Bug Fixes
  * FIX: Orient fieldmap before checking spline fit (#475)

25.1.0 (June 24, 2025)

First release of the 25.1.x series. A few key changes include a new workflow
for derivatives compatibility when an anatomical template is not present, and performing
a two step registration (currently only for MNI152NLin6Asym) is now the default behavior.
This can be disabled by adding `--no-multi-step-reg` to the command.

- Enhancements
  * ENH: Verify derivatives are compatible with anatomical reference (#459)
  * ENH: Make `--multi-step-reg` a boolean action, enable by default (#470)
  * ENH: Convert pooch retrieval to interface, allow setting cache dir (#467)

- Internals / Maintenance
  * MAINT: bump dependencies, test on python 3.13 (#468)
  * MAINT: deprecate `--clean-workdir` (#473)

25.0.2 (May 19, 2025)

A patch release including a couple key bug fixes:
 - Adds missing dependency to Docker image when BOLD coregistration falls back to FSL
 - Fixes connections to allow fieldmap-less SDC

Thanks to @joey-scanga for the contribution!

Documentation
  * DOC: Changed "B0Identifier" -> "B0FieldIdentifier" (#456)

Enhancements
  * ENH: Add message to show which files are to be used (#452)
  * ENH: Tag anatomical workflows (#463)

Bug Fixes
  * FIX: SyN workflow (#453)
  * FIX: Add Convert3d to Docker image (#461)

Internals / Maintenance
  * MAINT: Support sdcflows@main and smriprep >=0.18 (#462)

25.0.1 (February 5, 2025)

A bug-fix release to address an issue when using a precomputed mask for MCRIBS surface reconstruction without an anatomical template.

  * FIX: Match mask header prior to n4 correction (#443)

25.0.0 (January 28, 2025)

A new minor release with improvements to anatomical to template spatial normalization.

Registration will now prioritize the same modality as the anatomical template, if available.

A new flag `--norm-csf` performs CSF normalization on the anatomical template prior to template registration.

A new flag `--multi-step-reg` adds an intermediate step when registering to MNI152NLin6Asym, first performing anatomical -> MNIInfant:cohort-X (age matched by default), and then concatenates the transform with an already computed MNIInfant -> MNI152NLin6Asym.

Both of the new flags above are disabled by default, but have shown promise and may become defaults in the next release. Please experiment with your data, and any feedback on the results would be greatly appreciated!

- Enhancements
  * ENH: Output anatomical coregistration transform + report (#437)
  * ENH: Minimize clipping prior to surface reconstruction with MCRIBS (#436)
  * ENH: Output fsLR meshes on subject surfaces (#427)
  * ENH: Add flag for multi-step registration to adult templates (#415) (#425) (#430) (#433)
  * ENH: Option to normalize CSF prior to template registration (#419)
  * ENH: Expand template registration to use either anatomical modality (#418)

- Bug Fixes
  * FIX: Reduce range that --surface-recon-method auto recommends MCRIBS (#438)
  * FIX: Allow T2 only without the use of --derivatives
  * FIX: New styling catches (#417)
  * FIX: Default surface recon method should be None (#416)

- Internals / Maintenance
  * TST: Build workflow across different conditions (#409)
  * MAINT: Remove deprecated parser arguments (#407)