ScQCenrich enables multi-metric quality control for single-cell RNA sequencing.
12 blocks of code here have a permanent identifier (oscr:b:…), listed with the matches below: citable for good, with a page of its own. Select a match and press Cite to copy it. What a block identifier is.
The 13 matches
- [1] § Methods › scQCenrich workflow ↔ R/wrapper.R, lines 3 to 68 · score 0.94 · enrichment_plots, report_html, run_qc_pipeline, rescue_mode, low quality cells, qc_strength · block
oscr:b:VXR7YQRY6JNK6-2· Report a mismatch - [2] § Methods › QC burden scoring and removal rules ↔ R/outliers.R, lines 285 to 333 · score 0.93 · avoid double, remove_quantile, tailed deviation, MALAT1 term, nFeature, pctMT · block
oscr:b:0SC0Z5R0DBXYQ-R· Report a mismatch - [3] § Methods › scQCenrich workflow ↔ inst/benchmarking.R, lines 456 to 538 · score 0.92 · enrichment_plots, qc_report.html, run_qc_pipeline, rescue_mode, qc_strength, qc_outputs · block
oscr:b:1Y7Q2VDQ1YVVH-M· Report a mismatch - [4] § Methods › Preliminary annotation and clustering ↔ inst/benchmarking.R, lines 86 to 127 · score 0.91 · FindClusters, FindNeighbors, RunPCA, ScaleData, FindVariableFeatures, NormalizeData · block
oscr:b:RJ7PHM42YXAW5-M· Report a mismatch - [5] § Methods › Model-based low-quality detection ↔ R/outliers.R, lines 212 to 283 · score 0.90 · minPts, stress_score, Mclust fails, nFeature, pctMT, QC scoring · block
oscr:b:P1NGNDJX93VQH-M· Report a mismatch - [6] § Methods › Preliminary annotation and clustering ↔ R/enrichment.R, lines 82 to 126 · score 0.90 · FindClusters, FindNeighbors, RunPCA, ScaleData, FindVariableFeatures, NormalizeData · block
oscr:b:C3VTVQ3N4MCSA-L· Report a mismatch - [7] § Methods › Coherence-based rescue ↔ R/rescue.R, lines 103 to 146 · score 0.90 · available metric gates, Intronic gating, median intronic, rescue score, pass fraction, healthy · block
oscr:b:EQXKRSEVRRYYM-V· Report a mismatch - [8] § Methods › QC burden scoring and removal rules ↔ R/filter.R, lines 46 to 99 · score 0.89 · remove_quantile, qc_strength, nFeature, pctMT, stress score, intronic fraction · block
oscr:b:4GPZ29VYW5MQB-7· Report a mismatch - [9] § Methods › QC metrics calculation ↔ scripts/build_figure6_report_sources.R, lines 593 to 654 · score 0.81 · unspliced fraction, MALAT1 fraction, intronic fraction, stress score, detected genes, heat · block
oscr:b:0WQ1F1847DT6C-N· Report a mismatch - [10] § Methods › QC metrics calculation ↔ R/plots.R, lines 242 to 312 · score 0.80 · unspliced fraction, MALAT1 fraction, intronic fraction, stress score, detected genes, ratio · block
oscr:b:7CQ7PJRKSS2N6-3· Report a mismatch - [11] § Methods › Default safeguards and final QC states ↔ R/filter.R, lines 397 to 481 · score 0.68 · pre rescue, Borderline cells, removed cell, demoted, cap, extreme · block
oscr:b:H3G5C2MVNWF50-O· Report a mismatch - [12] § Methods › Automated reporting ↔ scripts/build_figure6_report_sources.R, lines 593 to 654 · score 0.67 · MALAT1 fraction, intronic fraction, stress score, detected genes, GO, mt · block
oscr:b:0WQ1F1847DT6C-N· Report a mismatch - [13] § Methods › Splice-aware input generation and comparator methods ↔ inst/benchmarking.R, lines 349 to 410 · score 0.63 · DropletQC, nuclear fraction, baselines, tuned, intact, unspliced · block
oscr:b:6F1S7BY8BSDMV-D· Report a mismatch
Paper
Loaded from Europe PMC by your browser; OSCR does not store it: doi.org · Europe PMC
The paper is loaded when this pane is shown.
The authors' code
R · 538 lines · 19 KB · other · 3 matches
- # install if missing ------------------------------------------------------
- # 1. Increase timeout for large Bioconductor/GitHub downloads
- options(timeout = 600)
- # 2. Define the packages by source
- cran_pkgs <- c("Seurat", "Matrix", "dplyr", "tidyr", "ggplot2", "cluster", "lme4", "remotes")
- bioc_pkgs <- c("scater", "SingleCellExperiment", "scuttle", "miQC", "scDblFinder",
- "celda", "SingleR", "celldex")
- github_pkgs <- c("DropletQC" = "powellgenomicslab/DropletQC")
- # 3. Ensure BiocManager and remotes are installed first
- if (!requireNamespace("BiocManager", quietly = TRUE)) install.packages("BiocManager")
- if (!requireNamespace("remotes", quietly = TRUE)) install.packages("remotes")
- # 4. Install missing CRAN packages
- missing_cran <- cran_pkgs[!(cran_pkgs %in% installed.packages()[, "Package"])]
- if (length(missing_cran)) install.packages(missing_cran)
- # 5. Install missing Bioconductor packages
- missing_bioc <- bioc_pkgs[!(bioc_pkgs %in% installed.packages()[, "Package"])]
- if (length(missing_bioc)) BiocManager::install(missing_bioc, ask = FALSE)
- # 6. Install missing GitHub packages (specifically DropletQC)
- if (!requireNamespace("DropletQC", quietly = TRUE)) {
- remotes::install_github(github_pkgs["DropletQC"])
- }
- # 7. Load all libraries
- all_pkgs <- c(cran_pkgs, bioc_pkgs, names(github_pkgs))
- lapply(all_pkgs, library, character.only = TRUE)
- # load lib ----------------------------------------------------------------
- library(scater) # addPerCellQCMetrics
- library(Seurat)
- library(SingleCellExperiment)
- library(scuttle)
- library(miQC) # mixtureModel, filterCells
- library(scDblFinder) # doublets
- library(celda) # DecontX
- library(SingleR)
- library(celldex) # biology annotation
- library(Matrix)
- library(dplyr)
- library(tidyr)
- library(ggplot2)
- library(cluster) # silhouette
- library(lme4) # mixed model
- library(DropletQC) # dropletqc
- options(timeout = 600)
- # Data path-----
- raw_counts_dir <- "path/to/filtered_feature_bc_matrix/"
- spliced_rds <- "path/to/testloom.rds"
- # human or mouse
- organism <- "human"
- organ <- c("Lung", "Blood")
- # preprocessing -------------------------------------------------------
- seurat_std <- CreateSeuratObject(counts = Read10X(raw_counts_dir), project = "QC_compare")
- seurat_sp <- readRDS(spliced_rds)
- # Helper: normalize cell barcodes to a comparable format
- .normalize_cells <- function(cells) {
- # drop sample prefix if present
- cells <- sub(".*:", "", cells)
- # drop trailing x if present
- cells <- sub("x$", "", cells)
- # drop trailing -1 if present
- cells <- sub("-1$", "", cells)
- cells
- }
- # Suppose you have:
- # seurat_std = your "standard" Seurat object (RNA assay)
- # seurat_sp = your velocity-style Seurat object (spliced/unspliced)
- # Normalize cell IDs
- std_ids <- .normalize_cells(colnames(seurat_std))
- sp_ids <- .normalize_cells(colnames(seurat_sp))
- # Find intersection
- common <- intersect(std_ids, sp_ids)
- message("Found ", length(common), " overlapping cells.")
- # Sample cells if needed (or fewer if less available)
- set.seed(123) # for reproducibility
- keep_ids <- sample(common, min(50000, length(common)))
- # Map back to original names in each object
- std_keep <- colnames(seurat_std)[.normalize_cells(colnames(seurat_std)) %in% keep_ids]
- sp_keep <- colnames(seurat_sp)[.normalize_cells(colnames(seurat_sp)) %in% keep_ids]
- # Subset
- seurat_std_small <- subset(seurat_std, cells = std_keep)
- seurat_sp_small <- subset(seurat_sp, cells = sp_keep)
- # Check dimensions
- dim(seurat_std_small) # genes x 500 (or fewer)
- dim(seurat_sp_small)
- seurat_std_small <- NormalizeData(seurat_std_small)
- seurat_std_small <- FindVariableFeatures(seurat_std_small)
- seurat_std_small <- ScaleData(seurat_std_small)
- seurat_std_small <- RunPCA(seurat_std_small)
- seurat_std_small <- RunUMAP(seurat_std_small, dims = 1:20, verbose = FALSE, seed.use = 1337)
- seurat_std_small <- FindNeighbors(seurat_std_small)
- seurat_std_small <- FindClusters(seurat_std_small, resolution = 0.4)
- # metric functions --------------------------------------------------------
- # ===========================
- # Helpers (species-agnostic mito detection)
- # ===========================
- .mito_patterns_default <- c("^MT-", "^mt-", "^Mt-") # human, mouse, mixed
- .mito_regex <- function(patterns) paste0("(", paste(patterns, collapse = "|"), ")")
- .get_mito_features <- function(seu, mito_patterns = NULL) {
- if (is.null(mito_patterns)) mito_patterns <- .mito_patterns_default
- genes <- rownames(seu)
- if (is.null(genes)) {
- return(character(0))
- }
- genes[grepl(.mito_regex(mito_patterns), genes)]
- }
- .get_mito_index_sce <- function(sce, mito_patterns = NULL) {
- if (is.null(mito_patterns)) mito_patterns <- .mito_patterns_default
- rn <- rownames(sce)
- if (is.null(rn)) {
- return(rep(FALSE, nrow(sce)))
- }
- grepl(.mito_regex(mito_patterns), rn)
- }
- # ===========================
- # 1) Utility: safe add meta by barcode (unchanged)
- # ===========================
- add_meta <- function(seu, df, suffix = NULL) {
- stopifnot(all(rownames(df) %in% colnames(seu)))
- if (!is.null(suffix)) colnames(df) <- paste0(colnames(df), "_", suffix)
- df <- df[colnames(seu), , drop = FALSE]
- Seurat::AddMetaData(seu, df)
- }
- # ---- META-ONLY MERGE (donor -> target) (minor namespace tighten; no behavior change) ----
- merge_meta_only <- function(target, donor, cols = NULL, suffix = "_donor",
- normalizer = .normalize_cells, verbose = TRUE) {
- stopifnot(inherits(target, "Seurat"), inherits(donor, "Seurat"))
- # maps of original -> normalized IDs
- map <- function(obj) {
- data.frame(
- orig = colnames(obj),
- norm = normalizer(colnames(obj)),
- stringsAsFactors = FALSE
- )
- }
- mT <- map(target)
- mD <- map(donor)
- # if normalization creates duplicate IDs, fall back to exact IDs
- if (any(duplicated(mT$norm)) || any(duplicated(mD$norm))) {
- if (verbose) message("Duplicates after normalization; falling back to exact barcode match.")
- mT$norm <- mT$orig
- mD$norm <- mD$orig
- }
- # intersection and index vectors
- common <- intersect(mT$norm, mD$norm)
- if (!length(common)) stop("No overlapping cells between target and donor after alignment.")
- idxT <- match(common, mT$norm)
- idxD <- match(common, mD$norm)
- # donor metadata (optionally subset columns)
- donor_meta <- [email hidden]
- if (!is.null(cols)) {
- missing_cols <- setdiff(cols, colnames(donor_meta))
- if (length(missing_cols)) warning("Skipping missing donor columns: ", paste(missing_cols, collapse = ", "))
- cols <- intersect(cols, colnames(donor_meta))
- donor_meta <- donor_meta[, cols, drop = FALSE]
- }
- # align rows to target’s order; fill NA where target has non-overlapping cells
- aligned <- donor_meta[mD$orig[idxD], , drop = FALSE]
- rownames(aligned) <- mT$orig[idxT]
- out <- matrix(NA,
- nrow = ncol(target), ncol = ncol(aligned),
- dimnames = list(colnames(target), colnames(aligned))
- )
- out[rownames(aligned), ] <- as.matrix(aligned)
- out <- as.data.frame(out, check.names = FALSE)
- # handle name collisions
- collide <- intersect(colnames([email hidden]), colnames(out))
- if (length(collide)) colnames(out)[match(collide, colnames(out))] <- paste0(collide, suffix)
- # add to target meta (by barcode rownames)
- target <- Seurat::AddMetaData(target, out)
- if (verbose) {
- message("Merged ", ncol(out), " column(s) onto target for ", length(common), " overlapping cells.")
- }
- return(target)
- }
- # ===========================
- # 2) Baseline: Seurat thresholds (species-agnostic via features list)
- # ===========================
- baseline_seurat <- function(seu, min_genes = 200, max_genes = 10000, max_mito = 10, mito_patterns = NULL) {
- mito_features <- .get_mito_features(seu, mito_patterns)
- if (length(mito_features)) {
- seu[["percent.mt"]] <- Seurat::PercentageFeatureSet(seu, features = mito_features)
- } else {
- warning("No mitochondrial features matched; setting percent.mt to NA.")
- seu[["percent.mt"]] <- NA_real_
- }
- keep <- with(
- [email hidden],
- nFeature_RNA > min_genes & nFeature_RNA < max_genes &
- (is.na(percent.mt) | percent.mt < max_mito)
- )
- add_meta(seu, data.frame(keep_seurat = keep, row.names = colnames(seu)))
- }
- # ===========================
- # 3) Baseline: scater/scuttle outlier rules (species-agnostic)
- # ===========================
- baseline_scater <- function(seu, mito_patterns = NULL) {
- sce <- as.SingleCellExperiment(seu)
- is_mito <- .get_mito_index_sce(sce, mito_patterns)
- sce <- scuttle::addPerCellQCMetrics(sce, subsets = list(mito = is_mito))
- low_lib <- scuttle::isOutlier(SummarizedExperiment::colData(sce)$sum, nmads = 3, type = "lower", log = TRUE)
- low_feat <- scuttle::isOutlier(SummarizedExperiment::colData(sce)$detected, nmads = 3, type = "lower", log = TRUE)
- high_mito <- scuttle::isOutlier(SummarizedExperiment::colData(sce)$subsets_mito_percent, nmads = 3, type = "higher")
- keep <- !(low_lib | low_feat | high_mito)
- add_meta(seu, data.frame(
- keep_scater = keep,
- subsets_mito_percent = SummarizedExperiment::colData(sce)$subsets_mito_percent,
- row.names = colnames(seu)
- ))
- }
- # ===========================
- # 4) Baseline: miQC (robust + species-agnostic; defaults unchanged)
- # ===========================
- baseline_miQC <- function(seu, mito_patterns = NULL, debug = TRUE) {
- stopifnot(inherits(seu, "Seurat"))
- sce <- as.SingleCellExperiment(seu)
- # ensure counts exist
- if (is.null(SummarizedExperiment::assay(sce, "counts"))) {
- SummarizedExperiment::assay(sce, "counts") <- Seurat::GetAssayData(seu, layer = "counts")
- }
- # Prepare required metrics (detected & subsets_mito_percent) in a species-agnostic way
- is_mito <- .get_mito_index_sce(sce, mito_patterns)
- sce <- scater::addPerCellQC(sce, subsets = list(mito = rownames(sce)[is_mito])) # adds 'detected' & 'subsets_mito_percent'
- det <- as.numeric(SummarizedExperiment::colData(sce)$detected)
- mito_pct <- as.numeric(SummarizedExperiment::colData(sce)$subsets_mito_percent) # 0–100
- # Guard against non-finite/degenerate inputs to flexmix
- bad <- !is.finite(det) | !is.finite(mito_pct)
- if (any(bad)) {
- if (isTRUE(debug)) message(sprintf("[miQC] dropping %d cells with non-finite QC metrics before fit", sum(bad)))
- sce <- sce[, !bad, drop = FALSE]
- }
- mito_now <- as.numeric(SummarizedExperiment::colData(sce)$subsets_mito_percent)
- if (length(unique(mito_now)) <= 1L) {
- # Avoid zero-variance crashes; if still degenerate, skip miQC gracefully
- if (isTRUE(debug)) message("[miQC] degenerate mitochondrial metric; skipping model and keeping all cells.")
- seu$miQC_prob <- NA_real_
- seu$keep_miQC <- TRUE
- return(seu)
- }
- # Fit miQC (linear → spline → 1D)
- mmod <- try(miQC::mixtureModel(sce, model_type = "linear"), silent = TRUE)
- if (inherits(mmod, "try-error")) {
- mmod <- try(miQC::mixtureModel(sce, model_type = "spline"), silent = TRUE)
- }
- if (inherits(mmod, "try-error")) {
- mmod <- try(miQC::mixtureModel(sce, model_type = "one_dimensional"), silent = TRUE)
- }
- if (inherits(mmod, "try-error")) {
- warning("miQC::mixtureModel failed after all model types; keeping all cells.")
- seu$miQC_prob <- NA_real_
- seu$keep_miQC <- TRUE
- return(seu)
- }
- # Posterior & choose “compromised” component (higher mito at median detected)
- post_mat <- flexmix::posterior(mmod)
- coef_mat <- flexmix::parameters(mmod)
- det_med <- stats::median(SummarizedExperiment::colData(sce)$detected, na.rm = TRUE)
- pick_comp <- function(coefs, det_med) {
- if (is.null(dim(coefs))) {
- return(2L)
- } # one_dimensional
- if (all(c("(Intercept)", "detected") %in% rownames(coefs))) {
- pred <- coefs["(Intercept)", ] + det_med * coefs["detected", ]
- return(which.max(pred)) # higher predicted mito% = compromised
- } else {
- return(2L)
- }
- }
- comp_k <- pick_comp(coef_mat, det_med)
- post_comp <- post_mat[, comp_k, drop = TRUE]
- names(post_comp) <- if (!is.null(rownames(post_mat))) rownames(post_mat) else colnames(sce)
- # Align back to Seurat barcodes
- seu$miQC_prob <- post_comp[match(colnames(seu), names(post_comp))]
- # Keep criterion: keep cells with posterior < 0.75 (miQC default)
- seu$keep_miQC <- seu$miQC_prob < 0.75
- if (isTRUE(debug)) {
- dir.create("qc_outputs", showWarnings = FALSE, recursive = TRUE)
- df <- data.frame(
- barcode = colnames(sce),
- detected = SummarizedExperiment::colData(sce)$detected,
- subsets_mito_percent = SummarizedExperiment::colData(sce)$subsets_mito_percent,
- miQC_prob = seu$miQC_prob[match(colnames(sce), colnames(seu))],
- keep_miQC = seu$keep_miQC[match(colnames(sce), colnames(seu))],
- stringsAsFactors = FALSE
- )
- utils::write.csv(df, file = "qc_outputs/miqc_input_metrics.csv", row.names = FALSE)
- }
- return(seu)
- }
- # ===========================
- # 7) Baseline: DropletQC damaged-only (requires nuclear_fraction + umi)
- # ===========================
- baseline_dropletqc <- function(seu, seurat_sp) {
- ## 1) Grab counts for spliced/unspliced and compute per-cell totals
- spliced <- GetAssayData(seurat_sp, assay = "spliced", layer = "counts")
- unspliced <- GetAssayData(seurat_sp, assay = "unspliced", layer = "counts")
- # Sanity: same cells in same order
- stopifnot(identical(colnames(spliced), colnames(unspliced)))
- exon_sum <- Matrix::colSums(spliced) # exonic counts
- intron_sum <- Matrix::colSums(unspliced) # intronic counts
- # DropletQC nuclear fraction = intronic / (intronic + exonic)
- nf <- intron_sum / (intron_sum + exon_sum + 1e-12)
- umi <- intron_sum + exon_sum # UMI for nf/umi plane (do NOT include ambiguous here)
- ## 2) Add to Seurat metadata
- seurat_sp$nuclear_fraction <- as.numeric(nf[colnames(seurat_sp)])
- seurat_sp$umi_nf_plane <- as.numeric(umi[colnames(seurat_sp)])
- # 1) Build the data frame for identify_empty_drops
- nf_umi <- data.frame(
- nf = as.numeric(seurat_sp$nuclear_fraction),
- umi = as.numeric(seurat_sp$umi_nf_plane),
- row.names = colnames(seurat_sp)
- )
- # Optional: drop any rows with NA (NF/UMI)
- nf_umi <- nf_umi[complete.cases(nf_umi[, 1:2]), ]
- # 2) Run identify_empty_drops
- ed <- identify_empty_drops(nf_umi = nf_umi, include_plot = FALSE)
- # 3) Add cell_type for identify_damaged_cells using the standard object's clusters
- # Use .normalize_cells internally if names dont perfectly match, but here they should due to subset alignment
- ed$cell_type <- seu$seurat_clusters[match(.normalize_cells(rownames(ed)), .normalize_cells(colnames(seu)))]
- # Drop any cell types that mapped to NA before pushing into identify_damaged_cells, else EM will crash
- ed <- ed[!is.na(ed$cell_type), ]
- # 4) Run DropletQC’s damaged-cell classifier
- dc <- identify_damaged_cells(
- ed, # min NF separation between intact vs damaged (tune if needed)
- verbose = TRUE,
- output_plots = T
- )
- dc$plots
- table(dc[[1]]$cell_status)
- # 5) Save calls back to Seurat metadata
- calls <- dc[[1]] # first list element = annotated table
- seurat_sp$DropletQC_status <- calls$cell_status[match(colnames(seurat_sp), rownames(calls))]
- seurat_sp$DropletQC_status[is.na(seurat_sp$DropletQC_status)] <- "unknown_NA"
- # labels can be "cell", "empty_droplet", or "damaged_cell"
- kept_dq <- seurat_sp$DropletQC_status == "cell"
- kept_dq[is.na(kept_dq)] <- FALSE
- seurat_sp$keep_dropletqc <- kept_dq
- want <- c("nuclear_fraction", "umi_nf_plane", "DropletQC_status", "keep_dropletqc")
- seu_merged_meta <- merge_meta_only(seu, seurat_sp, cols = want, suffix = "")
- return(seu_merged_meta)
- }
- ## qc plot -----------------------------------------------------------------
- seurat_std_small <- baseline_seurat(seurat_std_small)
- table(seurat_std_small$keep_seurat)
- p <- DimPlot(seurat_std_small, group.by = "keep_seurat", cols = c("red", "gray"), pt.size = 0.5, alpha = 0.5) +
- ggtitle("Seurat") +
- NoLegend()
- ggsave("keep_seurat.png", p, width = 4, height = 4)
- seurat_std_small <- baseline_scater(seurat_std_small)
- table(seurat_std_small$keep_scater)
- p <- DimPlot(seurat_std_small, group.by = "keep_scater", cols = c("red", "gray"), pt.size = 0.5, alpha = 0.5) +
- ggtitle("scater") +
- NoLegend()
- ggsave("keep_scater.png", p, width = 4, height = 4)
- seurat_std_small <- baseline_miQC(seurat_std_small)
- if (table(seurat_std_small$keep_miQC)[1] > table(seurat_std_small$keep_miQC)[2]) {
- seurat_std_small$keep_miQC <- !seurat_std_small$keep_miQC
- }
- table(seurat_std_small$keep_miQC)
- p <- DimPlot(seurat_std_small, group.by = "keep_miQC", cols = c("red", "gray"), pt.size = 0.5, alpha = 0.5) +
- ggtitle("miQC") +
- NoLegend()
- p
- ggsave("keep_miqc.png", p, width = 4, height = 4)
- table(seurat_std_small$keep_miQC)
- seurat_std_small <- baseline_dropletqc(seurat_std_small, seurat_sp_small)
- table(seurat_std_small$keep_dropletqc)
- p <- DimPlot(seurat_std_small, group.by = "keep_dropletqc", cols = c("red", "gray"), pt.size = 0.5, alpha = 0.5) +
- ggtitle("DropletQC") +
- NoLegend()
- p
- ggsave("keep_dq.png", p, width = 4, height = 4)
- # run scqc ----------------------------------------------------------------
- library(scQCenrich)
- res <- run_qc_pipeline(
- obj = seurat_std_small, # normal Seurat for baseline QC
- species = organism,
- assay = "RNA",
- method = "gmm",
- # external splicing sources:
- spliced_obj = seurat_sp_small,
- spliced_assay = "spliced",
- spliced_layer = "counts",
- unspliced_obj = seurat_sp_small,
- unspliced_assay = "unspliced",
- unspliced_layer = "counts",
- report_html = T,
- report_file = "qc_outputs/qc_report.html",
- debug = TRUE,
- annot_method = "marker_score",
- tissue = organ,
- marker_method = "findmarkers",
- doublets = "none",
- enrichment_plots = T
- # qc_strength = "strict"
- )
- if (!is.null(res$report)) browseURL(res$report)
- seu <- res$obj_all
- seu$keep_enrich <- seu$qc_status != "remove"
- seurat_std_small$keep_enrich <- seu$keep_enrich[match(colnames(seurat_std_small), colnames(seu))]
- p <- DimPlot(seu, group.by = "keep_enrich", cols = c("red", "gray"), pt.size = 0.5, alpha = 0.5) +
- ggtitle("scQCenrich") +
- NoLegend()
- p
- ggsave("keep_enrich.png", p, width = 4, height = 4)
- # ---- scQCenrich WITHOUT splice data -------------------------
- cat("\n--- Running scQCenrich without splice data (MALAT1 proxy) ---\n")
- met_nosplice <- calcQCmetrics(
- obj = seurat_std_small,
- species = organism,
- assay = "RNA",
- add_to_meta = FALSE
- # spliced_obj intentionally omitted -> MALAT1 proxy activates
- )
- cat(
- "intronic_frac all-NA (confirming no splice used):",
- all(is.na(met_nosplice$intronic_frac)), "\n"
- )
- cat("MALAT1_frac range:", round(range(met_nosplice$MALAT1_frac, na.rm = TRUE), 4), "\n")
- res_nosplice <- flagLowQuality(
- metrics = met_nosplice,
- method = "gmm",
- qc_strength = "auto",
- rescue_mode = "lenient"
- )
- # Align barcodes back to seurat_std_small (metrics rownames == colnames(seu))
- seurat_std_small$keep_enrich_nosplice <- res_nosplice$qc_status[
- match(colnames(seurat_std_small), rownames(res_nosplice))
- ] != "remove"
- cat("kept (no splice):", sum(seurat_std_small$keep_enrich_nosplice, na.rm = TRUE), "\n")
- cat("removed (no splice):", sum(!seurat_std_small$keep_enrich_nosplice, na.rm = TRUE), "\n")
- p_nosplice <- DimPlot(
- seurat_std_small,
- group.by = "keep_enrich_nosplice",
- cols = c("red", "gray"), pt.size = 0.5, alpha = 0.5
- ) +
- ggtitle("scQCenrich (no splice)") +
- NoLegend()
- p_nosplice
- ggsave("keep_enrich_nosplice.png", p_nosplice, width = 4, height = 4)
benchmarking.R at commit fa00b9c, under other · at the source
Overview
- The Seventh Medical Center of Chinese PLA General Hospital, Beijing, China
- PLA Medical School, Beijing, China
- Reahealth Inc, Beijing, China
- Bioinformatics Center of AMMS, Beijing, China
- Department of Dermatology, Southwest Hospital, Army Medical University, Chongqing, China
- Biological Therapy Center, Seventh Medical Center of Chinese PLA General Hospital, Beijing, China
Abstract
The abstract is not reproduced here: the paper's license (CC BY-NC-ND) does not allow it. Read it in the paper, at the publisher or on Europe PMC.
Repositories
Its files are read in the Code ↔ Paper reader above, with 13 matches between paragraphs and lines of code.
lemonlyy755/scQCenrich
fa00b9c0126bdaa5ba36a6b90a28c734d5397a6b, 7 May 2026Availability: 1 check, the latest on 27 September 2026: the link answers
- 27 September 2026: the link answers
31 files
- R/
apply_filter.R , R, 42 lines - R/
auto_annotate.R , R, 1,610 lines - R/
diagnostics.R , R, 40 lines - R/
enrichment.R , R, 126 lines, 1 match - R/
filter.R , R, 481 lines, 2 matches - R/
metrics.R , R, 545 lines - R/
outliers.R , R, 457 lines, 2 matches - R/
panglao_signatures.R , R, 177 lines - R/
plots.R , R, 312 lines, 1 match - R/
report.R , R, 92 lines - R/
rescue.R , R, 198 lines, 1 match - R/
scQCenrich-package.R , R, 13 lines - R/
signatures_generic.R , R, 48 lines - R/
tuner.R , R, 89 lines - R/
utils.R , R, 592 lines - R/
validation_plots.R , R, 1,169 lines - R/
wrapper.R , R, 685 lines, 1 match - R/
zzz-globals.R , R, 33 lines - README.Rmd, R, 202 lines
- data-raw/
toy_seu.R , R, 52 lines - inst/
benchmarking.R , R, 538 lines, 3 matches - inst/
templates/ , R, 530 linesqc_report.Rmd - scripts/
build_figure6_report_sou , R, 784 lines, 2 matchesrces.R - tests/
testthat.R , R, 4 lines - tests/
testthat/ , R, 31 lineshelper-data.R - tests/
testthat/ , R, 26 linestest-run_qc_pipeline.R - tests/
testthat/ , R, 21 linestest-toy_seu.R - vignettes/
QC_with_scQCenrich.Rmd , R, 64 lines - LICENSE, License, 2 lines
- LICENSE.md, License, 21 lines
- README.md, Text, 215 lines
Zenodo 20050798
Availability: 1 check, the latest on 27 September 2026: the link answers (HTTP 200)
- 27 September 2026: the link answers (HTTP 200)
31 files
- R/
apply_filter.R , R, 42 lines - R/
auto_annotate.R , R, 1,610 lines - R/
diagnostics.R , R, 40 lines - R/
enrichment.R , R, 126 lines - R/
filter.R , R, 481 lines - R/
metrics.R , R, 545 lines - R/
outliers.R , R, 457 lines - R/
panglao_signatures.R , R, 177 lines - R/
plots.R , R, 312 lines - R/
report.R , R, 92 lines - R/
rescue.R , R, 198 lines - R/
scQCenrich-package.R , R, 13 lines - R/
signatures_generic.R , R, 48 lines - R/
tuner.R , R, 89 lines - R/
utils.R , R, 592 lines - R/
validation_plots.R , R, 1,169 lines - R/
wrapper.R , R, 685 lines - R/
zzz-globals.R , R, 33 lines - README.Rmd, R, 202 lines
- data-raw/
toy_seu.R , R, 52 lines - inst/
benchmarking.R , R, 538 lines - inst/
templates/ , R, 530 linesqc_report.Rmd - scripts/
build_figure6_report_sou , R, 784 linesrces.R - tests/
testthat.R , R, 4 lines - tests/
testthat/ , R, 31 lineshelper-data.R - tests/
testthat/ , R, 26 linestest-run_qc_pipeline.R - tests/
testthat/ , R, 21 linestest-toy_seu.R - vignettes/
QC_with_scQCenrich.Rmd , R, 64 lines - LICENSE, License, 2 lines
- LICENSE.md, License, 21 lines
- README.md, Text, 215 lines
Code availability statement
The paper has a code availability statement. Its license (CC BY-NC-ND) does not allow reproducing it here; in short, from what the harvester recognized in it:
- it points to the authors' code: lemonlyy755/
scQCenrich - it says that the code is available on request
Read it in the paper: doi.org/10.1038/s42003-026-10382-x.
Tracing map
Proposed by the machine: these links were found in the paper and verified at the source, without human review. The map will receive a Zenodo DOI once one of the paper's authors has validated it with their ORCID.
What the map holds:
- 2 repositories of the authors' code, each at its verified commit, with its license and how the link was found in the paper;
- 56 scripts, each with its path and the digest of its content;
- 13 matches between paragraphs of the paper and lines of the code (method lexical-v1);
- neither the text of the paper nor the code itself.
Its JSON (tracing-map.json) is deposited on Zenodo with its DOI once the map is validated.
Data
Datasets cited
- geo:GSE131907, at NCBI GEO; found in “Data availability”
Data availability statement
The paper has a data availability statement. Its license (CC BY-NC-ND) does not allow reproducing it here; in short, from what the harvester recognized in it:
- it points to a dataset: NCBI GEO GSE131907
- it says that the data are available on request
Read it in the paper: doi.org/10.1038/s42003-026-10382-x.
Versions
The history of this record: each version stored by the harvester or made by a correction of its authors or of the maintainers of its code, and what changed in its facts. The texts of the paper (its abstract, its availability statements) are not part of it; versions that changed only those are not listed.
Version 1, 27 September 2026: the first record
Recorded: type, language, journal, volume, issue, pages, dates, 7 authors, 2 keywords, 7 MeSH terms, 22 references.
Cite
This paper
Liu, Y., Yang, C., Wang, C., Zhang, M., Luo, K., Wu, L., & Xie, X. (2026). ScQCenrich enables multi-metric quality control for single-cell RNA sequencing. Communications biology, 9(1), 864. https://
BibTeX
@article{liu2026scqcenri
author = {Liu, Yuanyuan and Yang, Cheng and Wang, Chenghui and Zhang, Mingwang and Luo, Kai and Wu, Lihua and Xie, Xiufeng},
title = {{ScQCenrich enables multi-metric quality control for single-cell RNA sequencing}},
journal = {Communications biology},
year = {2026},
month = jun,
volume = {9},
number = {1},
pages = {864},
publisher = {Nature Portfolio},
issn = {2399-3642},
doi = {10.1038/
url = {https://
pmid = {42342867},
pmcid = {PMC13315592}
}
RIS
TY - JOUR
AU - Liu, Yuanyuan
AU - Yang, Cheng
AU - Wang, Chenghui
AU - Zhang, Mingwang
AU - Luo, Kai
AU - Wu, Lihua
AU - Xie, Xiufeng
TI - ScQCenrich enables multi-metric quality control for single-cell RNA sequencing
T2 - Communications biology
J2 - Commun Biol
PY - 2026
DA - 2026/
VL - 9
IS - 1
SP - 864
SN - 2399-3642
PB - Nature Portfolio
DO - 10.1038/
UR - https://
LA - en
ER -
CSL-JSON
{
"id": "10.1038/
"type": "article-journal",
"title": "ScQCenrich enables multi-metric quality control for single-cell RNA sequencing",
"container-title": "Communications biology",
"author": [
{
"family": "Liu",
"given": "Yuanyuan"
},
{
"family": "Yang",
"given": "Cheng"
},
{
"family": "Wang",
"given": "Chenghui"
},
{
"family": "Zhang",
"given": "Mingwang"
},
{
"family": "Luo",
"given": "Kai"
},
{
"family": "Wu",
"given": "Lihua"
},
{
"family": "Xie",
"given": "Xiufeng"
}
],
"container-title-short":
"volume": "9",
"issue": "1",
"page": "864",
"DOI": "10.1038/
"PMID": "42342867",
"PMCID": "PMC13315592",
"ISSN": "2399-3642",
"publisher": "Nature Portfolio",
"URL": "https://
"language": "en",
"issued": {
"date-parts": [
[
2026,
6,
24
]
]
}
}
The tracing map gets a citation of its own once an author has validated it and it has a DOI.
Similar papers
The papers with a page that share the most with this one: the tools found in their code, their categories, datasets, cited references and authors, the rarest counting most.
- [1] doi:10.1016/j.crmeth.2026.101337 [code]
- Comparative analysis of nuclei isolation methods for brain single-nucleus RNA sequencing.Journal: Cell reports methodsIn common: circlize, ComplexHeatmap, Seurat, 3 other tools, genetics / omics, mouse, cellular / molecular, 7 references
- [2] doi:10.1084/jem.20232357 [code]
- Microglia and CD8+ T cell activation precede neuronal loss in a murine model of spastic paraplegia 15.Journal: The Journal of experimental medicineIn common: SingleCellExperiment, circlize, clusterProfiler, 6 other tools, mouse, cellular / molecular, 5 references
- [3] doi:10.1038/s41467-024-45165-7 [code]
- Single nuclei transcriptomics in human and non-human primate striatum in opioid use disorder.Journal: Nature communicationsIn common: SingleCellExperiment, circlize, ComplexHeatmap, 5 other tools, genetics / omics, cellular / molecular, 3 references
- [4] doi:10.1186/s40478-023-01568-z [code]
- Brain matters: unveiling the distinct contributions of region, age, and sex to glia diversity and CNS function.Journal: Acta neuropathologica communicationsIn common: SingleCellExperiment, clusterProfiler, Seurat, 5 other tools, mouse, cellular / molecular, 4 references
- [5] doi:10.1186/s12964-024-01686-8 [code]
- Altered glia-neuron communication in Alzheimer's Disease affects WNT, p53, and NFkB Signaling determined by snRNA-seq.Journal: Cell communication and signaling : CCSIn common: SingleCellExperiment, circlize, ComplexHeatmap, 5 other tools, genetics / omics, cellular / molecular, 3 references
- [6] doi:10.1016/j.xops.2023.100335 [code]
- Comparative Analysis of Single-cell and Single-nucleus RNA-sequencing in a Rabbit Model of Retinal Detachment-related Proliferative Vitreoretinopathy.Journal: Ophthalmology scienceIn common: SingleCellExperiment, circlize, clusterProfiler, 5 other tools, genetics / omics, cellular / molecular, 3 references
- [7] doi:10.1007/s00401-025-02913-3 [code]
- Single-cell transcriptomic landscape of the neuroimmune compartment in amyotrophic lateral sclerosis brain and spinal cord.Journal: Acta neuropathologicaIn common: circlize, clusterProfiler, ComplexHeatmap, 5 other tools, genetics / omics, cellular / molecular, 3 references
- [8] doi:10.1038/s41467-026-76232-w [code]
- Th17 effector cytokines induce shared and distinct microglial and endothelial cell responses in a mouse model for post-streptococcal encephalitis.Journal: Nature communicationsIn common: SingleCellExperiment, circlize, clusterProfiler, 6 other tools, genetics / omics, mouse, cellular / molecular, 1 reference
- [9] doi:10.15252/embr.202256233 [code]
- DOT1L activity affects neural stem cell division mode and reduces differentiation and ASNS expression.Journal: EMBO reportsIn common: SingleCellExperiment, circlize, clusterProfiler, 6 other tools, 2 references
- [10] doi:10.1016/j.jcmgh.2025.101590 [code]
- Single Cell Profiling in the Sox10&
lt;sup& gt;Dom& lt;/ sup& gt; Hirschsprung Mouse Implicates Hox Genes in Enteric Neuron Trajectory Allocation. Journal: Cellular and molecular gastroenterology and hepatologyIn common: clusterProfiler, ComplexHeatmap, Seurat, 5 other tools, genetics / omics, mouse, cellular / molecular, 3 references
Contribute
The authors of this paper can claim it, correct its record and validate its tracing map, and the maintainers of its code (its owner, or a public member of its organization) correct what it says of their repository; anyone signed in can ask for its removal. Every request goes to OSCR's own machine, which answers it; your account page follows them.
Sign in with ORCID to claim this paper as one of its authors, correct its record or validate its tracing map: when the paper's metadata lists your ORCID iD, you are recognized at once. Maintainers of its code: sign in with GitHub, then claim the repository on your account page.
Claim this paper
Correct its record
Say what each link of this record is, remove the ones that are not the paper's, add the ones that are missing. The correction becomes a new version of the record, in its Versions section.
Validate its tracing map
You validate the map as this page shows it: 2 repositories of the authors' code, each at its verified commit and with its license, 56 scripts, and 13 matches between paragraphs and code (see the Code and Map sections). It then receives a DOI on Zenodo, with you (your ORCID iD) and OSCR as its creators; the code itself is not deposited.
The map's fingerprint: sha256:96cce77565d4aeb6…
Add the badge to the code's README
If you are an author or a maintainer of this paper's code, you can add this badge. It says what OSCR knows of the paper (its code, its validated tracing map) and links the code to this page. Paste one of these snippets under the README's title. Keep the two marks around it, so that the badge can be replaced in place and is never added twice. OSCR changes nothing in your repository.
Markdown
<!-- oscr-badge:start -->
[](https://openscicode.org/badge/doi/10.1038/s42003-026-10382-x)
<!-- oscr-badge:end -->reStructuredText
.. oscr-badge:start
.. image:: https://openscicode.org/badge/doi/10.1038/s42003-026-10382-x.svg
:target: https://openscicode.org/badge/doi/10.1038/s42003-026-10382-x
:alt: OSCR
.. oscr-badge:endHTML
<!-- oscr-badge:start -->
<a href="https://openscicode.org/badge/doi/10.1038/s42003-026-10382-x"><img src="https://openscicode.org/badge/doi/10.1038/s42003-026-10382-x.svg" alt="OSCR"></a>
<!-- oscr-badge:end -->On GitHub, open the README, choose Edit (the pencil), paste the snippet under the title, then "Commit changes".
If you choose to, you can have the badge kept up to date for you, with oscr badge --write from the command line or with the GitHub Action in your repository's workflows. Every other form and option (a card, AsciiDoc, LaTeX, shields.io) is on the badge page.
Request its removal
To ask OSCR to remove this record, the copies of its authors' scripts or its tracing map, use the removal request page: signed in, you say who you are, what to remove and why, then review and confirm the request. Published rules decide every request (how).
Discussion, reproductions, activity
Discussion: code errors and mismatches between the code and the paper about this paper and its code, from readers and its authors, beside the paper and its tracing map.
Report a mismatch between the code and the paper · Report a code error (signed in)
Reproductions: reports from readers who ran the authors' code and did not get the paper's result, what they ran, with which environment, commit and data.
Report a reproduction failure (signed in)
Versions of its code: the releases of its code tied to a version of this paper (the preprint, the accepted manuscript, the version of record…), each with the tracing map versioned with it.
Activity: what happens around this paper: new versions of its record, its map's validation, discussions and reproductions. It opens with sign-in.
