CellCorHeatmap: CellCorHeatmap
In zh542370159/SCP: Single Cell Pipeline
CellCorHeatmap R Documentation
CellCorHeatmap
Description
This function generates a heatmap to visualize the similarity between different cell types or conditions. It takes in Seurat objects or expression matrices as input and calculates pairwise similarities or distance.
Usage
CellCorHeatmap(
srt_query,
srt_ref = NULL,
bulk_ref = NULL,
query_group = NULL,
ref_group = NULL,
query_assay = NULL,
ref_assay = NULL,
query_reduction = NULL,
ref_reduction = NULL,
query_dims = 1:30,
ref_dims = 1:30,
query_collapsing = !is.null(query_group),
ref_collapsing = TRUE,
features = NULL,
features_type = c("HVF", "DE"),
feature_source = "both",
nfeatures = 2000,
DEtest_param = list(max.cells.per.ident = 200, test.use = "wilcox"),
DE_threshold = "p_val_adj < 0.05",
distance_metric = "cosine",
k = 30,
filter_lowfreq = 0,
prefix = "KNNPredict",
exp_legend_title = NULL,
border = TRUE,
flip = FALSE,
limits = NULL,
cluster_rows = FALSE,
cluster_columns = FALSE,
show_row_names = FALSE,
show_column_names = FALSE,
row_names_side = "left",
column_names_side = "top",
row_names_rot = 0,
column_names_rot = 90,
row_title = NULL,
column_title = NULL,
row_title_side = "left",
column_title_side = "top",
row_title_rot = 90,
column_title_rot = 0,
nlabel = 0,
label_cutoff = 0,
label_by = "row",
label_size = 10,
heatmap_palette = "RdBu",
heatmap_palcolor = NULL,
query_group_palette = "Paired",
query_group_palcolor = NULL,
ref_group_palette = "simspec",
ref_group_palcolor = NULL,
query_cell_annotation = NULL,
query_cell_annotation_palette = "Paired",
query_cell_annotation_palcolor = NULL,
query_cell_annotation_params = if (flip) list(height = unit(10, "mm")) else list(width
= unit(10, "mm")),
ref_cell_annotation = NULL,
ref_cell_annotation_palette = "Paired",
ref_cell_annotation_palcolor = NULL,
ref_cell_annotation_params = if (flip) list(width = unit(10, "mm")) else list(height =
unit(10, "mm")),
use_raster = NULL,
raster_device = "png",
raster_by_magick = FALSE,
height = NULL,
width = NULL,
units = "inch",
seed = 11,
ht_params = list()
)
Arguments
srt_query
A Seurat object or count matrix representing the query dataset. This dataset will be used to calculate the similarities between cells.
srt_ref
A Seurat object or count matrix representing the reference dataset. If provided, the similarities will be calculated between cells from the query and reference datasets. If not provided, the similarities will be calculated within the query dataset.
bulk_ref
A count matrix representing bulk data. If provided, the similarities will be calculated between cells from the query dataset and bulk data.
query_group
The grouping variable in the query dataset. This variable will be used to group cells in the heatmap rows. If not provided, all cells will be treated as one group.
ref_group
The grouping variable in the reference dataset. This variable will be used to group cells in the heatmap columns. If not provided, all cells will be treated as one group.
query_assay
The assay to use for the query dataset. If not provided, the default assay of the query dataset will be used.
ref_assay
The assay to use for the reference dataset. If not provided, the default assay of the reference dataset will be used.
query_reduction
The dimensionality reduction method to use for the query dataset. If not provided, no dimensionality reduction will be applied to the query dataset.
ref_reduction
The dimensionality reduction method to use for the reference dataset. If not provided, no dimensionality reduction will be applied to the reference dataset.
query_dims
The dimensions to use for the query dataset. If not provided, the first 30 dimensions will be used.
ref_dims
The dimensions to use for the reference dataset. If not provided, the first 30 dimensions will be used.
query_collapsing
Whether to collapse cells within each query group before calculating similarities. If set to TRUE, the similarities will be calculated between query groups rather than individual cells.
ref_collapsing
Whether to collapse cells within each reference group before calculating similarities. If set to TRUE, the similarities will be calculated between reference groups rather than individual cells.
features
A vector of feature names to include in the heatmap. If not provided, a default set of highly variable features (HVF) will be used.
features_type
The type of features to use. Options are "HVF" for highly variable features, "DE" for differentially expressed features between query and reference groups.
feature_source
The source of features to use. Options are "query" to use only features from the query dataset, "ref" to use only features from the reference dataset, or "both" to use features from both datasets. If not provided or set to "both", features will be selected from both datasets.
nfeatures
The maximum number of features to include in the heatmap. If not provided, the default is 2000.
DEtest_param
The parameters to use for differential expression testing. This should be a list with two elements: "max.cells.per.ident" specifying the maximum number of cells per group for differential expression testing, and "test.use" specifying the statistical test to use for differential expression testing. If not provided, the default parameters will be used.
DE_threshold
The threshold for differential expression. Only features with adjusted p-values below this threshold will be considered differentially expressed.
distance_metric
The distance metric to use for calculating similarities between cells. This can be any of the following: "cosine", "pearson", "spearman", "correlation", "jaccard", "ejaccard", "dice", "edice", "hamman", "simple matching", or "faith". If not provided, the default is "cosine".
k
The number of nearest neighbors to use for calculating similarities. If not provided, the default is 30.
filter_lowfreq
The minimum frequency threshold for selecting query dataset features. Features with a frequency below this threshold will be excluded from the heatmap. If not provided, the default is 0.
prefix
The prefix to use for the KNNPredict tool slot in the query dataset. This can be used to avoid conflicts with other tools in the Seurat object. If not provided, the default is "KNNPredict".
exp_legend_title
The title for the color legend in the heatmap. If not provided, a default title based on the similarity metric will be used.
border
Whether to add a border around each heatmap cell. If not provided, the default is TRUE.
flip
Whether to flip the orientation of the heatmap. If set to TRUE, the rows and columns of the heatmap will be swapped. This can be useful for visualizing large datasets in a more compact form. If not provided, the default is FALSE.
limits
The limits for the color scale in the heatmap. If not provided, the default is to use the range of similarity values.
cluster_rows
Whether to cluster the rows of the heatmap. If set to TRUE, the rows will be rearranged based on hierarchical clustering. If not provided, the default is FALSE.
cluster_columns
Whether to cluster the columns of the heatmap. If set to TRUE, the columns will be rearranged based on hierarchical clustering. If not provided, the default is FALSE.
show_row_names
Whether to show the row names in the heatmap. If not provided, the default is FALSE.
show_column_names
Whether to show the column names in the heatmap. If not provided, the default is FALSE.
row_names_side
The side of the heatmap to show the row names. Options are "left" or "right". If not provided, the default is "left".
column_names_side
The side of the heatmap to show the column names. Options are "top" or "bottom". If not provided, the default is "top".
row_names_rot
The rotation angle of the row names. If not provided, the default is 0 degrees.
column_names_rot
The rotation angle of the column names. If not provided, the default is 90 degrees.
row_title
The title for the row names in the heatmap. If not provided, the default is to use the query grouping variable.
column_title
The title for the column names in the heatmap. If not provided, the default is to use the reference grouping variable.
row_title_side
The side of the heatmap to show the row title. Options are "top" or "bottom". If not provided, the default is "left".
column_title_side
The side of the heatmap to show the column title. Options are "left" or "right". If not provided, the default is "top".
row_title_rot
The rotation angle of the row title. If not provided, the default is 90 degrees.
column_title_rot
The rotation angle of the column title. If not provided, the default is 0 degrees.
nlabel
The maximum number of labels to show on each side of the heatmap. If set to 0, no labels will be shown. This can be useful for reducing clutter in large heatmaps. If not provided, the default is 0.
label_cutoff
The similarity cutoff for showing labels. Only cells with similarity values above this cutoff will have labels. If not provided, the default is 0.
label_by
The dimension to use for labeling cells. Options are "row" to label cells by row, "column" to label cells by column, or "both" to label cells by both row and column. If not provided, the default is "row".
label_size
The size of the labels in points. If not provided, the default is 10.
heatmap_palette
The color palette to use for the heatmap. This can be any of the palettes available in the circlize package. If not provided, the default is "RdBu".
heatmap_palcolor
The specific colors to use for the heatmap palette. This should be a vector of color names or RGB values. If not provided, the default is NULL.
query_group_palette
The color palette to use for the query group legend. This can be any of the palettes available in the circlize package. If not provided, the default is "Paired".
query_group_palcolor
The specific colors to use for the query group palette. This should be a vector of color names or RGB values. If not provided, the default is NULL.
ref_group_palette
The color palette to use for the reference group legend. This can be any of the palettes available in the circlize package. If not provided, the default is "simspec".
ref_group_palcolor
The specific colors to use for the reference group palette. This should be a vector of color names or RGB values. If not provided, the default is NULL.
query_cell_annotation
A vector of cell metadata column names or assay feature names to use for highlighting specific cells in the heatmap. Each element of the vector will create a separate cell annotation track in the heatmap. If not provided, no cell annotations will be shown.
query_cell_annotation_palette
The color palette to use for the query cell annotation tracks. This can be any of the palettes available in the circlize package. If a single color palette is provided, it will be used for all cell annotation tracks. If multiple color palettes are provided, each track will be assigned a separate palette. If not provided, the default is "Paired".
query_cell_annotation_palcolor
The specific colors to use for the query cell annotation palettes. This should be a list of vectors, where each vector contains the colors for a specific cell annotation track. If a single color vector is provided, it will be used for all cell annotation tracks. If multiple color vectors are provided, each track will be assigned a separate color vector. If not provided, the default is NULL.
query_cell_annotation_params
Additional parameters for customizing the appearance of the query cell annotation tracks. This should be a list with named elements, where the names correspond to parameter names in the heatmaps_annotation() function from the ComplexHeatmap package. If not provided, the default parameters will be used.
ref_cell_annotation
A vector of cell metadata column names or assay feature names to use for highlighting specific cells in the heatmap. Each element of the vector will create a separate cell annotation track in the heatmap. If not provided, no cell annotations will be shown.
ref_cell_annotation_palette
The color palette to use for the reference cell annotation tracks. This can be any of the palettes available in the circlize package. If a single color palette is provided, it will be used for all cell annotation tracks. If multiple color palettes are provided, each track will be assigned a separate palette. If not provided, the default is "Paired".
ref_cell_annotation_palcolor
The specific colors to use for the reference cell annotation palettes. This should be a list of vectors, where each vector contains the colors for a specific cell annotation track. If a single color vector is provided, it will be used for all cell annotation tracks. If multiple color vectors are provided, each track will be assigned a separate color vector. If not provided, the default is NULL.
ref_cell_annotation_params
Additional parameters for customizing the appearance of the reference cell annotation tracks. This should be a list with named elements, where the names correspond to parameter names in the heatmaps_annotation() function from the ComplexHeatmap package. If not provided, the default parameters will be used.
use_raster
Whether to use raster images for rendering the heatmap. If set to TRUE, the heatmap will be rendered as a raster image using the raster_device argument. If not provided, the default is determined based on the number of rows and columns in the heatmap.
raster_device
The raster device to use for rendering the heatmap. This should be a character string specifying the device name, such as "png", "jpeg", or "pdf". If not provided, the default is "png".
raster_by_magick
Whether to use the magick package for rendering rasters. If set to TRUE, the magick package will be used instead of the raster package. This can be useful for rendering large heatmaps more efficiently. If the magick package is not installed, this argument will be ignored.
height
The height of the heatmap in the specified units. If not provided, the height will be automatically determined based on the number of rows in the heatmap and the default unit.
width
The width of the heatmap in the specified units. If not provided, the width will be automatically determined based on the number of columns in the heatmap and the default unit.
units
The units to use for the width and height of the heatmap. Options are "mm", "cm", or "inch". If not provided, the default is "inch".
seed
The random seed to use for reproducible results. If not provided, the default is 11.
ht_params
Additional parameters to customize the appearance of the heatmap. This should be a list with named elements, where the names correspond to parameter names in the Heatmap() function from the ComplexHeatmap package. Any conflicting parameters will override the defaults set by this function.
Value
A list with the following elements:
plotThe heatmap plot as a ggplot object.
featuresThe features used in the heatmap.
simil_matrixThe similarity matrix used to generate the heatmap.
simil_nameThe name of the similarity metric used to generate the heatmap.
cell_metadataThe cell metadata used to generate the heatmap.
See Also
RunKNNMap RunKNNPredict
Examples
data("pancreas_sub")
pancreas_sub <- Standard_SCP(pancreas_sub)
ht1 <- CellCorHeatmap(srt_query = pancreas_sub, query_group = "SubCellType")
ht1$plot
data("panc8_sub")
# Simply convert genes from human to mouse and preprocess the data
genenames <- make.unique(capitalize(rownames(panc8_sub), force_tolower = TRUE))
panc8_sub <- RenameFeatures(panc8_sub, newnames = genenames)
panc8_sub <- check_srtMerge(panc8_sub, batch = "tech")[["srtMerge"]]
ht2 <- CellCorHeatmap(
srt_query = pancreas_sub, srt_ref = panc8_sub, nlabel = 3, label_cutoff = 0.6,
query_group = "SubCellType", ref_group = "celltype",
query_cell_annotation = "Phase", query_cell_annotation_palette = "Set2",
ref_cell_annotation = "tech", ref_cell_annotation_palette = "Set3",
width = 4, height = 4
)
ht2$plot
ht3 <- CellCorHeatmap(
srt_query = pancreas_sub, srt_ref = panc8_sub,
query_group = "SubCellType", query_collapsing = FALSE, cluster_rows = TRUE,
ref_group = "celltype", ref_collapsing = FALSE, cluster_columns = TRUE
)
ht3$plot
ht4 <- CellCorHeatmap(
srt_query = pancreas_sub, srt_ref = panc8_sub,
show_row_names = TRUE, show_column_names = TRUE,
query_group = "SubCellType", ref_group = "celltype",
query_cell_annotation = c("Sox9", "Rbp4", "Gcg"),
ref_cell_annotation = c("Sox9", "Rbp4", "Gcg")
)
ht4$plot
zh542370159/SCP documentation built on Nov. 22, 2023, 2:34 a.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
| CellCorHeatmap | R Documentation |
CellCorHeatmap
Description
This function generates a heatmap to visualize the similarity between different cell types or conditions. It takes in Seurat objects or expression matrices as input and calculates pairwise similarities or distance.
Usage
CellCorHeatmap(
srt_query,
srt_ref = NULL,
bulk_ref = NULL,
query_group = NULL,
ref_group = NULL,
query_assay = NULL,
ref_assay = NULL,
query_reduction = NULL,
ref_reduction = NULL,
query_dims = 1:30,
ref_dims = 1:30,
query_collapsing = !is.null(query_group),
ref_collapsing = TRUE,
features = NULL,
features_type = c("HVF", "DE"),
feature_source = "both",
nfeatures = 2000,
DEtest_param = list(max.cells.per.ident = 200, test.use = "wilcox"),
DE_threshold = "p_val_adj < 0.05",
distance_metric = "cosine",
k = 30,
filter_lowfreq = 0,
prefix = "KNNPredict",
exp_legend_title = NULL,
border = TRUE,
flip = FALSE,
limits = NULL,
cluster_rows = FALSE,
cluster_columns = FALSE,
show_row_names = FALSE,
show_column_names = FALSE,
row_names_side = "left",
column_names_side = "top",
row_names_rot = 0,
column_names_rot = 90,
row_title = NULL,
column_title = NULL,
row_title_side = "left",
column_title_side = "top",
row_title_rot = 90,
column_title_rot = 0,
nlabel = 0,
label_cutoff = 0,
label_by = "row",
label_size = 10,
heatmap_palette = "RdBu",
heatmap_palcolor = NULL,
query_group_palette = "Paired",
query_group_palcolor = NULL,
ref_group_palette = "simspec",
ref_group_palcolor = NULL,
query_cell_annotation = NULL,
query_cell_annotation_palette = "Paired",
query_cell_annotation_palcolor = NULL,
query_cell_annotation_params = if (flip) list(height = unit(10, "mm")) else list(width
= unit(10, "mm")),
ref_cell_annotation = NULL,
ref_cell_annotation_palette = "Paired",
ref_cell_annotation_palcolor = NULL,
ref_cell_annotation_params = if (flip) list(width = unit(10, "mm")) else list(height =
unit(10, "mm")),
use_raster = NULL,
raster_device = "png",
raster_by_magick = FALSE,
height = NULL,
width = NULL,
units = "inch",
seed = 11,
ht_params = list()
)
Arguments
srt_query |
A Seurat object or count matrix representing the query dataset. This dataset will be used to calculate the similarities between cells. |
srt_ref |
A Seurat object or count matrix representing the reference dataset. If provided, the similarities will be calculated between cells from the query and reference datasets. If not provided, the similarities will be calculated within the query dataset. |
bulk_ref |
A count matrix representing bulk data. If provided, the similarities will be calculated between cells from the query dataset and bulk data. |
query_group |
The grouping variable in the query dataset. This variable will be used to group cells in the heatmap rows. If not provided, all cells will be treated as one group. |
ref_group |
The grouping variable in the reference dataset. This variable will be used to group cells in the heatmap columns. If not provided, all cells will be treated as one group. |
query_assay |
The assay to use for the query dataset. If not provided, the default assay of the query dataset will be used. |
ref_assay |
The assay to use for the reference dataset. If not provided, the default assay of the reference dataset will be used. |
query_reduction |
The dimensionality reduction method to use for the query dataset. If not provided, no dimensionality reduction will be applied to the query dataset. |
ref_reduction |
The dimensionality reduction method to use for the reference dataset. If not provided, no dimensionality reduction will be applied to the reference dataset. |
query_dims |
The dimensions to use for the query dataset. If not provided, the first 30 dimensions will be used. |
ref_dims |
The dimensions to use for the reference dataset. If not provided, the first 30 dimensions will be used. |
query_collapsing |
Whether to collapse cells within each query group before calculating similarities. If set to TRUE, the similarities will be calculated between query groups rather than individual cells. |
ref_collapsing |
Whether to collapse cells within each reference group before calculating similarities. If set to TRUE, the similarities will be calculated between reference groups rather than individual cells. |
features |
A vector of feature names to include in the heatmap. If not provided, a default set of highly variable features (HVF) will be used. |
features_type |
The type of features to use. Options are "HVF" for highly variable features, "DE" for differentially expressed features between query and reference groups. |
feature_source |
The source of features to use. Options are "query" to use only features from the query dataset, "ref" to use only features from the reference dataset, or "both" to use features from both datasets. If not provided or set to "both", features will be selected from both datasets. |
nfeatures |
The maximum number of features to include in the heatmap. If not provided, the default is 2000. |
DEtest_param |
The parameters to use for differential expression testing. This should be a list with two elements: "max.cells.per.ident" specifying the maximum number of cells per group for differential expression testing, and "test.use" specifying the statistical test to use for differential expression testing. If not provided, the default parameters will be used. |
DE_threshold |
The threshold for differential expression. Only features with adjusted p-values below this threshold will be considered differentially expressed. |
distance_metric |
The distance metric to use for calculating similarities between cells. This can be any of the following: "cosine", "pearson", "spearman", "correlation", "jaccard", "ejaccard", "dice", "edice", "hamman", "simple matching", or "faith". If not provided, the default is "cosine". |
k |
The number of nearest neighbors to use for calculating similarities. If not provided, the default is 30. |
filter_lowfreq |
The minimum frequency threshold for selecting query dataset features. Features with a frequency below this threshold will be excluded from the heatmap. If not provided, the default is 0. |
prefix |
The prefix to use for the KNNPredict tool slot in the query dataset. This can be used to avoid conflicts with other tools in the Seurat object. If not provided, the default is "KNNPredict". |
exp_legend_title |
The title for the color legend in the heatmap. If not provided, a default title based on the similarity metric will be used. |
border |
Whether to add a border around each heatmap cell. If not provided, the default is TRUE. |
flip |
Whether to flip the orientation of the heatmap. If set to TRUE, the rows and columns of the heatmap will be swapped. This can be useful for visualizing large datasets in a more compact form. If not provided, the default is FALSE. |
limits |
The limits for the color scale in the heatmap. If not provided, the default is to use the range of similarity values. |
cluster_rows |
Whether to cluster the rows of the heatmap. If set to TRUE, the rows will be rearranged based on hierarchical clustering. If not provided, the default is FALSE. |
cluster_columns |
Whether to cluster the columns of the heatmap. If set to TRUE, the columns will be rearranged based on hierarchical clustering. If not provided, the default is FALSE. |
show_row_names |
Whether to show the row names in the heatmap. If not provided, the default is FALSE. |
show_column_names |
Whether to show the column names in the heatmap. If not provided, the default is FALSE. |
row_names_side |
The side of the heatmap to show the row names. Options are "left" or "right". If not provided, the default is "left". |
column_names_side |
The side of the heatmap to show the column names. Options are "top" or "bottom". If not provided, the default is "top". |
row_names_rot |
The rotation angle of the row names. If not provided, the default is 0 degrees. |
column_names_rot |
The rotation angle of the column names. If not provided, the default is 90 degrees. |
row_title |
The title for the row names in the heatmap. If not provided, the default is to use the query grouping variable. |
column_title |
The title for the column names in the heatmap. If not provided, the default is to use the reference grouping variable. |
row_title_side |
The side of the heatmap to show the row title. Options are "top" or "bottom". If not provided, the default is "left". |
column_title_side |
The side of the heatmap to show the column title. Options are "left" or "right". If not provided, the default is "top". |
row_title_rot |
The rotation angle of the row title. If not provided, the default is 90 degrees. |
column_title_rot |
The rotation angle of the column title. If not provided, the default is 0 degrees. |
nlabel |
The maximum number of labels to show on each side of the heatmap. If set to 0, no labels will be shown. This can be useful for reducing clutter in large heatmaps. If not provided, the default is 0. |
label_cutoff |
The similarity cutoff for showing labels. Only cells with similarity values above this cutoff will have labels. If not provided, the default is 0. |
label_by |
The dimension to use for labeling cells. Options are "row" to label cells by row, "column" to label cells by column, or "both" to label cells by both row and column. If not provided, the default is "row". |
label_size |
The size of the labels in points. If not provided, the default is 10. |
heatmap_palette |
The color palette to use for the heatmap. This can be any of the palettes available in the circlize package. If not provided, the default is "RdBu". |
heatmap_palcolor |
The specific colors to use for the heatmap palette. This should be a vector of color names or RGB values. If not provided, the default is NULL. |
query_group_palette |
The color palette to use for the query group legend. This can be any of the palettes available in the circlize package. If not provided, the default is "Paired". |
query_group_palcolor |
The specific colors to use for the query group palette. This should be a vector of color names or RGB values. If not provided, the default is NULL. |
ref_group_palette |
The color palette to use for the reference group legend. This can be any of the palettes available in the circlize package. If not provided, the default is "simspec". |
ref_group_palcolor |
The specific colors to use for the reference group palette. This should be a vector of color names or RGB values. If not provided, the default is NULL. |
query_cell_annotation |
A vector of cell metadata column names or assay feature names to use for highlighting specific cells in the heatmap. Each element of the vector will create a separate cell annotation track in the heatmap. If not provided, no cell annotations will be shown. |
query_cell_annotation_palette |
The color palette to use for the query cell annotation tracks. This can be any of the palettes available in the circlize package. If a single color palette is provided, it will be used for all cell annotation tracks. If multiple color palettes are provided, each track will be assigned a separate palette. If not provided, the default is "Paired". |
query_cell_annotation_palcolor |
The specific colors to use for the query cell annotation palettes. This should be a list of vectors, where each vector contains the colors for a specific cell annotation track. If a single color vector is provided, it will be used for all cell annotation tracks. If multiple color vectors are provided, each track will be assigned a separate color vector. If not provided, the default is NULL. |
query_cell_annotation_params |
Additional parameters for customizing the appearance of the query cell annotation tracks. This should be a list with named elements, where the names correspond to parameter names in the heatmaps_annotation() function from the ComplexHeatmap package. If not provided, the default parameters will be used. |
ref_cell_annotation |
A vector of cell metadata column names or assay feature names to use for highlighting specific cells in the heatmap. Each element of the vector will create a separate cell annotation track in the heatmap. If not provided, no cell annotations will be shown. |
ref_cell_annotation_palette |
The color palette to use for the reference cell annotation tracks. This can be any of the palettes available in the circlize package. If a single color palette is provided, it will be used for all cell annotation tracks. If multiple color palettes are provided, each track will be assigned a separate palette. If not provided, the default is "Paired". |
ref_cell_annotation_palcolor |
The specific colors to use for the reference cell annotation palettes. This should be a list of vectors, where each vector contains the colors for a specific cell annotation track. If a single color vector is provided, it will be used for all cell annotation tracks. If multiple color vectors are provided, each track will be assigned a separate color vector. If not provided, the default is NULL. |
ref_cell_annotation_params |
Additional parameters for customizing the appearance of the reference cell annotation tracks. This should be a list with named elements, where the names correspond to parameter names in the heatmaps_annotation() function from the ComplexHeatmap package. If not provided, the default parameters will be used. |
use_raster |
Whether to use raster images for rendering the heatmap. If set to TRUE, the heatmap will be rendered as a raster image using the raster_device argument. If not provided, the default is determined based on the number of rows and columns in the heatmap. |
raster_device |
The raster device to use for rendering the heatmap. This should be a character string specifying the device name, such as "png", "jpeg", or "pdf". If not provided, the default is "png". |
raster_by_magick |
Whether to use the magick package for rendering rasters. If set to TRUE, the magick package will be used instead of the raster package. This can be useful for rendering large heatmaps more efficiently. If the magick package is not installed, this argument will be ignored. |
height |
The height of the heatmap in the specified units. If not provided, the height will be automatically determined based on the number of rows in the heatmap and the default unit. |
width |
The width of the heatmap in the specified units. If not provided, the width will be automatically determined based on the number of columns in the heatmap and the default unit. |
units |
The units to use for the width and height of the heatmap. Options are "mm", "cm", or "inch". If not provided, the default is "inch". |
seed |
The random seed to use for reproducible results. If not provided, the default is 11. |
ht_params |
Additional parameters to customize the appearance of the heatmap. This should be a list with named elements, where the names correspond to parameter names in the Heatmap() function from the ComplexHeatmap package. Any conflicting parameters will override the defaults set by this function. |
Value
A list with the following elements:
plotThe heatmap plot as a ggplot object.featuresThe features used in the heatmap.simil_matrixThe similarity matrix used to generate the heatmap.simil_nameThe name of the similarity metric used to generate the heatmap.cell_metadataThe cell metadata used to generate the heatmap.
See Also
RunKNNMap RunKNNPredict
Examples
data("pancreas_sub")
pancreas_sub <- Standard_SCP(pancreas_sub)
ht1 <- CellCorHeatmap(srt_query = pancreas_sub, query_group = "SubCellType")
ht1$plot
data("panc8_sub")
# Simply convert genes from human to mouse and preprocess the data
genenames <- make.unique(capitalize(rownames(panc8_sub), force_tolower = TRUE))
panc8_sub <- RenameFeatures(panc8_sub, newnames = genenames)
panc8_sub <- check_srtMerge(panc8_sub, batch = "tech")[["srtMerge"]]
ht2 <- CellCorHeatmap(
srt_query = pancreas_sub, srt_ref = panc8_sub, nlabel = 3, label_cutoff = 0.6,
query_group = "SubCellType", ref_group = "celltype",
query_cell_annotation = "Phase", query_cell_annotation_palette = "Set2",
ref_cell_annotation = "tech", ref_cell_annotation_palette = "Set3",
width = 4, height = 4
)
ht2$plot
ht3 <- CellCorHeatmap(
srt_query = pancreas_sub, srt_ref = panc8_sub,
query_group = "SubCellType", query_collapsing = FALSE, cluster_rows = TRUE,
ref_group = "celltype", ref_collapsing = FALSE, cluster_columns = TRUE
)
ht3$plot
ht4 <- CellCorHeatmap(
srt_query = pancreas_sub, srt_ref = panc8_sub,
show_row_names = TRUE, show_column_names = TRUE,
query_group = "SubCellType", ref_group = "celltype",
query_cell_annotation = c("Sox9", "Rbp4", "Gcg"),
ref_cell_annotation = c("Sox9", "Rbp4", "Gcg")
)
ht4$plot
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.