Annotate single cells using scmap.

Usage

RunScmap(
  srt_query,
  srt_ref,
  ref_group = NULL,
  query_assay = "RNA",
  ref_assay = "RNA",
  method = "scmapCluster",
  nfeatures = 500,
  threshold = 0.5,
  k = 10
)

Arguments

srt_query: An object of class Seurat to be annotated with cell types.
srt_ref: An object of class Seurat storing the reference cells.
ref_group: A character vector specifying the column name in the srt_ref metadata that represents the cell grouping.
query_assay: A character vector specifying the assay to be used for the query data. Default is the default assay of the srt_query object.
ref_assay: A character vector specifying the assay to be used for the reference data. Default is the default assay of the srt_ref object.
method: The method to be used for scmap analysis. Can be any of "scmapCluster" or "scmapCell". Default is "scmapCluster".
nfeatures: The number of top features to be selected. Default is 500.
threshold: The threshold value on similarity to determine if a cell is assigned to a cluster. This should be a value between 0 and 1. Default is 0.5.
k: Number of clusters per group for k-means clustering when method is "scmapCell". Default is 10.

Examples

data(panc8_sub)
panc8_sub <- standard_scop(panc8_sub)
#> ℹ [2026-04-26 02:25:19] Start standard processing workflow...
#> ℹ [2026-04-26 02:25:20] Checking a list of <Seurat>...
#> ! [2026-04-26 02:25:20] Data 1/1 of the `srt_list` is "unknown"
#> ℹ [2026-04-26 02:25:20] Perform `NormalizeData()` with `normalization.method = 'LogNormalize'` on 1/1 of `srt_list`...
#> ℹ [2026-04-26 02:25:23] Perform `Seurat::FindVariableFeatures()` on 1/1 of `srt_list`...
#> ℹ [2026-04-26 02:25:23] Use the separate HVF from `srt_list`
#> ℹ [2026-04-26 02:25:23] Number of available HVF: 2000
#> ℹ [2026-04-26 02:25:24] Finished check
#> ℹ [2026-04-26 02:25:24] Perform `Seurat::ScaleData()`
#> ℹ [2026-04-26 02:25:25] Perform pca linear dimension reduction
#> ℹ [2026-04-26 02:25:26] Use stored estimated dimensions 1:20 for Standardpca
#> ℹ [2026-04-26 02:25:26] Perform `Seurat::FindClusters()` with `cluster_algorithm = 'louvain'` and `cluster_resolution = 0.6`
#> ℹ [2026-04-26 02:25:26] Reorder clusters...
#> ℹ [2026-04-26 02:25:27] Skip `log1p()` because `layer = data` is not "counts"
#> ℹ [2026-04-26 02:25:27] Perform umap nonlinear dimension reduction
#> ℹ [2026-04-26 02:25:27] Perform umap nonlinear dimension reduction using Standardpca (1:20)
#> ℹ [2026-04-26 02:25:33] Perform umap nonlinear dimension reduction using Standardpca (1:20)
#> ✔ [2026-04-26 02:25:39] Standard processing workflow completed

genenames <- make.unique(
  thisutils::capitalize(
    rownames(panc8_sub),
    force_tolower = TRUE
  )
)
names(genenames) <- rownames(panc8_sub)
panc8_sub <- RenameFeatures(
  panc8_sub,
  newnames = genenames
)
#> ℹ [2026-04-26 02:25:39] Rename features for the assay: RNA
panc8_sub <- CheckDataMerge(
  panc8_sub,
  batch = "tech"
)[["srt_merge"]]
#> ℹ [2026-04-26 02:25:39] Split `srt_merge` into `srt_list` by "tech"
#> ℹ [2026-04-26 02:25:40] Checking a list of <Seurat>...
#> ℹ [2026-04-26 02:25:40] Data 1/5 of the `srt_list` has been log-normalized
#> ℹ [2026-04-26 02:25:40] Perform `Seurat::FindVariableFeatures()` on 1/5 of `srt_list`...
#> ℹ [2026-04-26 02:25:40] Data 2/5 of the `srt_list` has been log-normalized
#> ℹ [2026-04-26 02:25:41] Perform `Seurat::FindVariableFeatures()` on 2/5 of `srt_list`...
#> ℹ [2026-04-26 02:25:41] Data 3/5 of the `srt_list` has been log-normalized
#> ℹ [2026-04-26 02:25:41] Perform `Seurat::FindVariableFeatures()` on 3/5 of `srt_list`...
#> ℹ [2026-04-26 02:25:42] Data 4/5 of the `srt_list` has been log-normalized
#> ℹ [2026-04-26 02:25:42] Perform `Seurat::FindVariableFeatures()` on 4/5 of `srt_list`...
#> ℹ [2026-04-26 02:25:42] Data 5/5 of the `srt_list` has been log-normalized
#> ℹ [2026-04-26 02:25:42] Perform `Seurat::FindVariableFeatures()` on 5/5 of `srt_list`...
#> ℹ [2026-04-26 02:25:43] Use the separate HVF from `srt_list`
#> ℹ [2026-04-26 02:25:43] Number of available HVF: 2000
#> ℹ [2026-04-26 02:25:43] Finished check
#> Warning: Key ‘StandardpcaUMAP2D_’ taken, using ‘standardumap2d_’ instead
#> Warning: Key ‘StandardpcaUMAP3D_’ taken, using ‘standardumap3d_’ instead

