get_known_signatures {MutationalPatterns} | R Documentation

## Get known signatures

### Description

This function loads a signature matrix of pre-defined signatures. It can retreive signatures for different types of mutations. It can also retreive signatures from different sources. Additionally, different signature types can be retreived. (The possible types are: Reference, tissue specific or drug exposure signatures.) Finally, the user can choose whether to include possible artifacts. If no signatures have been defined for a specific combination of options, then an error is given.

### Usage

    get_known_signatures(
      muttype = c("snv", "dbs", "indel", "tsb_snv"),
      source = c("COSMIC", "SIGNAL", "SPARSE"),
      sig_type = c("reference", "exposure", "tissue"),
      incl_poss_artifacts = FALSE,
      tissue_type = c(NA, "Biliary", "Bladder", "Bone", "Breast", "Cervix", "CNS",
        "Colorectal", "Esophagus", "Head", "Kidney", "Liver", "Lung", "Lymphoid", "Myeloid",
        "Ovary", "Pancreas", "Prostate", "Skin", "Stomach", "Thyroid", "Uterus")
    )

### Arguments

`muttype` | The type of mutations. Possible values: * 'snv' (default); * 'dbs'; * 'indel'; * 'tsb_snv' transcription strand bias snv;
`source` | The signature source. Possible values: * 'COSMIC' (default); * 'SIGNAL'; * 'SPARSE';
`sig_type` | The type of signature. Possible values: * 'reference' (default); * 'exposure'; * 'tissue';
`incl_poss_artifacts` | Whether to include possible artifacts. (default: TRUE)
`tissue_type` | The specific tissue to select signatures from. Can only be used when looking at tissue specific signatures. Keep this at NA to see tissue specific signatures for all tissues.

### Details

Possible combinations: COSMIC: - all muttypes. - reference - Can include possible artifacts for SNVs

SIGNAL: - snv. (+ dbs, when using exposure signatures.) - all signature types - Can include possible artifacts for reference SNVs

SPARSE: - snv - reference

Artifacts can be included when using reference signatures for SNVs with COSMIC and SIGNAL

The signatures bundled in this package came from several sources. Please cite the associated papers if you use them.

The COSMIC signatures were downloaded from: https://cancer.sanger.ac.uk/cosmic/signatures We used version 3.1. Paper: Alexandrov, L.B. et al., 2020, Nature

The SIGNAL signatures were downloaded from: https://signal.mutationalsignatures.com/ They were downloaded on: 03 July 2020. Paper: Andrea Degasperi et al., 2020, Nature Cancer Exposure paper: Jill E Kucab et al., 2019, Cell

The SPARSE signatures were downloaded from: https://www.biorxiv.org/content/10.1101/384834v2 They were downloaded on: 03 July 2020. Paper: Daniele Ramazzotti et al., 2019, Bioarchive

### Value

A signature matrix

### Examples

    ## Get reference snv signature from COSMIC
    get_known_signatures()

    ## Get reference snv signature from COSMIC,
    ## including potential artifacts.
    get_known_signatures(incl_poss_artifacts = TRUE)

    ## Get dbs signatures
    get_known_signatures("dbs")

    ## Get indel signatures
    get_known_signatures("indel")

    ## Get transcription strand bias snv signatures
    get_known_signatures("tsb_snv")

    ## Get reference signatures from SIGNAL
    get_known_signatures(source = "SIGNAL")

    ## Get reference signatures from SIGNAL,
    ## including potential artifacts
    get_known_signatures(source = "SIGNAL", incl_poss_artifacts = TRUE)

    ## Get exposure signatures from SIGNAL
    get_known_signatures(source = "SIGNAL", sig_type = "exposure")

    ## Get DBS exposure signatures from SIGNAL
    get_known_signatures("dbs", source = "SIGNAL", sig_type = "exposure")

    ## Get all tissue specific signatures from SIGNAL
    get_known_signatures(source = "SIGNAL", sig_type = "tissue")

    ## Get Bladder specific signatures from SIGNAL
    get_known_signatures(
      source = "SIGNAL",
      sig_type = "tissue",
      tissue_type = "Bladder"
    )

    ## If you use an incorrect tissue_type an error is given,
    ## showing all possible tissue_types.

    ## Get sparse signatures
    get_known_signatures(source = "SPARSE")

[Package MutationalPatterns version 3.0.1 Index]