MetaMorpheus: Free, Open-Source PTM Discovery

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 Core 5.0:
    • Windows: https://dotnet.microsoft.com/download/dotnet/thank-you/runtime-desktop-5.0.4-windows-x64-installer
    • Mac: https://dotnet.microsoft.com/download/dotnet/thank-you/runtime-5.0.4-macos-x64-installer
    • Linux: https://docs.microsoft.com/dotnet/core/install/linux-package-managers
• Note that the installer (MetaMorpheusInstaller.msi) only works on Windows. The command-line version of MetaMorpheus supports any operating system that supports .NET Core (Windows, MacOS, Linux)
• 8 GB RAM recommended

Spectra Requirements

• One of the following formats:
  • Thermo .raw (Windows and Linux only)
  • .mzML file in centroid mode. Please watch our How to convert files to .mzML video on YouTube.
  • .mgf
• 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.

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.

Test Installation (Windows GUI)

1. Download the latest MetaMorpheusInstaller.msi release, and install MetaMorpheus.
2. Download the example spectra and database files.
3. Open MetaMorpheus from the start menu, and drag and drop the .raw spectra files and the UniProt .xml database into MetaMorpheus.
4. Add a series of Tasks to make a workflow for MetaMorpheus to follow. Drag the .toml files (these files store MetaMorpheus's search parameters) (Task1 - Task5) into the application.

• Task1-SearchTaskconfig.toml - the standard search functionality.
• Task2-CalibrateTaskconfig.toml - will mass-calibrate the spectra file based on high scoring search results and write a new calibrated .mzML file.
• Task3-SearchTaskconfig.toml - searches the newly calibrated data file, which demonstrates improved performance (more PSMs, lower mass errors) and allows for tighter search tolerances.
• Task4-GPTMDTaskconfig.toml - searches the calibrated data file to find high-probability PTMs. This search task generates a new .xml protein database with annotated PTM possibilities discovered by G-PTM-D.
• Task5-SearchTaskconfig.toml - searches the calibrated input file against the G-PTM-D .xml database. This search result is the highest confidence in terms of total PSMs and modified peptides.

5. Click "Run All Tasks!"
6. As the third task completes, open the results.txt files for the first and third tasks (before and after calibration, respectively). Observe the increase in the number of confident PSMs and identified peptides due to calibration.
7. As the fifth task completes, open the results.txt files for the third and fifth tasks. Observe the increase in the number of confident PSMs identified due to discovered PTM-containing peptides.

Typical Usage (Windows GUI)

1. Open MetaMorpheus from the start menu, and drag and drop your .raw spectra files and protein database into the GUI.
2. Select "New Calibrate Task" tab and enter appropriate search parameters, using slightly liberal mass tolerances. Then "Add the Calibration Task". Subsequent tasks (searches) will use suggested ppm tolerances automatically generated by the calibration task.
3. Select "New GPTMD Task" tab. Specify the G-PTM-D modifications that you think may be present in your sample. Many typical modifications are pre-selected. Then "Add the GPTMD Task".
4. Select "New Search Task" tab. Specify the Post-Search Parameters (e.g. protein parsimony, quantification). Then "Add the Search Task".
5. Select "Run all tasks!". This search automatically looks for PTMs uncovered in the G-PTM-D step.

Test Installation (Windows Command Line Executable)

Please watch our "How to run MetaMorpheus command line video on YouTube

1. Download the latest release. Extract "MetaMorpheus_CommandLine.zip" using, for example, 7-Zip.
2. Download the example spectra and database files at https://uwmadison.box.com/v/MetaMorpheusPublic to the folder with the CMD.exe executable.
3. Run the command:

CMD.exe -t Task1-SearchTaskconfig.toml Task2-CalibrateTaskconfig.toml Task3-SearchTaskconfig.toml Task4-GPTMDTaskconfig.toml Task5-SearchTaskconfig.toml -s 04-30-13_CAST_Frac4_6uL.raw 04-30-13_CAST_Frac5_4uL.raw -d uniprot-mouse-reviewed-1-24-2018.xml.gz uniprot-cRAP-1-24-2018.xml.gz

4. As the third task completes, open the results.txt files for the first and third tasks (before and after calibration). Observe the increase in the number of confident PSMs identified due to calibration.
5. As the fifth task completes, open the results.txt files for the third and fifth tasks. Observe the increase in the number of confident PSMs identified due to an addition of new plausible PTMs.

Test Installation (via .NET Core .dll - Linux, macOS, Windows)

1. Download the latest release. Extract files from "MetaMorpheus_CommandLine.zip".
2. Download the files at https://uwmadison.box.com/v/MetaMorpheusPublic to the folder with the CMD.dll file.
3. Run the command:

• Thermo RAW files - Linux and Windows only (Thermo does not support macOS):

dotnet CMD.dll -t Task1-SearchTaskconfig.toml Task2-CalibrateTaskconfig.toml Task3-SearchTaskconfig.toml Task4-GPTMDTaskconfig.toml Task5-SearchTaskconfig.toml -s 04-30-13_CAST_Frac4_6uL.raw 04-30-13_CAST_Frac5_4uL.raw -d uniprot-mouse-reviewed-1-24-2018.xml.gz uniprot-cRAP-1-24-2018.xml.gz

• mzML files - Linux, macOS:

dotnet CMD.dll -t Task1-SearchTaskconfig.toml Task2-CalibrateTaskconfig.toml Task3-SearchTaskconfig.toml Task4-GPTMDTaskconfig.toml Task5-SearchTaskconfig.toml -s mzML/04-30-13_CAST_Frac4_6uL.mzML mzML/04-30-13_CAST_Frac5_4uL.mzML -d uniprot-mouse-reviewed-1-24-2018.xml.gz uniprot-cRAP-1-24-2018.xml.gz

• mzML files - Windows

dotnet CMD.dll -t Task1-SearchTaskconfig.toml Task2-CalibrateTaskconfig.toml Task3-SearchTaskconfig.toml Task4-GPTMDTaskconfig.toml Task5-SearchTaskconfig.toml -s mzML\04-30-13_CAST_Frac4_6uL.mzML mzML\04-30-13_CAST_Frac5_4uL.mzML -d uniprot-mouse-reviewed-1-24-2018.xml.gz uniprot-cRAP-1-24-2018.xml.gz

Test Conda Installation (Linux, macOS, Windows)

1. Install miniconda.
2. Open the terminal and enter conda install -c conda-forge metamorpheus.
3. Download the files at https://uwmadison.box.com/v/MetaMorpheusPublic.
4. Within that folder, run the command:

• Thermo RAW files - Linux and Windows only (Thermo does not support macOS):

metamorpheus -t Task1-SearchTaskconfig.toml Task2-CalibrateTaskconfig.toml Task3-SearchTaskconfig.toml Task4-GPTMDTaskconfig.toml Task5-SearchTaskconfig.toml -s 04-30-13_CAST_Frac4_6uL.raw 04-30-13_CAST_Frac5_4uL.raw -d uniprot-mouse-reviewed-1-24-2018.xml.gz uniprot-cRAP-1-24-2018.xml.gz

• mzML files - Linux, macOS:

metamorpheus -t Task1-SearchTaskconfig.toml Task2-CalibrateTaskconfig.toml Task3-SearchTaskconfig.toml Task4-GPTMDTaskconfig.toml Task5-SearchTaskconfig.toml -s mzML/04-30-13_CAST_Frac4_6uL.mzML mzML/04-30-13_CAST_Frac5_4uL.mzML -d uniprot-mouse-reviewed-1-24-2018.xml.gz uniprot-cRAP-1-24-2018.xml.gz

• mzML files - Windows

metamorpheus -t Task1-SearchTaskconfig.toml Task2-CalibrateTaskconfig.toml Task3-SearchTaskconfig.toml Task4-GPTMDTaskconfig.toml Task5-SearchTaskconfig.toml -s mzML\04-30-13_CAST_Frac4_6uL.mzML mzML\04-30-13_CAST_Frac5_4uL.mzML -d uniprot-mouse-reviewed-1-24-2018.xml.gz uniprot-cRAP-1-24-2018.xml.gz

mzLib

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.

References

• Enhanced Global Post-translational Modification Discovery with MetaMorpheus--J Proteome Res. 2018 May 4;17(5):1844-1851

• Global Post-translational Modification Discovery--J. Proteome Res., 2017, 16, 1383-1390

• Global Identification of Protein Post-translational Modifications in a Single-Pass Database Search--J. Proteome Res., 2015, 14 (11), pp 4714–4720

• A Proteomics Search Algorithm Specifically Designed for High-Resolution Tandem Mass Spectra--J. Proteome Res., 2013, 12 (3), pp 1377–1386