Skip to contents

Output files

PCGR generates multiple output files with annotations of molecular aberrations, including an interactive HTML report, a PDF report, an Excel workbook, and pure text-based annotation files (TSV).

HTML report - quarto-based

An interactive and structured HTML report that shows the most relevant findings in the query cancer genome has the following naming convention:

  • <sample_id>.pcgr.<genome_assembly>.html
    • The sample_id is provided as input by the user, and reflects a unique identifier of the tumor-normal sample pair to be analyzed.

The report is structured in various sections, pending upon the input provided by the user. The following sections may be included in the report:

  1. Key findings and settings
    • The top of the report shows sample details (cancer type, assay, subject sex and age, tumor purity and ploidy) and the input data provided
    • Key findings: a templated summary of the main findings - therapeutically actionable alterations (Tier 1 and 2), diagnostic evidence and composite genomic biomarkers (TMB-high, MSI-high, HR-deficient) first, followed by supporting findings. The rules for content and ordering are described in the documentation section of the report
    • Run configuration and report settings (collapsible) - key configurations for the analysis, including the genome assembly, type of sequencing assay (WES/WGS/TARGETED), and the cancer type (as provided by the user)
  2. Somatic SNVs/InDels
    • Provides an overview of the somatic SNVs and InDels detected in the tumor sample
    • Includes a global distribution of allelic support, statistics with respect to variant types and consequences
    • Variants are classified with respect to predicted oncogenicity (ClinGen/CGC/VICC standard operating procedures)
      • permits also exploration of somatic mutations through interactive filtering according to several dimensions (variant sequencing depth/support, variant consequence etc.)
    • Variants are classified with respect to clinical actionability (AMP/ASCO/CAP guidelines)
      • individual evidence items linked to actionable variants can be explored, indicating strength of evidence, tumor type and therapeutic context, and clinical significance
  3. Somatic CNAs
    • Aberrations are classified with respect to clinical actionability (AMP/ASCO/CAP guidelines)
      • individual evidence items linked to actionable variants can be explored, indicating strength of evidence, tumor type and therapeutic context, and clinical significance
    • Other potentially oncogenic aberrations are listed: proto-oncogenes subject to copy number amplifications, and tumor suppressor genes subject to homozygous deletions
    • Two-hit events: tumor suppressor genes may be subject to biallelic inactivation through a combination of:
      • Loss of heterozygosity (LOH) — a copy number segment affecting one allele of the gene
      • A somatic loss-of-function variant (e.g. frameshift, nonsense, splice-site) in the tumor
      • A germline loss-of-function variant (as classified by CPSR, if provided as input)
  4. MSI status
  • Indicates predicted microsatellite stability from the somatic mutation profile and supporting evidence (details of the underlying MSI statistical classifier can be found here)
  • The MSI classifier was trained on TCGA exome samples.
  • If an MSI result from an external MSI caller is provided (--input_msi), this is regarded as the primary result. In the HTML report, the external result and the classifier prediction (if available) are shown in separate tabs (External caller and PCGR classifier), with a note on concordance in the first tab. In the PDF report, only the external result is shown in detail, with a note on concordance with the classifier prediction
  1. HRD status
  • Result of an external HRD assay/tool (--input_hrd): HRD status (HR-deficient, HR-proficient or Indeterminate), score and kind of score (as stated in the input file), and how the status was obtained (reported by the assay/tool, or derived by PCGR with --input_hrd_threshold)
  • Genomic scar (HRD) score estimated by PCGR from the allele-specific copy number segments (--estimate_hrd; HRD-LOH, LST, TAI and their sum - research use only)
  • If both are available, they are shown in separate tabs (External assay/tool and PCGR genomic scar score) in the HTML report; in the PDF report, HRD is part of the Composite genomic biomarkers section
  1. Tumor mutational burden (TMB)
    • given a coding target region size specified by the user (ideally the callable target size), an estimate of the mutational burden is provided
    • The estimated TMB is shown in the context of TMB distributions from different primary sites in TCGA
  2. Mutational signatures
  1. Kataegis events
  • Kataegis events are clusters of particular SNV types. The report includes a datatable with all detected kataegis events.
  1. RNA fusions
  • Fusion partners are annotated with respect to oncogene status and overlap in the Mitelman database of chromosomal aberrations in cancer
  • Clinical actionability evidence linked to fusion events is shown where available (AMP/ASCO/CAP guidelines)
  1. RNA expression analysis
  • Datatable with expression outliers - as compared to distribution in reference cohorts
  • Datatable with correlation between gene expression in query sample and samples in other reference cohorts (TCGA, Treehouse Childhood Cancer Initiative, DepMap)
  • Immune contexture profiling
  1. Germline findings
  • Shown if germline variants classified by CPSR are provided as input (--input_cpsr, --input_cpsr_yaml)
  • Pathogenic and likely pathogenic variants in the virtual panel of cancer predisposition genes screened, and optionally a focused subset of variants of uncertain significance (VUS)
  1. Documentation
  • Annotation resources - databases with version and licensing information
    • Report contents - brief description of the main sections in the report
  • References - supporting scientific literature (key report elements)

Example reports

DOI

PDF report

A focused PDF report (generated with quarto and Typst) is provided by default in addition to the HTML report, and can be turned off with --no_pdf. It has the following naming convention:

  • <sample_id>.pcgr.<genome_assembly>.pdf

Sections are included depending on the input provided by the user:

  1. Cover page

    • Sample details and the Key findings summary, shared with the HTML report
  2. Clinical actionability

    • Tier 1 and 2 aberrations (SNVs/InDels, CNAs and RNA fusions), with the underlying biomarker evidence
  3. Diagnostic and prognostic biomarkers

  4. Somatic SNVs/InDels

    • Variant statistics, oncogenic and likely oncogenic variants, and variant filtering
  5. Somatic copy number aberrations

    • Amplified proto-oncogenes and deleted tumor suppressors, and the copy number profile
  6. Composite genomic biomarkers

    • TMB, MSI and HRD status
  7. Mutational features

    • Mutational signatures and kataegis events
  8. Transcriptome findings

    • RNA fusions and gene expression
  9. Germline findings

    • Pathogenic and likely pathogenic variants classified by CPSR (if provided as input)
  10. Analysis configuration & data sources

    • Settings and versions of the data sources
  11. Appendix

    • Documentation of report contents, references, and a medical disclaimer

SNVs/InDels

1. Variant call format - VCF

A VCF file containing annotated, somatic calls (single nucleotide variants and insertion/deletions) is generated with the following naming convention:

  • <sample_id>.pcgr.<genome_assembly>.vcf.gz
    • The sample_id is provided as input by the user, and reflects a unique identifier of the tumor-normal sample pair to be analyzed. Following common standards, the annotated VCF file is compressed with bgzip and indexed with tabix. Below follows a description of all annotations/tags present in the VCF INFO column after processing with the PCGR annotation pipeline:
