Skip to content

A library for QC report based on MultiQC framework

License

Notifications You must be signed in to change notification settings

bigbio/pmultiqc

Repository files navigation

pmultiqc

Python application Upload Python Package

A library for proteomics QC report based on MultiQC framework. The library generates a QC report for the quantms pipeline. The library read the input of the quantms pipeline by specified analysis dir, with the following structure:

  • analysis_dir : Final results of the pipeline
    • experimental_design.tsv : experimental design file in two-table format
    • *.mzTab : mzTab with results of the identification
    • *msstats*csv : MSstats/MSstatsTMT input file
    • *.mzML : mzML spectra files
    • *ms_info.tsv : MS quality control information extracted from raw files.
    • *.idXML : Identification results from search + percolator
    • *.yml : summary software information and parameters of quantms pipeline (optional)
    • diann_report.tsv : DIA-NN main report file. Only for DIA analysis.

Usage

multiqc {analysis_dir} -o {output dir}

example: multiqc resources/LFQ -o ./

parameters

  • --raw: Keep filenames in experimental design output as raw when exp_design file is provided
  • --condition: Create conditions from provided (e.g., factor) columns when exp_design file is provided
  • --remove_decoy: Whether to remove the decoy peptides when counting
  • --decoy_affix: Pre- or suffix of decoy proteins in their accession
  • --contaminant_affix: The contaminant prefix or suffix used or to be used
  • --affix_type: Location of the decoy marker string in the fasta accession. Before (prefix) or after (suffix)
  • --disable_plugin: disable pmultiqc plugin
  • --quantification_method: The quantification method for LFQ experiment (default: feature_intensity)
  • --disable_table: Disable protein/peptide table plots for large dataset
  • --ignored_idxml: ignored idxml files for faster running

An example report can be found in multiqc_report.html

Most of the metrics are compute based on the out.mzTab and the *.idXML which contains the peptides and protein identifications.

Metrics

General report

  • First we show the experimental design of the dataset project http://bigbio.xyz/pmultiqc/shared-peptides-star-align-stricter-pep-protein-FDR/multiqc_report.html#proteomicslfq_exp_design . This is a translation from the SDRF proteomics standard to OpenMS standard configuration.

  • Pipeline performance overview: show the quantms performance overview including.

    • Contaminants Score: as fraction of summed intensity with 0 = sample full of contaminants; 1 = no contaminants
    • Peptide Intensity: linear scale of the median intensity reaching the threshold, i.e. reaching 2^21 of 2^23 gives score 0.25.
    • Charge Score: deviation of the charge 2 proportion from a representative Raw file (median). For typtic digests, peptides of charge 2 (one N-terminal and one at tryptic C-terminal R or K residue) should be dominant. Ionization issues (voltage?), in-source fragmentation, missed cleavages and buffer irregularities can cause a shift (see Bittremieux 2017, DOI: 10.1002/mas.21544 ).
    • Missed Cleavages: the fraction (0% - 100%) of fully cleaved peptides per Raw file
    • Missed Cleavages Var: each raw file is scored for its deviation from the ‘average’ digestion state of the current study.
    • ID rate over RT: the number of identifications (here, after FDR filtering) over time. Scored using ‘Uniform’ scoring function.
    • MS2 OverSampling: The percentage of non-oversampled 3D-peaks.
    • Pep Missing Value: Linear scale of the fraction of missing peptides.
  • Summary Table: shows the number of spectra, % of identified spectra, total peptide count, total identified proteins (including protein groups - if two proteins are identified by the same peptide the two proteins are count) http://bigbio.xyz/pmultiqc/shared-peptides-star-align-stricter-pep-protein-FDR/multiqc_report.html#proteomicslfq_summary_table

  • MS1 Information: shows the quality control metrics on MS1 level, including total ion chromatograms (TIC), base peaks count (BPC), number of MS1 peaks, and general stats.

  • Pipeline Results Statistics: shows quantms pipeline final results, total peptide identified, total identified proteins et al (The data comes from mzTab and the experimental design file).

  • Number of peptides per Protein: Includes an histogram with the number of peptides per proteins http://bigbio.xyz/pmultiqc/shared-peptides-star-align-stricter-pep-protein-FDR/multiqc_report.html#num_of_pep_per_prot

Results tables

Two tables are shown to the user with the first 500 peptides in the mzTab and the first 500 PSMs. This tables enable to show some of the most relevant peptide and PSMs in the experiment.

Identification Statistics

A table called Spectra Tracking summarize the Identification results by mzML file. The table capture the following numbers:

  • MS1_num: Number of MS1 in the mzML
  • MS2_num: Number of MS2 in the mzML
  • MSGF: Number of Peptides identified using the MSGF+ search engine
  • Comet: Number of Peptides identified using the Comet search engine
  • Final result of Spectra: Final number of PSMs reported in the mzTab
  • Final result of Peptides: Final number of Peptides identified in the mzTab

Summary of Search Engine Scores

