Customizing oncoplots
#path to TCGA LAML MAF file
laml.maf = system.file('extdata', 'tcga_laml.maf.gz', package = 'maftools')
#clinical information containing survival information and histology. This is optional
laml.clin = system.file('extdata', 'tcga_laml_annot.tsv', package = 'maftools')
laml = read.maf(maf = laml.maf,
clinicalData = laml.clin,
verbose = FALSE)Including Transition/Transversions into oncoplot
Changing colors for variant classifications
#One can use any colors, here in this example color palette from RColorBrewer package is used
vc_cols = RColorBrewer::brewer.pal(n = 8, name = 'Paired')
names(vc_cols) = c(
'Frame_Shift_Del',
'Missense_Mutation',
'Nonsense_Mutation',
'Multi_Hit',
'Frame_Shift_Ins',
'In_Frame_Ins',
'Splice_Site',
'In_Frame_Del'
)
print(vc_cols)
#> Frame_Shift_Del Missense_Mutation Nonsense_Mutation Multi_Hit
#> "#A6CEE3" "#1F78B4" "#B2DF8A" "#33A02C"
#> Frame_Shift_Ins In_Frame_Ins Splice_Site In_Frame_Del
#> "#FB9A99" "#E31A1C" "#FDBF6F" "#FF7F00"
oncoplot(maf = laml, colors = vc_cols, top = 10)
Including copy number data into oncoplots.
There are two ways one include CN status into MAF. 1. GISTIC results 2. Custom copy number table
GISTIC results
Most widely used tool for copy number analysis from large scale
studies is GISTIC and we can simultaneously read gistic results along
with MAF. GISTIC generates numerous files but we need mainly four files
all_lesions.conf_XX.txt,
amp_genes.conf_XX.txt, del_genes.conf_XX.txt,
scores.gistic where XX is confidence level. These files
contain significantly altered genomic regions along with amplified and
deleted genes respectively.
#GISTIC results LAML
all.lesions =
system.file("extdata", "all_lesions.conf_99.txt", package = "maftools")
amp.genes =
system.file("extdata", "amp_genes.conf_99.txt", package = "maftools")
del.genes =
system.file("extdata", "del_genes.conf_99.txt", package = "maftools")
scores.gis =
system.file("extdata", "scores.gistic", package = "maftools")
#Read GISTIC results along with MAF
laml.plus.gistic = read.maf(
maf = laml.maf,
gisticAllLesionsFile = all.lesions,
gisticAmpGenesFile = amp.genes,
gisticDelGenesFile = del.genes,
gisticScoresFile = scores.gis,
isTCGA = TRUE,
verbose = FALSE,
clinicalData = laml.clin
)
This plot shows frequent deletions in TP53 gene which is located on one of the significantly deleted locus 17p13.2.
Custom copy-number table
In case there is no GISTIC results available, one can generate a table containing CN status for known genes in known samples. This can be easily created and read along with MAF file.
For example lets create a dummy CN alterations for
DNMT3A in random 20 samples.
set.seed(seed = 1024)
barcodes = as.character(getSampleSummary(x = laml)[,Tumor_Sample_Barcode])
#Random 20 samples
dummy.samples = sample(x = barcodes,
size = 20,
replace = FALSE)
#Genarate random CN status for above samples
cn.status = sample(
x = c('ShallowAmp', 'DeepDel', 'Del', 'Amp'),
size = length(dummy.samples),
replace = TRUE
)
custom.cn.data = data.frame(
Gene = "DNMT3A",
Sample_name = dummy.samples,
CN = cn.status,
stringsAsFactors = FALSE
)
head(custom.cn.data)
#> Gene Sample_name CN
#> 1 DNMT3A TCGA-AB-2898 ShallowAmp
#> 2 DNMT3A TCGA-AB-2879 Del
#> 3 DNMT3A TCGA-AB-2920 Amp
#> 4 DNMT3A TCGA-AB-2866 Del
#> 5 DNMT3A TCGA-AB-2892 Del
#> 6 DNMT3A TCGA-AB-2863 ShallowAmp
# Its recommended to also include additional columns Chromosome, Start_Position, End_Position
laml.plus.cn = read.maf(maf = laml.maf,
cnTable = custom.cn.data,
verbose = FALSE)
oncoplot(maf = laml.plus.cn, top = 5)
Bar plots
leftBarData, rightBarData and
topBarData arguments can be used to display additional
values as barplots. Below example demonstrates adding gene expression
values and mutsig q-values as left and right side bars
respectivelly.
#Selected AML driver genes
aml_genes = c("TP53", "WT1", "PHF6", "DNMT3A", "DNMT3B", "TET1", "TET2", "IDH1", "IDH2", "FLT3", "KIT", "KRAS", "NRAS", "RUNX1", "CEBPA", "ASXL1", "EZH2", "KDM6A")
#Variant allele frequcnies (Right bar plot)
aml_genes_vaf = subsetMaf(maf = laml, genes = aml_genes, fields = "i_TumorVAF_WU", mafObj = FALSE)[,mean(i_TumorVAF_WU, na.rm = TRUE), Hugo_Symbol]
colnames(aml_genes_vaf)[2] = "VAF"
head(aml_genes_vaf)
#> Hugo_Symbol VAF
#> <char> <num>
#> 1: ASXL1 37.11250
#> 2: CEBPA 22.00235
#> 3: DNMT3A 43.51556
#> 4: DNMT3B 37.14000
#> 5: EZH2 68.88500
#> 6: FLT3 34.60294
#MutSig results (Right bar plot)
laml.mutsig = system.file("extdata", "LAML_sig_genes.txt.gz", package = "maftools")
laml.mutsig = data.table::fread(input = laml.mutsig)[,.(gene, q)]
laml.mutsig[,q := -log10(q)] #transoform to log10
head(laml.mutsig)
#> gene q
#> <char> <num>
#> 1: FLT3 12.64176
#> 2: DNMT3A 12.64176
#> 3: NPM1 12.64176
#> 4: IDH2 12.64176
#> 5: IDH1 12.64176
#> 6: TET2 12.64176
oncoplot(
maf = laml,
genes = aml_genes,
leftBarData = aml_genes_vaf,
leftBarLims = c(0, 100),
rightBarData = laml.mutsig,
rightBarLims = c(0, 20)
)
Including annotations
Annotations are stored in clinical.data slot of MAF.
getClinicalData(x = laml)
#> Tumor_Sample_Barcode FAB_classification days_to_last_followup
#> <char> <char> <num>
#> 1: TCGA-AB-2802 M4 365
#> 2: TCGA-AB-2803 M3 792
#> 3: TCGA-AB-2804 M3 2557
#> 4: TCGA-AB-2805 M0 577
#> 5: TCGA-AB-2806 M1 945
#> ---
#> 189: TCGA-AB-3007 M3 1581
#> 190: TCGA-AB-3008 M1 822
#> 191: TCGA-AB-3009 M4 577
#> 192: TCGA-AB-3011 M1 1885
#> 193: TCGA-AB-3012 M3 1887
#> Overall_Survival_Status
#> <int>
#> 1: 1
#> 2: 1
#> 3: 0
#> 4: 1
#> 5: 1
#> ---
#> 189: 0
#> 190: 1
#> 191: 1
#> 192: 0
#> 193: 0Include FAB_classification from clinical data as one of
the sample annotations.
More than one annotations can be included by passing them to the
argument clinicalFeatures. Above plot can be further
enhanced by sorting according to annotations. Custom colors can be
specified as a list of named vectors for each levels.
#Color coding for FAB classification
fabcolors = RColorBrewer::brewer.pal(n = 8,name = 'Spectral')
names(fabcolors) = c("M0", "M1", "M2", "M3", "M4", "M5", "M6", "M7")
#For continuous numrical annotations, use one of the below palettes
# c("Blues", "BuGn", "BuPu", "GnBu", "Greens", "Greys", "Oranges",
# "OrRd", "PuBu", "PuBuGn", "PuRd", "Purples", "RdPu", "Reds",
# "YlGn", "YlGnBu", "YlOrBr", "YlOrRd")
anno_cols = list(FAB_classification = fabcolors, days_to_last_followup = "Blues")
print(anno_cols)
#> $FAB_classification
#> M0 M1 M2 M3 M4 M5 M6 M7
#> "#D53E4F" "#F46D43" "#FDAE61" "#FEE08B" "#E6F598" "#ABDDA4" "#66C2A5" "#3288BD"
#>
#> $days_to_last_followup
#> [1] "Blues"
oncoplot(
maf = laml, genes = aml_genes,
clinicalFeatures = c('FAB_classification', 'days_to_last_followup'),
sortByAnnotation = TRUE,
annotationColor = anno_cols
)
Highlighting samples
If you prefer to highlight mutations by a specific attribute, you can
use additionalFeature argument.
Example: Highlight all mutations where alt allele is C.
Note that first argument (Tumor_Seq_Allele2) must a be column in MAF
file, and second argument (C) is a value in that column. If you want to
know what columns are present in the MAF file, use
getFields.
getFields(x = laml)
#> [1] "Hugo_Symbol" "Entrez_Gene_Id" "Center"
#> [4] "NCBI_Build" "Chromosome" "Start_Position"
#> [7] "End_Position" "Strand" "Variant_Classification"
#> [10] "Variant_Type" "Reference_Allele" "Tumor_Seq_Allele1"
#> [13] "Tumor_Seq_Allele2" "Tumor_Sample_Barcode" "Protein_Change"
#> [16] "i_TumorVAF_WU" "i_transcript_name"Group by Pathways
Genes can be auto grouped based on their pathway belongings. Currently maftools has two pathway databases,
- oncogenic signalling pathways: A curated list of 10 signalling pathways
- Catalog of known driver genes classified by their biological processes
By setting pathways argument either sigpw
or smgbp - cohort can be summarized by altered pathways.
pathways argument also accepts a custom pathway list in the
form of a two column tsv file or a data.frame containing gene names and
their corresponding pathway.
Oncogenic siganlling pathways
setting pathways = 'sigpw' to draw 5 most affected
pathways
oncoplot(maf = laml, pathways = "sigpw", gene_mar = 8, fontSize = 0.6, topPathways = 5)
#> Drawing upto top 5 mutated pathways
#> Warning in oncoplot(maf = laml, pathways = "sigpw", gene_mar = 8, fontSize = 0.6, : Found following pathways with the same name as gene symbols. Renamed them with the suffix _pw
#> TP53
#> Warning in oncoplot(maf = laml, pathways = "sigpw", gene_mar = 8, fontSize =
#> 0.6, : Duplicated genes found across multiple pathways! This might cause issue
#> while plotting.
Biological processes of known drivers
oncoplot(maf = laml, pathways = "smgbp", gene_mar = 8, fontSize = 0.8, topPathways = 5)
#> Drawing upto top 5 mutated pathways
Custom pathway list
pathways = data.frame(
Genes = c(
"TP53",
"WT1",
"PHF6",
"DNMT3A",
"DNMT3B",
"TET1",
"TET2",
"IDH1",
"IDH2",
"FLT3",
"KIT",
"KRAS",
"NRAS",
"RUNX1",
"CEBPA",
"ASXL1",
"EZH2",
"KDM6A"
),
Pathway = rep(c(
"TSG", "DNAm", "Signalling", "TFs", "ChromMod"
), c(3, 6, 4, 2, 3)),
stringsAsFactors = FALSE
)
head(pathways)
#> Genes Pathway
#> 1 TP53 TSG
#> 2 WT1 TSG
#> 3 PHF6 TSG
#> 4 DNMT3A DNAm
#> 5 DNMT3B DNAm
#> 6 TET1 DNAm
oncoplot(maf = laml, pathways = pathways, gene_mar = 8, fontSize = 0.6)
#> Drawing upto top 3 mutated pathways
Collapse pathways
By setting collapsePathway = TRUE..
oncoplot(maf = laml, pathways = "sigpw", gene_mar = 8, fontSize = 0.6, topPathways = 5, collapsePathway = TRUE)
#> Drawing upto top 5 mutated pathways
#> Warning in oncoplot(maf = laml, pathways = "sigpw", gene_mar = 8, fontSize = 0.6, : Found following pathways with the same name as gene symbols. Renamed them with the suffix _pw
#> TP53
#> Warning in oncoplot(maf = laml, pathways = "sigpw", gene_mar = 8, fontSize =
#> 0.6, : Duplicated genes found across multiple pathways! This might cause issue
#> while plotting.
Combining everything
oncoplot(
maf = laml.plus.gistic,
draw_titv = TRUE,
pathways = pathways, topPathways = 5,
clinicalFeatures = c('FAB_classification', 'days_to_last_followup'),
sortByAnnotation = TRUE,
additionalFeature = c("Tumor_Seq_Allele2", "C"),
leftBarData = aml_genes_vaf,
leftBarLims = c(0, 100),
rightBarData = laml.mutsig[,.(gene, q)],
)
#> Drawing upto top 5 mutated pathways
SessionInfo
sessionInfo()
#> R version 4.4.2 (2024-10-31)
#> Platform: x86_64-pc-linux-gnu
#> Running under: Ubuntu 24.04.1 LTS
#>
#> Matrix products: default
#> BLAS: /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3
#> LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/libopenblasp-r0.3.26.so; LAPACK version 3.12.0
#>
#> locale:
#> [1] LC_CTYPE=en_US.UTF-8 LC_NUMERIC=C
#> [3] LC_TIME=en_US.UTF-8 LC_COLLATE=C
#> [5] LC_MONETARY=en_US.UTF-8 LC_MESSAGES=en_US.UTF-8
#> [7] LC_PAPER=en_US.UTF-8 LC_NAME=C
#> [9] LC_ADDRESS=C LC_TELEPHONE=C
#> [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C
#>
#> time zone: Etc/UTC
#> tzcode source: system (glibc)
#>
#> attached base packages:
#> [1] parallel stats4 stats graphics grDevices utils datasets
#> [8] methods base
#>
#> other attached packages:
#> [1] pheatmap_1.0.12 doParallel_1.0.17
#> [3] iterators_1.0.14 foreach_1.5.2
#> [5] NMF_0.28 Biobase_2.67.0
#> [7] cluster_2.1.6 rngtools_1.5.2
#> [9] registry_0.5-1 BSgenome.Hsapiens.UCSC.hg19_1.4.3
#> [11] BSgenome_1.75.0 rtracklayer_1.67.0
#> [13] BiocIO_1.17.1 Biostrings_2.75.1
#> [15] XVector_0.47.0 GenomicRanges_1.59.1
#> [17] GenomeInfoDb_1.43.2 IRanges_2.41.1
#> [19] S4Vectors_0.45.2 BiocGenerics_0.53.3
#> [21] generics_0.1.3 mclust_6.1.1
#> [23] maftools_2.23.0
#>
#> loaded via a namespace (and not attached):
#> [1] tidyselect_1.2.1 gridBase_0.4-7
#> [3] dplyr_1.1.4 farver_2.1.2
#> [5] R.utils_2.12.3 bitops_1.0-9
#> [7] RaggedExperiment_1.31.1 fastmap_1.2.0
#> [9] RCurl_1.98-1.16 GenomicAlignments_1.43.0
#> [11] XML_3.99-0.17 digest_0.6.37
#> [13] lifecycle_1.0.4 survival_3.7-0
#> [15] magrittr_2.0.3 compiler_4.4.2
#> [17] rlang_1.1.4 sass_0.4.9
#> [19] tools_4.4.2 utf8_1.2.4
#> [21] yaml_2.3.10 data.table_1.16.2
#> [23] knitr_1.49 S4Arrays_1.7.1
#> [25] curl_6.0.1 DelayedArray_0.33.2
#> [27] plyr_1.8.9 RColorBrewer_1.1-3
#> [29] abind_1.4-8 BiocParallel_1.41.0
#> [31] sys_3.4.3 R.oo_1.27.0
#> [33] grid_4.4.2 fansi_1.0.6
#> [35] colorspace_2.1-1 ggplot2_3.5.1
#> [37] scales_1.3.0 MultiAssayExperiment_1.33.1
#> [39] SummarizedExperiment_1.37.0 cli_3.6.3
#> [41] rmarkdown_2.29 crayon_1.5.3
#> [43] reshape2_1.4.4 httr_1.4.7
#> [45] rjson_0.2.23 DNAcopy_1.81.0
#> [47] cachem_1.1.0 stringr_1.5.1
#> [49] zlibbioc_1.52.0 splines_4.4.2
#> [51] BiocManager_1.30.25 restfulr_0.0.15
#> [53] matrixStats_1.4.1 vctrs_0.6.5
#> [55] Matrix_1.7-1 jsonlite_1.8.9
#> [57] berryFunctions_1.22.5 maketools_1.3.1
#> [59] jquerylib_0.1.4 glue_1.8.0
#> [61] codetools_0.2-20 stringi_1.8.4
#> [63] gtable_0.3.6 UCSC.utils_1.3.0
#> [65] munsell_0.5.1 tibble_3.2.1
#> [67] pillar_1.9.0 htmltools_0.5.8.1
#> [69] GenomeInfoDbData_1.2.13 R6_2.5.1
#> [71] evaluate_1.0.1 lattice_0.22-6
#> [73] R.methodsS3_1.8.2 Rsamtools_2.23.1
#> [75] bslib_0.8.0 Rcpp_1.0.13-1
#> [77] SparseArray_1.7.2 xfun_0.49
#> [79] pkgconfig_2.0.3 MatrixGenerics_1.19.0
#> [81] buildtools_1.0.0