THIS PAGE IS UNDER DEVELOPMENT

Listed below are the preprocessing routines that are run in GannetLoad.m. Whether a particular routine or subroutine is run will depend on the format of the inputted data and the options set in GannetPreInitialise.m.

RF coil combination

Certain raw MRS data formats store data without coil combination; specifically, GE P-file (.7), NIfTI-MRS (if the source data were raw), Philips .raw, and Siemens TWIX (.dat) data. Gannet uses generalized least squares1 to optimally combine the signal from the multiple RF channels. If water files are provided, these data will be used as references for signal weighting and phasing of the coil data.

Eddy-current correction

  Eddy-current correction can only be applied if water data are provided.

In GannetPreInitialise.m, users have the option to apply eddy-current correction (ECC) to metabolite and water data. If applied, Gannet uses the method described by Klose (1990)2. The code for the ECC routine can be found in EddyCurrentCorrection.m.

Line-broadending (apodization)

FID data are multiplied by a time-varying exponential weighting function where the weighting constant is set in GannetPreInitialise.m (3 Hz is the default).

Frequency and phase alignment

During acquisition, spectral data are affected by frequency and phase offsets as a results of biophysical, electrical, mechanical, and participant factors. Gannet has several algorithms to correct for these errors during preprocessing. Users can choose which method to use in GannetPreInitialise.m. The methods are:

Method Option Description
Robust spectral registration3 (default) RobustSpecReg A method based on spectral registration4 that is robust against spectral distortions such as unstable residual water and lipid contamination.
Multi-step frequency and phase correction5 SpecRegHERMES A method originally developed to align multiplexed edited HERMES data. This approach is also based on spectral registration.

Phase correction

It is common for unprocessed spectra to be out of phase. Gannet applies a global zero-order phase correction to all transients by fitting the real-valued 3 ppm Cr and 3.2 ppm Cho signals in the frequency domain.

Signal averaging

Gannet provides two methods for averaging individual transients (selected in GannetPreInitialise.m): arithmetic averaging (with outlier rejection) and weighted averaging (the default). The code for the signal averaging routines can be found in SignalAveraging.m.

Arithmetic averaging

Arithmetic averaging is straightforward. All sequentially acquired \(n\) pairs of subspectra \(x_i\) (e.g., all edit-ON and edit-OFF subspectra) are averaged using the arithmetic mean: \(\bar{x} = \frac{1}{n}\sum_{i=1}^nx_i\).

Note that before the arithmetic averaging of subspectra, individual transients are excluded based on the outlier rejection algorithm used during frequency and phase alignment.

Weighted averaging

Weighted averaging down-weights individual difference subspectra that are corrupted by signal artifacts — this is an important distinction from traditional signal averaging. First, the difference between sequentially acquired pairs (e.g., all edit-ON and edit-OFF subspectra) is calculated. A similarity matrix \(\mathbf{D}\in\mathbb{R}^{P{\times}P}\) is obtained by calculating the mean squared error between each real-valued difference subspectrum \(p\) and every other real-valued difference subspectrum (in the range 1.8 to 3.4 ppm). A similarity metric \(d_{p}\) is calculated as the column-wise median of \(\mathbf{D}\). Normalized weights \(w_{p}\) are then derived, \(w_{p} = d^{-2}_p/\sum{d^{-2}_p}\), and applied to the difference pairs before summation.


References

