Package: scClustEval 1.0.0

scClustEval: Single Cell Clustering Evaluation and Optimization Framework

A comprehensive framework for evaluating and optimizing single-cell RNA-seq clustering results using self-projection machine learning approaches. The package implements an iterative optimization strategy that merges poorly discriminated clusters based on confusion matrix analysis, achieving robust and reliable cell type identification. Features include multiple classifier support (logistic regression, random forest, SVM, etc.), ROC curve analysis, confusion matrix visualization, and seamless integration with Seurat objects. This is an R implementation inspired by the SCCAF Python package.

Authors:Zaoqu Liu [aut, cre], Chichau Miao [ctb]

scClustEval_1.0.0.tar.gz
scClustEval_1.0.0.zip(r-4.7)scClustEval_1.0.0.zip(r-4.6)scClustEval_1.0.0.zip(r-4.5)
scClustEval_1.0.0.tgz(r-4.6-x86_64)scClustEval_1.0.0.tgz(r-4.6-arm64)scClustEval_1.0.0.tgz(r-4.5-x86_64)scClustEval_1.0.0.tgz(r-4.5-arm64)
scClustEval_1.0.0.tar.gz(r-4.7-arm64)scClustEval_1.0.0.tar.gz(r-4.7-x86_64)scClustEval_1.0.0.tar.gz(r-4.6-arm64)scClustEval_1.0.0.tar.gz(r-4.6-x86_64)
scClustEval_1.0.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html
card.svg |card.png
scClustEval/json (API)
NEWS

