Skip to content

Releases: schorschinho/osprey

Osprey v2.5.0

11 Apr 19:34
Choose a tag to compare

What's new?

  • This new release includes fully compiled versions of the OspreyGUI for MacOS, Windows, and Ubuntu. The installer includes the correct MATLAB runtime for each OS. This will allow the user to run Osprey without a MATLAB license. The compiled version also includes the matching binaries of LCModel if Osprey is used as a wrapper for analyzing conventional MRS with LCModel.

What's Changed (detailed)

New Contributors

Full Changelog: v.2.4.0...v.2.5.0

Osprey v2.4.0

04 Aug 15:31
Choose a tag to compare

What's Changed

  • [FEATURE REQUEST] - Update description plotProcess and plotFit - Maari13 by @HJZollner in #455
  • [BUG FIX] - GUI crashes during load plot - osp_plotLoad - Gaelle Doucet by @HJZollner in #457
  • [BUG FIX] - plotPDF crashes for ref/water scan - osp_plotModule - Mikkelsen/Hupfeld/Mullins by @HJZollner in #459
  • [NEW FEATURE] - Process 'any' water scan as water reference - various… by @HJZollner in #461
  • [FEATURE REQUEST] - Import Siemens XA (31) data - OspreyLoad - Karl K… by @HJZollner in #462
  • [BUG FIX] - Issue with Special Flag - osp_combineCoils - marilenad by @HJZollner in #464
  • [FEATURE] - Add basis and remove noise scan - Gaelle Doucet by @HJZollner in #468
  • [BUG FIX] - GE MRS & nifti anatomical LR flip - coreg_ge_nifti - Simm… by @HJZollner in #470
  • [BUG FIX] - remove uncombined raw - OspreyLoad - Helge by @HJZollner in #472
  • [BUG FIX] - crash during osp_plotModule - osp_plotModule - Gaelle Doucet by @HJZollner in #474
  • [BUG FIX] - OspreyJobGUI not showing 1. header - CreateOspreyJob_app … by @HJZollner in #477
  • [BUG FIX] - pars all sub options in OspreyJob - OspreyJob - Helge Zoe… by @HJZollner in #483
  • [BUG FIX] - FID-A functions for multi-dim data - op_ppmref/op_autopha… by @HJZollner in #484
  • [BUG FIX] - pre_referencing unreliable - op_preref - Helge Zoellner by @HJZollner in #485
  • [BUG FIX] - non-integer spectral width - GUI functions - Helge Zoellner by @HJZollner in #486
  • [BUG FIX] - file_w not loaded when file_ref is supplied - osp_CoilCo… by @HJZollner in #487
  • [BUG FIX] - GUI crash during Load window - ? - Koen Cuypers by @HJZollner in #489
  • [FEATURE] - Autodetect Same Name Masks - OspreyCoreg - Helge Zoellner by @HJZollner in #490
  • [FEATURE] - Update Segmentation for BIDS and Overlay - OspreySeg - Helge Zoellner by @HJZollner in #491
  • Fix continuous integration by @HJZollner in #492
  • Add new example data by @HJZollner in #493
  • Add BB and vx manually by @HJZollner in #494
  • [BUG FIX] - fieldtrip interferes with MATLAB finv - regression_line_c… by @HJZollner in #495
  • Prepare Release v.2.4.0 by @HJZollner in #496
  • Release Push v.2.4.0 by @HJZollner in #497

Full Changelog: v.2.3.0...v.2.4.0

Osprey v2.3.0

24 Jun 21:49
Choose a tag to compare

What's Changed

Full Changelog: v.2.2.0...v.2.3.0

Osprey v2.2.0

09 Jun 00:13
Choose a tag to compare

What's Changed

Full Changelog: v.2.1.0...v.2.2.0

Osprey v2.1.0

29 Apr 17:57
Choose a tag to compare

What's Changed Summary


  • Integration of coregistration and segmentation of NIfTI-MRS datasets
  • Export function for edited/multi-subspectra NIfTI-MRS format
  • Renamed Ins to mI for Myo-Inositol & Scyllo to sI. This has been passed to all basis sets, the default metabolite list, and example files. HOWEVER, if you are manually passing a metabolite list with the old naming convention the basis set will not be properly defined.