VEP consequence annotations
Tag Description
CSQ Complete consequence annotations from VEP. Format (separated by a |): Allele, Consequence, IMPACT, SYMBOL, Gene, Feature_type, Feature, BIOTYPE, EXON, INTRON, HGVSc, HGVSp, cDNA_position, CDS_position, Protein_position, Amino_acids, Codons, Existing_variation, ALLELE_NUM, DISTANCE, STRAND, FLAGS, PICK, VARIANT_CLASS, SYMBOL_SOURCE, HGNC_ID, CANONICAL, MANE_SELECT, MANE_PLUS_CLINICAL, TSL, APPRIS, CCDS, ENSP, SWISSPROT, TREMBL, UNIPARC, UNIPROT_ISOFORM, RefSeq, DOMAINS, HGVS_OFFSET, AF, AFR_AF, AMR_AF, EAS_AF, EUR_AF, SAS_AF, gnomAD_AF, gnomAD_AFR_AF, gnomAD_AMR_AF, gnomAD_ASJ_AF, gnomAD_EAS_AF, gnomAD_FIN_AF, gnomAD_NFE_AF, gnomAD_OTH_AF, gnomAD_SAS_AF, CLIN_SIG, SOMATIC, PHENO, CHECK_REF, MOTIF_NAME, MOTIF_POS, HIGH_INF_POS, MOTIF_SCORE_CHANGE, TRANSCRIPTION_FACTORS, NearestExonJB
Consequence Impact modifier for the consequence type (picked by VEP’s --flag_pick_allele option)
Gene Ensembl stable ID of affected gene (picked by VEP’s --flag_pick_allele option)
Feature_type Type of feature. Currently one of Transcript, RegulatoryFeature, MotifFeature (picked by VEP’s --flag_pick_allele option)
Feature Ensembl stable ID of feature (picked by VEP’s --flag_pick_allele option)
cDNA_position Relative position of base pair in cDNA sequence (picked by VEP’s --flag_pick_allele option)
CDS_position Relative position of base pair in coding sequence (picked by VEP’s --flag_pick_allele option)
CDS_RELATIVE_POSITION Ratio of variant coding position to length of coding sequence
CDS_CHANGE Coding, transcript-specific sequence annotation (picked by VEP’s --flag_pick_allele option)
ALTERATION HGVSp/HGVSc identifier
AMINO_ACID_START Protein position indicating absolute start of amino acid altered (fetched from Protein_position)
AMINO_ACID_END Protein position indicating absolute end of amino acid altered (fetched from Protein_position)
Protein_position Relative position of amino acid in protein (picked by VEP’s --flag_pick_allele option)
Amino_acids Only given if the variant affects the protein-coding sequence (picked by VEP’s --flag_pick_allele option)
GRANTHAM_DISTANCE Grantham distance between the reference and variant amino acids
Codons The alternative codons with the variant base in upper case (picked by VEP’s --flag_pick_allele option)
IMPACT Impact modifier for the consequence type (picked by VEP’s --flag_pick_allele option)
VARIANT_CLASS Sequence Ontology variant class (picked by VEP’s --flag_pick_allele option)
SYMBOL Gene symbol (picked by VEP’s --flag_pick_allele option)
SYMBOL_SOURCE The source of the gene symbol (picked by VEP’s --flag_pick_allele option)
STRAND The DNA strand (1 or -1) on which the transcript/feature lies (picked by VEP’s --flag_pick_allele option)
ENSP The Ensembl protein identifier of the affected transcript (picked by VEP’s --flag_pick_allele option)
FLAGS Transcript quality flags: cds_start_NF: CDS 5’, incomplete cds_end_NF: CDS 3’ incomplete (picked by VEP’s --flag_pick_allele option)
SWISSPROT Best match UniProtKB/Swiss-Prot accession of protein product (picked by VEP’s --flag_pick_allele option)
TREMBL Best match UniProtKB/TrEMBL accession of protein product (picked by VEP’s --flag_pick_allele option)
UNIPARC Best match UniParc accession of protein product (picked by VEP’s --flag_pick_allele option)
HGVSc The HGVS coding sequence name (picked by VEP’s --flag_pick_allele option)
HGVSc_RefSeq The HGVSc coding sequence name using RefSeq transcript identifiers (MANE select) - picked by VEP’s --flag_pick_allele option)
HGVSp The HGVS protein sequence name (picked by VEP’s --flag_pick_allele option)
HGVSp_short The HGVS protein sequence name, short version (picked by VEP’s --flag_pick_allele option)
HGVS_OFFSET Indicates by how many bases the HGVS notations for this variant have been shifted (picked by VEP’s --flag_pick_allele option)
NearestExonJB VEP plugin that finds nearest exon junction for a coding sequence variant. Format: Ensembl exon identifier+distanceto exon boundary+boundary type(start/end)+exon length
MOTIF_NAME The source and identifier of a transcription factor binding profile aligned at this position (picked by VEP’s --flag_pick_allele option)
MOTIF_POS The relative position of the variation in the aligned TFBP (picked by VEP’s --flag_pick_allele option)
HIGH_INF_POS A flag indicating if the variant falls in a high information position of a transcription factor binding profile (TFBP) (picked by VEP’s --flag_pick_allele option)
MOTIF_SCORE_CHANGE The difference in motif score of the reference and variant sequences for the TFBP (picked by VEP’s --flag_pick_allele option)
CELL_TYPE List of cell types and classifications for regulatory feature (picked by VEP’s --flag_pick_allele option)
CANONICAL A flag indicating if the transcript is denoted as the canonical transcript for this gene (picked by VEP’s --flag_pick_allele option)
CCDS The CCDS identifier for this transcript, where applicable (picked by VEP’s --flag_pick_allele option)
INTRON The intron number (out of total number) (picked by VEP’s --flag_pick_allele option)
EXON The exon number (out of total number) (picked by VEP’s --flag_pick_allele option)
EXON_AFFECTED The exon affected by the variant (picked by VEP’s --flag_pick_allele option)
LAST_EXON Logical indicator for last exon of transcript (picked by VEP’s --flag_pick_allele option)
LAST_INTRON Logical indicator for last intron of transcript (picked by VEP’s --flag_pick_allele option)
INTRON_POSITION Relative position of intron variant to nearest exon/intron junction (NearestExonJB VEP plugin)
EXON_POSITION Relative position of exon variant to nearest intron/exon junction (NearestExonJB VEP plugin)
DISTANCE Shortest distance from variant to transcript (picked by VEP’s --flag_pick_allele option)
BIOTYPE Biotype of transcript or regulatory feature (picked by VEP’s --flag_pick_allele option)
TSL Transcript support level (picked by VEP’s --flag_pick_allele option)
PUBMED PubMed ID(s) of publications that cite existing variant - VEP
PHENO Indicates if existing variant is associated with a phenotype, disease or trait - VEP
GENE_PHENO Indicates if overlapped gene is associated with a phenotype, disease or trait - VEP
ALLELE_NUM Allele number from input; 0 is reference, 1 is first alternate etc - VEP
REFSEQ_MATCH The RefSeq transcript match status; contains a number of flags indicating whether this RefSeq transcript matches the underlying reference sequence and/or an Ensembl transcript (picked by VEP’s --flag_pick_allele option)
PICK Indicates if this block of consequence data was picked by VEP’s --flag_pick_allele option
VEP_ALL_CSQ All transcript consequences (Consequence:SYMBOL:Feature_type:Feature:BIOTYPE) - VEP
EXONIC_STATUS Indicates if variant consequence type is ‘exonic’ or ‘nonexonic’. We here define ‘exonic’ as any variant with either of the following consequences: stop_gained / stop_lost, start_lost, frameshift_variant, missense_variant, splice_donor_variant, splice_acceptor_variant, inframe_insertion / inframe_deletion, synonymous_variant, start_retained, stop_retained, protein_altering
CODING_STATUS Indicates if primary variant consequence type is ‘coding’ or ‘noncoding’ (wrt. protein-alteration). ‘coding’ variants are here defined as those with an ‘exonic’ status, with the exception of synonymous variants
EXONIC_STATUS Indicates if variant consequence type is ‘exonic’ or ‘nonexonic’. We define ‘exonic’ as any variants with the following consequence types: stop_gained / stop_lost, start_lost, frameshift_variant, missense_variant, splice_donor_variant, splice_acceptor_variant, inframe_insertion / inframe_deletion, synonymous_variant, protein_altering
CODING_STATUS Indicates if primary variant consequence type is ‘coding’ or ‘noncoding’. ‘coding’ variants are here defined as those consequence types with an ‘exonic’ status, with the exception of synonymous variants. All other consequence types are considered ‘noncoding’
NULL_VARIANT Primary variant consequence type is frameshift or stop_gained
LOSS_OF_FUNCTION Loss-of-function variant - primary variant consequence being either stop_gained / stop_lost, start_lost, frameshift_variant, splice_donor_variant, or splice_acceptor_variant
LOF_FILTER Loss-of-function filter - exceptions to putative LOF variants - GC to GT at splice donor sites or truncations within the last 5% of coding sequence
SPLICE_DONOR_RELEVANT Logical indicating if variant is located at a particular location near the splice donor site (+3A/G, +4A or +5G)
REGULATORY_ANNOTATION Comma-separated list of all variant annotations of Feature_type, RegulatoryFeature, and MotifFeature. Format (separated by a |): <Consequence>, <Feature_type>, <Feature>, <BIOTYPE>, <MOTIF_NAME>, <MOTIF_POS>, <HIGH_INF_POS>, <MOTIF_SCORE_CHANGE>, <TRANSCRIPTION_FACTORS>
Gene information
Tag Description
ENTREZGENE Entrez gene identifier
APPRIS Principal isoform flags according to the APPRIS principal isoform database
MANE_SELECT Indicating if the transcript is the MANE Select for the gene (picked by VEP’s --flag_pick_allele_gene option)
MANE_PLUS_CLINICAL Indicating if the transcript is MANE Plus Clinical, as required for clinical variant reporting (picked by VEP’s --flag_pick_allele_gene option)
UNIPROT_ID UniProt identifier
UNIPROT_ACC UniProt accession(s)
ENSEMBL_GENE_ID Ensembl gene identifier for VEP’s picked transcript (ENSGXXXXXXX)
ENSEMBL_TRANSCRIPT_ID Ensembl transcript identifier for VEP’s picked transcript (ENSTXXXXXX)
ENSEMBL_PROTEIN_ID Ensembl corresponding protein identifier for VEP’s picked transcript (ENSPXXXXXX)
REFSEQ_TRANSCRIPT_ID Corresponding RefSeq transcript(s) identifier for VEP’s picked transcript (NM_XXXXX)
MANE_SELECT2 MANE select transcript identifer: one high-quality representative transcript per protein-coding gene that is well-supported by experimental data and represents the biology of the gene - provided through BioMart
MANE_PLUS_CLINICAL2 transcripts chosen to supplement MANE Select when needed for clinical variant reporting - provided through BioMart
GENCODE_TAG tag for gencode transcript (basic etc)
GENCODE_TRANSCRIPT_TYPE type of transcript (protein-coding etc.)
TSG Flag indicating whether gene is predicted as a tumor suppressor gene, from Cancer Gene Census, Network of Cancer Genes (NCG) & the CancerMine text-mining resource
TSG_SUPPORT Underlying evidence for gene being a tumor suppressor. Format: NCG&CancerMine:num_citations
ONCOGENE Flag indicating whether gene is predicted as an oncogene, from Cancer Gene Census, Network of Cancer Genes (NCG) & the CancerMine text-mining resource.
ONCOGENE_SUPPORT Underlying evidence for gene being an oncogene. Format: NCG&CancerMine:num_citations
INTOGEN_DRIVER Gene is predicted as a cancer driver in the IntoGen Cancer Drivers Database
TCGA_DRIVER Gene is predicted as a cancer driver in the TCGA pan-cancer analysis of cancer driver genes and mutations
PROB_EXAC_LOF_INTOLERANT dbNSFP_gene: the probability of being loss-of-function intolerant (intolerant of both heterozygous and homozygous lof variants) based on ExAC r0.3 data
PROB_EXAC_LOF_INTOLERANT_HOM dbNSFP_gene: the probability of being intolerant of homozygous, but not heterozygous lof variants based on ExAC r0.3 data
PROB_EXAC_LOF_TOLERANT_NULL dbNSFP_gene: the probability of being tolerant of both heterozygous and homozygous lof variants based on ExAC r0.3 data
PROB_EXAC_NONTCGA_LOF_INTOLERANT dbNSFP_gene: the probability of being loss-of-function intolerant (intolerant of both heterozygous and homozygous lof variants) based on ExAC r0.3 nonTCGA subset
PROB_EXAC_NONTCGA_LOF_INTOLERANT_HOM dbNSFP_gene: the probability of being intolerant of homozygous, but not heterozygous lof variants based on ExAC r0.3 nonTCGA subset
PROB_EXAC_NONTCGA_LOF_TOLERANT_NULL dbNSFP_gene: the probability of being tolerant of both heterozygous and homozygous lof variants based on ExAC r0.3 nonTCGA subset
PROB_GNOMAD_LOF_INTOLERANT dbNSFP_gene: the probability of being loss-of-function intolerant (intolerant of both heterozygous and homozygous lof variants based on gnomAD 2.1 data
PROB_GNOMAD_LOF_INTOLERANT_HOM dbNSFP_gene: the probability of being intolerant of homozygous, but not heterozygous lof variants based on gnomAD 2.1 data
PROB_GNOMAD_LOF_TOLERANT_NULL dbNSFP_gene: the probability of being tolerant of both heterozygous and homozygous lof variants based on gnomAD 2.1 data
PROB_HAPLOINSUFFICIENCY dbNSFP_gene: Estimated probability of haploinsufficiency of the gene (from http://dx.doi.org/10.1371/journal.pgen.1001154)
ESSENTIAL_GENE_CRISPR dbNSFP_gene: Essential (E) or Non-essential phenotype-changing (N) based on large scale CRISPR experiments. from http://dx.doi.org/10.1126/science.aac7041
ESSENTIAL_GENE_CRISPR2 dbNSFP_gene: Essential (E), context-Specific essential (S), or Non-essential phenotype-changing (N) based on large scale CRISPR experiments. from http://dx.doi.org/10.1016/j.cell.2015.11.015
Variant effect and protein-coding information
Tag Description
MUTATION_HOTSPOT mutation hotspot codon in cancerhotspots.org. Format: gene_symbol | codon | q-value
MUTATION_HOTSPOT_TRANSCRIPT hotspot-associated transcripts (Ensembl transcript ID)
MUTATION_HOTSPOT_CANCERTYPE hotspot-associated cancer types (from cancerhotspots.org)
PFAM_DOMAIN Pfam domain identifier (from VEP)
INTOGEN_DRIVER_MUT Indicates if existing variant is predicted as driver mutation from IntoGen Catalog of Driver Mutations
EFFECT_PREDICTIONS In silico predictions of variant effect on protein function and pre-mRNA splicing from database of non-synonymous functional predictions - dbNSFP. Predicted effects are provided by different sources/algorithms (separated by &), T = Tolerated, N = Neutral, D = Damaging
SPLICE_EFFECT Effect of splicing, from MutSpliceDB and/or MaxEntScan, combined into a single comma-separated string. MutSpliceDB component format: <ENTREZGENE>|<SYMBOL>|<REFSEQ_TRANSCRIPT_ID>|<HGVSc>|<EFFECT>|<AFFECTED_EXONS>|<SOURCE>. MaxEntScan component format: MaxEntScan|<stratum>|<evidence_tier> (see MAXENTSCAN below for details)
DBNSFP_BAYESDEL_ADDAF predicted effect from BayesDel (dbNSFP)
DBNSFP_LIST_S2 predicted effect from LIST-S2 (dbNSFP)
DBNSFP_SIFT predicted effect from SIFT (dbNSFP)
DBNSFP_POLYPHEN2_HVAR predicted effect from PolyPhen2 (dbNSFP)
DBNSFP_PROVEAN predicted effect from PROVEAN (dbNSFP)
DBNSFP_MUTATIONTASTER predicted effect from MUTATIONTASTER (dbNSFP)
DBNSFP_MUTATIONASSESSOR predicted effect from MUTATIONASSESSOR (dbNSFP)
DBNSFP_M_CAP predicted effect from M-CAP (dbNSFP)
DBNSFP_MUTPRED score from MUTPRED (dbNSFP)
DBNSFP_CLINPRED predicted effect from ClinPred (dbNSFP)
DBNSFP_FATHMM predicted effect from FATHMM-XF (dbNSFP)
DBNSFP_PRIMATEAI predicted effect from PRIMATEAI (dbNSFP)
DBNSFP_DEOGEN2 predicted effect from DEOGEN2 (dbNSFP)
DBNSFP_PHACTBOOST predicted effect from PHACTboost (dbNSFP)
DBNSFP_ALPHA_MISSENSE predicted effect from AlphaMissense (dbNSFP)
DBNSFP_MUTFORMER predicted effect from MutFormer (dbNSFP)
DBNSFP_ESM1B predicted effect from ESM1b (dbNSFP)
DBNSFP_GERP evolutionary constraint measure from GERP (dbNSFP)
DBNSFP_CADD Combined Annotation Dependent Depletion (CADD) score (dbNSFP)
DBNSFP_VEST4 VEST4 score (dbNSFP)
DBNSFP_FATHMM_XF predicted effect from FATHMM-XF (dbNSFP)
DBNSFP_META_RNN predicted effect from ensemble prediction (deep learning - dbNSFP)
DBNSFP_SPLICE_SITE_RF predicted effect of splice site disruption, using random forest (dbscSNV)
DBNSFP_SPLICE_SITE_ADA predicted effect of splice site disruption, using boosting (dbscSNV)
Variant frequencies/annotations in germline/somatic databases
Tag Description
gnomADe_AFR_AF African/American germline allele frequency - exome set (gnomAD release 4.1)
gnomADe_AMR_AF Latino/Admixed American germline allele frequency - exome set (gnomAD release 4.1)
gnomADe_AF Adjusted global germline allele frequency - exome set (gnomAD release 4.1)
gnomADe_SAS_AF South Asian germline allele frequency - exome set (gnomAD release 4.1)
gnomADe_EAS_AF East Asian germline allele frequency - exome set (gnomAD release 4.1)
gnomADe_FIN_AF Finnish germline allele frequency - exome set (gnomAD release 4.1)
gnomADe_NFE_AF Non-Finnish European germline allele frequency - exome set (gnomAD release 4.1)
gnomADe_OTH_AF Other germline allele frequency - exome set (gnomAD release 4.1)
gnomADe_ASJ_AF Ashkenazi Jewish allele frequency - exome set (gnomAD release 4.1)
gnomADg_AFR_AF African/American germline allele frequency - genome set (gnomAD release 4.1)
gnomADg_AMR_AF Latino/Admixed American germline allele frequency - genome set (gnomAD release 4.1)
gnomADg_AF Adjusted global germline allele frequency - genome set (gnomAD release 4.1)
gnomADg_SAS_AF South Asian germline allele frequency - genome set (gnomAD release 4.1)
gnomADg_EAS_AF East Asian germline allele frequency - genome set (gnomAD release 4.1)
gnomADg_FIN_AF Finnish germline allele frequency - genome set (gnomAD release 4.1)
gnomADg_NFE_AF Non-Finnish European germline allele frequency - genome set (gnomAD release 4.1)
gnomADg_MID_AF Middle Eastern germline allele frequency - genome set (gnomAD release 4.1)
gnomADg_OTH_AF Other germline allele frequency - genome set (gnomAD release 4.1)
gnomADg_ASJ_AF Ashkenazi Jewish allele frequency - genome set (gnomAD release 4.1)
DBSNP_RSID dbSNP reference ID, as provided by VEP
COSMIC_MUTATION_ID Mutation identifier in Catalog of somatic mutations in cancer database, as provided by VEP
TCGA_PANCANCER_COUNT Raw variant count across all TCGA tumor types
TCGA_FREQUENCY Frequency of variant across TCGA tumor types. Format: tumortype| percent affected|affected cases|total cases
Clinical associations
Tag Description
CLINVAR_MSID ClinVar Measure Set/Variant ID
CLINVAR_ALLELE_ID ClinVar allele ID
CLINVAR_PMID Associated Pubmed IDs for variant in ClinVar - germline state-of-origin
CLINVAR_HGVSP Protein variant expression using HGVS nomenclature
CLINVAR_PMID_SOMATIC Associated Pubmed IDs for variant in ClinVar - somatic state-of-origin
CLINVAR_CLNSIG Clinical significance for variant in ClinVar - germline state-of-origin
CLINVAR_CLNSIG_SOMATIC Clinical significance for variant in ClinVar - somatic state-of-origin
CLINVAR_MEDGEN_CUI Associated MedGen concept identifiers (CUIs) - germline state-of-origin
CLINVAR_MEDGEN_CUI_SOMATIC Associated MedGen concept identifiers (CUIs) - somatic state-of-origin
CLINVAR_VARIANT_ORIGIN Origin of variant (somatic, germline, de novo etc.) for variant in ClinVar
CLINVAR_REVIEW_STATUS_STARS Rating of the ClinVar variant (0-4 stars) with respect to level of review
KNOWN_ONCOGENIC Variant matches with known oncogenic variants in ClinVar, through ClinGen/CGC/VICC SOP. Format:
KNOWN_ONCOGENIC_SITE Variant matches with known oncogenic site/codon in ClinVar, through ClinGen/CGC/VICC SOP. The variant must have approximately the same Grantham distance as the one recorded for the oncogenic site. Format:
Other
Tag Description
BIOMARKER_MATCH Variant matches with biomarker evidence in CIViC/CGI. Format: ||::::|. Multiple evidence items are separated by ‘&’. Example: civic
ONCOGENICITY Oncogenicity annotation - ClinGen/CGC/VICC SOP implementation
ONCOGENICITY_CODE Variant-matching oncogenicity code(s) - ClinGen/CGC/VICC SOP implementation
ONCOGENICITY_SCORE Variant oncogenicity score - ClinGen/CGC/VICC SOP implementation

2. Tab-separated values (TSV)

We provide a tab-separated values file with most important annotations for SNVs/InDels. The file has the following naming convention:

  • <sample_id>.pcgr.<genome_assembly>.snv_indel_ann.tsv.gz

The following variables are included in the TSV file (VCF tags issued by the user (--retained_info_tags) will be appended at the end). Columns suffixed with _OKB are only present when OncoKB annotation is enabled via --oncokb_api_token.

Variable Description
1. SAMPLE_ID Sample identifier
2. VARIANT_CLASS Variant type, e.g. SNV/insertion/deletion/indel
3. VAR_ID Variant identifier. Format: <chrom>_<position>_<ref_allele>_<alt_allele>
4. GENOMIC_CHANGE Identifier for variant at the genome (VCF) level, e.g. 1:g.152382569A>G. Format: <chrom>:g.<position><ref_allele><alt_allele>
5. GENOME_VERSION Assembly version, e.g. GRCh38
6. SYMBOL Gene symbol
7. ENTREZGENE Entrez gene identifier
8. ENSEMBL_GENE_ID Ensembl gene identifier
9. GENENAME Gene name
10. ALTERATION Combined HGVSp/HGVSc annotation
11. CDS_CHANGE Coding sequence change
12. HGVSc HGVS coding sequence name
13. HGVSc_RefSeq HGVS coding sequence name (RefSeq/MANE select)
14. HGVSp HGVS protein sequence name
15. HGVSP Protein change in one-letter amino-acid HGVS notation (HGVSp_short)
16. SPLICE_EFFECT Splice effect annotations from MutSpliceDB and MaxEntScan (see details above)
17. MAXENTSCAN MaxEntScan splice site impact summary for canonical (±1/±2 bp) and non-canonical (donor +3 to +6, acceptor -3 to -20) splice positions. Format: MaxEntScan|<stratum>|<evidence_tier>. <stratum> identifies the splice-site position category (e.g. Donor_+5, Acceptor_PPT_Close, Canonical_Site). <evidence_tier> reflects predicted impact strength, from strongest to weakest: Strong > Moderate > Supporting > No_Call > Uninformative (. for canonical sites, which are always high-confidence). Only variants with a Strong tier at non-canonical positions are additionally flagged as loss-of-function
18. EFFECT_PREDICTIONS Variant effect predictions - from dbNSFP
19. EXON Exon number (out of total number of exons)
20. CONSEQUENCE Variant consequence - from VEP
21. PFAM_DOMAIN_NAME Pfam domain name
22. LOSS_OF_FUNCTION Loss of function flag
23. LOF_FILTER Loss of function filter
24. CODING_STATUS Coding status - flag indicating if consequence is protein-altering/affecting splice sites
25. EXONIC_STATUS Exonic status - flag indicating if consequence is silent/protein-altering/affecting splice sites
26. DP_TUMOR Depth of coverage at variant position in tumor sample
27. VAF_TUMOR Variant allele fraction at variant position in tumor sample
28. AD_TUMOR Allelic depth (number of reads supporting alt allele) in tumor sample
29. CALL_CONFIDENCE Call confidence
30. DP_CONTROL Depth of coverage at variant position in control sample
31. VAF_CONTROL Variant allele fraction at variant position in control sample
32. AD_CONTROL Allelic depth (number of reads supporting alt allele) in control sample
33. MUTATION_HOTSPOT Mutation hotspot annotation
34. MUTATION_HOTSPOT_CANCERTYPE Mutation hotspot-associated cancer types (from cancerhotspots.org)
35. ACTIONABILITY_TIER Variant clinical actionability tier - AMP/ASCO/CAP implementation
36. ACTIONABILITY Variant clinical actionability significance - AMP/ASCO/CAP implementation
37. ONCOGENICITY Oncogenicity annotation - ClinGen/CGC/VICC SOP implementation
38. ONCOGENICITY_CODE Variant-matching oncogenicity code(s) - ClinGen/CGC/VICC SOP implementation
39. ONCOGENICITY_SCORE Variant oncogenicity score - ClinGen/CGC/VICC SOP implementation
40. MUTATION_EFFECT_OKB (OncoKB only) OncoKB mutation effect annotation (e.g. Loss-of-function, Gain-of-function)
41. MUTATION_EFFECT_CITATIONS_OKB (OncoKB only) OncoKB mutation effect citations
42. MUTATION_EFFECT_DESCRIPTION_OKB (OncoKB only) OncoKB mutation effect description
43. ONCOGENICITY_OKB (OncoKB only) OncoKB oncogenicity annotation (e.g. Oncogenic, Likely Oncogenic, Likely Neutral etc.)
44. TUMOR_TYPE_SUMMARY_OKB (OncoKB only) OncoKB tumor type summary
45. VARIANT_SUMMARY_OKB (OncoKB only) OncoKB variant summary
46. HOTSPOT_OKB (OncoKB only) OncoKB hotspot flag - indicates if variant overlaps a known OncoKB hotspot
47. VUS_OKB (OncoKB only) OncoKB variant of uncertain significance flag
48. CANONICAL Flag indicating if transcript is canonical
49. CCDS CCDS identifier
50. UNIPROT_ACC UniProt accession
51. ENSEMBL_TRANSCRIPT_ID Ensembl transcript identifier
52. ENSEMBL_PROTEIN_ID Ensembl protein identifier
53. REFSEQ_TRANSCRIPT_ID RefSeq transcript identifier
54. REFSEQ_PROTEIN_ID RefSeq protein identifier
55. MANE_SELECT MANE transcript select
56. MANE_PLUS_CLINICAL MANE transcript plus clinical
57. ONCOGENE Flag indicating if gene is oncogene (CancerMine/NCG)
58. ONCOGENE_SUPPORT Oncogene annotation support (CancerMine/NCG)
59. TUMOR_SUPPRESSOR Flag indicating if gene is tumor suppressor (CancerMine/NCG)
60. TUMOR_SUPPRESSOR_SUPPORT Tumor suppressor annotation support (CancerMine/NCG)
61. TARGETED_INHIBITORS2 Targeted inhibitors
62. REGULATORY_ANNOTATION Regulatory annotation
63. VEP_ALL_CSQ VEP consequence - all transcripts
64. gnomADe_AF gnomAD exomes allele frequency - globally
65. gnomADg_AF gnomAD genomes allele frequency - globally
66. DBSNP_RSID dbSNP identifier
67. COSMIC_ID COSMIC identifier
68. TCGA_FREQUENCY Frequency of variant across TCGA tumor types. Format: tumortype | percent affected | affected cases | total cases
69. TCGA_PANCANCER_COUNT Raw variant count across all TCGA tumor types
70. CLINVAR_MSID ClinVar measureset identifier
71. CLINVAR_CLASSIFICATION ClinVar variant classification
72. CLINVAR_VARIANT_ORIGIN ClinVar variant origin
73. CLINVAR_NUM_SUBMITTERS ClinVar number of submitters
74. CLINVAR_GOLD_STARS ClinVar review status gold stars (0-4)
75. CLINVAR_CONFLICTED ClinVar variant classification is conflicted
Tumor-only runs

For tumor-only runs, we provide a similarly formatted tab-separated values file that include both filtered (i.e. likely germline events) and unfiltered (deemed somatic) variants. The file has the following naming convention:

  • <sample_id>.pcgr.<genome_assembly>.snv_indel_unfiltered.ann.tsv.gz

This file shares most columns with the standard/filtered TSV above, with the following differences:

  • Added SOMATIC_CLASSIFICATION (column 5, after VARIANT_CLASS): indicates whether a variant is classified as somatic or germline. Value is SOMATIC (not caught by any filter), or one or more of the following germline tags: GERMLINE_GNOMAD (always on), GERMLINE_CLINVAR, GERMLINE_DBSNP, GERMLINE_HET, GERMLINE_HOM, GERMLINE_PON.
  • Added per-population gnomAD columns: gnomADg_AFR_AF, gnomADg_AMR_AF, gnomADg_ASJ_AF, gnomADg_EAS_AF, gnomADg_FIN_AF, gnomADg_NFE_AF, gnomADg_OTH_AF, gnomADg_SAS_AF (genome set) and gnomADe_AFR_AF, gnomADe_AMR_AF, gnomADe_EAS_AF, gnomADe_FIN_AF, gnomADe_NFE_AF, gnomADe_SAS_AF (exome set).
  • Omitted compared to the filtered TSV: DP_CONTROL, VAF_CONTROL, AD_CONTROL (not applicable in tumor-only runs)

Tumor mutational burden (TSV)

We provide a tab-separated values (TSV) file with information about mutational burden detected in the tumor sample. The file has the following naming convention:

  • <sample_id>.pcgr.<genome_assembly>.tmb.tsv

The format of the TSV file is the following:

Variable Description
1. SAMPLE_ID sample identifier
2. N_SOMATIC_VARIANTS number of somatic variants in total for sample
3. TMB_MEASURE TMB measure - type of variants included
4. TMB_CSQ_REGEX VEP consequence regex for variants included in TMB calculation
5. TMB_TARGET_SIZE_MB target size in megabases
6. TMB_DP_MIN minimum depth of coverage for variant to be included in TMB calculation
7. TMB_AF_MIN minimum allele frequency for variant to be included in TMB calculation
8. TMB_N_VARIANTS number of variants included in TMB calculation
9. TMB_ESTIMATE TMB estimate
10. TMB_UNIT TMB unit (i.e. mutations/Mb)

MSI result from external caller (TSV)

If an MSI result from an external MSI caller is provided (--input_msi), a normalised copy of the result is written to a tab-separated values (TSV) file, with the following naming convention:

  • <sample_id>.pcgr.<genome_assembly>.msi.tsv

The file has one data row, and the following columns (missing values are denoted .):

Variable Description
1. SAMPLE_ID Sample identifier
2. MSI_STATUS MSI status: MSI-H, MSS or Indeterminate
3. MSI_STATUS_BASIS How the MSI status was obtained: caller (reported by the MSI caller) or derived (derived by PCGR from the score)
4. MSI_CALLER Name of the MSI caller
5. CALLER_VERSION Version of the MSI caller
6. MSI_SCORE Score, as reported by the MSI caller
7. MSI_SCORE_TYPE Description of the score
8. MSI_SCORE_THRESHOLD_USED Threshold on the score applied for MSI-H (by the caller, or by PCGR if the status was derived: default or set with --input_msi_threshold)
9. N_LOCI_EVALUATED Number of microsatellite loci evaluated
10. N_LOCI_UNSTABLE Number of unstable microsatellite loci

HRD result from external assay/tool (TSV)

If an HRD result from an external assay/tool is provided (--input_hrd), a normalised copy of the result is written to a tab-separated values (TSV) file, with the following naming convention:

  • <sample_id>.pcgr.<genome_assembly>.hrd.tsv

The file has one data row, and the following columns (missing values are denoted .):

Variable Description
1. SAMPLE_ID Sample identifier
2. HRD_STATUS HRD status: HR-deficient, HR-proficient or Indeterminate
3. HRD_STATUS_BASIS How the HRD status was obtained: caller (given in the input file) or derived (derived by PCGR from the score with --input_hrd_threshold)
4. HRD_CALLER Name of the HRD assay/tool
5. CALLER_VERSION Version of the HRD assay/tool
6. HRD_SCORE_TYPE Kind of score: genomic_scar, mutational_signature, composite or other
7. HRD_SCORE_DESCRIPTION Description of the score
8. HRD_SCORE Score, as reported by the assay/tool
9. HRD_SCORE_THRESHOLD_USED Threshold on the score for HR-deficient (by the assay/tool, or by PCGR if the status was derived)
10. HRD_LOH Genomic scar component: HRD-LOH
11. HRD_LST Genomic scar component: LST
12. HRD_TAI Genomic scar component: TAI

Mutational signature contributions (TSV)

We provide a tab-separated values (TSV) file with information about mutational signatures detected in the tumor sample. The file has the following naming convention:

  • <sample_id>.pcgr.<genome_assembly>.msigs.tsv.gz

The format of the TSV file is the following:

Variable Description
1. SAMPLE_ID sample identifier
2. SIGNATURE_ID identifier for signature
3. N_BS_ITERATIONS number of bootstrap iterations
4. PROP_SIGNATURE relative contribution of mutational signature
5. PROP_SIGNATURE_CI_LOWER lower bound of confidence interval for relative contribution of mutational signature
6. PROP_SIGNATURE_CI_UPPER upper bound of confidence interval for relative contribution of mutational signature
7. AETIOLOGY underlying aetiology of mutational signature
8. COMMENTS additional comments regarding aetiology
9. GROUP keyword for signature aetiology
10. ALL_REFERENCE_SIGNATURES logical indicating if all reference signatures were used for reconstruction/inference
11. TUMOR_TYPE tumor type (used for retrieval of reference signatures)
12. REFERENCE_COLLECTION collection used for reference signatures
13. REFERENCE_SIGNATURES signatures present in reference collection
14. FITTING_ACCURACY accuracy of mutational signature fitting

Copy number aberrations

1. Tab-separated values (TSV)

Copy number segments are intersected with the genomic coordinates of all transcripts from GENCODE’s basic gene annotation. In addition, PCGR attaches cancer-relevant annotations for the affected transcripts. The naming convention of the compressed TSV files are as follows:

  • <sample_id>.pcgr.<genome_assembly>.cna_segment.tsv.gz
    • segment level information only
  • <sample_id>.pcgr.<genome_assembly>.cna_gene_ann.tsv.gz
    • This file is organized according to the affected transcripts (i.e. one line/record per affected transcript, segments not overlapping with any transcripts will thus not be included in this files).

Note that a second file, <sample_id>.pcgr.<genome_assembly>.cna_gene.tsv.gz, is also written to the output directory. This is a pipeline intermediate (copy number segments mapped to overlapping transcripts and genes, with BIOMARKER_MATCH in raw format, and two-hit candidate flags and OncoKB columns appended when available) that is read when generating the report. The cna_gene_ann.tsv.gz file described here is the final annotated result and should be used for downstream analysis.

The format of the compressed cna_gene_ann.tsv.gz is the following. Columns suffixed with _OKB are only present when OncoKB annotation is enabled via --oncokb_api_token. Note that HOTSPOT_OKB and VUS_OKB are not included for CNA output.

Variable Description
1. SAMPLE_ID Sample identifier
2. VAR_ID Variant identifier. Format: <chromosome>:<segment_start>-<segment_end>:<major_cn>:<minor_cn>
3. GENOME_VERSION Assembly version, e.g. GRCh38
4. CN_MAJOR Major copy number
5. CN_MINOR Minor copy number
6. CN_MAJOR_MINOR_IMPUTED TRUE if the major/minor split of the segment is imputed (total copy number observed), from the optional input column nMajor_nMinor_Imputed. FALSE otherwise
7. LOH Loss of heterozygosity flag (not called for segments with an imputed major/minor split)
8. TWOHIT_CANDIDATE_SOMATIC Comma-separated somatic loss-of-function variants overlapping the segment (TSG with allele-specific LOH: deletion or copy-neutral). Each entry has the format VAR_ID;CONSEQUENCE;VAF_FLAG;ALTERATION;VAF_TUMOR;DP_TUMOR;ONCOGENICITY, where VAF_FLAG is one of: VAF_CONSISTENT (observed VAF consistent with variant on retained allele given tumor purity), VAF_LOW (VAF below purity-adjusted expectation — variant may reside on the deleted allele or be subclonal to the LOH event), or VAF_UNKNOWN (tumor purity not provided); ALTERATION is the protein-level consequence (or . if absent); VAF_TUMOR is the allele fraction in the tumor; DP_TUMOR is the read depth; and ONCOGENICITY is the OncoKB classification (or . if OncoKB is not enabled).
9. TWOHIT_CANDIDATE_GERMLINE Comma-separated germline pathogenic/likely-pathogenic loss-of-function variants matching by gene symbol (TSG with allele-specific LOH: deletion or copy-neutral; requires CPSR input). Each entry has the format VAR_ID;CONSEQUENCE.
10. FOLD_CHANGE Fold change of segment copy number relative to tumor ploidy
11. TUMOR_PLOIDY Tumor ploidy estimate
12. TUMOR_PLOIDY_SOURCE Source of tumor ploidy estimate: provided (--tumor_ploidy, e.g. estimated with ASCAT or other tools) or estimated (genome-wide weighted median of the segment copy numbers, estimated by PCGR when --tumor_ploidy is not provided)
13. TUMOR_PURITY Tumor purity estimate
14. SEGMENT_LENGTH_MB Length of segment in Mb
15. CYTOBAND Associated cytoband
16. EVENT_TYPE Focal or broad (covering more than 25% of chromosome arm)
17. VARIANT_CLASS amplification: total copy number >= user-defined threshold; homdel: total copy number equal to zero; hetdel: total copy number equal to one; gain: copy number gain below amplification threshold; undefined: other copy number states
18. VARIANT_CLASS_DISPLAY Display label for variant class
19. SYMBOL Gene symbol
20. ENTREZGENE Entrez gene identifier
21. GENENAME Gene name
22. ENSEMBL_GENE_ID Ensembl gene identifier
23. TUMOR_SUPPRESSOR Flag indicating if gene is tumor suppressor (CancerMine/NCG)
24. TUMOR_SUPPRESSOR_SUPPORT Tumor suppressor annotation support (CancerMine/NCG)
25. ONCOGENE Flag indicating if gene is oncogene (CancerMine/NCG)
26. ONCOGENE_SUPPORT Oncogene annotation support (CancerMine/NCG)
27. MUTATION_EFFECT_OKB (OncoKB only) OncoKB mutation effect annotation (e.g. Loss-of-function, Gain-of-function)
28. MUTATION_EFFECT_CITATIONS_OKB (OncoKB only) OncoKB mutation effect citations
29. MUTATION_EFFECT_DESCRIPTION_OKB (OncoKB only) OncoKB mutation effect description
30. ONCOGENICITY_OKB (OncoKB only) OncoKB oncogenicity annotation (e.g. Oncogenic, Likely Oncogenic)
31. TUMOR_TYPE_SUMMARY_OKB (OncoKB only) OncoKB tumor type summary
32. VARIANT_SUMMARY_OKB (OncoKB only) OncoKB variant summary
33. TRANSCRIPT_OVERLAP Comma-separated list of associated transcripts, including percentage of transcript overlap
34. TRANSCRIPT_OVERLAP_PERCENT Percentage overlap between copy number segment and transcript
35. ACTIONABILITY_TIER Variant actionability tier - AMP/ASCO/CAP
36. ACTIONABILITY Variant clinical actionability significance - AMP/ASCO/CAP
37. BIOMARKER_MATCH Biomarker match
38. TARGETED_INHIBITORS_ALL2 Molecularly targeted inhibitors - indicated for any tumor type

2. Sample-level CNA summary (TSV)

Sample-level scores derived from the allele-specific copy number segments are provided in a separate, single-row TSV file (the per-segment and per-transcript files above hold one record per segment/transcript, and thus have no place for sample-level values):

  • <sample_id>.pcgr.<genome_assembly>.cna_summary.tsv
Variable Description
1. SAMPLE_ID Sample identifier
2. FRACTION_GENOME_ALTERED Fraction of the segmented autosomal genome (chromosomes 1-22) with a total copy number (nMajor + nMinor) different from 2. This adapts the cBioPortal fraction-genome-altered metric (genome fraction with an absolute segment mean log2 ratio of at least 0.2) to integer copy numbers: a diploid baseline is used rather than the tumor ploidy, so the value approaches 1 in near-tetraploid/genome-doubled tumors
3. WGD_FRACTION Fraction of the segmented autosomal genome with a major allele copy number (nMajor) of two or more
4. GENOME_DOUBLED Whole-genome doubling status (TRUE/FALSE): TRUE when WGD_FRACTION is at least 0.5, following Bielski et al. 2018
5. HRD_LOH (--estimate_hrd only) Number of loss-of-heterozygosity regions longer than 15 Mb that do not span a whole chromosome
6. HRD_LST (--estimate_hrd only) Number of large-scale state transitions - chromosomal breakpoints between adjacent regions of at least 10 Mb
7. HRD_TAI (--estimate_hrd only) Number of telomeric allelic imbalances - regions with allelic imbalance extending to the telomere without crossing the centromere
8. HRD_SUM (--estimate_hrd only) Sum of HRD_LOH, HRD_LST and HRD_TAI (research use only - see running PCGR)

Missing values (e.g. the HRD columns when --estimate_hrd is not set) are denoted ..

RNA fusions

Tab-separated values (TSV)

Detected RNA fusions are annotated with gene-level cancer relevance, Mitelman database evidence, and clinical actionability. The output file has the following naming convention:

  • <sample_id>.pcgr.<genome_assembly>.fusion_ann.tsv.gz

Note that a second file, <sample_id>.pcgr.<genome_assembly>.rna_fusion.tsv.gz, is also written to the output directory. This is a pipeline intermediate (the input fusion calls matched against biomarker evidence, with BIOMARKER_MATCH in raw format, and OncoKB columns appended when enabled) that is read when generating the report. The fusion_ann.tsv.gz file described here is the final annotated result and should be used for downstream analysis.

Columns suffixed with _OKB are only present when OncoKB annotation is enabled via --oncokb_api_token. Note that HOTSPOT_OKB and VUS_OKB are not included for fusion output.

Variable Description
1. SAMPLE_ID Sample identifier
2. VARIANT_CLASS Variant type: fusion
3. VAR_ID Variant identifier. Format: <gene1>--<gene2>:<breakpoint_5P>:<breakpoint_3P>
4. ENTREZGENE Entrez gene identifiers for both fusion partners. Format: <entrezgene_5P>::<entrezgene_3P>
5. FUSION_GENE Fusion gene name. Format: <gene1>--<gene2>
6. FUSION_GENE2 Alternative fusion gene notation used for Mitelman database variant matching
7. SPLIT_READS Number of split reads supporting the fusion
8. FUSION_GENE_5P Gene symbol of the 5’ fusion partner
9. FUSION_GENE_3P Gene symbol of the 3’ fusion partner
10. BREAKPOINT_5P Chromosomal breakpoint position of the 5’ partner
11. BREAKPOINT_3P Chromosomal breakpoint position of the 3’ partner
12. GENENAME_5P Full gene name of the 5’ partner
13. ONCOGENE_5P Flag indicating if the 5’ partner gene is an oncogene (CancerMine/NCG)
14. ENSEMBL_TRANSCRIPT_ID_5P Ensembl transcript identifier covering the 5’ breakpoint
15. GENENAME_3P Full gene name of the 3’ partner
16. ONCOGENE_3P Flag indicating if the 3’ partner gene is an oncogene (CancerMine/NCG)
17. ENSEMBL_TRANSCRIPT_ID_3P Ensembl transcript identifier covering the 3’ breakpoint
18. SAMPLE_ALTERATION Alteration description for the sample. Format: <FUSION_GENE> fusion
19. MITDB_NUM_EVIDENCE Number of evidence records matching the fusion in the Mitelman Database of Chromosome Aberrations and Gene Fusions in Cancer
20. MITDB_EVIDENCE Evidence records for the fusion from the Mitelman database (cancer type associations)
21. ACTIONABILITY_TIER Variant clinical actionability tier - AMP/ASCO/CAP implementation
22. ACTIONABILITY Variant clinical actionability significance - AMP/ASCO/CAP implementation
23. MUTATION_EFFECT_OKB (OncoKB only) OncoKB mutation effect annotation (e.g. Loss-of-function, Gain-of-function)
24. MUTATION_EFFECT_CITATIONS_OKB (OncoKB only) OncoKB mutation effect citations
25. MUTATION_EFFECT_DESCRIPTION_OKB (OncoKB only) OncoKB mutation effect description
26. ONCOGENICITY_OKB (OncoKB only) OncoKB oncogenicity annotation (e.g. Oncogenic, Likely Oncogenic)
27. TUMOR_TYPE_SUMMARY_OKB (OncoKB only) OncoKB tumor type summary
28. VARIANT_SUMMARY_OKB (OncoKB only) OncoKB variant summary

Gene expression data

If users provide bulk RNA-seq expression data as input, PCGR will attach basic gene annotations for the affected transcripts, and perform similarity analysis and outlier detection if configured by the user. The naming convention of the compressed TSV files are as follows:

Expression data - basic

  • Filename: <sample_id>.pcgr.<genome_assembly>.expression.tsv.gz

One row per affected transcript. Contains TPM expression values with basic gene/transcript annotations.

Variable Description
1. SAMPLE_ID Sample identifier
2. ID Input transcript/gene identifier as provided by the user
3. ID_TYPE Type of identifier (e.g. ensembl_transcript_id)
4. AMBIGUOUS_ID Flag indicating whether the identifier maps to multiple genes
5. TPM Expression level in transcripts per million (TPM)
6. ENSEMBL_TRANSCRIPT_ID Ensembl transcript identifier
7. ENSEMBL_GENE_ID Ensembl gene identifier
8. SYMBOL Gene symbol
9. ENTREZGENE Entrez gene identifier
10. GENENAME Full gene name
11. BIOTYPE Transcript biotype (e.g. protein_coding, lncRNA)

Expression outliers

  • Filename: <sample_id>.pcgr.<genome_assembly>.expression_outliers.tsv.gz

One row per gene. Contains outlier statistics comparing the sample’s gene-level expression against a tumor-type-matched reference cohort.

Variable Description
1. SAMPLE_ID Sample identifier
2. REF_COHORT Reference cohort used for comparison (e.g. tcga_skcm)
3. REF_COHORT_SIZE Number of samples in the reference cohort
4. ENSEMBL_GENE_ID Ensembl gene identifier
5. TPM_LOG2_GENE Log2-transformed gene-level TPM for the query sample
6. MEAN Mean log2 TPM across the reference cohort
7. STD Standard deviation of log2 TPM across the reference cohort
8. Z_SCORE Z-score of the query sample relative to the reference cohort
9. Q1 First quartile (25th percentile) of log2 TPM in the reference cohort
10. Q2 Median (50th percentile) of log2 TPM in the reference cohort
11. Q3 Third quartile (75th percentile) of log2 TPM in the reference cohort
12. IQR Interquartile range (Q3 − Q1) in the reference cohort
13. PERCENTILE Percentile rank of the query sample within the reference cohort

Sample similarity analysis

  • Filename: <sample_id>.pcgr.<genome_assembly>.expression_similarity.tsv.gz

One row per external reference sample. Contains transcriptome-wide (protein-coding only) correlation scores between the query sample and samples from reference expression cohorts.

Variable Description
1. SAMPLE_ID Sample identifier
2. EXT_SAMPLE_ID Identifier of the external reference sample
3. EXT_DB Source database of the external reference sample (e.g. tcga)
4. CORR Pearson correlation coefficient between the query sample and the external reference sample
5. PROTEIN_CODING_ONLY Flag indicating whether the correlation was computed using protein-coding genes only
6. EXT_SAMPLE_ID2 Secondary identifier for the external reference sample
7. EXT_SAMPLE_NAME Display name of the external reference sample
8. EXT_SAMPLE_TYPE Sample type of the external reference sample (e.g. tumor subtype)
9. EXT_AGE_AT_DX Age at diagnosis of the external reference sample donor
10. EXT_AGE_CATEGORY Age category of the external reference sample donor
11. EXT_GENDER Gender of the external reference sample donor
12. EXT_LINK URL link to the external reference sample record
13. EXT_PRIMARY_DIAGNOSIS Primary diagnosis of the external reference sample
14. EXT_PRIMARY_SITE Primary tumor site of the external reference sample

Excel workbook (XLSX)

The Excel workbook has the following naming convention:

  • <sample_id>.pcgr.<genome_assembly>.xlsx

It contains up to 20 sheets, each populated conditionally on the type of input data provided and the analysis performed. Sheets with no data are omitted entirely. Any sheet exceeding 30,000 rows is truncated to the first 30,000 rows (a warning is emitted in that case; the full data is always available in the corresponding TSV file).

The table below describes each sheet, when it is included, and any filtering or content restrictions applied to keep the workbook manageable.

Sheet Included when Content and filtering
SETTINGS Always Key parameters used for the analysis, including filtering thresholds
DATA_VERSIONS Always Version information for all databases used in the annotation and analysis
SAMPLE_ASSAY Always Subject, sample and assay properties (CATEGORY column: SUBJECT, SAMPLE or ASSAY): subject sex and age at tumor sampling, tumor site, purity, ploidy (each with its source - provided: value from --tumor_purity/--tumor_ploidy; estimated: ploidy estimated by PCGR from the copy number segments; purity is never estimated by PCGR), assay type (WGS/WES/TARGETED), tumor-normal/tumor-only mode, and effective target size
SOMATIC_SNV_INDEL --input_vcf provided Somatic SNV/InDel annotations using the same columns as the TSV output, minus BIOMARKER_MATCH and VEP_ALL_CSQ. Filtered to exonic variants (EXONIC_STATUS == "exonic") plus any non-exonic variant with an actionability tier ≤ 3. User-retained VCF INFO tags (--retained_info_tags) are appended as additional columns. HGVSP is renamed to HGVSp_short to avoid column name conflicts
SOMATIC_SNV_INDEL_BIOMARKER --input_vcf provided and biomarker hits exist One row per biomarker evidence item matched to a somatic SNV/InDel. A TIER column encodes evidence category and rank (e.g. T1/T2/T3 = therapeutic sensitivity, R1/R2/R3 = therapeutic resistance, PP1–PP2 = poor prognosis, PB1–PB2 = better prognosis, D1–D2 = diagnostic positive). Only the therapeutic categories (T, R) are AMP/ASCO/CAP actionability tiers; for prognostic and diagnostic evidence (PP, PB, D) the number is an internal evidence-strength rank (lower = stronger evidence), not a tier. Diagnostic-negative evidence is excluded
SOMATIC_CNA --input_cna provided CNA gene-level annotations using the same columns as the TSV output, minus BIOMARKER_MATCH. Filtered to genes with a non-missing ACTIONABILITY_TIER
CNA_SUMMARY --input_cna provided Sample-level scores derived from the copy number segments - fraction of genome altered and (with --estimate_hrd) the HRD score components (same content as the .cna_summary.tsv file)
MSI_BIOMARKER tumor classified as MSI-High Biomarker evidence items (CIViC; OncoKB if enabled) for MSI-High, with AMP/ASCO/CAP tier
TMB_BIOMARKER tumor classified as TMB-High Biomarker evidence items (CIViC; OncoKB if enabled) for TMB-High, with AMP/ASCO/CAP tier
SOMATIC_CNA_BIOMARKER --input_cna provided and biomarker hits exist One row per biomarker evidence item matched to a somatic CNA, using the same TIER encoding and sorting as SOMATIC_SNV_INDEL_BIOMARKER
RNA_FUSION --input_rna_fusion provided RNA fusion annotations using the same columns as the TSV output, minus BIOMARKER_MATCH. Filtered to fusions with a non-missing ACTIONABILITY_TIER
RNA_FUSION_BIOMARKER --input_rna_fusion provided and biomarker hits exist One row per biomarker evidence item matched to an RNA fusion, using the same TIER encoding and sorting as SOMATIC_SNV_INDEL_BIOMARKER
TMB --input_vcf provided Tumor mutational burden estimates (same content as the .tmb.tsv file)
MSI --input_msi provided MSI result from an external MSI caller (same content as the .msi.tsv file)
MSI_INTERNAL --input_vcf provided and MSI estimation enabled MSI classifier statistics and predicted stability status
HRD --input_hrd provided HRD result from an external HRD assay/tool (same content as the .hrd.tsv file)
MUTATIONAL_SIGNATURE --input_vcf provided and signature estimation enabled Mutational signature contributions (same content as the .msigs.tsv.gz file)
KATAEGIS_EVENTS --input_vcf provided and kataegis events detected Kataegis loci identified from the somatic mutation profile
RNA_EXPRESSION_OUTLIERS --input_rna_expression provided and outlier detection enabled Expression outlier genes/transcripts compared to reference cohorts. A subset of display-only columns (GENENAME, CANCERGENE_EVIDENCE, TARGETED_INHIBITORS_ALL, ENSEMBL_GENE_ID) are removed to reduce width
RNA_IMMUNE_CONTEXTURE --input_rna_expression provided Immune cell type deconvolution results from bulk RNA-seq (quanTIseq)

Biomarker evidence in the HTML report vs. the Excel workbook

The _BIOMARKER sheets are more comprehensive than what is displayed in the HTML report. The HTML report shows only the tier-defining evidence items — those that directly determined the variant’s actionability tier assignment. The Excel _BIOMARKER sheets include all matched evidence items, each annotated with a BM_ACTIONABILITY_SUPPORT column that records its relationship to the tier assignment.

The possible values of BM_ACTIONABILITY_SUPPORT are:

  • tier-defining — the evidence item was the primary basis for the variant’s actionability tier. Only these items appear in the HTML report.
  • additional — the evidence item is relevant (correct evidence type, overlapping molecular profile) but was not sufficient on its own to define the tier, either because the tumor type does not match the query or the evidence is weaker than what the tier requires.