Abstract
We describe a new comprehensive and open-source MATLAB library, called the Visual Display Interface (VDI), designed to process, model, quantify and visualize magnetic resonance spectroscopy (MRS) and spectroscopic imaging (MRSI) data. The library focuses on three major strengths: promoting reproducible research by creating comprehensive data logging and reporting and identifying outlier datasets; seamlessly combining spectral and spatial processing of both single and multivoxel data; and offering a modern, object-oriented design. VDI handles a wide range of common tasks, including spectral and spatial transforms, built-in spectral fitting, absolute quantification, and running density-matrix simulations for coupled and uncoupled spin systems to generate appropriate basis sets and aid in sequence design. VDI interfaces with the Statistical Parameteric Mapping (SPM) toolbox to carry out tissue segmentation, calculate tissue fractions within voxels, derive mean metabolite values from regions of interest defined by anatomical or functional atlases, and perform linear regression for global white matter and gray matter metabolite concentrations. The library’s workings are demonstrated for two tasks: (1) Pre-processing, fitting and analysis of single-voxel proton MRS data from healthy volunteers; and (2) Extracting region-specific metabolite concentrations from spectroscopic imaging data based on an existing cortical atlas in MNI space, and calculating average gray and white matter global concentrations using linear regression.
Competing Interest Statement
The authors have declared no competing interest.
Funding Statement
the Israel Science Foundation (Personal Grant 416/20); the National Natural Science Foundation of China (Grant No. 62001290).
Author Declarations
I confirm all relevant ethical guidelines have been followed, and any necessary IRB and/or ethics committee approvals have been obtained.
Yes
The details of the IRB/oversight body that provided approval or exemption for the research described are given below:
All data used in the current publication were previously published (T. Finkelman, E. Furman-Haran, R. Paz and A. Tal, NeuroImage 247(15):118810 (2022)), made available publicly by request from Authors, and approved by an appropriate IRB board.
I confirm that all necessary patient/participant consent has been obtained and the appropriate institutional forms have been archived, and that any patient/participant/sample identifiers included were not known to anyone (e.g., hospital staff, patients or participants themselves) outside the research group so cannot be used to identify individuals.
Yes
I understand that all clinical trials and any other prospective interventional studies must be registered with an ICMJE-approved registry, such as ClinicalTrials.gov. I confirm that any such study reported in the manuscript has been registered and the trial registration ID is provided (note: if posting a prospective study registered retrospectively, please provide a statement in the trial ID field explaining why the study was not registered in advance).
Yes
I have followed all appropriate research reporting guidelines, such as any relevant EQUATOR Network research reporting checklist(s) and other pertinent material, if applicable.
Yes
Footnotes
Sponsors, Grants & Funding: Assaf Tal acknowledges the support of the Monroy-Marks Career Development Fund and the historic generosity of the Harold Perlman Family. Assaf Tal acknowledges the support of the Israel Science Foundation (Personal Grant 416/20). Yiling Liu and Zhiyong Zhang acknowledge the support of the National Natural Science Foundation of China (No. 62001290)
Data Availability
The VDI software and all example data discussed herein are available from the software website directly, at www.vdisoftware.net
