Bottom-up proteomics database search software with integrated posttranslational modification (PTM) discovery capability
Clone or download
acesnik and rmillikin IntersectsVariationFix (#1522)
* psm includes variant fix

* update mzLib
Latest commit 4c69a31 Nov 15, 2018

README.md

MetaMorpheus: Free, Open-Source PTM Discovery Tweet

Build status codecov

Download the current version here. For first-time Windows users, choose "MetaMorpheusInstaller.msi" and install MetaMorpheus. Check out our getting started video 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.
  • 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.
  • G-PTM-D: Post-translational modification (PTM) discovery, which expands the scope of peptide identifications to include both known and unknown PTMs.
  • Quantification: Ultrafast label-free peptide quantification with FlashLFQ. MS2-identified peptides are used as "seeds" for peakfinding, including PTM-containing peptides.

System Requirements

Spectra Requirements

  • One of the following formats:
    • Thermo .raw
    • .mzML file in centroid mode
    • .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 from https://uwmadison.box.com/v/MetaMorpheusPublic.
  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.
  • Task1SearchExample.toml - the standard search functionality.
  • Task2CalibrationExample.toml - will mass-calibrate the spectra file based on high scoring search results and write a new calibrated .mzML file.
  • Task3SearchExample.toml - searches the newly calibrated data file, which demonstrates improved performance (more PSMs, lower mass errors) and allows for tighter search tolerances.
  • Task4GptmdExample.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.
  • Task5SearchExample.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.
  1. Click "Run All Tasks!"
  2. 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.
  3. 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)

  1. Download the latest release. Extract "MetaMorpheusDotNetFrameworkAppveyor.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 Task1SearchExample.toml Task2CalibrationExample.toml Task3SearchExample.toml Task4GptmdExample.toml Task5SearchExample.toml -s 04-30-13_CAST_Frac4_6uL.raw 04-30-13_CAST_Frac5_4uL.raw -d uniprot-mouse-reviewed-3-9-2017.xml.gz uniprot-cRAP-1-24-2018.xml.gz
  1. 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.
  2. 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 (.NET Core)

  1. Download the latest release. Extract files from "MetaMorpheusDotNetCoreAppveyor.zip".
  2. Download the files at https://uwmadison.box.com/v/MetaMorpheusPublic to the folder with the CMD.dll file.
  3. Run the command:
dotnet CMD.dll -t Task1SearchExample.toml Task2CalibrationExample.toml Task3SearchExample.toml Task4GptmdExample.toml Task5SearchExample.toml -s 04-30-13_CAST_Frac4_6uL.raw 04-30-13_CAST_Frac5_4uL.raw -d uniprot-mouse-reviewed-3-9-2017.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