This folder contains the OXSA (Open-source eXtensible Spectroscopy Analysis) toolbox for developing pipelines for spectroscopy analysis. It includes code for loading Siemens spectroscopy data, and for spectral fitting/analysis.
Version: 2.1 Release date: 2024-07-08
Contact: ctr28@cam.ac.uk or chris@rodgers.org.uk
If you use this software in an academic publication, please include the following, or similar, text in your methods section:
"OXSA Matlab code was used for analysis, as previously described [1]."
- Purvis LAB, Clarke WT, Biasiolli L, Valkovic L, Robson MD, Rodgers CT. OXSA: An open-source magnetic resonance spectroscopy analysis toolbox in MATLAB. Plos One. 2017; 12(9):e0185356.
If the included AMARES-based algorithm is used, the following paper should also be cited:
Vanhamme L, van den Boogaart A, Van Huffel S. Improved method for accurate and efficient quantification of MRS data with use of prior knowledge. J Magn Reson. 1997; 129(1):35-43.
This is released for NON-COMMERCIAL USE ONLY. See LICENSE.TXT for further details.
- OXSA Fitting Guide v1.0 - using the functions included in the AMARES package.
- Loading data v1.0 - using Spectro classes and GUIs to load data.
- OXSA v1.0 - details about the Spectro classes.
- OXSA v2.0 update - Notes on the restructuring for OXSA v2.
There are several examples included to show the methods of loading and running data. Each of these will change to the appropriate directory when run.
The /test/ folder contains a few basic test scripts. The aim is to include additional scripts so that all testing is fully automated. In the /test/MonteCarlo/ folder there are several scripts and data files that should allow the comparison of updates to OXSA fitting.
v1.0 - 2017-07-10 - Initial release v2.0 - 2018-05-30 - Restructuring to allow simpler inclusion of additional prior knowledge. Added the ability to fit using Voigt lineshapes. Some folder reorganisation so that the OXSA code can be run as part of the OCMR in-house processing pipeline. Several other minor changes to update all code to match current in-house versions. v2.1 - 2024-07-08 - Update contact details and amend the name.