spectral-similarity-network-generation
Summary
Generate a spectral similarity graph by uploading processed MS/MS feature tables and spectral data to the GNPS web-platform, configuring molecular networking parameters, and retrieving node and edge tables that represent compounds/spectra and their spectral similarity relationships.
When to use
After feature detection and alignment across LC-MS/MS runs (via MZmine2 or Optimus) have produced a feature quantification table and MGF file with MS/MS spectra, and you need to discover molecular relationships and detect unknown compounds through spectral clustering and library matching.
When NOT to use
- Input MS/MS data lacks proper precursor m/z or retention time annotation — GNPS requires complete spectral metadata.
- Feature table has not undergone quality filtering (e.g., blank/control exclusion, reproducibility checks in QC replicates) — unfiltered features will produce noisy network topology.
- The goal is targeted compound identification rather than untargeted molecular relationship discovery — consider MS/MS library matching workflows instead.
Inputs
- feature quantification table (CSV format with aligned features and intensities across samples)
- MS/MS spectral data (MGF or mzML format with precursor m/z, retention time, and MS/MS fragmentation spectra)
Outputs
- node table (list of compounds/spectra with metadata)
- edge table (spectral similarity links with similarity scores and edge filtering information)
- spectral similarity network graph (for import into Cytoscape or other visualization tools)
How to apply
Prepare your feature table and MS/MS data in formats accepted by GNPS (typically mzML or MGF containing precursor m/z, retention time, and MS/MS spectra). Access the GNPS web-platform at http://gnps.ucsd.edu and upload the processed data. Configure molecular networking parameters including spectral similarity scoring (typically cosine similarity) and edge filtering thresholds to define when two spectra are considered connected. Submit the job to the GNPS platform to compute the spectral similarity graph. Retrieve the resulting node table containing compounds/spectra identifiers and the edge table containing spectral similarity links and scores between pairs of spectra. The edge table defines the network topology for downstream visualization and analysis.
Related tools
- MZmine2 (Feature detection, alignment, and quantification to produce feature table and MGF spectral file for GNPS submission) — http://mzmine.github.io/
- Optimus (Alternative LC-MS feature detection and quantification using OpenMS algorithms to generate feature table and MS/MS data for GNPS networking) — https://github.com/MolecularCartography/Optimus
- GNPS (Web-platform for spectral similarity graph computation, molecular networking, and spectral library matching) — http://gnps.ucsd.edu
- Cytoscape (Visualization and interactive exploration of the spectral similarity network graph (node and edge tables from GNPS)) — http://www.cytoscape.org/
Evaluation signals
- Node table contains all input spectra with unique identifiers and includes metadata fields (precursor m/z, retention time, sample origin).
- Edge table contains pairs of node IDs with spectral similarity scores and respects the configured edge filtering threshold (e.g., cosine similarity > 0.7).
- Network connectivity is meaningful: isolated nodes indicate spectra with low similarity to library or other samples; dense clusters indicate co-eluting or chemically related compounds.
- Node and edge tables can be successfully imported into Cytoscape without schema errors or missing required fields.
- GNPS output includes quality metrics such as number of connected components, average node degree, and number of library matches (MS/MS validation).
Limitations
- GNPS spectral similarity relies on cosine similarity scoring of fragmentation patterns; structural isomers or compounds with similar MS/MS spectra may be incorrectly linked.
- Edge thresholds must be tuned per compound class and ionization method; too stringent filtering may disconnect true analogues, too permissive filtering introduces false edges.
- Molecular networking does not validate spectral annotations; MS/MS library matches require manual inspection or secondary validation (e.g., by Sirius or MS-FINDER in-silico prediction).
- Large datasets (hundreds of LC-MS runs) may require parameter optimization and extended computation time on GNPS servers.
- Spectra lacking MS/MS data or with very few fragment ions may not form network edges and will appear as isolated nodes.
Evidence
- [other] Prepare feature table and MS/MS data in the format required by GNPS (typically mzML or MGF with precursor m/z, retention time, and MS/MS spectra).: "Prepare feature table and MS/MS data in the format required by GNPS (typically mzML or MGF with precursor m/z, retention time, and MS/MS spectra)."
- [other] Access the GNPS web-platform at http://gnps.ucsd.edu and upload the processed data. Configure molecular networking parameters including spectral similarity scoring and edge filtering thresholds. Submit the job to the GNPS platform to compute the spectral similarity graph.: "Access the GNPS web-platform at http://gnps.ucsd.edu and upload the processed data. Configure molecular networking parameters including spectral similarity scoring and edge filtering thresholds."
- [other] Retrieve the resulting node table (compounds/spectra) and edge table (spectral similarity links) from GNPS output.: "Retrieve the resulting node table (compounds/spectra) and edge table (spectral similarity links) from GNPS output."
- [readme] The workflow relies on open bioinformatic tools, such MZmine2 or Optimus (using OpenMS), a Jupyter notebook, and the GNPS web-platform: "The workflow relies on open bioinformatic tools, such MZmine2 or Optimus (using OpenMS), a Jupyter notebook, and the GNPS web-platform"
- [readme] Process your data following instructions described in the GNPS feature-based molecular networking workflow (FBMN) documentation.: "Process your data following instructions described in the GNPS feature-based molecular networking workflow (FBMN) documentation."
1---2name: spectral-similarity-network-generation-23description: Use when after feature detection and alignment across LC-MS/MS runs (via MZmine2 or Optimus) have produced a feature quantification table and MGF file with MS/MS spectra, and you need to discover molecular relationships and detect unknown compounds through spectral clustering and library matching.4license: CC-BY-4.05---67# spectral-similarity-network-generation89## Summary1011Generate a spectral similarity graph by uploading processed MS/MS feature tables and spectral data to the GNPS web-platform, configuring molecular networking parameters, and retrieving node and edge tables that represent compounds/spectra and their spectral similarity relationships.1213## When to use1415After feature detection and alignment across LC-MS/MS runs (via MZmine2 or Optimus) have produced a feature quantification table and MGF file with MS/MS spectra, and you need to discover molecular relationships and detect unknown compounds through spectral clustering and library matching.1617## When NOT to use1819- Input MS/MS data lacks proper precursor m/z or retention time annotation — GNPS requires complete spectral metadata.20- Feature table has not undergone quality filtering (e.g., blank/control exclusion, reproducibility checks in QC replicates) — unfiltered features will produce noisy network topology.21- The goal is targeted compound identification rather than untargeted molecular relationship discovery — consider MS/MS library matching workflows instead.2223## Inputs2425- feature quantification table (CSV format with aligned features and intensities across samples)26- MS/MS spectral data (MGF or mzML format with precursor m/z, retention time, and MS/MS fragmentation spectra)2728## Outputs2930- node table (list of compounds/spectra with metadata)31- edge table (spectral similarity links with similarity scores and edge filtering information)32- spectral similarity network graph (for import into Cytoscape or other visualization tools)3334## How to apply3536Prepare your feature table and MS/MS data in formats accepted by GNPS (typically mzML or MGF containing precursor m/z, retention time, and MS/MS spectra). Access the GNPS web-platform at http://gnps.ucsd.edu and upload the processed data. Configure molecular networking parameters including spectral similarity scoring (typically cosine similarity) and edge filtering thresholds to define when two spectra are considered connected. Submit the job to the GNPS platform to compute the spectral similarity graph. Retrieve the resulting node table containing compounds/spectra identifiers and the edge table containing spectral similarity links and scores between pairs of spectra. The edge table defines the network topology for downstream visualization and analysis.3738## Related tools3940- **MZmine2** (Feature detection, alignment, and quantification to produce feature table and MGF spectral file for GNPS submission) — http://mzmine.github.io/41- **Optimus** (Alternative LC-MS feature detection and quantification using OpenMS algorithms to generate feature table and MS/MS data for GNPS networking) — https://github.com/MolecularCartography/Optimus42- **GNPS** (Web-platform for spectral similarity graph computation, molecular networking, and spectral library matching) — http://gnps.ucsd.edu43- **Cytoscape** (Visualization and interactive exploration of the spectral similarity network graph (node and edge tables from GNPS)) — http://www.cytoscape.org/4445## Evaluation signals4647- Node table contains all input spectra with unique identifiers and includes metadata fields (precursor m/z, retention time, sample origin).48- Edge table contains pairs of node IDs with spectral similarity scores and respects the configured edge filtering threshold (e.g., cosine similarity > 0.7).49- Network connectivity is meaningful: isolated nodes indicate spectra with low similarity to library or other samples; dense clusters indicate co-eluting or chemically related compounds.50- Node and edge tables can be successfully imported into Cytoscape without schema errors or missing required fields.51- GNPS output includes quality metrics such as number of connected components, average node degree, and number of library matches (MS/MS validation).5253## Limitations5455- GNPS spectral similarity relies on cosine similarity scoring of fragmentation patterns; structural isomers or compounds with similar MS/MS spectra may be incorrectly linked.56- Edge thresholds must be tuned per compound class and ionization method; too stringent filtering may disconnect true analogues, too permissive filtering introduces false edges.57- Molecular networking does not validate spectral annotations; MS/MS library matches require manual inspection or secondary validation (e.g., by Sirius or MS-FINDER in-silico prediction).58- Large datasets (hundreds of LC-MS runs) may require parameter optimization and extended computation time on GNPS servers.59- Spectra lacking MS/MS data or with very few fragment ions may not form network edges and will appear as isolated nodes.6061## Evidence6263- [other] Prepare feature table and MS/MS data in the format required by GNPS (typically mzML or MGF with precursor m/z, retention time, and MS/MS spectra).: "Prepare feature table and MS/MS data in the format required by GNPS (typically mzML or MGF with precursor m/z, retention time, and MS/MS spectra)."64- [other] Access the GNPS web-platform at http://gnps.ucsd.edu and upload the processed data. Configure molecular networking parameters including spectral similarity scoring and edge filtering thresholds. Submit the job to the GNPS platform to compute the spectral similarity graph.: "Access the GNPS web-platform at http://gnps.ucsd.edu and upload the processed data. Configure molecular networking parameters including spectral similarity scoring and edge filtering thresholds."65- [other] Retrieve the resulting node table (compounds/spectra) and edge table (spectral similarity links) from GNPS output.: "Retrieve the resulting node table (compounds/spectra) and edge table (spectral similarity links) from GNPS output."66- [readme] The workflow relies on open bioinformatic tools, such MZmine2 or Optimus (using OpenMS), a Jupyter notebook, and the GNPS web-platform: "The workflow relies on open bioinformatic tools, such MZmine2 or Optimus (using OpenMS), a Jupyter notebook, and the GNPS web-platform"67- [readme] Process your data following instructions described in the GNPS feature-based molecular networking workflow (FBMN) documentation.: "Process your data following instructions described in the GNPS feature-based molecular networking workflow (FBMN) documentation."
HolobiomicsLab 