Cell Ranger3.1, printed on 09/21/2023
In this part of the analysis walkthrough, we use Loupe V(D)J Browser to look at clonotypes within a gene expression cluster, and compare clonotype distributions between clusters. You need these files to proceed:
If you're new to Loupe V(D)J Browser, you may want to read the Loupe V(D)J Browser tutorial before continuing.
To look at clonotypes within gene expression clusters in Loupe V(D)J Browser, you'll need
to first download one or more V(D)J
.vloupe files, and then import the gene expression
To start, open Loupe V(D)J Browser, and click on Browse for a Loupe V(D)J Browser File.
LungTumorT dataset and press Load. You see the
following after loading:
Next, click on the folder icon on the top toolbar, and select Load clusters from cloupe file.
LungTumorGEX file that you either downloaded from the previous
exercise, or from the link above.
After importing gene expression data, you see an icon next to any V(D)J samples for which
corresponding gene expression data has been loaded. Then you see the icon next to the
The icon signals that you can filter clonotypes in that file by cluster, and use Comparison Mode to compare clonotypes between gene expression clusters.
Select the Cluster option from the Filter By field below the clonotype list. Type 'CD8' in the Enter Cluster Name box. The CD8+ Cytotoxic T Cells cluster appears from the autocomplete list. Select it to limit the clonotype list to cells in that cluster. Clicking on each chain in the list shows you the mutations (vertical lines) against the combined V(D)J reference for the chain.
Next, let's compare clonotype distributions between gene expression clusters.
Next, use Loupe V(D)J Browser to identify any clonotypes that are unique to the CD4+ Helper T Cell cluster and the CD8+ Cytotoxic T Cell cluster.
Select Comparison Mode from the file selector, and then choose Clonotype Comparison from the Chart Type chart selector above the sample table. Since you have already loaded gene expression data, you may choose Cluster from the Compare By dropdown. Under Cluster A, enter "CD4+ Helper T Cells", and under Cluster B, enter "CD8+ Cytotoxic T Cells":
You can see that there are a set of clonotypes which are unique to the CD8+ Cytotoxic T Cell cluster, and another set that are unique to the CD4+ Helper T Cell cluster. Clonotype differences are ordered by p-value, as computed by applying Fisher's exact test. To explore a clonotype in more detail, you can copy a CDR3 sequence by clicking on it, and using the CDR3 Amino filter in the single-sample clonotype/chain view. Finally, you can export the list of differing clonotypes to a CSV file, for further downstream processing.
Now that you've seen how to combine V(D)J and gene expression data with Loupe Browser and Loupe V(D)J Browser, you'll have ideas about how to use the Chromium™ Single Cell V(D)J Solution for your own experiments. If you have any questions or feedback about software or other parts of the integrated V(D)J and gene expression workflow, contact [email protected].