Skip to content

Repository files navigation

MetaMorpheus: Free, Open-Source PTM Discovery

Release Build status Tests codecov Github All Releases Github All Releases

Anaconda-Server Badge Anaconda-Server Badge Anaconda-Server Badge

Download the current version here. For first-time Windows users, choose "MetaMorpheusInstaller.msi" and install MetaMorpheus. Check out our getting started playlist on YouTube

MetaMorpheus is a bottom-up proteomics database search software with integrated post-translational modification (PTM) discovery capability. This program combines features of Morpheus and G-PTM-D in a single tool.

Check out the wiki page for software details!

Major Features

  • Database Search: A robust search algorithm that identifies peptides by their fragmentation spectra. Watch our Search task YouTube video
  • Calibration: A calibration tool that uses peptides identified by a database search to calibrate the m/z values of all peaks in the spectra. This improves the quality of any subsequent search or analysis of the data. Watch our calibration task YouTube video.
  • G-PTM-D: Post-translational modification (PTM) discovery, which expands the scope of peptide identifications to include both known and unknown PTMs. Watch our GPTMD task YouTube video.
  • Quantification: Ultrafast label-free peptide quantification with FlashLFQ. MS2-identified peptides are used as "seeds" for peakfinding, including PTM-containing peptides. Watch our Label-free quantification with MetaMorpheus video on YouTube.
  • O-glycopeptide Characterization: O-Pair Search identifies O-glycopeptides using an ion-indexed open modification search and localizes O-glycosites using graph theory and probability-based localization.

System Requirements

  • Environment:
    • 64-bit operating system
    • .NET 10.0, from https://dotnet.microsoft.com/en-us/download/dotnet/10.0 — that page offers installers for Windows, macOS (both Intel and Apple Silicon) and Linux
      • Running the GUI needs the Desktop Runtime (the plain Runtime is not enough for WPF); the CLI needs only the Runtime, and building from source needs the SDK
  • Note that the installer (MetaMorpheusInstaller.msi) only works on Windows. The command-line version of MetaMorpheus supports any operating system that supports .NET (Windows, macOS, Linux)
  • 8 GB RAM recommended

Spectra Requirements

  • One of the following formats:
  • MS1 and MS2 scans
  • If you would like to know more about the types of files that can be searched with MetaMorpheus, please watch our Mass Spectra Files Video on YouTube.

Agreeing to the Thermo licence

Reading Thermo .raw files requires agreeing to Thermo's RawFileReader licence. The GUI asks the first time a .raw file is added; the command line asks the first time a run includes one.

Where there is no console to answer that prompt — a container, a scheduled cluster job, a CI runner, anything with stdin redirected or closed — pass --acceptThermoLicence. It prints the licence, records the agreement, and does not prompt:

dotnet CMD.dll --acceptThermoLicence

It may also be given alongside a run, which then proceeds without prompting:

dotnet CMD.dll --acceptThermoLicence -t SearchTask.toml -d database.fasta -s spectra.raw -o output

The agreement is stored as UserHasAgreedToThermoRawFileReaderLicence in settings.toml in the MetaMorpheus data directory. For a Windows installation that is %LOCALAPPDATA%\MetaMorpheus, so it is recorded once per user and survives upgrades. Otherwise it is the folder MetaMorpheus was extracted into, so a new download, conda environment or container layer will need the agreement again.

Database Requirements

UniProt .XML or .fasta format; may be used in compressed (.gz) format. If you would like to know how to obtain a UniProt .XML databases, please watch our Protein Databases Video on YouTube.

Getting Started

Please check out our wiki for useful information and guides.

Installation and typical usage is described for the on the Getting Started page:

References & Citation Guide for MetaMorpheus

MetaMorpheus:

GPTMD searches:

Quantification:

Crosslinking MS (XL-MS) search: Identification of MS-Cleavable and Noncleavable Chemically Cross-Linked Peptides with MetaMorpheus , J. Proteome Res. 2018, 17, 7, 2370–2376.

Multiple protease parsimony: Improved Protein Inference from Multiple Protease Bottom-Up Mass Spectrometry Data, J Proteome Res 2019, 18, 9, 3429–3438.

Glycoproteomic searches: O-Pair Search with MetaMorpheus for O-glycopeptide characterization, Nat Methods 2020, 17, 1133–1138.

Proteogenomic database searches with Spritz: Spritz: A Proteogenomic Database Engine, J Proteome Res 2021, 20, 1826–1834.

Long-read proteogenomic characterization: Enhanced protein isoform characterization through long-read proteogenomics, Genome Biology 2022, 23, 69.

Spectral library GPTMD search: A Hybrid Spectral Library and Protein Sequence Database Search Strategy for Bottom-Up and Top-Down Proteomic Data Analysis, J of Proteome Res 2022, 21, 2609-2618

Spectral Averaging: Spectral averaging with outlier rejection algorithms to increase identifications in top-down proteomics

mzLib, an all-purpose mass spectrometry toolchest implemented by MetaMorpheus

mzLib is a nuget package that we created as an all-purpose toolchest for mass-spec data analysis and many of its functions provide the tools for MetaMorpheus. mzLib is freely available for use in mass-spec applications. You do not need to download mzLib separately to run MetaMorpheus; it is already included.

About

Proteomics search software with integrated calibration, PTM discovery, bottom-up, top-down and LFQ capabilities

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

111 stars

Watchers

7 watching

Forks

Releases

Packages

Used by

Contributors

Languages