10x Genomics
Chromium Single Cell Immune Profiling

Cell Ranger2.2, printed on 12/18/2024

Annotation Algorithm

Each assembled contig in each cell is aligned against all of the germline segment reference sequences via Smith-Waterman.

First, the contig is aligned to all V reference sequences. The best match is found and the matching bases are masked from the contig. Then the same procedure is followed one-by-one for J, C, and 5′ UTR reference sequences. Finally, we search for the best matching D reference sequence if both V and J annotations were found (only for TRB, IGH).

Next, if a V annotation is found, the CDR3 region is sought in 2 different ways. If the sequence spans the 5′ end of the L+V region which contains the start codon, then search for a CDR3 motif (Cys-to-XGXG/FXXG) in that frame, starting from the C-terminal Cys residue in the aligned V region. Otherwise, search for a CDR3 sequence in all frames. CDR3 regions are restricted to be at least 26 and at most 80 nucleotides long.

Each contig's productivity is determined by these criteria:

• It is full-length. This means we are able to find a V gene annotation and the J gene annotation spans until the 3' end of the reference. In order to allow for alignment clipping when 3′ SNVs are present, the J alignment is allowed to be missing at most 3 bp on the 3′ end. Otherwise, productivity cannot be determined, and the value is set to "None".
• It contains a recognizable start codon in the expected V location. First, we look for a start codon at the 5′ end of the annotated V gene within the first two codons. If the start codon is not found, search for the 5′ most start codon in the CDR3 frame after annotating the CDR3 region. If both the searches for start codon fail, it is considered unproductive, and the value is set to "False".
• It contains a CDR3 region in-frame with the start codon. If no CDR3 is found or the CDR3 is not in-frame, it is considered unproductive.
• It contains no stop codons in the V-J spanning region. If a stop codon is found, it is considered unproductive.

Contig Filtering

It is expected that each cell barcode typically contains two matching productive contigs, comprising either a TRA and a TRB, or a heavy chain (IGH) and a light chain (IGK or IGL). Additional productive contigs produced by the assembler are less likely to be legitimate. For each chain, we define the contig with the most UMIs as the 'top' contig. Further productive contigs with distinct CDR3s must have at least 2 UMIs and greater than 0.2 x UMIs of the top contig to be considered confident. Otherwise, they are considered low-confidence. Additionally, extra productive contigs with the same CDR3 as an existing contig for that chain are considered low-confidence; these are likely induced by assembly artifacts. Productive contigs not labeled as low-confidence are labeled as high-confidence. Only high-confidence contigs will appear in the Loupe V(D)J browser.

Clonotype Grouping and Consensus Building

Cell barcodes are grouped together into clonotypes if they share the same set of productive CDR3 nucleotide sequences by exact match. Note that for B cells, somatic mutations that fall within the CDR3 will break up clonotypes that are in fact clonally related. Cells with somatic mutations outside the CDR3 will be considered to share a clonotype.

For each clonotype and each CDR3, the contigs in all cells are assembled together to produce a clonotype consensus sequence.

Because this sequence is constructed using multiple cells, its accuracy is expected to be even higher than sequences constructed from a single cell.