Package: ClustIRR 1.11.10

Simo Kitanovski

ClustIRR: Clustering of Immune Receptor Repertoires

ClustIRR analyzes repertoires of B- and T-cell receptors. It starts by identifying communities of immune receptors with similar specificities, based on the sequences of their complementarity-determining regions (CDRs). Next, it employs a Bayesian probabilistic models to quantify differential community occupancy (DCO) between repertoires, allowing the identification of expanding or contracting communities in response to e.g. infection or cancer treatment.

Authors:Simo Kitanovski [aut, cre], Kai Wollek [aut]

ClustIRR_1.11.10.tar.gz
ClustIRR_1.11.10.zip(r-4.7-x86_64)ClustIRR_1.11.10.zip(r-4.7-arm64)ClustIRR_1.11.10.zip(r-4.6-x86_64)ClustIRR_1.11.10.zip(r-4.6-arm64)ClustIRR_1.11.10.zip(r-4.5-x86_64)
ClustIRR_1.11.10.tgz(r-4.6-x86_64)ClustIRR_1.11.10.tgz(r-4.6-arm64)ClustIRR_1.11.10.tgz(r-4.5-x86_64)ClustIRR_1.11.10.tgz(r-4.5-arm64)
ClustIRR_1.11.10.tar.gz(r-4.7-arm64)ClustIRR_1.11.10.tar.gz(r-4.7-x86_64)ClustIRR_1.11.10.tar.gz(r-4.6-arm64)ClustIRR_1.11.10.tar.gz(r-4.6-x86_64)
ClustIRR_1.11.10.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
ClustIRR/json (API)

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

Bug tracker:https://github.com/snaketron/clustirr/issues

Uses libs:
  • onetbb– Parallelism library for C++
  • c++– GNU Standard C++ Library v3
Datasets:
  • BLOSUM62 - BLOSUM62 matrix
  • D_CMV_FLU - Processed single-cell TCR and gene expression dataset of antigen stimulated T cells
  • D1 - Synthetic dataset 'D1' with three TCRalphabeta repertoires
  • D2 - Synthetic dataset 'D2' with six TCRalphabeta repertoires
  • mcpas - CDR3 sequences and their matching epitopes obtained from McPAS-TCR
  • tcr3d - CDR3 sequences and their matching epitopes obtained from TCR3d
  • vdjdb - CDR3 sequences and their matching epitopes obtained from VDJdb

On BioConductor:ClustIRR-1.11.10(bioc 3.24)ClustIRR-1.10.0(bioc 3.23)

clusteringimmunooncologysinglecellsoftwareclassificationbayesianbiomedicalinformaticsmathematicalbiologyb-cell-receptorbioinformaticsimmunoinformaticsimmunologyquantitative-methodsrep-seqrepertoire-analysist-cell-receptoronetbbcpp

6.81 score 6 stars 16 scripts 362 downloads 21 exports 114 dependencies

Last updated from:267ec5b9d0. Checks:1 WARNING, 13 NOTE, 2 OK. Indexed: yes.

TargetResultTimeFilesSyslog
bioc-checksWARNING275
linux-devel-arm64NOTE345
linux-devel-x86_64NOTE499
source / vignettesOK487
linux-release-arm64NOTE344
linux-release-x86_64NOTE356
macos-release-arm64NOTE298
macos-release-x86_64NOTE612
macos-oldrel-arm64NOTE185
macos-oldrel-x86_64NOTE512
windows-devel-arm64NOTE420
windows-devel-x86_64NOTE468
windows-release-arm64NOTE432
windows-release-x86_64NOTE384
windows-oldrel-x86_64NOTE355
wasm-releaseOK180

Exports:attach_clonotypesclustirrdcodecode_all_communitiesdecode_communitydetect_communitiesget_ag_gene_hitsget_ag_species_hitsget_beta_cprob_agget_beta_violin_agget_cdr3_motifsget_clustirr_clustget_clustirr_inputsget_community_feature_purityget_community_feature_statsget_cosine_similarityget_honeycombsget_nradsmerge_clustirrsplot_graphsave_interactive_graph

