What’s new

24.0.0 (TBD)

Initial major release of 2024, featuring the extraction of IQMs from DWI data for first time in MRIQC’s timeline.

Author list for papers based on MRIQC 23.0 series

As described in the Contributor Guidelines, anyone listed as developer or contributor may write and submit manuscripts about MRIQC. To do so, please move the author(s) name(s) to the front of the following list:

Christopher J. Markiewicz 1; Zvi Baratz 2; Eilidh MacNicol 3; Céline Provins 4; Teresa Gomez 5; Dylan Nielson 6; Jan Varada 7; Ross W. Blair 1; Dimitri Papadopoulos Orfanos 8; William Triplett 9; Mathias Goncalves 1; Nikita Beliy 10; John A. Lee 11; Patrick Sadil 12; Ursula A. Tooley 13; Yibei Chen 14; James D. Kent 15; Yaroslav O. Halchenko 16; Bennet Fauber 17; Taylor Salo 18; Michael Krause 19; Pablo Velasco 20; Thomas Nichols 21; Adam Huffman 22; Elodie Savary 4; Johannes Achtzehn 23; Joke Durnez 1; Satrajit S. Ghosh 24; Adam C. Raikes 25; Asier Erramuzpe 26; Benjamin Kay 27; Daniel Birman 1; McKenzie P. Hagen 28; Michael Dayan 29; Michael G. Clark 30; Rafael Garcia-Dias 31; Adam G. Thomas 32; Russell A. Poldrack 1; Ariel Rokem 5; Oscar Esteban 4.

Affiliations:

  1. Department of Psychology, Stanford University, CA, USA

  2. Sagol School of Neuroscience, Tel Aviv University, Tel Aviv, Israel

  3. Department of Neuroimaging, Institute of Psychiatry, Psychology and Neuroscience, King’s College London, London, UK

  4. Department of Radiology, Lausanne University Hospital and University of Lausanne, Switzerland

  5. The University of Washington eScience Institute, WA, USA

  6. Section on Clinical and Computational Psychiatry, National Institute of Mental Health, Bethesda, MD, USA

  7. Functional MRI Facility, National Institute of Mental Health, Bethesda, MD, USA

  8. NeuroSpin, CEA, Université Paris-Saclay, NeuroSpin, Gif-sur-Yvette, France

  9. University of Florida: Gainesville, Florida, US

  10. CRC ULiege, Liege, Belgium

  11. Quansight, Dublin, Ireland

  12. Johns Hopkins Bloomberg School of Public Health, MD, USA

  13. Department of Neuroscience, University of Pennsylvania, PA, USA

  14. McGovern Institute for Brain Research, Massachusetts Institute of Technology, Cambridge, USA

  15. Department of Psychology, University of Texas at Austin, TX, USA

  16. Psychological and Brain Sciences Department, Dartmouth College, NH, USA

  17. University of Michigan, Ann Arbor, USA

  18. Department of Psychology, Florida International University, FL, USA

  19. Max Planck Institute for Human Development, Berlin, Germany

  20. Center for Brain Imaging, New York University, NY, USA

  21. Oxford Big Data Institute, University of Oxford, Oxford, GB

  22. Department of Physics, Imperial College London, London, UK

  23. Charité Berlin, Berlin, Germany

  24. McGovern Institute for Brain Research, MIT, MA, USA; and Department of Otolaryngology, Harvard Medical School, MA, USA

  25. Center for Innovation in Brain Science, University of Arizona, Tucson, AZ, USA

  26. Computational Neuroimaging Lab, BioCruces Health Research Institute

  27. Washington University School of Medicine, St.Louis, MO, USA

  28. Psychology Department, University of Washington, Seattle, WA, USA

  29. International Committee of the Red Cross - ICRC, Geneva, Switzerland

  30. National Institutes of Health, USA

  31. Institute of Psychiatry, Psychology & Neuroscience, King’s College London, London, UK

  32. Data Science and Sharing Team, National Institute of Mental Health, Bethesda, MD, USA