data(pancreas_sub)
pancreas_sub <- standard_scop(pancreas_sub)
#> ℹ [2026-04-26 02:25:46] Start standard processing workflow...
#> ℹ [2026-04-26 02:25:46] Checking a list of <Seurat>...
#> ! [2026-04-26 02:25:46] Data 1/1 of the `srt_list` is "unknown"
#> ℹ [2026-04-26 02:25:46] Perform `NormalizeData()` with `normalization.method = 'LogNormalize'` on 1/1 of `srt_list`...
#> ℹ [2026-04-26 02:25:49] Perform `Seurat::FindVariableFeatures()` on 1/1 of `srt_list`...
#> ℹ [2026-04-26 02:25:50] Use the separate HVF from `srt_list`
#> ℹ [2026-04-26 02:25:50] Number of available HVF: 2000
#> ℹ [2026-04-26 02:25:50] Finished check
#> ℹ [2026-04-26 02:25:50] Perform `Seurat::ScaleData()`
#> ℹ [2026-04-26 02:25:50] Perform pca linear dimension reduction
#> ℹ [2026-04-26 02:25:51] Use stored estimated dimensions 1:20 for Standardpca
#> ℹ [2026-04-26 02:25:52] Perform `Seurat::FindClusters()` with `cluster_algorithm = 'louvain'` and `cluster_resolution = 0.6`
#> ℹ [2026-04-26 02:25:52] Reorder clusters...
#> ℹ [2026-04-26 02:25:52] Skip `log1p()` because `layer = data` is not "counts"
#> ℹ [2026-04-26 02:25:52] Perform umap nonlinear dimension reduction
#> ℹ [2026-04-26 02:25:52] Perform umap nonlinear dimension reduction using Standardpca (1:20)
#> ℹ [2026-04-26 02:25:58] Perform umap nonlinear dimension reduction using Standardpca (1:20)
#> ✔ [2026-04-26 02:26:03] Standard processing workflow completed
pancreas_sub <- RunScmap(
  srt_query = pancreas_sub,
  srt_ref = panc8_sub,
  ref_group = "celltype",
  method = "scmapCluster"
)
#> ℹ [2026-04-26 02:26:35] Data type is log-normalized
#> ℹ [2026-04-26 02:26:35] Detected `srt_query` data type: "log_normalized_counts"
#> ℹ [2026-04-26 02:26:36] Data type is log-normalized
#> ℹ [2026-04-26 02:26:36] Detected `srt_ref` data type: "log_normalized_counts"
#> ℹ [2026-04-26 02:26:40] Perform selectFeatures
#> ℹ [2026-04-26 02:26:40] Perform indexCluster
#> ℹ [2026-04-26 02:26:41] Perform scmapCluster
#> Warning: Features Mt-atp6, Mt-co1, Mt-co2, Mt-co3, Mt-nd1, Mt-nd2, Mt-nd4, Mt-nd4l, Mt-nd5 are not present in the 'SCESet' object and therefore were not set.
CellDimPlot(
  pancreas_sub,
  group.by = "scmap_annotation"
)


pancreas_sub <- RunScmap(
  srt_query = pancreas_sub,
  srt_ref = panc8_sub,
  ref_group = "celltype",
  method = "scmapCell"
)
#> ℹ [2026-04-26 02:26:42] Data type is log-normalized
#> ℹ [2026-04-26 02:26:42] Detected `srt_query` data type: "log_normalized_counts"
#> ℹ [2026-04-26 02:26:43] Data type is log-normalized
#> ℹ [2026-04-26 02:26:43] Detected `srt_ref` data type: "log_normalized_counts"
#> ℹ [2026-04-26 02:26:47] Perform selectFeatures
#> ℹ [2026-04-26 02:26:47] Perform indexCell
#> ℹ [2026-04-26 02:26:48] Perform scmapCell
#> ℹ [2026-04-26 02:26:49] Perform scmapCell2Cluster
CellDimPlot(
  pancreas_sub,
  group.by = "scmap_annotation"
)

Annotate single cells using scmap.

Usage

Arguments

See also

Examples