Bug fixes

  • Full integration of SPM12 and GUI for MATLAB 2021a and newer
  • Bug fix for failing coil combination for TWIX data if no water reference is supplied
  • Write rda datapoint re-ordering fixed
  • Fix for multi IMA DICOM loader
  • Removed warning output from plots

Full Changelog: v.2.0.0...v.2.1.0

Osprey v.2.0.0

25 Mar 21:49
Choose a tag to compare


  • In case metabolite suppressed data is supplied, OspreyFit has been updated to perform three separate linear-combination modeling runs.: 1) Using parameterized MM basis functions (standard approach with Gaussian functions); 2) Include the cleaned measured MM spectrum (denoised by using a spline function) in the LCM; 3) If multiple subjects are supplied a mean MM spectrum across all subjects is created and included in the last run.
  • Analysis of metabolite-suppressed data from edited and multiplexed spectra is now supported.
  • Add multiple MRS experiments to a single subject by adding another dimension to your input cell arrays. Osprey will load and process all spectra and concatenate them along the extra dimension. In the current release, the extra dimension is not incorporated into the OspreyFit, OspreyQuantify or OspreyQuantify module. This will be part of a future release. However, this can be used if for example, multiple MRS experiments need to be averaged e.g. two separate scans from the same voxel (See example jobSDAT_MEGA_Multidataset.m). After processing you have to call osp_AverageAllDatasetsAlongExtras to average the acquisitions.


  • The MRSCont struct has been completely restructured. Therefore the files from older versions are not compatible, please re-run the analysis or use an older release version.

Osprey v1.2.0

24 Mar 15:03
Choose a tag to compare


  • Added CRLBs and h2oarea as csv files to the LCModel fit in Osprey
  • ProbSpecReg for multiplexed and MEGA data
  • Tabular outputs are now .tsv, rather than .csv, and accompanying .json files are produced. File naming conventions for structural outputs are also reviewed.

Bug fix

  • More information to the OspreyProcess Module in the ops_plotModule and updated the wrong calcualtion of FWHM in ppm. This was done to match the GUI and print output. Thank you Deborah Barany for reporting this issue.
  • updated the nii viewer function to work for all kind of combinations of .nii and .nii.gz files
  • close the opts.PDF generated plots
  • report from Cristian Guerrero about 'Concatented' fitting not creating
  • Siemens DCM loader bug for older spectra fixed (reported by Jill Naaijen)
  • Siemens HERMES/HERCULES coil combination not working when 4 averages are acquired in the water reference scan
  • Bug fix for Siemens TWIX PRESS data acquired on Connectom Scanner with VD software version
  • Single average RDA MEGA-PRESS data not being processed correctly

Osprey v1.1.0

26 Aug 19:29
Choose a tag to compare

New functionalities

  • Automated LCModel integration from within the Osprey pipeline for unedited data. Osprey automatically creates the needed control files and calls LCModel from within MATLAB. The results are imported back into Osprey to be used in the downstream modules. You can also provide your own control files and .BASIS files. You need to add compiled LCModel binaries into the libraries/LCModel folder (visit for instructions). Currently, Osprey is shipped with compiled binaries for Windows 10 and macos catalina.
  • Nifti MRS loader and export functions

Updates & Bugfixes

  • Reduced file size by removing redundant basis set from the MRS container
  • Issues related to the deletion of user supplied strucutral images

Other changes

  • automated OS identifier and font picker

Osprey v1.0.2.1

09 Jul 21:00
Choose a tag to compare

Version check bug fix

Osprey v1.0.2

09 Jul 20:01
Choose a tag to compare

New functionalities

  • updates to the MRSI module to process three slice edited MRSI data (loading & MoCo)
  • GE nifti files accepted
  • MRSinMRS markdown function
  • 7 T relaxation time lookup table for quantification
  • Improved functionality to run Osprey on the server
  • Added co-edited MM model to HERCULES modeling
  • OspreyOverview can be called after OspreyProcess to generate overview plots without fitting

Updates & Bugfixes

  • Preliminary fit picks metabolites based on the supplied basis set (e.g. Cho containing compounds instead of Cho)
  • FitQA definitions updated to match the original paper
  • AllPDF bug fixes
  • Updated GE load function
  • Updated Siemens DICOM loader
  • Updated all example jobFiles to reflect the current functionalities of Osprey and to reflect BIDS structured automated processing
  • Updated version numbering and check function to give soft warnings only

Other changes

  • Prior module check function