GC-MS Deconvolution for GNPS

The GC-MS data have to be processed before performing the spectral library search and molecular networking workflow. See more information here. Below, we describe how to use the GC-MS deconvolution workflow on GNPS that uses MS-Hub. Alternatively, ADAP-MZmine or MS-DIAL can be used.

GC-MS Deconvolution Workflow on GNPS with MS-Hub

Configure the Workflow

Log in to GNPS (gnps.ucsd.edu). If an account has to be created first, refer to GNPS documentation at the quickstart banner. Before starting, files from GC-MS analysis must be converted from proprietary vendor formats to .mzML, or .CDF file formats. To convert, please see our conversion guide.

The GNPS home page includes two sections to launch GNPS GC-MS data analysis job, one for data processing - deconvolution and one for GC-MS library search/networking. By clicking on the “Process Raw GC-MS data” icon, a job page opens.

img

(1) Start by entering the title of your job.

(2) The “Select Files” section allows importing existing or previously uploaded dataset(s) from MassIVE. Select the files that need to be processed by clicking on “Select Input Files”. A pop-up window appears with three tabs: “Select Input Files”, “Upload Files”, and “Share Files”. To upload files to GNPS using the browser (limited to 20MB), you can use our web drag and drop uploader in the “Upload Files” banner. See the documentation here for more information.

(3) Readers following the tutorial can go to the “Share Files” tab, enter the MassIVE accession number for the dataset (e.g. MSV000084226) in the “Import Data Share” box.

(4) Then click on “Import”.

(5) This specific dataset is now available directly in your GNPS user workspace at the “Select Input Files” section.

(6) Select the input file, who appears highlighted in blue color, and click on “Spectrum files”.

(7) When the selected files are visible in the “Selected Spectrum Files” box, click on the “Finish Selection” button.

img

NOTE:

  • All of the data used for the job must be collected using the same GC protocol (temperature program, column, injection mode). Multiple datasets could be combined as long as the data have been collected using the same protocol.
  • When creating a dataset on MassIVE (massive.ucsd.edu), include “GNPS” and “GC” in the name (As GNPS_GC_Name of the GNPS-MassIVE dataset). See the documentation about Dataset Creation/Sharing and an example of a MassIVE dataset MSV000084226 for more information.
  • An insufficient volume of data causes unstable deconvolution resulting in spurious low-quality spectra. It is recommended for datasets smaller than ~10 files to use alternative deconvolution solutions such as MZMine2/ADAP, MS-Dial or XCMS. Increasing the number of files, for example, could be done by co-analyzing multiple datasets obtained with the same experimental protocol.

The “Advanced MSHub Processing” section displays some automatic setting parameters (related to peak symmetry and baseline adjustment) determined internally by MSHub. The user does not need to provide settings, although they can be set manually, should the user choose to do so.

(8) In the “Advanced Clustering” section, the cluster spectra have to be turned off (CLUSTER_SPECTRA = NO). The TIME_UNIT must be set as minutes or seconds, depending on the chromatography time units of your data (typically the default time units are seconds in NetCDF files and minutes in .mzML files).

(9) Enter your email address.

(10) Finish by clicking “Submit”.

img

Inspect the Results

When the job has been completed, you will receive a notification email and the status “DONE” appears on your GNPS job. All submitted jobs appear under the “jobs” link from the GNPS main menu.

img

By selecting the job of interest and clicking on the “Done” button, the “Job Status” window opens with different options:

(i) Explore deconvolution results with the “View All Deconvolved Spectra” option.

(ii) Download/export quantification results and feature table by clicking on “Download Spectra as MGF”, “Download Feature Table” (MZmine formatted), "Download MSHub Data Integral Table", or "Download MSHub Spectra Data".

(iii) Continue the process with the “Search Spectral Library and Molecular Network” tool to conduct a library search and create a molecular network.

img

The first line of the MSHub data integral table indicates the retention time (in min.) with a balance score in parenthesis (in percentage). The “Rel. Max Integral” and “Sample\Best order” values relate to the relative proportion of each peak in the data and the ranking of the feature in terms of its size, correspondingly.

img

The feature table is formatted as a MZmine table output.

img

GC-MS data processing with ADAP-MZmine

[to be completed]

GC-MS data processing with MS-DIAL

[to be completed]

Page contributors

Alexander Aksenov (UCSD), Melissa Nothias-Esposito (UCSD), Mabel C. Gonzales (UCSD), Louis Felix Nothias (UCSD).