matchSignatures {mutSignatures}

Match Mutational Signatures.

Description

Analyze the similarity between mutational signatures from different analyses/runs. THis function can be helpful to match de novo extracted signatures with previously described signatures (such as COSMIC), or to reveal signatures that can be identified with alternative NMF algorithms, or that may be due to an algorithm bias.

Usage

matchSignatures(
  mutSign,
  reference = NULL,
  method = "cosine",
  threshold = 0.5,
  plot = "TRUE"
)

Arguments

mutSign

a mutationSignatures object

reference

a mutationSignatures object. If NULL, COSMIC signatures will be retrieved

method

distance method used to compute similarity (1 - distance)

threshold

signal (similarity) upper threshold for maxing the signal

plot

logical, shall a heatmap be plotted

Details

This function is part of the user-interface set of tools included in mutSignatures. This is an exported function.

Value

list, including distance matrix and a heatmap plot

Author(s)

Damiano Fantini, [e-mail]

References

More information and examples about mutational signature analysis can be found here:

1. GitHub Repo: https://github.com/dami82/mutSignatures/

2. More info and examples about the mutSignatures R library: https://www.data-pulse.com/dev_site/mutsignatures/

3. Sci Rep paper, introducing mutS: https://www.nature.com/articles/s41598-020-75062-0/

4. Oncogene paper, Mutational Signatures Operative in Bladder Cancer: https://www.nature.com/articles/s41388-017-0099-6