Cell Ranger 3.1 (latest), printed on 08/23/2019
With the AMLTutorial dataset loaded, let's take a quick tour of the Loupe Cell Browser user interface.
The workspace is centered around the barcode plot, in which single points representing cell barcodes are shown in a variety of projections. Each point represents a single barcode, the vast majority of which represent a single cell. The default projection is the t-SNE plot created by the Cell Ranger pipeline. Cell Ranger generates this plot by identifying the most significant feature vectors using principal component analysis, and then applying t-SNE dimensionality reduction to produce a two-dimensional scatter plot. A selector at the upper right of the barcode plot allows you to toggle between projections.For datasets generated using Feature Barcode technology, you may view alternate t-SNE plots generated by considering cell surface markers or CRISPR guide RNA features instead of genes. You may also switch to a projection that plots feature counts on two-dimensional axes.
You can drag the mouse over the cells to reposition the plot, and use the mouse wheel or track pad to smoothly zoom in and out. You'll see cluster labels as you move your mouse over the plot, which is useful for data that has a high number of precomputed clusters. Cells are colored by the active legend in the sidebar.
On the left side of the window is the toolbox. When you move your mouse over the toolbox buttons, you will see an explanation of what each button does. Use the toolbox to open files and save your work, control zoom, select cells for manual categorization, export screenshots of the current plot view, split the barcode plot into individual clusters, and adjust marker settings. Clicking the 10x button will return you to the home screen and Recent Files list.
You will use the mode selector at the top right corner of the workspace to switch between Loupe Cell Browser's different modes. There are four modes in Loupe Cell Browser 3.1 for gene expression data: Categories mode, Gene/Feature Expression mode, Filters, and V(D)J Clonotypes mode. Switching between modes will apply mode-specific coloring to the graph, and change the sidebar to reveal mode-specific functionality.
Cell Ranger pipelines compute and produce clusterings from two algorithms: a graph-based clustering algorithm and by K-Means clustering. A selector at the top of the Categories sidebar allows you to switch between these clusterings or other qualitative attributes. If your data comes from a cellranger aggr pipeline run, you can also color by library ID, and any additional attributes you add to the aggr spreadsheet, such as 'AMLStatus' in this dataset. Finally, you can also switch to categories that you make yourself within Loupe Cell Browser.
You can hide, show and highlight individual clusters within a category by using the sidebar. To highlight a cluster, click on the cluster name within the legend. To hide and show a cluster, click on the checkbox next to the cluster name. Finally, you may hide or show all clusters within a category by clicking on the menu with three dots, to the right of the category selector.
In Loupe Cell Browser 1.0.5 and later, you also have the ability to rename and recolor clusters, by right-clicking on a cluster name. Read the v1.0.5 release notes for more information.
In Gene/Feature Expression mode, you see a graphical representation of feature expression across your dataset. You may look at one or more features at a time, load and save lists of features for analyzing across multiple datasets, and look at patterns of transcript, surface marker, or CRISPR guide RNA counts across your data. We will explore this mode more in-depth when looking for cell types.
In Filter mode, you can compose complex boolean filters to find barcodes which fulfill your criteria. You can create rules based on feature counts or cluster membership and combine these rules using boolean operators. You may then save and load filters and use them across multiple datasets. We will introduce filtering in detail and identify complex cell types.
In V(D)J Clonotypes mode, you can load an input sample's corresponding V(D)J data into the Loupe Cell Browser workspace. Cells that belong to the active set of V(D)J clonotypes are colored blue, and the sidebar changes to a filterable clonotype list. For more information on how to use Loupe Cell Browser to combine gene expression and immune repertoire data, follow the Integrated Gene Expression and V(D)J Analysis in Loupe Cell Browser tutorial.
The data panel on the bottom of the workspace displays information about the features driving differences between clusters. By default, it will enumerate the genes that drive differences between the current precomputed clustering selected in the Categories sidebar. It will also display the results of a Significant Features analysis. The mini-toolbar to the left of the data panel switches between a table and a hierarchical heat map of differentiating features. Clicking on a feature name in the table view will allow you to add that feature to a list for future reference, or to show counts of that feature across the dataset in the active projection.
Now that you are familiar with the user interface, let's explore the data.