HOME  ›   visualization
If your question is not answered here, please email us at:  ${email.software}

Cell Ranger


Loupe

10x Genomics
Chromium Single Cell Gene Expression

Cell Ranger6.1, printed on 11/14/2024

Identifying Cell Types

Table of Contents

Goal: To identify known immature and mature B cell types in the dataset.

Next we build on the work done in the identifying cell types and exploring substructure sections. We will use the Filters panel available in Loupe Cell Browser 3.1 or later and Loupe Browser 4.0 and higher.

Finding B cell subtypes

In the identifying cell types section we identified B Cells with marker genes and in the exploring substructure section we further segmented B cells in t-SNE space by lassoing. Let's find and create new clusters of immature and mature B cells within the previous B cell cluster we found by using the presence or absence of TCL1A.

Let's open the Filters interface in the right panel and start building a filter. First, we'll add all three clusters that we created in exploring substructure. You can add a cluster by clicking the "Create new rule" button, then the "IN [cluster name]", and finally enter the cluster name "Main Population". Repeat this with the two other clusters: "Cluster 1" and "Cluster 2". Since these two cluster names are shared among multiple categories, you can prepend the category name "B Cells" to the cluster name, or find the cluster in the drop-down that belongs to the "B Cells" category, which appears under the cluster name (do not select "Cluster 1" from the Graph-based category).

You may have noticed that after adding all three clusters, there are no barcodes selected. You may have also noticed that there is a human-readable form of the filter at the bottom right of the panel, which updates whenever a change is made. It should currently show that the ruleset is filtering for barcodes in (in B Cells: Main Population and in B Cells: Cluster 1 and in B Cells: Cluster 2). However, there are no barcodes that are in all three (or even two) clusters. Instead, we want to find barcodes that are in either (in B Cells: Main Population or in B Cells: Cluster 1 or in B Cells: Cluster 2). We can accomplish this by clicking the AND/OR toggle in the top right of this ruleset. You should immediately see that the clusters in the top right are now highlighted in purple, the same clusters that we created in exploring substructure.

Next, to find immature B cells, we want to find barcodes that are in these clusters and expressing TCL1A. Since each ruleset is restricted to a single boolean operator, we need to add a new ruleset. Click the "Add new ruleset" button and then click the new "Create new rule" button. Add a rule that thresholds on count that's greater than a value by clicking the > button in the "Threshold by count" section. For this rule, select the gene TCL1A. You should see a subset of the barcodes that were highlighted which should represent immature B cells. The human-readable filter at the bottom should now read: (in B Cells: Main Population or in B Cells: Cluster 1 or in B Cells: Cluster 2) and (TCL1A > 0).

Let's assign these barcodes to a new category by clicking the "Assign 347 barcodes" button at the bottom. Name the category "B Cell Subtypes" and the cluster "Immature".

Now, we will find mature B cells by modifying the filter we just made. Since mature B cells don't express TCL1A, we will modify the existing TCL1A rule we created so that the rule reads "TCL1A = 0" instead of "TCL1A > 0". You can do so by clicking the greater than symbol (>) directly and choosing equals (=) instead. You should see a different highlighted subset of B cells in purple. Assign these 343 barcodes to the same category "B Cell Subtypes" and name the cluster "Mature".

Now that you've segmented the B cells in this dataset, you can choose to run differential expression between these subtypes like we did in exploring substructure. It's interesting to note that "Cluster 2" (the bottom right-most cluster) of the B cells categories looks like it's exclusively mature B cells, while the other two are mixed.

Filtering in depth

Filters allow you to create boolean filters with one level of nesting. Each ruleset represents a grouping of rules which are joined by the same logical operator. The logical operator can be toggled between AND/OR using the slider in the top right of the ruleset.

You can add additional rulesets when the first ruleset has more than one rule by clicking the "Add new ruleset" at the bottom. Rulesets operate independently from one another. Each ruleset may have its own logical operator.

Rulesets are all joined by the same logical operator. This can similarly be toggled between AND/OR using the dropdown at the top when there are greater than two rulesets. The options are:

In the human-readable form of the filter at the bottom, each ruleset is grouped with parentheses. The logical operator within parentheses must be the same operator. Similarly, the logical operator between sets of parentheses (rulesets) must be the same operator.

Next steps

We've now done some substantive exploration of this dataset. Let's finish the tutorial by learning how to save and share our work.