cschlaffner / PoGo

PoGo is a proteogenomic tool which allows mapping of peptides identified through mass spectrometry to a reference genome through provided gene annotation.
http://www.sanger.ac.uk/science/tools/pogo
GNU General Public License v3.0
11 stars 7 forks source link

PoGo

Overview

In proteogenomic analyses it is essential to know the loci giving rise to peptides in order to improve genomic annotation and the functional characterization of protein products in their biological context. With next-generation sequencing of DNA and RNA for each sample studied by proteomic mass spectrometry integration and visualisation in a common coordinate system, i.e. the genome, is vital for systems biology. Advances in technology in mass spectrometry now allow almost complete quantification of the sample proteome. With research moving to protein quantitative trait loci (pQTL) to identify genomic alterations with functional effects on the proteome and the high complexity of combinations thereof integration and visualisation of protein and peptide quantification on genomic loci is paramount for this type of analysis. Furthermore, moving towards more personal multi-omics studies comparative visualisation of proteomic data on a genome has been lacking. Not only genomic variation affecting proteins have come into focus of functional integration studies but also post-translational modifications (PTM), the effect of single nucleotide variants and other alterations on PTMs and alternative modification loci, and the effects of alternative PTMs on protein abundance have become more a centre of attention for researchers. To facilitate this type of integration not only the genomic locations of modified peptides but specifically the genomic loci of associated with these modifications is required. Here, we provide a mapping tool, PoGo, to quickly and efficiently identify genomic loci of peptides and post-translational modifications and couple these mappings with associated quantitative values over multiple samples. Using reference gene annotation and an associated transcript translations our tool identifies the genomic loci of peptides given as input and generates output in different formats borrowed from genomics and transcriptomics which can be loaded in various genome browsers such as UCSC Genome Browser, Ensembl Genome Browser, BioDalliance, and the Integrative Genomics Viewer.

Download and Instiallation

PoGo source code is written to support compilation on Windows, Mac and Linux systems. Executables can be downloaded here: ftp://ftp.sanger.ac.uk/pub/teams/17/software/PoGo/.

Learn and Support

PoGo uses transcript translations and reference gene annotations to identify the genomic loci of peptides and post-translational modifications. Multiple occurrences of peptides in the input data resulting in the same genomic loci will be collapsed as a single occurrence in the output.

Input format

The input format required by PoGo is a tab delimited file with four columns.

ColumnColumn headerDescription
1SampleName of sample or experiment
2PeptidePeptide sequence with PSI-MS nodification names in round brackets following the mpdified amino acid, e.g. PEPT(Phopsho)IDE for a phosphorylated threonine
3PSMsNumber of peptide-spectrum matches (PSMs) for the given peptide
4QuantQuantitative value for the given peptide in the given sample

Output formats

BED

This format contains the genomic loci for peptides, the exon-structure, the peptide sequence, as well as a colour code for uniqueness of peptides within the genome.

Colour Description
Peptide is unique to single gene AND single transcript
Peptide is unique to single gene BUT shared between multiple transcripts
Peptide is shared between multiple genes

PTMBED

Like BED but containing the location of the post-translational modification on the genome. Thick parts of the peptide blocks indicate the position of the post-translational modification on a single amino acid (short thick block) while longer blocks indicate the occurrence of the first and last post-translational modification and residues in between. In the PTMBED the colour code is changed to indicate the type of modification.

Colour Post-translational Modification
Phosphorylation (phospho)
Acetylation (acetyl)
Amidation (amidated)
Oxidation (oxidation)
Methylation (methyl)
Ubiquitinylation (glygly; gg)
Sulfation (sulfo)
Palmitoylation (palmitoyl)
Formylation (formyl)
Deamidation (deamidated)
Any other post-translational modification

GTF

This output format contains besides the genomic loci the annotated information for the genes giving rise to each peptide sequence including status and biotype. For each mapped peptide the sample, number of peptide-spectrum matches and associated quantitative value as tags.

GCT

In this format the peptide sequences are combines with the Ensembl gene identifier. It contains the genomic loci for each peptide as well as the quantitative values for each peptide in different samples as a matrix.

Usage

PoGo is a readily compiled command line tool written in C++, basic usage to generate map peptides to corresponding genomic loci with default parameters:

