LORIS MRI Release v17.0.0
This release of the Loris-MRI repo accompanies the LORIS 17.0 release and the current version of the DICOM Archive Tools repository for LORIS
All changes for Loris-MRI 17.0 (not including schema and module changes in main Loris repo)
New Features
- Sample prod file allows new scans to be inserted must match mri_protocol table but are no longer required to match isFileToBeRegisteredGivenProtocol function (dicom-archive-tools#41)
- New command-line tool seriesuid2fileid to compare imaging data on server against database insertion status (for DICOM and minc files), based on SeriesUID #155
- New script minc_deletion.pl to delete a minc file based on SeriesUID #138, and a sample wrapper script deletemincsqlwrapper.pl for calling minc_deletion.pl #172
- New handling of duplicate detection via tarchive_files table now takes into account Echo time as well as SeriesUID (dicom-archive-tools#42, Loris#1978)
- When duplicates are detected, notification spool error message indicates next script to run #165
- Explicit ordering of modalities enabled via new AcqOrderPerModality column in files table Loris#2221
- Scanner ID is more clearly specified via the files table, moved from the parameter_file table to better distinguish human vs. phantom scans (#156, Loris#2189)
Install
- CentOS install process now runs more of the imaging_install.sh script #163
Improvements and Documentation
- Improved integration of Imaging Uploader to insertion pipeline setup
- Improved pipeline status messages and debug messages
- Various bug fixes
- For projects using the imaging uploader's auto-launch insertion feature, log files are deleted only if insertion was successful Loris#2252
- Force-inserting a scan into LORIS (using the acquisition_protocol flag in minc_insertion.pl #141) now automatically sets the Caveat flag to True for this file in Imaging Browser #171
Notes for Existing Projects
When updating your Loris-MRI code to the release branch, it important to ensure your dicom-archive-tools code is updated at the same time.
Note carefully recent updates to dicom-archive-tools/profileTemplate file coinciding with 17.0 release. Note that your prod file should be manually updated with any applicable changes committed to this profileTemplate file. Examples include:
- isFileToBeRegisteredGivenProtocol() change : new scans to be inserted should match mri_protocol table but are no longer required to match isFileToBeRegisteredGivenProtocol function in prod file (dicom-archive-tools#41)
After applying the Loris 17.0 release patch, run the new tools/BackPopulateSNRAndAcquisitionOrder.pl script to back-populate an existing database with SNR (in parameter_file table) and AcqOrderPerModality (in files) table. See #162 for complete instructions, and note that prod:getSNRfunction() is a pre-requisite to back-populating SNR.