===========
This is a document summarizing the changes that are associated with (major) updates and releases. Priority is given to changes that are relevant to the user, and those that introduce new features or break compatibility with prior versions.
- Added group-only, no-group options to allow for running the scripts at the individual or group level only. Default is to run at both levels.
- Added status file and skip-existing option to allow for incremental updates of a given output directory; additional cases or additional modules will be added. Existing ones will not be recomputed.
- This fixes an issue with the outlier module, which did not run for FastSurfer output due to incorrect expectations for names of stats files.
- This fix addresses two minor issues where output was omitted for the SNR computation and the fornix evaluation whenever hires inputs were used.
- Name changes for the toolbox, repository, package, and scripts: the toolbox has been renamed to "fsqc tools", the python package name "qatoolspython" has been changed to "fsqc", and the "qatools.py" script has been renamed to "run_fsqc". The github repository is now located at "https://github.com/Deep-MI/fsqc", but requests to the old "https://github.com/Deep-MI/qatools-python" repository will be redirected.
- Name changes for output files (replacing 'qatools' with 'fsqc').
- Interface changes: importing and running the scripts has changed. In particular,
run_fsqc
is now an executable file and replaces theqatools
orqatools.py
command.run_fsqc()
is now also function that can be used in a Python environment. See here for details. - New names for main and dev branches: the main (default) branch is now called
stable
(was:freesurfer-module-releases
), and the dev branch is now calleddev
(was:freesurfer-module-dev
). The old branches will still be kept for a while in a deprecation state, but will not receive further updates or support. - Screenshots are now in radiological orientation (left is right). Before version 2.0, screenshots were in neurological orientation (left is left).
- Addition of skullstrip, surfaces, hippocampus and hypothalamus modules.
- Improved logging, error handling, and testing frameworks.
- Enhanced containerization support (docker, singularity, dockerhub).
- Updated requirements, easier installation of the package and its dependencies, availability of the package on pypi.org.
- FreeSurfer is no longer required as a dependency (except for the optional 'shape analysis' module, which relies on the brainprint package).
- We do not preserve compatibility with earlier versions.