ICAMS

Travis build status CRAN_Status_Badge License: GPL v3

In-depth Characterization and Analysis of Mutational Signatures (‘ICAMS’)

Purpose

Analysis and visualization of experimentally elucidated mutational signatures – the kind of analysis and visualization in Boot et al., “In-depth characterization of the cisplatin mutational signature in human cell lines and in esophageal and liver tumors”, Genome Research 2018, https://doi.org/10.1101/gr.230219.117 and “Characterization of colibactin-associated mutational signature in an Asian oral squamous cell carcinoma and in other mucosal tumor types”, Genome Research 2020 https://doi.org/10.1101/gr.255620.119. ‘ICAMS’ stands for In-depth Characterization and Analysis of Mutational Signatures. ‘ICAMS’ has functions to read in variant call files (VCFs) and to collate the corresponding catalogs of mutational spectra and to analyze and plot catalogs of mutational spectra and signatures. Handles both “counts-based” and “density-based” catalogs of mutational spectra or signatures.

Installation

To begin with, install the necessary dependency package from Bioconductor for ICAMS:

install.packages("BiocManager")
BiocManager::install("BSgenome")

For first time installation, it may take a long time, please be patient.

Afterwards, install the stable version of ICAMS from CRAN with the R command line:

install.packages("ICAMS")

Get the development version

To use features in the development version, you can install ICAMS from the master branch on GitHub, which may not be stable:

install.packages("remotes")
remotes::install_github(repo = "steverozen/ICAMS", ref = "master")

Binaries of recent stable development versions are at Windows binary or macOS binary These are for users who cannot install from source because they do not have Rtools (Windows) or XCode (Mac). To use these binaries, download the .zip (Windows) or .tgz (Mac) file for your operating system.

Then do:

install.packages(pkgs = "path-to-binary-file-on-your-computer", repos = NULL)

Reference manual

https://github.com/steverozen/ICAMS/blob/master/data-raw/ICAMS_2.2.4.pdf

Frequently asked questions

How to do normalization for “counts-based” catalogs of mutational spectra or signatures to account for differing abundances of the source sequence of the mutations?

You can use exported function TransformCatalog in ICAMS to normalize the data. Please refer to the documentation and example of TransformCatalog for more details.