moduleHeatmap {celda} | R Documentation

## Heatmap for featureModules

### Description

Renders a heatmap for selected `featureModule`. Cells are ordered from those with the lowest probability of the module on the left to the highest probability on the right. Features are ordered from those with the highest probability in the module on the top to the lowest probability on the bottom. Use of save_multi_panel_figure is recommended for outputting figures in various formats.

### Usage

    moduleHeatmap(x, ...)

    ## S4 method for signature 'SingleCellExperiment'
    moduleHeatmap(
      x,
      useAssay = "counts",
      altExpName = "featureSubset",
      featureModule = NULL,
      col = circlize::colorRamp2(c(-2, 0, 2), c("#1E90FF", "#FFFFFF", "#CD2626")),
      topCells = 100,
      topFeatures = NULL,
      normalizedCounts = NA,
      normalize = "proportion",
      transformationFun = sqrt,
      scaleRow = scale,
      showFeaturenames = TRUE,
      trim = c(-2, 2),
      rowFontSize = 6,
      showHeatmapLegend = FALSE,
      showTopAnnotationLegend = FALSE,
      showTopAnnotationName = FALSE,
      topAnnotationHeight = 1.5,
      showLeftAnnotation = FALSE,
      showLeftAnnotationLegend = FALSE,
      showLeftAnnotationName = FALSE,
      leftAnnotationWidth = 1.5,
      width = "auto",
      height = "auto",
      unit = "mm",
      ModuleLabel = "auto",
      labelJust = c("right", "bottom"),
      ...
    )

### Arguments

`x` | A numeric matrix of counts or a SingleCellExperiment with the matrix located in the assay slot under `useAssay`. Rows represent features and columns represent cells.
`...` | Additional parameters passed to Heatmap.
`useAssay` | A string specifying which assay slot to use if `x` is a SingleCellExperiment object. Default "counts".
`altExpName` | The name for the altExp slot to use. Default "featureSubset".
`featureModule` | Integer Vector. The featureModule(s) to display. Multiple modules can be included in a vector. Default `NULL` which plots all module heatmaps.
`col` | Passed to Heatmap. Set color boundaries and colors.
`topCells` | Integer. Number of cells with the highest and lowest probabilities for each module to include in the heatmap. For example, if `topCells = 50`, the 50 cells with the lowest probabilities and the 50 cells with the highest probabilities for each featureModule will be included. If NULL, all cells will be plotted. Default 100.
`topFeatures` | Integer. Plot 'topFeatures' features with the highest probabilities in the module heatmap for each featureModule. If `NULL`, plot all features in the module. Default `NULL`.
`normalizedCounts` | Integer matrix. Rows represent features and columns represent cells. If you have a normalized matrix result from normalizeCounts, you can pass through the result here to skip the normalization step in this function. Make sure the colnames and rownames match the object in x. This matrix should correspond to one generated from this count matrix `assay(altExp(x, altExpName), i = useAssay)`. If `NA`, normalization will be carried out in the following form `normalizeCounts(assay(altExp(x, altExpName), i = useAssay), normalize = "proportion", transformationFun = sqrt)`. Use of this parameter is particularly useful for plotting many module heatmaps, where normalizing the counts matrix repeatedly would be too time consuming. Default NA.
`normalize` | Character. Passed to normalizeCounts if `normalizedCounts` is `NA`. Divides counts by the library sizes for each cell. One of 'proportion', 'cpm', 'median', or 'mean'. 'proportion' uses the total counts for each cell as the library size. 'cpm' divides the library size of each cell by one million to produce counts per million. 'median' divides the library size of each cell by the median library size across all cells. 'mean' divides the library size of each cell by the mean library size across all cells. Default "proportion".
`transformationFun` | Function. Passed to normalizeCounts if `normalizedCounts` is `NA`. Applys a transformation such as sqrt, log, log2, log10, or log1p. If NULL, no transformation will be applied. Occurs after normalization. Default sqrt.
`scaleRow` | Function. Which function to use to scale each individual row. Set to NULL to disable. Occurs after normalization and log transformation. For example, scale will Z-score transform each row. Default scale.
`showFeaturenames` | Logical. Wheter feature names should be displayed. Default TRUE.
`trim` | Numeric vector. Vector of length two that specifies the lower and upper bounds for plotting the data. This threshold is applied after row scaling. Set to NULL to disable. Default c(-2,2).
`rowFontSize` | Integer. Font size for genes.
`showHeatmapLegend` | Passed to Heatmap. Show legend for expression levels.
`showTopAnnotationLegend` | Passed to HeatmapAnnotation. Show legend for cell annotation.
`showTopAnnotationName` | Passed to HeatmapAnnotation. Show heatmap top annotation name.
`topAnnotationHeight` | Passed to HeatmapAnnotation. Column annotation height. rowAnnotation. Show legend for module annotation.
`showLeftAnnotation` | Show left annotation. Default `FALSE`.
`showLeftAnnotationLegend` | Passed to HeatmapAnnotation. Show legend for feature module annotation.
`showLeftAnnotationName` | Passed to rowAnnotation. Show heatmap left annotation name.
`leftAnnotationWidth` | Passed to rowAnnotation. Row annotation width.
`width` | Passed to multi_panel_figure. The width of the output figure.
`height` | Passed to multi_panel_figure. The height of the output figure.
`unit` | Passed to multi_panel_figure. Single character object defining the unit of all dimensions defined.
`ModuleLabel` | Must be vector of the same length as `length(unique(celdaModules(x)))` or `length(unique(celdaClusters(x)$y))`. Set to `""` to disable.
`labelJust` | Passed to fill_panel. Justification for the label within the interpanel spacing grob to the top-left of the panel content grob.

### Value

A multi_panel_figure object.

### Examples

    data(sceCeldaCG)
    moduleHeatmap(sceCeldaCG, width = 250, height = 250)

[Package celda version 1.6.1 Index]