CHANGES

  • FIX: Finalized naming and connection of DWI IQMs (#1272)

  • FIX: Enable group reports for DWI (#1266)

  • FIX: Address issues that had broken the group reports (#1262)

  • FIX: Select filters if modalities are selected (#1261)

  • FIX: Make sure new logs and config file output are compatible with parallel processes (#1259)

  • FIX: Skip short BOLD runs that break outlier detection (#1120)

  • FIX: Revise config save/load and update inputs after dropping (#1245)

  • FIX: Drift should not be estimated when less than three low-b volumes present (#1242, #1243)

  • FIX: Handle NUMEXPR_MAX_THREADS like OMP_NUM_THREADS (#1241)

  • FIX: Exclude DWI runs with insufficient orientations or missing bvals (#1240)

  • FIX: Avert costly BIDSLayout.__repr__ calls when saving config (#1239)

  • FIX: Duplicate node in anatomical workflow (#1234)

  • FIX: Typo in sorted(..., reverse=True) call (#1211)

  • ENH: Mechanism to protect config’s fields and write out config (#1258)

  • ENH: Improve documentation and logging of SynthStrip’s model (#1254)

  • ENH: Improve logging of runtime (#1253)

  • ENH: Expose a command-line option for minimum DWI volumes (#1249)

  • ENH: Improve error handling and logging (#1238)

  • ENH: Add b-vector angular deviations as IQMs (#1233)

  • ENH: Move from DTI to DKI with multishell data (#1230)

  • ENH: Noise floor estimated with PCA (dwidenoise) as an IQM (#1229)

  • ENH: Integrate PIESNO noise mask and sigma estimation (#1227)

  • ENH: Use MAD for robust estimation of sigma in the CC mask (#1228)

  • ENH: Add new IQM for DWI → NDC (#1226)

  • ENH: Add FA-based IQMs (nans percentage and degenerate percentage) (#1225)

  • ENH: Add computation of spiking voxels mask and percent IQMs (#1224)

  • ENH: Adds diffusion-related IQMs. (#1131)

  • ENH: Revise summary stats extraction and include controlled roundings (#1219)

  • DOC: Add changelog to documentation (#1217)

  • MAINT: Removed pre-commit from development dependencies (#1269)

  • MAINT: Clean up more FutureWarning issued by Pandas (#1257)

  • MAINT: Prevent pandas-originating deprecation warning (#1251)

  • MAINT: Move GitHub Actions and config files from flake8ruff (#1212)

  • MAINT: Update contributor affiliation in CONTRIBUTORS.md (#1214)

23.1.1 (March 20, 2024)

A long-overdue hotfix release addressing many bugs generated during the development of the new dMRI workflows, and some relating to improvements of the handling of multi-echo fMRI. The release also include one year-worth of maintenance actions and a general code cleanup with Ruff.

CHANGES

23.1.0 (June 14, 2023)

A new minor release featuring the new individual reports built with the new NiReports VRS (visual reports system). This means MRIQC now uses the same package fMRIPrep uses for generating its reports. In addition to that, this new release also features Beta support for diffusion MRI (dMRI).

CHANGES

  • FIX: Better handling of BIDS cached indexation (#1121)

  • FIX: Make doctest of NumberOfShells more reliable (#1122)

  • FIX: Add protection for NaNs and INFs when calculating QI2 (#1112)

  • FIX: PlotMosaic expects lists, not tuples (#1111)

  • FIX: BIDS database directory handling (#1110)

  • FIX: Remove unused dipy import in the functional interfaces (#1109)

  • FIX: Refine the head mask after removal of FSL BET (#1107)

  • FIX: Inform SynthStrip about the desired intraop threads (#1101)

  • FIX: Test broken by #1098 (#1100)

  • FIX: Separate report bootstrap files (anat vs. func) (#1098)

  • FIX: Propagate logging level to subprocesses (#1030)

  • ENH: Incorporate new NiReports’ DWI heatmaps (#1119)

  • ENH: More compact of shell-wise summary statistic maps (avg/std) (#1116)

  • ENH: Add a basic DTI fitting into the diffusion workflow (#1115)

  • ENH: MRIQC for DWI (#1113)

  • ENH: Culminate dropping FSL as a dependency (#1108)

  • ENH: Replace FSL FAST with ANTs Atropos for brain tissue segmentation (#1099)

  • ENH: Drop FSL MELODIC (without alternative) (#1106)

  • ENH: Drop FSL BET to estimate the “outskin” (head) mask (#1105)

  • ENH: Drop utilization of “head” mask from template (#1104)

  • ENH: Move templates’ probsegs into individual at normalization (#1103)

  • ENH: Improving the resource monitor – infer PID from process name (#1049) (#1049)

  • ENH: Refactor reports system to use NiReports and the general VRS (#1085)

  • MAINT: Move codespell configuration to pyproject.toml (#1097)

  • MAINT: Update deprecated nibabel.spatialimage.get_data() calls (#1096)

Author list for papers based on MRIQC 23.0 series

As described in the Contributor Guidelines, anyone listed as developer or contributor may write and submit manuscripts about MRIQC. To do so, please move the author(s) name(s) to the front of the following list:

Zvi Baratz 1; Christopher J. Markiewicz 2; Eilidh MacNicol 3; Dylan Nielson 4; Jan Varada 5; Ross W. Blair 2; Céline Provins 6; William Triplett 7; Mathias Goncalves 2; Nikita Beliy 8; John A. Lee 9; Ursula A. Tooley 10; James D. Kent 11; Yaroslav O. Halchenko 12; Bennet Fauber 13; Taylor Salo 14; Michael Krause 15; Pablo Velasco 16; Thomas Nichols 17; Adam Huffman 18; Elodie Savary 6; Johannes Achtzehn 19; Joke Durnez 2; Satrajit S. Ghosh 20; Asier Erramuzpe 21; Benjamin Kay 22; Daniel Birman 2; McKenzie P. Hagen 23; Michael G. Clark 24; Patrick Sadil 25; Rafael Garcia-Dias 26; Adam G. Thomas 27; Russell A. Poldrack 2; Ariel Rokem 28; Oscar Esteban 6.

Affiliations:

  1. Sagol School of Neuroscience, Tel Aviv University, Tel Aviv, Israel

  2. Department of Psychology, Stanford University, CA, USA

  3. Department of Neuroimaging, Institute of Psychiatry, Psychology and Neuroscience, King’s College London, London, UK

  4. Section on Clinical and Computational Psychiatry, National Institute of Mental Health, Bethesda, MD, USA

  5. Functional MRI Facility, National Institute of Mental Health, Bethesda, MD, USA

  6. Department of Radiology, Lausanne University Hospital and University of Lausanne, Switzerland

  7. University of Florida: Gainesville, Florida, US

  8. CRC ULiege, Liege, Belgium

  9. Quansight, Dublin, Ireland

  10. Department of Neuroscience, University of Pennsylvania, PA, USA

  11. Department of Psychology, University of Texas at Austin, TX, USA

  12. Psychological and Brain Sciences Department, Dartmouth College, NH, USA

  13. University of Michigan, Ann Arbor, USA

  14. Department of Psychology, Florida International University, FL, USA

  15. Max Planck Institute for Human Development, Berlin, Germany

  16. Center for Brain Imaging, New York University, NY, USA

  17. Oxford Big Data Institute, University of Oxford, Oxford, GB

  18. Department of Physics, Imperial College London, London, UK

  19. Charité Berlin, Berlin, Germany

  20. McGovern Institute for Brain Research, MIT, MA, USA; and Department of Otolaryngology, Harvard Medical School, MA, USA

  21. Computational Neuroimaging Lab, BioCruces Health Research Institute

  22. Washington University School of Medicine, St.Louis, MO, USA

  23. Psychology Department, University of Washington, Seattle, WA, USA

  24. National Institutes of Health, USA

  25. Johns Hopkins Bloomberg School of Public Health, MD, USA

  26. Institute of Psychiatry, Psychology & Neuroscience, King’s College London, London, UK

  27. Data Science and Sharing Team, National Institute of Mental Health, Bethesda, MD, USA

  28. The University of Washington eScience Institute, WA, USA

23.0.1 (March 24, 2023)

A hotfix release resolving a reggression introduced with the new optimized indexing.

  • FIX: Underspecified regex sets BIDSLayout to ignore data with sessions (#1094)

  • FIX: Input data has incompatible dimensionality (plotting ICA) (#1082)

  • ENH: Optimize metadata gathering reusing BIDSLayout db (#1084)

  • DOC : update anatomical example report in documentation (#1088)

  • MAINT: Drop old mriqc_plot script (#1091)

23.0.0 (March 10, 2023)

The new 23.0.x series include several prominent changes. Visualization has been migrated from MRIQC and niworkflows over to the new NiReports project. This series include a major bugfix with the optimization of the indexing of the input BIDS folder, which was taking large times with sizeable datasets. Telemetry has also been incorporated with migas. These new series also involve maintenance housekeeping, and includes some relevant bugfixes.

New contributors

CHANGES

Full Changelog: https://github.com/nipreps/mriqc/compare/22.0.6…23.0.0

  • FIX: Send metadata extraction to workers (functional workflow) (#1081)

  • FIX: Plot coronal as main plain for mosaic of rodent images (#1027)

  • FIX: Address non-empty take from empty axes (anatomical IQMs) (#1077)

  • FIX: Uniformize building workflow message (anat vs. func) (#1072)

  • FIX: Move telemetry atexit into entrypoint func (#1067)

  • FIX: Preempt PyBIDS to spend time indexing non-BIDS folders (#1050)

  • FIX: Update T1w metrics (#1063)

  • FIX: Resource monitor would not ever start tracking (#1051)

  • ENH: Add DataLad getter to inputs of functional workflows (#1071)

  • ENH: Add migas telemetry (#1036)

  • ENH: Add codespell automation: config, action, and typos fixed (#1057)

  • MAINT: Update NiReports calls to upcoming interfaces API (#1078)

  • MAINT: Pacify codespell (#1080)

  • MAINT: Conclude porting of reportlets into NiReports (#1068)

  • MAINT: Migrate to hatchling (#1070)

  • MAINT: Pin PyBIDS 0.15.6 (culminating #1050) (#1069)

  • MAINT: Update niworkflows pin to support newer ANTs releases (#1047)

  • MAINT: Fix minor aspects of WebAPI deployment on CircleCI (#1064)

  • MAINT: Update CircleCI executor and use built-in docker-compose (#1061)

  • MAINT: Rotate CircleCI secrets and setup up org-level context (#1046)

  • DOC: Update documentation with the new carpet plot (#1045)

  • DOC: Complete the documentation of summary_stats() (#1044)

  • DOC: Fixes a couple of broken links to the nipype documentation (#1040)

Author list for papers based on MRIQC 23.0 series

As described in the Contributor Guidelines, anyone listed as developer or contributor may write and submit manuscripts about MRIQC. To do so, please move the author(s) name(s) to the front of the following list:

Zvi Baratz 1; Christopher J. Markiewicz 2; Eilidh MacNicol 3; Dylan Nielson 4; Jan Varada 5; Ross W. Blair 2; Céline Provins 6; William Triplett 7; Mathias Goncalves 2; Nikita Beliy 8; John A. Lee 9; Ursula A. Tooley 10; James D. Kent 11; Yaroslav O. Halchenko 12; Bennet Fauber 13; Taylor Salo 14; Michael Krause 15; Pablo Velasco 16; Thomas Nichols 17; Adam Huffman 18; Johannes Achtzehn 19; Joke Durnez 2; Satrajit S. Ghosh 20; Asier Erramuzpe 21; Benjamin Kay 22; Daniel Birman 2; Elodie Savary 23; McKenzie P. Hagen 24; Michael G. Clark 25; Patrick Sadil 26; Rafael Garcia-Dias 27; Adam G. Thomas 28; Russell A. Poldrack 2; Ariel Rokem 29; Oscar Esteban 30.

Affiliations:

  1. Sagol School of Neuroscience, Tel Aviv University, Tel Aviv, Israel

  2. Department of Psychology, Stanford University, CA, USA

  3. Department of Neuroimaging, Institute of Psychiatry, Psychology and Neuroscience, King’s College London, London, UK

  4. Section on Clinical and Computational Psychiatry, National Institute of Mental Health, Bethesda, MD, USA

  5. Functional MRI Facility, National Institute of Mental Health, Bethesda, MD, USA

  6. Lausanne University Hospital and University of Lausanne, Lausanne, Switzerland

  7. University of Florida: Gainesville, Florida, US

  8. CRC ULiege, Liege, Belgium

  9. Quansight, Dublin, Ireland

  10. Department of Neuroscience, University of Pennsylvania, PA, USA

  11. Department of Psychology, University of Texas at Austin, TX, USA

  12. Psychological and Brain Sciences Department, Dartmouth College, NH, USA

  13. University of Michigan, Ann Arbor, USA

  14. Department of Psychology, Florida International University, FL, USA

  15. Max Planck Institute for Human Development, Berlin, Germany

  16. Center for Brain Imaging, New York University, NY, USA

  17. Oxford Big Data Institute, University of Oxford, Oxford, GB

  18. Department of Physics, Imperial College London, London, UK

  19. Charité Berlin, Berlin, Germany

  20. McGovern Institute for Brain Research, MIT, MA, USA; and Department of Otolaryngology, Harvard Medical School, MA, USA

  21. Computational Neuroimaging Lab, BioCruces Health Research Institute

  22. Washington University School of Medicine, St.Louis, MO, USA

  23. Department of Radiology, Lausanne University Hospital and University of Lausanne, Switzerland

  24. Psychology Department, University of Washington, Seattle, WA, USA

  25. National Institutes of Health, USA

  26. Johns Hopkins Bloomberg School of Public Health, MD, USA

  27. Institute of Psychiatry, Psychology & Neuroscience, King’s College London, London, UK

  28. Data Science and Sharing Team, National Institute of Mental Health, Bethesda, MD, USA

  29. The University of Washington eScience Institute, WA, USA

  30. Department of Radiology, Lausanne University Hospital and University of Lausanne

22.0.6 (August 24, 2022)

A hotfix release partially rolling-back the previous fix #1025. Thanks everyone for your patience with the excessively rushed release of 22.0.5.

  • FIX: Better fix to the multi-argument --participant-label issue (#1026)

22.0.5 (August 24, 2022)

A hotfix release addressing a problem with the argument parser.

  • FIX: Multiple valued --participant-label wrongly parsed (#1025)

22.0.4 (August 23, 2022)

A hotfix release to ensure smooth operation of datalad within Docker.

  • FIX: Major improvements to new datalad-based interface & perform within containers (#1024)

  • ENH: Bump Docker base to latest release (#1022)

22.0.3 (August 19, 2022)

A patch release containing a bugfix to the SynthStrip preprocessing.

  • FIX: SynthStrip preprocessing miscalculating new shape after reorientation (#1021)

  • ENH: Remove slice-timing correction (#1019)

  • ENH: Add a new DataladIdentityInterface (#1020)

  • ENH: Set rat-specific defaults for FD calculations (#1005)

  • ENH: New version of the rating widget (#1012)

  • DOC: Move readthedocs to use the config v2 file (YAML) (#1018)

  • MAINT: Fix statsmodels dependency, it is not optional (#1017)

  • MAINT: Several critical updates to CircleCI and Docker images (#1016)

  • MAINT: Update the T1w IQMs to the new reference after #997 (#1014)

  • MAINT: Fix failing tests as python setup.py is deprecated (#1013)

22.0.2 (August 15, 2022)

A patch release including the new ratings widget.

  • ENH: New version of the rating widget (#1012)

  • DOC: Move readthedocs to use the config v2 file (YAML) (#1018)

  • MAINT: Fix statsmodels dependency, it is not optional (#1017)

  • MAINT: Several critical updates to CircleCI and Docker images (#1016)

  • MAINT: Update the T1w IQMs to the new reference after #997 (#1014)

  • MAINT: Fix failing tests as python setup.py is deprecated (#1013)

22.0.1 (May 3rd, 2022)

A patch release addressing a new minor bug.

  • FIX: More lenient handling of skull-stripped datasets (#997)

22.0.0 (May 3rd, 2022)

First official release after migrating the repository into the NiPreps’ organization. A major new feature is the rodent pipeline by Eilidh MacNicol (@eilidhmacnicol). A second major feature is the adoption of the updated carpet plots for BOLD fMRI, contributed by Céline Provins (@celprov). Virtual memory allocation has been ten-fold cut down, and a complementary resource monitor instrumentation is now available with MRIQC. This release updates the Docker image with up-to-date dependencies, updates MRIQC’s codebase to the latest NiTransforms and includes some minor bugfixes. The code, modules and data related to the MRIQC classifier have been extracted into an isolated package called [MRIQC-learn](https://github.com/nipreps/mriqc-learn). Finally, this release also contains a major code style overhaul by Zvi Baratz.

The contributor/author crediting system has been adapted to the current draft of the NiPreps Community Governance documents.

With thanks to @ZviBaratz, @nbeliy, @octomike, @benkay86, @verdurin, @leej3, @utooley, and @jAchtzehn for their contributions.

  • FIX: Inconsistent API in anatomical CNR computation (#995)

  • FIX: Check sanity of input data before extracting IQMs (#994)

  • FIX: Plot segmentations after dropping off-diagonal (#989)

  • FIX: Replace all deprecated nibabel.get_data() in anatomical module (#988)

  • FIX: Resource profiler was broken with config file (#981)

  • FIX: preserve WM segments in rodents (#979)

  • FIX: Pin jinja2 < 3.1 (#978)

  • FIX: Make toml config unique, works around #912 (#960)

  • FIX: Nipype multiproc plugin expects n_procs and not nprocs (#961)

  • FIX: Set TR when generating carpetplots (enables time for X axis) (#971)

  • FIX: template_resolution deprecation warning (#941)

  • FIX: Set entity datatype in BIDSLayout queries (#942)

  • FIX: T2w image of MNI template unavailable in Singularity (#940)

  • FIX: Release process – Docker deployment not working + Python package lacks WebAPI token (#938)

  • FIX: Revise building documentation at RTD after migration (#935)

  • FIX: Final touch-ups in the maintenance of Docker image + CI (#928)

  • FIX: Update unit tests (#927)

  • FIX: Update dependencies and repair BOLD workflow accordingly (#926)

  • FIX: Update dependencies and repair T1w workflow accordingly (#925)

  • FIX: Set matplotlib on Agg output mode (#892)

  • ENH: Deprecate --start-idx / --stop-idx (#993)

  • ENH: Add SynthStrip base module (#987)

  • ENH: Improve building workflow message feedback (#990)

  • ENH: Add instrumentation to monitor resources (#984)

  • ENH: Standalone, lightweight version of MultiProc plugin (#985)

  • ENH: Revise plugin and workflow initialization (#983)

  • ENH: Base generalization of the pipeline for rodents (#969)

  • ENH: Update to new NiWorkflows’ API, which adds the crown to the carpetplot (#968)

  • ENH: Optimize PyBIDS’ layout initialization (#939)

  • ENH: Refactored long strings to a mriqc.messages module (#901)

  • ENH: Refactored mriqc.interfaces.common module (#901)

  • DOC: Improve documentation of --nprocs and --omp-nthreads (#986)

  • DOC: Add sbatch file example for SLURM execution (#963)

  • DOC: Various fixes to “Running mriqc” section (#897)

  • MAINT: Refactor Dockerfile using new miniconda image (#974)

  • MAINT: Outsource the classifier into nipreps/mriqc-learn (#973)

  • MAINT: Update CONTRIBUTORS.md (#953)

  • MAINT: Update contributor location (#952)

  • MAINT: Updates to CONTRIBUTORS.md file

  • MAINT: Revise Docker image settings & CircleCI (#937)

  • MAINT: Finalize transfer to nipreps organization (#936)

  • MAINT: Relicensing to Apache-2.0, for compliance with NiPreps and prior transfer to the org (#930)

  • MAINT: New Docker layer caching system of other NiPreps (#929)

  • MAINT: Code style overhaul (#901)

  • MAINT: Update Dockerfile and catch-up with fMRIPrep’s (#924)

  • STY: Run black at the top of the repo (#932)

Full Changelog: https://github.com/nipreps/mriqc/compare/0.16.1…22.0.0

Author list for papers based on MRIQC 22.0.x

As described in the Contributor Guidelines, anyone listed as developer or contributor may write and submit manuscripts about MRIQC. To do so, please move the author(s) name(s) to the front of the following list:

Zvi Baratz 1; Christopher J. Markiewicz 2; Eilidh MacNicol 3; Dylan Nielson 4; Jan Varada 5; Ross W. Blair 2; William Triplett 6; Nikita Beliy 7; Céline Provins 8; John A. Lee 9; Ursula A. Tooley 10; James D. Kent 11; Bennet Fauber 12; Taylor Salo 13; Mathias Goncalves 2; Michael Krause 14; Pablo Velasco 15; Thomas Nichols 16; Adam Huffman 17; Johannes Achtzehn 18; Joke Durnez 2; Satrajit S. Ghosh 19; Asier Erramuzpe 20; Benjamin Kay 21; Daniel Birman 2; Michael G. Clark 22; Rafael Garcia-Dias 23; Sean Marret 5; Adam G. Thomas 24; Russell A. Poldrack 2; Krzysztof J. Gorgolewski 25; Oscar Esteban 26.

Affiliations:

  1. Sagol School of Neuroscience, Tel-Aviv University

  2. Department of Psychology, Stanford University, CA, USA

  3. Department of Neuroimaging, Institute of Psychiatry, Psychology and Neuroscience, King’s College London, London, UK

  4. Section on Clinical and Computational Psychiatry, National Institute of Mental Health, Bethesda, MD, USA

  5. Functional MRI Facility, National Institute of Mental Health, Bethesda, MD, USA

  6. University of Florida: Gainesville, Florida, US

  7. CRC ULiege, Liege, Belgium

  8. Lausanne University Hospital and University of Lausanne, Lausanne, Switzerland

  9. Quansight, Dublin, Ireland

  10. Department of Neuroscience, University of Pennsylvania, PA, USA

  11. Department of Psychology, University of Texas at Austin, TX, USA

  12. University of Michigan, Ann Arbor, USA

  13. Department of Psychology, Florida International University, FL, USA

  14. Max Planck Institute for Human Development, Berlin, Germany

  15. Center for Brain Imaging, New York University, NY, USA

  16. Oxford Big Data Institute, University of Oxford, Oxford, GB

  17. Department of Physics, Imperial College London, London, UK

  18. Charité Berlin, Berlin, Germany

  19. McGovern Institute for Brain Research, MIT, MA, USA; and Department of Otolaryngology, Harvard Medical School, MA, USA

  20. Computational Neuroimaging Lab, BioCruces Health Research Institute

  21. Washington University School of Medicine, St.Louis, MO, USA

  22. National Institutes of Health, USA

  23. Institute of Psychiatry, Psychology & Neuroscience, King’s College London, London, UK

  24. Data Science and Sharing Team, National Institute of Mental Health, Bethesda, MD, USA

  25. Google LLC

  26. Department of Radiology, Lausanne University Hospital and University of Lausanne

Series 0.16.x

0.16.1 (January 30, 2021)

Bug-fix release in 0.16.x series.

This PR improves BIDS Derivatives compliance, fixes an issue with reading datasets with subjects of the form sub-sXYZ, and improves compatibility with more recent matplotlib.

  • FIX: Participant labels starting with [sub] cannot be used (#890)

  • FIX: Change deprecated normed to density in parameters to hist() (#888)

  • ENH: Write derivatives metadata (#885)

  • ENH: Add --pdb option to make debugging easier (#884)

0.16.0 (January 5, 2021)

New feature release in 0.16.x series.

This version removes the FSL dependency from the fMRI workflow.

  • FIX: Skip version cache on read-only filesystems (#862)

  • FIX: Honor $OMP_NUM_THREADS environment variable (#848)

  • RF: Simplify comprehensions, using easy-to-read var names (#875)

  • RF: Free the fMRI workflow from FSL (#842)

  • CI: Fix up Circle builds (#876)

  • CI: Update machine images on Circle (#874)

Older (unsupported) series

0.15.3 (September 18, 2020)

A bugfix release to re-enable setting of --omp-nthreads/--ants-nthreads.

  • FIX: omp_nthreads typo (#846)

0.15.2 (April 6, 2020)

A bugfix release containing mostly maintenance actions and documentation improvements. This version drops Python 3.5. The core of MRIQC has adopted the config-module pattern from fMRIPrep. With thanks to A. Erramuzpe, @justbennet, U. Tooley, and A. Huffman for contributions.

  • MAINT: revise style of all files (except for workflows) (#839)

  • MAINT: Clear the clutter of warnings (#838)

  • RF: Adopt config module pattern from fMRIPrep (#837)

  • MAINT: Clear the clutter of warnings (#838)

  • MAINT: Drop Python 3.5, simplify linting (#833)

  • MAINT: Update to latest Ubuntu Xenial tag (#814)

  • MAINT: Centralize all requirements and versions on setup.cfg (#819)

  • MAINT: Use recent Python image to build packages in CircleCI (#808)

  • DOC: Improve AQI (and other IQMs) and boxplot whiskers descriptions (#816)

  • DOC: Refactor how documentation is built on CircleCI (#818)

  • DOC: Corrected a couple of typos in --help text (#809)

0.15.1 (July 26, 2019)

A maintenance patch release updating PyBIDS.

  • FIX: FileNotFoundError when MELODIC (--ica) does not converge (#800) @oesteban

  • MAINT: Migrate MRIQC to a setup.cfg style of installation (#799) @oesteban

  • MAINT: Use PyBIDS 0.9.2+ via niworkflows PR (#796) @effigies

0.15.0 (April 5, 2019)

A long overdue update, pinning updated versions of TemplateFlow and Niworkflows. With thanks to @garciadias for contributions.

  • ENH: Revision of QI2 (#606) @oesteban

  • FIX: Set matplotlib backend early (#759) @oesteban

  • FIX: Niworkflows pin <0.5 (#766) @oesteban

  • DOC: Update BIDS validation link. (#764) @garciadias

  • DOC: Add data sharing agreement (#765) @oesteban

  • FIX: Catch uncaught exception in WebAPI upload. (#774) @rwblair

  • FIX/DOC: Append new line after dashes in mriqc_run help text (#777) @rwblair

  • ENH: Use TemplateFlow and niworkflows-0.8.x (#782) @oesteban

  • FIX: Correctly set WebAPI rating endpoint in BOLD reports. (#785) @oesteban

  • FIX: Correctly process values of rating widget (#787) @oesteban

0.14.2 (August 20, 2018)

  • FIX: Preempt pandas resolving Path objects (#746) @oesteban

  • FIX: Codacy issues (#745) @oesteban

0.14.1 (August 20, 2018)

  • FIX: Calculate relative path with sessions (#742) @oesteban

  • ENH: Add a toggle button to rating widget (#743) @oesteban

0.14.0 (August 17, 2018)

  • ENH: New feedback widget (#740) @oesteban

0.13.1 (August 16, 2018)

  • [ENH,FIX] Updates to individual reports, fix table after rating (#739) @oesteban

0.13.0 (August 15, 2018)

  • MAINT: Overdue refactor (#736) @oesteban * FIX: Reorganize outputs (closes #396) * ENH: Memory usage - lessons learned with FMRIPREP (#703) * FIX: Cannot allocate memory (v 0.9.4) (closes #536) * FIX: Drop inoperative --report-dir flag (#550) * FIX: Drop misleading WARNING of the group-level execution (#714) * FIX: Expand usernames on input paths (#721) * MAINT: More robust naming of derivatives (related to #661)

  • FIX: Do not fail with spurious 4th dimension on T1w (#738) @oesteban

  • ENH: Move on to .tsv files (#737) @oesteban

0.12.1 (August 13, 2018)

  • FIX: BIDSLayout queries (#735)

0.12.0 (August 09, 2018)

  • FIX: Reduce tSNR memory requirements (#712)

  • DOC: Fix typos in IQM documentation (#725)

  • PIN: Update MRIQC WebAPI version (#734)

  • BUG: Fix missing library in singularity images (#733)

  • PIN: nipype 1.1.0, niworkflows (#726)

0.11.0 (June 05, 2018)

  • RF: Resume external nipype dependency (#715)

0.10.6 (May 29, 2018)

  • HOTFIX: Bug #659

0.10.5 (May 28, 2018)

  • ENH: Report feedback (#659)

0.10.4 (March 22, 2018)

  • ENH: Various improvements to reports (#708)

  • MAINT: Style revision (#704)

  • PIN: pybids 0.5 (#700)

  • ENH: Increase FAST memory limits (#702)

0.10.3 (February 26, 2018)

  • ENH: Enable T2w metrics uploads (#696)

  • PIN: Updating niworkflows (#698)

  • DOC: Option -o is outdated for classifier (#697)

0.10.2 (February 15, 2018)

  • ENH: Add warning about mounting relative paths (#690)

  • FIX: Sanitize inputs (#687)

  • DOC: Fix documentation to use --version instead of -v (#688)

0.10.1

  • FIX: Fixed a bug in reading outputs of 3dFWHMx (#678)

0.9.10

  • FIX: Updated AFNI to 17.3.03. Resolves errors regarding opening display by 3dSkullStrip (#669)

0.9.9

  • ENH: Update nipype to fix $DISPLAY problem of AFNI’s 3dSkullStrip

0.9.8

With thanks to Jan Varada (@jvarada) for the session/run filtering.

  • ENH: Report recall in cross-validation (requested by reviewer) (#633)

  • ENH: Hotfixes to 0.9.7 (#635)

  • FIX: Implement filters for session, run and task of BIDS input (#612)

0.9.7

  • ENH: Clip outliers in FD and SPIKES group plots (#593)

  • ENH: Second revision of the classifier (#555): * Set matplotlib plugin to agg in docker image * Migrate scalings to sklearn pipelining system * Add Satra’s feature selection for RFC (with thanks to S. Ghosh for his suggestion) * Make model selection compatible with sklearn Pipeline * Multiclass classification * Add feature selection filter based on Sites prediction (requires pinning to development sklearn-0.19) * Add RobustLeavePGroupsOut, replace RobustGridSearchCV with the standard GridSearchCV of sklearn. * Choice between RepeatedStratifiedKFold and RobustLeavePGroupsOut in mriqc_clf * Write cross-validation results to an .npz file.

  • ENH: First revision of the classifier (#553): * Add the possibility of changing the scorer function. * Unifize labels for raters in data tables (to rater_1) * Add the possibility of setting a custom decision threshold * Write the probabilities in the prediction file * Revised mriqc_clf processing flow * Revised labels file for ds030. * Add IQMs for ABIDE and DS030 calculated with MRIQC 0.9.6.

  • ANNOUNCEMENT: Dropped support for Python<-3.4

  • WARNING (#596): We have changed the default number of threads for ANTs. Using parallelism with ANTs causes numerical instability on the calculated measures. The most sensitive metrics to this problem are the kurtosis calculations on the intensities of regions and qi_2.

0.9.6

  • ENH: Finished setting up MRIQC Web API

  • ENH: Better error message when –participant_label is set (#542)

  • FIX: Allow –load-classifier option to be empty in mriqc_clf (#544)

  • FIX: Borked bias estimation derived from Conform (#541)

  • ENH: Test against web API 0.3.2 (#540)

  • ENH: Change the default Web API address (#539)

  • ENH: MRIQCWebAPI: hash fields that may have PI (#538)

  • ENH: Added token authorization to MRIQCWebAPI client (#535)

  • FIX: Do not mask and antsAffineInitializer twice (#534)

  • FIX: Datasets where air (hat) mask is empty (#533)

  • ENH: Integration testing for MRIQCWebAPI (#520)

  • ENH: Use AFNI to calculate gcor (#531)

  • ENH: Refactor derivatives (#530)

  • ENH: New bold-IQM: dummy_trs (non-stady state volumes) (#524)

  • FIX: Order of BIDS components in IQMs CSV table (#525)

  • ENH: Improved logging of mriqc_run (#526)

0.9.5

  • ENH: Refactored structural metrics calculation (#513)

  • ENH: Calculate rotation mask (#515)

  • ENH: Intensity harmonization in the anatomical workflow (#510)

  • ENH: Set N4BiasFieldCorrection number of threads (#506)

  • ENH: Convert FWHM in pixel units (#503)

  • ENH: Add MRIQC client for feature crowdsourcing (#464)

  • DOC: Fix functional feature labels in documentation (docs_only) (#507)

  • FIX: New implementation for the rPVE feature (normalization, left-tail values) (#505)

  • ENH: Parse BIDS selectors (run, task, etc.), improve CLI (#504)

0.9.4

  • ANNOUNCEMENT: Dropped Python 2 support

  • ENH: Use versioneer to handle versions (#500)

  • ENH: Speed up spatial normalization (#495)

  • ENH: Resampling of hat mask and TPMs with linear interp (#498)

  • TST: Build documentation in CircleCI (#484)

  • ENH: Use full-resolution T1w images from ABIDE (#486)

  • TST: Parallelize tests (#493)

  • TST: Binding /etc/localtime stopped working in docker 1.9.1 (#492)

  • TST: Downgrade docker to 1.9.1 in circle (build_only) (#491)

  • TST: Check for changes in intermediate nifti files (#485)

  • FIX: Erroneous flag –n_proc in CircleCI (#490)

  • ENH: Add build_only tag to circle builds (#488)

  • ENH: Update Dockerfile (#482)

  • FIX: Ignore –profile flag with Linear plugin (#483)

  • DOC: Deep revision of the documentation (#479)

  • ENH: Minor improvements: SpatialNormalization and segmentation (#472)

  • ENH: Fixed typo for neurodebian install via apt-get (#478)

  • ENH: Updating fs2gif script (#465)

  • ENH: RF: Use niworkflows.interface.SimpleInterface (#468)

  • ENH: Add reproducibility of metrics tracking (#466)

Release 0.9.3

  • ENH: Reafactor of the Dockerfile to improve transparency, reduce size, and enable injecting code in Singularity (#457)

  • ENH: Make more the memory consumption estimates of each processing step more conservative to improve robustness (#456)

  • FIX: Minor documentation cleanups (#461)

Release 0.9.2

  • ENH: Optional ICA reports for identifying spatiotemporal artifacts (#412)

  • ENH: Add –profile flag (#435)

  • ENH: Crashfiles are saved in plain text to improve portability (#434)

  • FIX: Fixes EPI mask erosion (#442)

  • ENH: Make FSL and AFNI motion correction more comparable by using the same scheme for defining the reference image (#444)

  • FIX: Temporarily disabling T1w quality classifier until it can be retrained on new measures (#447)

Release 0.9.1

  • ENH: Add mriqc version and input image hash to IQMs json file (#432)

  • FIX: Affine and warp transforms are now applied in the correct order (#431)

Release 0.9.0-2

  • ENH: Revise Docker paths (#429)

  • FIX: Greedy participant selection (#426)

  • FIX: Pin pybids to new version 0.1.0 (#427)

  • FIX: Amends sloppy PR #425 (#428)

Release 0.9.0-1

  • FIX: BOLD reports clipped IQMs after spikes_num (#425)

  • FIX: Unicode error writing group reports (#424)

  • FIX: Respect Nifi header in fMRI conform node (#415)

  • DOC: Deep revision of documentation (#411, #416)

  • ENH: Added sphinx extension to plot workflow graphs (#411)

  • FIX: Removed repeated bias correction on anatomical workflows (#410)

  • FIX: Race condition in bold workflow when using shared workdir (#409)

  • FIX: Tests (#408, #407, #405)

  • FIX: Remove CDN for group level reports (#406)

  • FIX: Unused connection, matplotlib segfault (#403, #402)

  • ENH: Skip SpikeFFT detector by default (#400)

  • ENH: Use float32 (#399)

  • ENH: Spike finder performance improvoments (#398)

  • ENH: Basic T2w workflow (#394)

  • ENH: Re-enable 3dvolreg (#390)

  • ENH: Add T1w classifier (#389)

Release 0.9.0-0

  • FIX: Remove non-repeatable step from pipeline (#369)

  • ENH: Improve group level command line, with more informative output when no IQMs are found for a modality (#372)

  • ENH: Make group reports self-contained (#333)

  • FIX: New mosaics, based on old ones (#361, #360, #334)

  • FIX: Require numpy>=1.12 to avoid casting problems (#356)

  • FIX: Add support for acq and rec tags of BIDS (#346)

  • DOC: Documentation updates (#350)

  • FIX: pybids compatibility “No scans were found” (#340, #347, #342)

  • ENH: Rewrite PYTHONPATH in docker/singularity images (#345)

  • ENH: Move metadata onto the bottom of the individual reports (#332)

  • ENH: Don’t include MNI registration report unlesS –verbose-reports is used (#362)

Release 0.8.9

  • ENH: Added registration svg panel to reports (#297)

Release 0.8.8

  • FIX: Bug translating int16 to uint8 in conform image.

  • FIX: Error in ConformImage interface (#297)

  • ENH: Replace BBR by ANTs (#295, #296)

  • FIX: Singularity: user-environment leaking into container (#293)

  • ENH: Report failed cases in group report (#291)

  • FIX: Brighter anatomical –verbose-reports (#290)

  • FIX: X-flip in the mosaics (#289)

  • ENH: Show metadata in the individual report (#288)

  • ENH: Label in the cutoff threshold - fmriplot (#287)

  • ENH: PyBIDS (#286)

  • ENH: Simplify tests (#284)

  • FIX: MRIQC crashed generating csv files (#283)

  • FIX: Bug in setup.py (#281)

  • ENH: Makefile (#280)

  • FIX: Revision of IQMs (#266, #272, #279)

  • ENH: Deprecation of –nthreads, new flags (#260)

  • ENH: Improvements on plots rendering (#254, #257, #258, #267, #268, #269, #270)

  • ENH: FFT detection of spikes (#253, #272)

  • FIX: Labels and links of samples in group plots (#249)

  • ENH: Units in group plots (#242)

  • FIX: More reliable group level (#238)

  • ENH: Add –verbose-reports for fMRI (#236)

  • ENH: Migrate functional reports to html (#232)

  • ENH: Add 0.2 FD cutoff line (#231)

  • ENH: Add AFNI’s outlier count to carpet plot confound charts (#230)

Release 0.8.7

  • ENH: Anatomical Group reports in html (#227)

  • ENH: Add kurtosis to summary statistics (#224)

  • ENH: New report layout for fMRI, added carpetplot (#198)

  • ENH: Anatomical workflow refactor (#219).

Release 0.8.6

  • [FIX, CRITICAL] Do not chmod in Docker internal scripts

  • FIX: Error creating derivatives folder

  • ENH: Moved MNI spatial normalization to NIworkflows, and made robust.

  • ENH: De-coupled participant and group (reports) levels

  • ENH: Use new FD and DVARs calculations from nipype (#172)

  • ENH: Started with python3 compatibility

  • ENH: Added new M2WM measure #158

  • FIX: QI2 is skipped if background intensity is not appropriate (#147)

Release 0.8.5

  • FIX: Error inverting the T1w-to-MNI warping (#146)

  • FIX: TypeError computing DVARS (#145)

  • ENH: Plot figure of fitted background chi for QI2 (#143)

  • ENH: Move skull-stripping and reorient to NIworkflows (#142)

  • FIX: mriqc crashes if no anatomical scans are found (#141)

  • DOC: Added acknowledgments to CPAC team members (#134)

  • ENH: Use absolute imports (#133)

  • FIX: VisibleDeprecationWarning (#132)

  • ENH: Provide full FD/DVARS files (#128)

  • ENH: Use MCFLIRT to compute motion parameters. AFNI’s 3dvolreg now is optional (#121)

  • FIX: BIDS trees with anatomical images with different acquisition tokens (#116)

  • FIX: BIDS trees with anatomical images with several runs (#112)

  • ENH: Options for ANTs normalization: reduced test times (#124), and updated options (#115)

Release 0.8.4

  • ENH: PDF reports now use RST templates and jinja2 (#109)

  • FIX: Single-session-multiple-run anatomical files were not correctly located (#112)

Release 0.8.3

  • DOC: Added examples of the PDF reports (#107)

  • FIX: Fixed problems with Python 3 when generating reports.

Release 0.8.2

  • ENH: Python 3 compatibility (#99)

  • ENH: Add JSON settings file for ANTS (#95)

  • ENH: Generate reports automatically if mriqc is run without the -S flag (#93)

  • FIX: Revised implementation of QI2 measure (#90)

  • AGAVE: Fixed docker image for agave (#89)

  • FIX: Problem when generating the air mask with dipy installed (#88)

  • ENH: One-session-one-run execution mode (#85)

  • AGAVE: Added an agave app description generator (#84)

Release 0.3.0

  • ENH: Updated CircleCI and Docker to use the version 2.1.0 of ANTs compiled by their developers.

  • ENH: New anatomical workflows to compute the air mask (#56)

Release 0.1.0

  • FIX: #55

  • ENH: Added rotation of output csv files if they exist

Release 0.0.2

  • ENH: Completed migration from QAP

  • ENH: Integration with ReadTheDocs

  • ENH: Submission to PyPi

Release 0.0.1

  • Basic mriqc functionality