Awesome Open Source
Awesome Open Source

Personal Cancer Genome Reporter (PCGR) - variant interpretation for precision cancer medicine


The Personal Cancer Genome Reporter (PCGR) is a stand-alone software package for translation of individual tumor genomes for precision cancer medicine.

PCGR interprets primarily somatic SNVs/InDels and copy number aberrations. The software extends basic gene and variant annotations from the Ensembl's Variant Effect Predictor (VEP) with oncology-relevant, up-to-date annotations retrieved flexibly through vcfanno, and produces interactive HTML reports intended for clinical interpretation. PCGR can perform multiple types of analyses, including:

  • Somatic variant classification (ACMG/AMP)
    • mapping the therapeutic and prognostic implications of somatic DNA aberrations
  • Tumor mutational burden (TMB) estimation
  • Tumor-only analysis (variant filtering)
  • Mutational signature analysis
  • Kataegis detection
  • Microsatellite instability (MSI) classification

If you want to interrogate germline variants and their relation to cancer predisposition, we recommend trying the accompanying tool Cancer Predisposition Sequencing Reporter (CPSR).

PCGR overview


  • May 2022: 1.0.3 release

  • March 2022: 1.0.2 release

  • March 2022: 1.0.1 release

    • Fixed bug for huge input sets that cause JSON output crash
      • huge input variant sets (WGS) are now reduced prior to reporting with R, i.e. exclusion of intronic and intergenic variants, as well as upstream/downstream gene variants (#178).
    • Fixed bug for cases where mutational signature analysis reports > 18 different aetiologies after fitting (#187).
  • February 2022: 1.0.0 release

    • Complete restructure of Python and R components. Installation now relies on two separate conda packages, pcgr (Python component) and pcgrr (R component). Direct Docker support remains, with the Dockerfile simplified to rely exclusively on the installation of the above Conda packages. Significant contributon by the great @pdiakumis
    • VCF validation step removed. Feedback from users suggested that Ensembl's vcf-validator was often too stringent so its use has been deprecated. The --no_vcf_validate option remains for backwards compatibility.
    • New documentation site (
    • Data bundle updates (CIViC, ClinVar, Open Targets Platform, CancerMine, UniProt KB, Pfam)
  • June 30th 2021: 0.9.2 release

    • Data bundle updates (CIViC, ClinVar, CancerMine, UniProt KB, PFAM)
    • Software upgrades: VEP (104), R v4.1/BioConductor 3.13
    • NEW: TOML configuration removed - all options to PCGR are now command-line based
    • NEW: Feed PCGR with a CPSR report to view key germline findings in the tumor report
    • Planned for next release: Support for analysis of RNA fusions
  • November 30th 2020: 0.9.1 release

    • Data bundle updates (CIViC, ClinVar, CancerMine, UniProt KB)

Example reports


Getting started


If you use PCGR, please cite the publication:

Sigve Nakken, Ghislain Fournous, Daniel Vodák, Lars Birger Aaasheim, Ola Myklebost, and Eivind Hovig. Personal Cancer Genome Reporter: variant interpretation report for precision oncology (2017). Bioinformatics. 34(10):1778–1780. doi:10.1093/bioinformatics/btx817


sigven AT

Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
R (58,749
Variants (5,162
Genome (4,974
Vcf (1,352
Annotation Tool (397
Cancer (219
Cancer Genomics (168
Reporting Engine (77
Copy Number Variation (38
Tumor (32
Clinical (31
Snv (24
Annotation Framework (15
Cancer Variants (9
Somatic (6
Precision Oncology (6
Variant Interpretation (4
Precision Cancer Medicine (4