Dependencies:abindaskpassbackportsbase64encBHBiocFileCacheBiocGenericsBiostringsbitbit64blobbslibcachemcallrcheckmateclicpp11crayoncurlDBIdbplyrdescdigestdistributionaldplyrevaluatefarverfastmapfilelockfontawesomefsgenericsggforceggplot2ggseqlogogluegridExtragtablehighrhtmltoolshtmlwidgetshttr2igraphinlineIRangesisobandjquerylibjsonliteknitrlabelinglatticelifecycleloomagrittrMASSMatrixmatrixStatsmemoisemimemsaMultipleAlignmentnumDerivopensslotelpillarpkgbuildpkgconfigplyrpolyclipposteriorprocessxpspurrrQuickJSRR6RADanalysisrappdirsrBLASTRColorBrewerRcppRcppEigenRcppParallelreshape2rlangrmarkdownRSQLiterstanrstantoolsS4VectorsS7sassscalesSeqinfosfsmiscStanHeadersstringdiststringistringrsyssystemfontstensorAtibbletidyrtidyselecttinytextweenrutf8vctrsviridisLitevisNetworkwithrxfunXVectoryaml

Decoding antigen-stimulated T cell receptor repertoires with ClustIRR
Analysis of T cell receptor (TCR) repertoires | Install and load the current version of ClustIRR | Familiarize with TCR data | Familiarize with gene expression data | Using ClustIRR to compare the two repertoires, CMV vs. Flu | Step 1 Building a joint graph | Using igraph functions to inspect $J$ | Step 2 Detecting communities in $J$ | Step 3 Finding differentially abundant communities (DACs) | Posterior predictive checks | Taking a peek at the relative community abundances ($\beta$) | Inspecting DACs of interest | Show the CDR3$\alpha$\beta$ sequence logos of community 9 | Visualize the graph of community 9 | Integration of TCR and GEX data

Last update: 2026-10-18
Started: 2026-07-01

Decoding T- and B-cell receptor repertoires with ClustIRR
Introduction | Installation | System requirements | ClustIRR algorithm | Input | Algorithm | Step 1. Compute TCR clonotype similarities in a repertoire with cluster_irr | Step 2-3. Construct TCR repertoire graphs and join them into $J$ | Run steps 1-3 with clustirr | Inspect the content of clust_irrs | Inspect graphs with plot_graph | You can evaluate $J$ with igraph | Step 4. community detection with detect_communities | Inspecting the outputs of detect_communities | Qualitative similarity between community abundance vectors with get_honeycombs | Quantitative similarity between community abundance vectors with get_cosine_similarity | Summary of communities is provided in the detect_communities outputs | Special functions: decoding communities with decode_community | Step 5. differential community occupancy (DCO) with dco | Step 6. Inspect results | Visualizing the distribution of $\beta$ with get_beta_violin_ag | Posterior predictive checks | Differential community abundance results $\rightarrow$ par. $\delta$ | Conclusion: you can also use custom community occupancy matrix for DCO!

Last update: 2026-10-18
Started: 2026-01-05

Finding biological condition-specific changes in T- and B-cell receptor repertoires with ClustIRR

Last update: 2026-04-09
Started: 2026-01-05

Readme and manuals

Help Manual

Help pageTopics
Attach Clonotypes to Existing Communitiesattach_clonotypes
BLOSUM62 matrixBLOSUM62
clust_irr classclass:clust_irr clust_irr clust_irr-class get_clustirr_clust get_clustirr_clust,clust_irr-method get_clustirr_inputs get_clustirr_inputs,clust_irr-method
Clustering of immune receptor repertoires (IRRs)clustirr
Processed single-cell TCR and gene expression dataset of antigen stimulated T cellsD_CMV_FLU
Synthetic dataset 'D1' with three TCRalphabeta repertoiresD1
Synthetic dataset 'D2' with six TCRalphabeta repertoiresD2
Model-based differential community occupancy (DCO) analysisdco
Decode all graph communitiesdecode_all_communities
Decode graph communitiesdecode_community
Graph-based community detection (GCD)detect_communities
Annotate antigen gene hits in node summaryget_ag_gene_hits
Annotate antigen species hits in node summaryget_ag_species_hits
Visualize cumulative probability of beta means for antigen-specific communitiesget_beta_cprob_ag
Visualize distribution of beta means in each repertoire as violin plotsget_beta_violin_ag
Generate CDR3 motif for communitiesget_cdr3_motifs
Compute community purity with respect to a node featureget_community_feature_purity
Compute descriptive statistics of a community node featureget_community_feature_stats
Compute and Visualize Cosine Similarity (CS)get_cosine_similarity
Generate honycomb plot: visualize community occupancy of pairs of immune receptor repertoiresget_honeycombs
Compute Normalized Rank Abundance Distributions (NRADs)get_nrads
CDR3 sequences and their matching epitopes obtained from McPAS-TCRmcpas
Merge immune receptor repertoire similarity graphsmerge_clustirrs
Plot ClustIRR graphplot_graph
Save interactive ClustIRR graphsave_interactive_graph
CDR3 sequences and their matching epitopes obtained from TCR3dtcr3d
CDR3 sequences and their matching epitopes obtained from VDJdbvdjdb