# Install 'scClustEval' in R:
install.packages('scClustEval', repos = c('https://zaoqu-liu.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/zaoqu-liu/scclusteval/issues

Uses libs:
  • openblas– Optimized BLAS
  • c++– GNU Standard C++ Library v3
  • openmp– GCC OpenMP (GOMP) support library

On CRAN:

Conda:

openblascppopenmp

4.81 score 129 scripts 40 exports 77 dependencies

Last updated from:dabff729e1 (on main). Checks:8 NOTE, 2 OK, 3 FAIL. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-arm64NOTE223
linux-devel-x86_64NOTE260
source / vignettesOK273
linux-release-arm64NOTE237
linux-release-x86_64NOTE244
macos-release-arm64NOTE147
macos-release-x86_64NOTE505
macos-oldrel-arm64FAIL86
macos-oldrel-x86_64FAIL134
windows-develNOTE191
windows-releaseNOTE227
windows-oldrelFAIL92
wasm-releaseOK189

Exports:.get_color_paletteAddClusterReliabilitybhattacharyya_distancebhattacharyya_matrixcalc_confusion_matrixcluster_adjacency_matrixcreate_classifierget_available_classifiersget_connection_matrixget_distance_matrixget_top_markersGetExpressionMatrixmake_unique_namesmerge_clustersnormalize_confmat_r1normalize_confmat_r2normalize_confusion_matrixper_cell_accuracyper_cluster_accuracyplot_assessment_summaryplot_cluster_centersplot_cluster_linksplot_cluster_sankeyplot_confusion_heatmapplot_embedding_with_linksplot_optimization_historyplot_rocPlotConfusionLinksQuickAssessRunAssessmentRunOptimizationsc_assessmentsc_optimizesc_optimize_allSCCAF_assessmentSCCAF_optimizeSCCAF_optimize_allself_projectiontrain_test_splittrain_test_split_stratified

Dependencies:caretclasscliclockcodetoolscpp11data.tablediagramdigestdplyre1071farverforeachfuturefuture.applygenericsggplot2glmnetglobalsgluegowergtablehardhatigraphipredisobanditeratorsKernSmoothlabelinglatticelavalifecyclelistenvlubridatemagrittrMASSMatrixModelMetricsnlmennetnumDerivparallellypillarpkgconfigplyrpROCprodlimprogressrproxypurrrR6RColorBrewerRcppRcppArmadilloRcppEigenrecipesreshape2rlangrpartS7scalesshapesparsevctrsSQUAREMstringistringrsurvivaltibbletidyrtidyselecttimechangetimeDatetzdbutf8vctrsviridisLitewithr

Algorithm Principles and Mathematical Foundation

Rendered fromalgorithm.Rmdusingknitr::rmarkdownon May 26 2026.

Last update: 2026-01-26
Started: 2026-01-26

Introduction to scClustEval

Rendered fromintroduction.Rmdusingknitr::rmarkdownon May 26 2026.

Last update: 2026-01-25
Started: 2026-01-25

Quick Start Guide

Rendered fromquick-start.Rmdusingknitr::rmarkdownon May 26 2026.

Last update: 2026-01-26
Started: 2026-01-26

Seurat Integration

Rendered fromseurat-integration.Rmdusingknitr::rmarkdownon May 26 2026.

Last update: 2026-01-26
Started: 2026-01-26

Visualization Guide

Rendered fromvisualization.Rmdusingknitr::rmarkdownon May 26 2026.

Last update: 2026-01-26
Started: 2026-01-26

Readme and manuals

Help Manual

Help pageTopics
scClustEval: Single Cell Clustering Evaluation and Optimization FrameworkscClustEval-package scClustEval
Add cluster reliability scores to Seurat objectAddClusterReliability
Assessment Functions for scClustEvalassessment
Bhattacharyya distancebhattacharyya_distance
Bhattacharyya distance matrixbhattacharyya_matrix
Calculate confusion matrixcalc_confusion_matrix
Classifier Functions for scClustEvalclassifiers
Cluster adjacency matrixcluster_adjacency_matrix
Clustering Functions for scClustEvalclustering
Confusion Matrix Functions for scClustEvalconfusion_matrix
Create a classifiercreate_classifier
Get available classifiersget_available_classifiers
Get connection matrix between clusteringsget_connection_matrix
Get distance matrix between clustersget_distance_matrix
Get top markers from classifierget_top_markers
Extract feature matrix from Seurat (exported helper)GetExpressionMatrix
Make unique namesmake_unique_names
Merge clustersmerge_clusters
Normalize confusion matrix (R1 norm)normalize_confmat_r1
Normalize confusion matrix (R2 norm)normalize_confmat_r2
Normalize confusion matrixnormalize_confusion_matrix
Optimization Functions for scClustEvaloptimization
Compute per-cell accuracyper_cell_accuracy
Compute per-cluster accuracyper_cluster_accuracy
Plot assessment summaryplot_assessment_summary
Plot cluster centroids on embeddingplot_cluster_centers
Plot cluster connections on embeddingplot_cluster_links
Plot Sankey diagram of cluster changesplot_cluster_sankey
Plot confusion matrix heatmapplot_confusion_heatmap
Plot embedding with cluster linksplot_embedding_with_links
Plot optimization historyplot_optimization_history
Plot ROC curvesplot_roc
Plot method for scClustEval objectsplot.scClustEval
Plot Seurat embedding with cluster confusion linksPlotConfusionLinks
Print method for scClustEvalprint.scClustEval
Print method for classifierprint.scClustEval_classifier
Print method for optimization resultprint.scClustEval_optim
Quick assessment from Seurat objectQuickAssess
Run clustering assessment on Seurat objectRunAssessment
Run clustering optimization on Seurat objectRunOptimization
Single Cell Clustering Assessmentsc_assessment
Single round of clustering optimizationsc_optimize
Full iterative optimization pipelinesc_optimize_all
SCCAF AssessmentSCCAF_assessment
SCCAF OptimizeSCCAF_optimize
SCCAF Optimize AllSCCAF_optimize_all
Self-projection assessmentself_projection
Seurat Integration Functions for scClustEvalseurat_integration
Summary method for scClustEvalsummary.scClustEval
Summary method for optimization resultsummary.scClustEval_optim
Simple train-test splittrain_test_split
Stratified train-test splittrain_test_split_stratified
Utility Functions for scClustEvalutils
Visualization Functions for scClustEvalvisualization
Package Startup Functionszzz