1.
An L, Willem van der Veen J, Li S, Thomasson DM, Shen J. Combination of multichannel single-voxel MRS signals using generalized least squares. Journal of Magnetic Resonance Imaging. 2013;37(6):1445-1450. doi:10.1002/jmri.23941
2.
Klose U. In vivo proton spectroscopy in presence of eddy currents. Magnetic Resonance in Medicine. 1990;14(1):26-30. doi:10.1002/mrm.1910140104
3.
Mikkelsen M, Tapper S, Near J, Mostofsky SH, Puts NAJ, Edden RAE. Correcting frequency and phase offsets in MRS data using robust spectral registration. NMR in Biomedicine. 2020;33(10):e4368. doi:10.1002/nbm.4368
4.
Near J, Edden R, Evans CJ, Paquin R, Harris A, Jezzard P. Frequency and phase drift correction of magnetic resonance spectroscopy data by spectral registration in the time domain. Magnetic Resonance in Medicine. 2015;73(1):44-50. doi:10.1002/mrm.25094
5.
Mikkelsen M, Saleh MG, Near J, et al. Frequency and phase correction for multiplexed edited MRS of GABA and glutathione. Magnetic Resonance in Medicine. 2018;80(1):21-28. doi:10.1002/mrm.27027
LS0tCnRpdGxlOiAiUHJlcHJvY2Vzc2luZyIKZGF0ZTogIkxhc3QgdXBkYXRlZDogYHIgZm9ybWF0KFN5cy50aW1lKCksICclQiAlZCwgJVknKWAiCmJpYmxpb2dyYXBoeTogYmlibGlvZ3JhcGh5LmJpYgpjc2w6IGFtZXJpY2FuLW1lZGljYWwtYXNzb2NpYXRpb24uY3NsCmxpbmstY2l0YXRpb25zOiB5ZXMKb3V0cHV0OgogIGh0bWxfZG9jdW1lbnQ6CiAgICB0b2M6IFRSVUUKICAgIHRvY19kZXB0aDogMgogICAgdG9jX2Zsb2F0OgogICAgICBjb2xsYXBzZWQ6IEZBTFNFCi0tLQoKYGBge3Igc2V0dXAsIGluY2x1ZGUgPSBGQUxTRX0Ka25pdHI6Om9wdHNfY2h1bmskc2V0KGVjaG8gPSBUUlVFKQpgYGAKCmBgYHtyLCBjaGlsZCA9ICJqcy9iYWNrLXRvLXRvcC5qcyJ9CmBgYAoKYGBge2NzcywgZWNobyA9IEZBTFNFfQp0YWJsZSB7CiAgbWFyZ2luOiBhdXRvOwp9Cgp0YWJsZSB0aGVhZCB0aCB7CiAgYm9yZGVyLWJvdHRvbTogMXB4IHNvbGlkICNkZGQ7Cn0KCnRoLCB0ZCB7CiAgcGFkZGluZzogNXB4Owp9CmBgYAoKPGJyPgoKOjo6IHdhcm5pbmcKPGkgY2xhc3M9ImZhIGZhLWV4Y2xhbWF0aW9uLWNpcmNsZSIgc3R5bGU9ImNvbG9yOiB3aGl0ZSI+PC9pPiZuYnNwOyBUSElTIFBBR0UgSVMgVU5ERVIgREVWRUxPUE1FTlQKOjo6CgpMaXN0ZWQgYmVsb3cgYXJlIHRoZSBwcmVwcm9jZXNzaW5nIHJvdXRpbmVzIHRoYXQgYXJlIHJ1biBpbiBgR2FubmV0TG9hZC5tYC4gV2hldGhlciBhIHBhcnRpY3VsYXIgcm91dGluZSBvciBzdWJyb3V0aW5lIGlzIHJ1biB3aWxsIGRlcGVuZCBvbiB0aGUgZm9ybWF0IG9mIHRoZSBpbnB1dHRlZCBkYXRhIGFuZCB0aGUgb3B0aW9ucyBzZXQgaW4gYEdhbm5ldFByZUluaXRpYWxpc2UubWAuCgojIyBSRiBjb2lsIGNvbWJpbmF0aW9uCgpDZXJ0YWluIHJhdyBNUlMgZGF0YSBmb3JtYXRzIHN0b3JlIGRhdGEgd2l0aG91dCBjb2lsIGNvbWJpbmF0aW9uOyBzcGVjaWZpY2FsbHksIEdFIFAtZmlsZSAoLjcpLCBOSWZUSS1NUlMgKGlmIHRoZSBzb3VyY2UgZGF0YSB3ZXJlIHJhdyksIFBoaWxpcHMgLnJhdywgYW5kIFNpZW1lbnMgVFdJWCAoLmRhdCkgZGF0YS4gR2FubmV0IHVzZXMgZ2VuZXJhbGl6ZWQgbGVhc3Qgc3F1YXJlcyBbQEFuMjAxM10gdG8gb3B0aW1hbGx5IGNvbWJpbmUgdGhlIHNpZ25hbCBmcm9tIHRoZSBtdWx0aXBsZSBSRiBjaGFubmVscy4gSWYgd2F0ZXIgZmlsZXMgYXJlIHByb3ZpZGVkLCB0aGVzZSBkYXRhIHdpbGwgYmUgdXNlZCBhcyByZWZlcmVuY2VzIGZvciBzaWduYWwgd2VpZ2h0aW5nIGFuZCBwaGFzaW5nIG9mIHRoZSBjb2lsIGRhdGEuCgojIyBFZGR5LWN1cnJlbnQgY29ycmVjdGlvbgoKOjo6IGluZm8KPGkgY2xhc3M9ImZhIGZhLWluZm8tY2lyY2xlIiBzdHlsZT0iY29sb3I6IHdoaXRlIj48L2k+Jm5ic3A7IEVkZHktY3VycmVudCBjb3JyZWN0aW9uIGNhbiBvbmx5IGJlIGFwcGxpZWQgaWYgd2F0ZXIgZGF0YSBhcmUgcHJvdmlkZWQuCjo6OgoKSW4gYEdhbm5ldFByZUluaXRpYWxpc2UubWAsIHVzZXJzIGhhdmUgdGhlIG9wdGlvbiB0byBhcHBseSBlZGR5LWN1cnJlbnQgY29ycmVjdGlvbiAoRUNDKSB0byBtZXRhYm9saXRlIGFuZCB3YXRlciBkYXRhLiBJZiBhcHBsaWVkLCBHYW5uZXQgdXNlcyB0aGUgbWV0aG9kIGRlc2NyaWJlZCBieSBLbG9zZSAoMTk5MCkgW0BLbG9zZTE5OTBdLiBUaGUgY29kZSBmb3IgdGhlIEVDQyByb3V0aW5lIGNhbiBiZSBmb3VuZCBpbiBgRWRkeUN1cnJlbnRDb3JyZWN0aW9uLm1gLgoKIyMgTGluZS1icm9hZGVuZGluZyAoYXBvZGl6YXRpb24pCgpGSUQgZGF0YSBhcmUgbXVsdGlwbGllZCBieSBhIHRpbWUtdmFyeWluZyBleHBvbmVudGlhbCB3ZWlnaHRpbmcgZnVuY3Rpb24gd2hlcmUgdGhlIHdlaWdodGluZyBjb25zdGFudCBpcyBzZXQgaW4gYEdhbm5ldFByZUluaXRpYWxpc2UubWAgKDMgSHogaXMgdGhlIGRlZmF1bHQpLgoKIyMgRnJlcXVlbmN5IGFuZCBwaGFzZSBhbGlnbm1lbnQKCkR1cmluZyBhY3F1aXNpdGlvbiwgc3BlY3RyYWwgZGF0YSBhcmUgYWZmZWN0ZWQgYnkgZnJlcXVlbmN5IGFuZCBwaGFzZSBvZmZzZXRzIGFzIGEgcmVzdWx0cyBvZiBiaW9waHlzaWNhbCwgZWxlY3RyaWNhbCwgbWVjaGFuaWNhbCwgYW5kIHBhcnRpY2lwYW50IGZhY3RvcnMuIEdhbm5ldCBoYXMgc2V2ZXJhbCBhbGdvcml0aG1zIHRvIGNvcnJlY3QgZm9yIHRoZXNlIGVycm9ycyBkdXJpbmcgcHJlcHJvY2Vzc2luZy4gVXNlcnMgY2FuIGNob29zZSB3aGljaCBtZXRob2QgdG8gdXNlIGluIGBHYW5uZXRQcmVJbml0aWFsaXNlLm1gLiBUaGUgbWV0aG9kcyBhcmU6Cgp8IDx1Pk1ldGhvZDwvdT4gfCA8dT5PcHRpb248L3U+IHwgPHU+RGVzY3JpcHRpb248L3U+IHwKfCA6LS0tLS0tLS0gfCA6LS0tLSB8IDotLS0tLS0tLS0gfAp8IFJvYnVzdCBzcGVjdHJhbCByZWdpc3RyYXRpb24gW0BNaWtrZWxzZW4yMDIwXSAoZGVmYXVsdCkgfCBgUm9idXN0U3BlY1JlZ2AgfCBBIG1ldGhvZCBiYXNlZCBvbiBzcGVjdHJhbCByZWdpc3RyYXRpb24gW0BOZWFyMjAxNV0gdGhhdCBpcyByb2J1c3QgYWdhaW5zdCBzcGVjdHJhbCBkaXN0b3J0aW9ucyBzdWNoIGFzIHVuc3RhYmxlIHJlc2lkdWFsIHdhdGVyIGFuZCBsaXBpZCBjb250YW1pbmF0aW9uLiAgfAp8IE11bHRpLXN0ZXAgZnJlcXVlbmN5IGFuZCBwaGFzZSBjb3JyZWN0aW9uIFtATWlra2Vsc2VuMjAxOF0gfCBgU3BlY1JlZ0hFUk1FU2AgfCBBIG1ldGhvZCBvcmlnaW5hbGx5IGRldmVsb3BlZCB0byBhbGlnbiBtdWx0aXBsZXhlZCBlZGl0ZWQgSEVSTUVTIGRhdGEuIFRoaXMgYXBwcm9hY2ggaXMgYWxzbyBiYXNlZCBvbiBzcGVjdHJhbCByZWdpc3RyYXRpb24uIHwKCiMjIFBoYXNlIGNvcnJlY3Rpb24KCkl0IGlzIGNvbW1vbiBmb3IgdW5wcm9jZXNzZWQgc3BlY3RyYSB0byBiZSBvdXQgb2YgcGhhc2UuIEdhbm5ldCBhcHBsaWVzIGEgZ2xvYmFsIHplcm8tb3JkZXIgcGhhc2UgY29ycmVjdGlvbiB0byBhbGwgdHJhbnNpZW50cyBieSBmaXR0aW5nIHRoZSByZWFsLXZhbHVlZCAzIHBwbSBDciBhbmQgMy4yIHBwbSBDaG8gc2lnbmFscyBpbiB0aGUgZnJlcXVlbmN5IGRvbWFpbi4KCiMjIFNpZ25hbCBhdmVyYWdpbmcKCkdhbm5ldCBwcm92aWRlcyB0d28gbWV0aG9kcyBmb3IgYXZlcmFnaW5nIGluZGl2aWR1YWwgdHJhbnNpZW50cyAoc2VsZWN0ZWQgaW4gYEdhbm5ldFByZUluaXRpYWxpc2UubWApOiBhcml0aG1ldGljIGF2ZXJhZ2luZyAod2l0aCBvdXRsaWVyIHJlamVjdGlvbikgYW5kIHdlaWdodGVkIGF2ZXJhZ2luZyAodGhlIGRlZmF1bHQpLiBUaGUgY29kZSBmb3IgdGhlIHNpZ25hbCBhdmVyYWdpbmcgcm91dGluZXMgY2FuIGJlIGZvdW5kIGluIGBTaWduYWxBdmVyYWdpbmcubWAuCgojIyMgQXJpdGhtZXRpYyBhdmVyYWdpbmcKCkFyaXRobWV0aWMgYXZlcmFnaW5nIGlzIHN0cmFpZ2h0Zm9yd2FyZC4gQWxsIHNlcXVlbnRpYWxseSBhY3F1aXJlZCAkbiQgcGFpcnMgb2Ygc3Vic3BlY3RyYSAkeF9pJCAoZS5nLiwgYWxsIGVkaXQtT04gYW5kIGVkaXQtT0ZGIHN1YnNwZWN0cmEpIGFyZSBhdmVyYWdlZCB1c2luZyB0aGUgYXJpdGhtZXRpYyBtZWFuOiAkXGJhcnt4fSA9IFxmcmFjezF9e259XHN1bV97aT0xfV5ueF9pJC4KCk5vdGUgdGhhdCBiZWZvcmUgdGhlIGFyaXRobWV0aWMgYXZlcmFnaW5nIG9mIHN1YnNwZWN0cmEsIGluZGl2aWR1YWwgdHJhbnNpZW50cyBhcmUgZXhjbHVkZWQgYmFzZWQgb24gdGhlIG91dGxpZXIgcmVqZWN0aW9uIGFsZ29yaXRobSB1c2VkIGR1cmluZyBmcmVxdWVuY3kgYW5kIHBoYXNlIGFsaWdubWVudC4KCiMjIyBXZWlnaHRlZCBhdmVyYWdpbmcKCldlaWdodGVkIGF2ZXJhZ2luZyBkb3duLXdlaWdodHMgaW5kaXZpZHVhbCBkaWZmZXJlbmNlIHN1YnNwZWN0cmEgdGhhdCBhcmUgY29ycnVwdGVkIGJ5IHNpZ25hbCBhcnRpZmFjdHMg4oCUIHRoaXMgaXMgYW4gaW1wb3J0YW50IGRpc3RpbmN0aW9uIGZyb20gdHJhZGl0aW9uYWwgc2lnbmFsIGF2ZXJhZ2luZy4gRmlyc3QsIHRoZSBkaWZmZXJlbmNlIGJldHdlZW4gc2VxdWVudGlhbGx5IGFjcXVpcmVkIHBhaXJzIChlLmcuLCBhbGwgZWRpdC1PTiBhbmQgZWRpdC1PRkYgc3Vic3BlY3RyYSkgaXMgY2FsY3VsYXRlZC4gQSBzaW1pbGFyaXR5IG1hdHJpeCAkXG1hdGhiZntEfVxpblxtYXRoYmJ7Un1ee1B7XHRpbWVzfVB9JCBpcyBvYnRhaW5lZCBieSBjYWxjdWxhdGluZyB0aGUgbWVhbiBzcXVhcmVkIGVycm9yIGJldHdlZW4gZWFjaCByZWFsLXZhbHVlZCBkaWZmZXJlbmNlIHN1YnNwZWN0cnVtICRwJCBhbmQgZXZlcnkgb3RoZXIgcmVhbC12YWx1ZWQgZGlmZmVyZW5jZSBzdWJzcGVjdHJ1bSAoaW4gdGhlIHJhbmdlIDEuOCB0byAzLjQgcHBtKS4gQSBzaW1pbGFyaXR5IG1ldHJpYyAkZF97cH0kIGlzIGNhbGN1bGF0ZWQgYXMgdGhlIGNvbHVtbi13aXNlIG1lZGlhbiBvZiAkXG1hdGhiZntEfSQuIE5vcm1hbGl6ZWQgd2VpZ2h0cyAkd197cH0kIGFyZSB0aGVuIGRlcml2ZWQsICR3X3twfSA9IGReey0yfV9wL1xzdW17ZF57LTJ9X3B9JCwgYW5kIGFwcGxpZWQgdG8gdGhlIGRpZmZlcmVuY2UgcGFpcnMgYmVmb3JlIHN1bW1hdGlvbi4KCjxicj4KCiMjIyBSZWZlcmVuY2VzCgoKCg==


Built with R Markdown in RStudio

Copyright © 2020–2024, Mark Mikkelsen