PLoS Computational BiologyImmunologyPeer-reviewed journal article
scRepertoire 2: Enhanced and Efficient Toolkit for Single-Cell Immune Profiling
Qile YangiD, Ksenia R. SafinaiD, Kieu Diem Quynh Nguyen, Zewen Kelvin TuongiD, Nicholas C. BorcherdingiD
Abstract
Single-cell adaptive immune receptor repertoire sequencing (scAIRR-seq) and single-cell RNA sequencing (scRNA-seq) provide a transformative approach to profiling immune responses at unprecedented resolution across diverse pathophysiologic contexts. This work presents scRepertoire 2, a substantial update to our R package for analyzing and visualizing single-cell immune receptor data. This new version introduces an array of features designed to enhance both the depth and breadth of immune receptor analysis, including improved workflows for clonotype tracking, repertoire diversity metrics, and novel visualization modules that facilitate longitudinal and comparative studies. Additionally, scRepertoire 2 offers seamless integration with contemporary single-cell analysis frameworks like Seurat and SingleCellExperiment, allowing users to conduct end-to-end immune profiling with transcriptomic data. Performance optimizations in scRepertoire 2 substantially reduce computational time and memory usage, addressing the demands of the ever-increasing size and scale of single-cell studies. This release marks an advancement in single-cell immunogenomics, equipping researchers with a robust toolset to uncover immune dynamics in health and disease.
- organism: human
- assay: scRNA-seq
- research focus: software / tool
- research focus: cell type annotation
- research focus: clustering
- research focus: dimensionality reduction
- approach: deep learning
- approach: statistical model
In-depth summary
Claude Opus 5.5 · xhigh effort · 8 Nov 2026 · from the full text of version 1 (31 Dec 2024) · CC BY 4.0
R package rebuild for single-cell T/B cell receptor analysis: Rcpp rewrites reportedly make clonal pairing and edit-distance clustering scale linearly; adds auto-detected multi-format import, AIRR-compatible export, CDR3 summaries.
The authors say many existing R and Python tools for single-cell immune receptor data lack robust integration with transcriptomic analyses or flexibility in export formats, while datasets keep growing. scRepertoire 2 rebuilds the earlier package, which already worked with Seurat and SingleCellExperiment, with C++-accelerated internals, wider import/export, new sequence-summary and diversity functions, and links to companion deep-learning packages (Trex, Ibex, immApex).
Key results
ClaimedCore routines were rewritten in C++ via Rcpp. The authors state that receptor-to-cell pairing in combineTCR/combineBCR now scales linearly rather than quadratically with repertoire size, and that BCR clonotype inference and Levenshtein-based clone clustering also run in linear time.
Only complexity statements are given: no runtimes, memory figures or comparisons with version 1 or other tools are reported. Other changes: length-threshold filtering before edit-distance clustering, a similar speed-up for amino acid and nucleotide k-mer counting, and export run before plotting when both are requested. · Performance Optimizations; Abstract
ClaimedloadContigs auto-detects 10x Genomics, AIRR and BD Rhapsody input, plus MiXCR, TRUST4, WAT3R, Omniscope and Parse Bio Evercode outputs. exportClone writes barcode-level clone tables, including AIRR-compatible ones. Clones from other pipelines can be supplied through a cell metadata column.
These are described as package features. No import/export test across formats and no round-trip check is reported. Paired clones attach to Seurat or SingleCellExperiment objects for joint analysis with expression data. · Expanded Data Compatibility; Workflow
SuggestedOn published erythema migrans data (Jiang et al.), plasma cells showed the strongest clonal expansion. Among each patient's top 20 TCR clones, overlap was observed between lesion and adjacent normal skin, but no BCR clones were shared across tissues.
Six patients; two samples were excluded (no scAIRR data or no second tissue). 13 lymphocyte types remained after QC. In 192567SKL one clone exceeded 50% of the plasma cell cluster. CD4+ tissue effector memory, cytotoxic CD8+ T and mucosal-associated invariant T (MAIT) cells were also expanded. Among patient 192566's top 20 TCR clones, those shared by blood and lesion did not appear in normal skin. · Results; Figure legends
ShownDiversity is estimated with Shannon and inverse Simpson indices, bootstrapped to the smallest repertoire in each comparison, with iNEXT-based interpolation and extrapolation for rarefaction and sample completeness. clonalRarefaction estimates clonal richness by rarefaction and can group samples by condition.
Each estimate averages 100 bootstrap runs. It was applied per sequencing run to the erythema migrans data (Figure 2D). Differences in diversity between samples are described only in words, with no values or statistical tests. StartracDiversity was reimplemented without custom data dependencies but is not demonstrated. · Results; Clonal Diversity Analysis; Figure legends
SuggestedThe new CDR3 sequence summaries (positional amino acid usage, Atchley factors, k-mers, V-J pairing) and Levenshtein-based clone clustering were demonstrated. BCR heavy-chain CDR3s in sample 192567 were rich in serine at positions 6 and 11.
At those serine-rich positions, mean Atchley factors showed lower molecular size (AF3) and electrostatic charge (AF5). A TRAV usage heatmap was combined with PCA across sequencing runs. TRA chains were clustered at a normalized Levenshtein threshold of 0.85 and shown on a UMAP and as a Fruchterman-Reingold igraph network. All results are descriptive, without statistical testing. · Results; Enhanced Repertoire Summarization; Figure legends
Methods, data and reproducibility
Rebuild of the scRepertoire R package with C++ (Rcpp) routines for clonal pairing, edit-distance clustering and k-mer counting. It adds import/export, CDR3 summary (positionalProperty, positionalEntropy, percentAA, percentKmer, percentVJ) and diversity (clonalRarefaction, StartracDiversity) functions. Features are illustrated on published single-cell RNA plus TCR/BCR data from erythema migrans skin.
- Published single-cell RNA plus TCR and BCR profiling (Jiang et al.) of erythema migrans skin lesions (SKL) and adjacent normal skin (SKN), with peripheral blood (BL) for one patient (192566) · human (cohort described as patients) · n = 6 patients; 2 samples removed before analysis
- Methods & tools
- scRepertoire 2, Rcpp, Seurat, SingleCellExperiment, iNEXT, igraph, Trex, Ibex, immApex, APackOfTheClones, DandelionR, scPlotter
- Code
- https://github.com/ncborcherding/scRepertoirehttps://github.com/ncborcherding/scRepertoire.v2_manuscripthttps://bioconductor.org/packages/scRepertoire
- Reproducibility gaps
- The speed and memory gains are asserted without timing or memory measurements. The example dataset is cited only as Jiang et al., with no accession or download link. No package or dependency versions are given.
Limitations (3)
- The authors hedge that the lack of BCR clone sharing across tissues may reflect low overall sampling rather than immune compartmentalization, and the supporting data are not shown. · stated by the authors
- The claims of linear scaling and lower runtime and memory use have no timing or memory benchmark behind them, and no comparison with version 1 or other single-cell receptor tools. · noted in this summary
- Capabilities are shown on one small published cohort (six patients, two samples removed), with biological interpretations offered but not tested. Outputs are not compared with other repertoire packages. · noted in this summary
Read this if you analyse paired single-cell TCR/BCR and transcriptome data in R (Seurat or SingleCellExperiment) and want to know what scRepertoire 2 adds for import formats, CDR3 summaries, diversity estimation and clone clustering.
- Citations
- 57
- FWCI
- 15.74
- Field percentile
- top 1%
Reproducibility ledger
Nobody has reported trying to reproduce this paper yet. Did you replicate an experiment or run the code? Your report saves the next lab a week.
Sign in to file a reproducibility report.
Related papers
- Immunopipe: A comprehensive and flexible scRNA-seq and scTCR-seq data analysis pipeline
Panwen Wang, Yue Yu, … Ying Li·NAR Genomics and BioinformaticsPeer-reviewed·Mar 29, 2025
- SiCR: Web application for single-cell repertoire analysis and immune profiling
Masakazu Ishikawa, Kaoru Matsumoto, Daisuke Okuzaki·bioRxiv·Aug 3, 2023
- Scirpy: A Scanpy extension for analyzing single-cell T-cell receptor sequencing data
Gregor Sturm, Tamás Géza Szabó, … Francesca Finotello·BioinformaticsPeer-reviewed·Jun 24, 2020
- scHDeepInsight: A Hierarchical Deep Learning Framework for Precise Immune Cell Annotation in Single-Cell RNA-seq Data
Shangru Jia, Artem Lysenko, … Tatsuhiko Tsunoda·Briefings in BioinformaticsPeer-reviewed·Aug 31, 2025
- Scupa: Single-cell unified polarization assessment of immune cells using the single-cell foundation model
Wendao Liu, Zhongming Zhao·BioinformaticsPeer-reviewed·Feb 25, 2025
- SeuratExtend: Streamlining Single-Cell RNA-Seq Analysis Through an Integrated and Intuitive Framework
Yichao Hua, Linqian Weng, … Florian Rambow·GigaSciencePeer-reviewed·Jan 1, 2025