This section contains search scores and PEPs counts for different search engines in different files, and they also contain a summary of the consensus PSMs if two or more search engines are used.

  • SpecEvalue: Spectral E-values, the search score of MSGF. The value used for plotting is -lg(SpecEvalue).
  • xcorr: cross-correlation scores, the search score of Comet. The value used for plotting is xcorr.
  • hyperscore : Hyperscore, the search score of Sage. The value used for plotting is hyperscore.
  • Consensus support: is a measure of agreement between search engines. Every peptide sequence in the analysis has been identified by at least one search run. The consensus support defines which fraction (between 0 and 1) of the remaining search runs "supported" a peptide identification that was kept.

Precursor Charges Distribution

The Precursor Charges Distribution aims to show the distribution of the precursor ion charges for a given whole experiment, but also for the identified spectra and unidentified spectra. This information can be used to identify potential ionization problems including many 1+ charges from an ESI ionization source or an unexpected distribution of charges. MALDI experiments are expected to contain almost exclusively 1+ charged ions. An unexpected charge distribution may furthermore be caused by specific search engine parameter settings such as limiting the search to specific ion charges.

Number of Peaks per MS/MS spectrum

The Number of Peaks per MS/MS spectrum aims to show the number of peaks per MS/MS spectrum in a given experiment. Too few peaks can identify poor fragmentation or a detector fault, as opposed to a large number of peaks representing very noisy spectra. This chart is extensively dependent on the pre-processing steps performed to the spectra (centroiding, deconvolution, peak picking approach, etc).

Peak Intensity Distribution

The Peak Intensity Distribution aims to show the Peak instensity in the MS2 spectra for all the experiment but also for the identified spectra. The plot split the intesity in chunks of 0-10, 10-100, 100-300, ... 6k-10k, >10k.

This is a histogram representing the ion intensity vs. the frequency for all MS2 spectra in a whole given experiment. It is possible to filter the information for all, identified and unidentified spectra. This plot can give a general estimation of the noise level of the spectra. Generally, one should expect to have a high number of low intensity noise peaks with a low number of high intensity signal peaks. A disproportionate number of high signal peaks may indicate heavy spectrum pre-filtering or potential experimental problems. In the case of data reuse this plot can be useful in identifying the requirement for pre-processing of the spectra prior to any downstream analysis. The quality of the identifications is not linked to this data as most search engines perform internal spectrum pre-processing before matching the spectra. Thus, the spectra reported are not necessarily pre-processed since the search engine may have applied the pre-processing step internally. This pre-processing is not necessarily reported in the experimental metadata.

Oversampling Distribution

The [Oversampling Distribution] aims to show the OverSampling information. An oversampled 3D-peak is defined as a peak whose peptide ion (same sequence and same charge state) was identified by at least two distinct MS2 spectra in the same Raw file. For high complexity samples, oversampling of individual 3D-peaks automatically leads to undersampling or even omission of other 3D-peaks, reducing the number of identified peptides. Oversampling occurs in low-complexity samples or long LC gradients, as well as undersized dynamic exclusion windows for data independent acquisitions.

Delta Mass

The Delta Mass aims to show the Peak instensity in the MS2 spectra for all the experiment but also for the identified spectra. The plot split the intesity in chunks of 0-10, 10-100, 100-300, ... 6k-10k, >10k. Mass deltas close to zero reflect more accurate identifications and also that the reporting of the amino acid modifications and charges have been done accurately. This plot can highlight systematic bias if not centered on zero. Other distributions can reflect modifications not being reported properly. Also it is easy to see the different between the target and the decoys identifications.

Peptides Quantification Table

The Peptides Quantification Table aims to show the quantitative level and distribution of peptides in different study variables, run and peptiforms. The distribution show all the intensity values in a bar plot above(blue) and below(red) the average intensity for all the samples. All intensities are log values.

  • BestSearchScore: It is equal to 1 - min(Q.Value) for DIA datasets. Then It is equal to 1 - min(best_search_engine_score[1]), which is from best_search_engine_score[1] column in mzTab peptide table for DDA datasets.
  • Average Intensity: Average intensity of each peptide sequence across all conditions with NA=0 or NA ignored.
  • Peptide intensity in each condition (Eg. CT=Mixture;CN=UPS1;QY=0.1fmol): Summarize intensity of fractions, and then mean intensity in technical replicates/biological replicates separately. Click distribution to switch to bar plots

Protein Quantification Table

The Protein Quantification Table also aims to show the quantitative level and distribution of proteins in different study variables. The distribution show all the intensity values in a bar plot above(blue) and below(red) the average intensity for all samples. All intensities are log values.

  • Peptides_Number: The number of peptides for each protein
  • Average Intensity: Average intensity of each protein across all conditions with NA=0 or NA ignored.
  • Protein intensity in each condition (Eg. CT=Mixture;CN=UPS1;QY=0.1fmol): Summarize intensity of peptides.Click distribution to switch to bar plots

Note: Because DIA-NN has much difference in output file !!! So some metrics are difficult to calculate

Note: If you want to disable this plugin and use the multiqc function, please set disable_plugin

Development quick start

In short, for development, follow these steps:

  • git clone https://github.com/bigbio/pmultiqc && cd pmultiqc
  • pip install -r requirements.txt
  • Code and make your changes
  • pip install . -e
  • cd tests && multiqc resources/LFQ -o ./
  • Contribute by forking and creating a PR from your fork against bigbio