Windows: PoGo.exe -fasta annotation.translation.fasta -gtf annotation.gtf -in example.tsv Linux/Unix/Mac: PoGo -fasta annotation.translation.fasta -gtf annotation.gtf -in example.tsv

Full usage: PoGo/PoGo.exe -fasta TRANSL -gtf ANNO -in *.tsv[,*.tsv] [-format OUTF] [-merge TRUE/FALSE] [-source SRC] [-mm NUM] [-mmmode TRUE/FALSE]

Required arguments:

-fasta TRANSL
Filepath for file containing protein sequences in FASTA format
-gtf ANNO
Gene annotation with coding sequences (CDS) in GTF format
-in *.tsv
Path to single input file or comma separated list of paths to input files containing peptides to be mapped with associated number of peptide to spectrum matches, sample name and quantitative value (see input file format)

Optional arguments:

-format OUTF
Set output format GTF, GCT, BED, PTMBED or ALL. Comma separated combination possible. Default = ALL
-merge TRUE/FALSE
Set TRUE to merge output of multiple input files (output will be named after last input file *_merged). Default = FALSE
-source SRC
Set TRUE to merge output of multiple input files (output will be named after last input file *_merged). Default = FALSE
-mm NUM
Number of mismatches allowed in mapping (0, 1 or 2). DEFAULT = 0
-mmmode TRUE/FALSE
Set TRUE to restrict number of mismatch in kmer to 1. DEFAULT = FALSE
-genome GENOME
Filepath for the fine containing genome sequences in Ensembl FASTA format. Used to identify chromosome names and order and differenciate between chromosomes and scaffolds. If not set chromosome names are extracted from the GTF file without differenciation between chromosomes and scaffolds

Step by step

  1. Download annotation and translated sequences for human from GENCODE, e.g. release 25. Go to www.gencodegenes.org/release/25.html and download the GTF file containing 'Comprehensive gene annotation' and the 'Protein-coding transcript translation sequences' as Fasta file. Store and unzip both files into a folder, e.g. ${POGO_DIR}/input/
  2. Navigate to the folder that contains the PoGo executable (cd ${POGO})
  3. Execute the following command to generate gtf, gct, bed and ptmbed output for of the your input file referred to as ${Peptides.txt}
    Linux/Unix
    ./PoGo -fasta ./input/gencode.v25.pc_translations.fa -gtf ./input/gencode.v25.annotation.gtf -in /PATH/TO/${Peptides.txt}
    Windows
    .\PoGo.exe -fasta .\input\gencode.v25.pc_translations.fa -gtf .\input\gencode.v25.annotation.gtf -in \PATH\TO\${Peptides.txt}
  4. You can load the generated BED and/or GTF files into a genome browser or create an web accessible track hub for your data through the TrackHub Generator (http://www.sanger.ac.uk/science/tools/trackhub-generator). Here the example is shown for visualisation in the UCSC genome browser.
    To load the data into the browser please follow these steps:
    1. Go to https://genome.ucsc.edu and navigate to 'My Data' -> 'Custom Tracks'.
    2. After clicking 'Choose File' select the file you want to upload and submit via the 'Submit' button.
    3. You will be redirected to the 'Manage Custom Tracks' webpage.
    4. Proceed from the 'Manage Custom Tracks' page by selecting 'Genome Browser' and confirm ('go').
    5. Now you can browse the peptides mapped to their genomic loci on the reference genome.
### Runtime and Memory Estimation Runtime and required memory (RAM) for PoGo execution across different settings for inclusion of mismatches and depending on number of peptides in the input file.
Mismatch Parameter Setting~1,500 peptides in Input~250,000 peptides in Input
-mm 0
< 5 min / < 4 GB<5 min / min 10 GB
-mm 1
~5 min / < 4 GB~5 min / min 16 GB
-mm 2 -mmode true
< 15 min / min 6 GB< 20 min / min 32 GB
-mm 2 -mmode false
~ 1.5 h / min 64 GB~ 2 h / min 160 GB
### Test Examples Test examples, requirement specifications and time estimations are available here: ftp://ftp.sanger.ac.uk/pub/teams/17/software/PoGo/PoGo_Testprocedures.zip. ## Contact Christoph Schlaffner (christoph.schlaffner@cantab.net)