mass-spectrometry-database-search
License: restricted — no clear open-source license detected for the underlying tool; verify licensing before commercial use or redistribution.
Summary
Query an unknown mass spectrum against billion-scale spectral databases to identify metabolites and related compounds through spectral similarity matching. This skill enables fast, error-tolerant search of metabolomics MS data at scales previously infeasible with earlier tools.
When to use
You have an unknown mass spectrum (or a representative metabolite spectrum from public data) and need to identify it by comparing it against a large reference library—particularly when the database contains billions of spectra and earlier tools like MASST are too slow or resource-intensive.
When NOT to use
- Your query spectrum is already confidently annotated and does not require identification verification.
- You are searching against a small, local spectral database (< millions of spectra) where MASST or simpler similarity tools are adequate.
Inputs
- Query mass spectrum (USI format or GNPS library spectrum)
- Spectral database connection parameters (database URL or local indexed repository path)
- Mass tolerance threshold (ppm or m/z units)
- Scoring parameters (e.g., dot-product similarity cutoff)
Outputs
- Ranked list of spectral hits (sorted by spectral similarity score)
- Metabolite identifications with confidence scores
- Search execution metadata (elapsed time, result count, resource consumption)
How to apply
Prepare or select a query mass spectrum (in USI format or from the GNPS library) and configure MASST+ with connection parameters to the target spectral database (e.g., GNPS or a local indexed repository). Submit the query via the MASST+ web interface or integrated workflow (e.g., from a molecular networking job) using standard mass tolerance and scoring parameters. MASST+ will execute the search—reducing search time by two orders of magnitude compared to MASST—and rank results by spectral similarity score (dot-product). Monitor query execution time and resource consumption, then retrieve and validate that results are returned with ranked hits. Record completion status, elapsed time, and result count in a summary report.
Related tools
- MASST+ (Primary search engine: executes billion-scale spectral similarity queries and ranks hits by dot-product score) — https://github.com/mohimanilab/MASSTplus
- GNPS (Host platform and reference library: provides web service interface to MASST+, manages molecular networking integration, and serves as the default spectral database backend) — https://proteomics3.ucsd.edu/ProteoSAFe/
- GNPS Molecular Networking (Upstream workflow context: generates clusters and network edges that can be queried via MASST+ for spectral matching at scale)
Evaluation signals
- Query execution completes without timeout or resource exhaustion, regardless of database size (billions of spectra).
- Returned hits are ranked by spectral similarity score (dot-product), with highest-scoring metabolites appearing first.
- Result count and elapsed time are logged and comparable to the two-order-of-magnitude speedup claimed (e.g., seconds to minutes rather than hours).
- Metabolite identifications returned include valid GNPS spectrum IDs, library accessions (MSV, filename, scan), and precursor mass / retention time metadata.
- Search results remain consistent when the same query is resubmitted against the same database snapshot.
Limitations
- Search accuracy is limited by spectral resolution and quality of the reference database; noisy or low-abundance query spectra may return false positives or false negatives.
- Error tolerance and mass tolerance thresholds directly affect both recall and precision; overly lenient parameters may yield spurious matches.
- Integration with molecular networking (via Advanced MASST) requires a completed GNPS networking job; on-the-fly searches require either a USI or a pre-indexed local database.
- Very-large-scale databases (billions of spectra) require indexed storage and sufficient computational resources; raw, unindexed databases may still be prohibitively slow.
Evidence
- [other] MASST+ is capable of querying against databases of billions of mass spectra, whereas this capability was not feasible with MASST.: "MASST+ is capable of querying against databases of billions of mass spectra, which was not feasible with MASST"
- [readme] MASST+ provides fast and error tolerant search of metabolomics mass spectrometry data while reducing the search time by two orders of magnitude.: "MASST+ provides fast and error tolerant search of metabolomics mass spectrometry data while reducing the search time by two orders of magnitude"
- [other] Results are returned ranked by spectral similarity score.: "Retrieve and validate that results are returned (hits ranked by spectral similarity score)"
- [readme] MASST+ can be integrated with molecular networking workflows to search clusters.: "When the job has completed, click 'View All Clusters With IDs'. This will open a new tab, where you can click 'Advanced MASST' and then 'MASST+ Search'"
- [other] Query submission uses standard mass tolerance and scoring parameters.: "Submit the query using MASST+ search interface with standard mass tolerance and scoring parameters"
1---2name: mass-spectrometry-database-search-23description: Use when you have an unknown mass spectrum (or a representative metabolite spectrum from public data) and need to identify it by comparing it against a large reference library—particularly when the database contains billions of spectra and earlier tools like MASST are too slow or resource-intensive.4license: CC-BY-4.05---67# mass-spectrometry-database-search89> **License: restricted** — no clear open-source license detected for the underlying tool; verify licensing before commercial use or redistribution. <!-- asb-license-banner -->10## Summary1112Query an unknown mass spectrum against billion-scale spectral databases to identify metabolites and related compounds through spectral similarity matching. This skill enables fast, error-tolerant search of metabolomics MS data at scales previously infeasible with earlier tools.1314## When to use1516You have an unknown mass spectrum (or a representative metabolite spectrum from public data) and need to identify it by comparing it against a large reference library—particularly when the database contains billions of spectra and earlier tools like MASST are too slow or resource-intensive.1718## When NOT to use1920- Your query spectrum is already confidently annotated and does not require identification verification.21- You are searching against a small, local spectral database (< millions of spectra) where MASST or simpler similarity tools are adequate.2223## Inputs2425- Query mass spectrum (USI format or GNPS library spectrum)26- Spectral database connection parameters (database URL or local indexed repository path)27- Mass tolerance threshold (ppm or m/z units)28- Scoring parameters (e.g., dot-product similarity cutoff)2930## Outputs3132- Ranked list of spectral hits (sorted by spectral similarity score)33- Metabolite identifications with confidence scores34- Search execution metadata (elapsed time, result count, resource consumption)3536## How to apply3738Prepare or select a query mass spectrum (in USI format or from the GNPS library) and configure MASST+ with connection parameters to the target spectral database (e.g., GNPS or a local indexed repository). Submit the query via the MASST+ web interface or integrated workflow (e.g., from a molecular networking job) using standard mass tolerance and scoring parameters. MASST+ will execute the search—reducing search time by two orders of magnitude compared to MASST—and rank results by spectral similarity score (dot-product). Monitor query execution time and resource consumption, then retrieve and validate that results are returned with ranked hits. Record completion status, elapsed time, and result count in a summary report.3940## Related tools4142- **MASST+** (Primary search engine: executes billion-scale spectral similarity queries and ranks hits by dot-product score) — https://github.com/mohimanilab/MASSTplus43- **GNPS** (Host platform and reference library: provides web service interface to MASST+, manages molecular networking integration, and serves as the default spectral database backend) — https://proteomics3.ucsd.edu/ProteoSAFe/44- **GNPS Molecular Networking** (Upstream workflow context: generates clusters and network edges that can be queried via MASST+ for spectral matching at scale)4546## Evaluation signals4748- Query execution completes without timeout or resource exhaustion, regardless of database size (billions of spectra).49- Returned hits are ranked by spectral similarity score (dot-product), with highest-scoring metabolites appearing first.50- Result count and elapsed time are logged and comparable to the two-order-of-magnitude speedup claimed (e.g., seconds to minutes rather than hours).51- Metabolite identifications returned include valid GNPS spectrum IDs, library accessions (MSV, filename, scan), and precursor mass / retention time metadata.52- Search results remain consistent when the same query is resubmitted against the same database snapshot.5354## Limitations5556- Search accuracy is limited by spectral resolution and quality of the reference database; noisy or low-abundance query spectra may return false positives or false negatives.57- Error tolerance and mass tolerance thresholds directly affect both recall and precision; overly lenient parameters may yield spurious matches.58- Integration with molecular networking (via Advanced MASST) requires a completed GNPS networking job; on-the-fly searches require either a USI or a pre-indexed local database.59- Very-large-scale databases (billions of spectra) require indexed storage and sufficient computational resources; raw, unindexed databases may still be prohibitively slow.6061## Evidence6263- [other] MASST+ is capable of querying against databases of billions of mass spectra, whereas this capability was not feasible with MASST.: "MASST+ is capable of querying against databases of billions of mass spectra, which was not feasible with MASST"64- [readme] MASST+ provides fast and error tolerant search of metabolomics mass spectrometry data while reducing the search time by two orders of magnitude.: "MASST+ provides fast and error tolerant search of metabolomics mass spectrometry data while reducing the search time by two orders of magnitude"65- [other] Results are returned ranked by spectral similarity score.: "Retrieve and validate that results are returned (hits ranked by spectral similarity score)"66- [readme] MASST+ can be integrated with molecular networking workflows to search clusters.: "When the job has completed, click 'View All Clusters With IDs'. This will open a new tab, where you can click 'Advanced MASST' and then 'MASST+ Search'"67- [other] Query submission uses standard mass tolerance and scoring parameters.: "Submit the query using MASST+ search interface with standard mass tolerance and scoring parameters"
HolobiomicsLab