cdr3clustering

Cluster TCR/BCR clones by CDR3 sequences using GIANA or ClusTCR.

22|4|Updated May 18, 2021
One-click install
npx skills add https://github.com/pwwang/immunopipe --skill cdr3clustering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cdr3clustering
Source: https://github.com/pwwang/immunopipe/tree/main/skills/cdr3clustering
Command: npx skills add https://github.com/pwwang/immunopipe --skill cdr3clustering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Clustering of TCR/BCR clones by CDR3 sequences to reveal related clonotypes and public motifs, enabling downstream clonotype analysis.

Core Features & Use Cases

  • Clusters by CDR3 sequences using GIANA or ClusTCR (Faiss-based) and annotates with a CDR3_Cluster column.
  • Flexible method and chain selection to suit dataset size and analysis goals.
  • Use Case: Investigate convergent recombination and cross-sample public clonotypes for downstream analyses.

Quick Start

Run the CDR3Clustering process on your TCR/BCR data to generate the CDR3_Cluster metadata.

Frequently Asked Questions about cdr3clustering

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I cluster TCR/BCR clones by CDR3 sequences?

Cluster TCR/BCR clones by CDR3 sequences using GIANA or ClusTCR to group related clonotypes and generate a CDR3_Cluster metadata field for downstream analysis. The process supports per-sample or cross-sample clustering.

What is the best way to identify public clonotypes across multiple samples?

Cross-sample CDR3 clustering identifies public clonotypes by revealing convergent recombination and shared motifs across your dataset. You can configure the clustering threshold to suit your analysis goals.

Does CDR3 clustering support both T-cell and B-cell receptor chains?

CDR3 clustering supports T-cell receptor chains (TRA/TRB) and B-cell receptor chains (IGH/IGL/IGK). You can flexibly select the specific chains to cluster based on your dataset and analysis goals.

What input data format is required for clustering CDR3 sequences?

Clustering CDR3 sequences requires TCR/BCR data outputs from ScRepCombiningExpression. The process validates required dependencies and environment settings to ensure your data is properly formatted for clustering.

When should I choose GIANA over ClusTCR for clonotype clustering?

Choose GIANA or ClusTCR based on your dataset size and analysis goals. Both use Faiss-based methods to cluster CDR3 sequences, but you can select the tool and configure threshold options to suit your specific clonotype analysis needs.

Why do I need Faiss for CDR3 sequence clustering?

Faiss provides efficient similarity search for clustering large sets of CDR3 sequences. GIANA and ClusTCR rely on Faiss to rapidly group related TCR/BCR clonotypes, enabling the identification of public motifs across samples.