Add tutorial on Cerebrovascular Reactivity Mapping on MEICA data with phys2cv

[smoia]

Hey hey! A while back Eneko asked me to create a page to compute CVR using ME and ICA data.

Full disclosure: I'm not a jupyter user, and I don't know how to write a notebook - but I did my best effort. Anyway, here's the page, and here's Copilot blahblahblah about what was changed.

This pull request significantly expands the documentation for Cerebrovascular Reactivity (CVR) mapping, introduces a new dependency, and updates the references. The main focus is on providing a comprehensive tutorial for using the phys2cvr tool, including practical code examples and explanations for different types of regressors. Additionally, a new scientific publication is added to the bibliography, and the phys2cvr package is now listed as a dependency.

Documentation Enhancements:

• Major expansion of the 06_Cerebrovascular_Reactivity_Mapping.md tutorial to include:
  • Detailed workflow for CVR mapping with phys2cvr, including setup instructions, parameter explanations, and practical code examples for various regressor types (CO₂ traces, pre-made PETCO₂, task designs, and BOLD signal averages).
  • Guidance on denoising strategies, manual classification, and considerations for signal processing.
  • Additional usage tips, final remarks, and references to relevant literature and documentation.

Dependency Updates:

• Added phys2cvr version 0.28.4 and peakdet version 0.6.1 to the pyproject.toml dependencies to ensure the tutorial and related workflows function as described.

References/Bibliography:

• Added a new article (Cohen2025RS) to references.bib, providing up-to-date literature relevant to resting-state BOLD-perfusion coupling and multi-echo imaging.

[tsalo]

@smoia thank you! If this is ready, I can merge it in and try building locally.

[smoia]

After a chat with Eneko, it turns out I need to do a quick addition to process the IC timeseries before phys2cvr. I plan to do it by Wednesday or so!

[tsalo]

Sounds good. Just let me know when you want me to merge.