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

Cell Ranger ATAC


Loupe

10x Genomics
Chromium Single Cell ATAC

Cell Ranger ATAC6.4 (latest), printed on 11/14/2024

Peak Viewer Details

Overview

The Peak Viewer panel provides the tools to look at differential chromatin accessibility across genomic regions of interest. It combines two visualizations. The peak distribution chart shows the sizes of called peaks, and the relative number of cells per cluster within those peaks. The Peak Viewer also displays cut site tracks, which uses the fragments.tar.gz file generated by the Cell Ranger ATAC pipeline to show a finer-grained picture of chromatin accessibility on a base-by-base level. The Peak Viewer is exclusive to ATAC data, and can be activated by clicking on the icon to the left of the bottom data panel.

Peak distribution

When loading a file for the first time, the Peak Viewer shows the peak distribution chart, with the window showing the first five called peaks in the dataset. You can see the currently selected range in the top left of the Peak Viewer, ticks at the top of the panel to show genomic position, and a track of peak distributions per cluster. Called peaks appear as rectangles of varying width and height. The height of each peak is proportional to the number of cells within that cluster that had cut sites falling within the called peak. You can hover over each peak to identify the location of the peak, and the number of cells per cluster with a fragment within this peak. Clicking on a peak highlights the cells in the barcode plot where that region was accessible.

Navigation

There are a variety of ways to navigate through the genome to look at regions of interest. At the top left, there is a field to enter either a set of genomic coordinates, or enter a gene. Use the region selector at top left to toggle between searching by Region (e.g., "chr2:86,999,840-87,047,412") or by Gene (e.g., "CD8A").

In addition, the first four buttons on the Peak Viewer's menu bar allow you to pan left and right, and to zoom in and out. Finally, you can drag over a particular region to zoom in more rapidly.

The viewer supports a maximum genomic interval size of 10 Mb.

Loading the fragments file

While peak distribution information comes preloaded in a .cloupe file, information about individual fragments, which drive the cut site tracks, are stored in another file generated by the Cell Ranger ATAC pipeline, the fragments.tsv.gz file. This file is bundled separately from the .cloupe file, as it usually takes up much more disk space. You can add the fragments file to the working session by clicking the folder icon on the Peak Viewer menu bar.

There are two options for attaching fragments files. If Cell Ranger ATAC outputs are available from behind a web server, you can specify the URL when the From URL tab is highlighted. For example, the URL of the ATACTutorial dataset's fragments.tsv.gz file is https://cf.10xgenomics.com/supp/cell-atac/ATACTutorial-fragments.tsv.gz. Choosing the From File tab and clicking the Load From File button brings up your operating system's file chooser, through which you can navigate to select the appropriate fragments.tsv.gz file. If you provide an invalid URL, or the fragments.tsv.gz file selected is from a different dataset, you see a simple error message. If the association is successful, you see cut site tracks atop the peak distribution, and the peak distribution bars turns gray.

Shortcut: If you are loading the .cloupe file directly from a Cell Ranger ATAC outs folder, then Loupe Browser automatically detects the corresponding fragments file. If this is the case, you see both the peak distribution chart and cut site tracks in the Peak Viewer when first loading a file.

Understanding cut site tracks

With the fragments file loaded, you can look at chromatin accessibility at base-level resolution by analyzing cut site tracks. Cut site tracks are generated by analyzing all of the fragments detected within the current viewing window from the fragments.tsv.gz file. Each read fragment called and validated by the Cell Ranger ATAC pipeline has two cut sites: the start position of the fragment, and the end position of the fragment. These are the locations where the ATAC enzyme attached to open chromatin. For each cut site, the Peak Viewer imputes an open region, where the chromatin is presumed to be accessible. By default, the open window is 400 bases wide and centered around the cut site, though this is configurable (see Peak Viewer Options below). Finally, the cut site track is generated by computing a rolling sum over these open windows, akin to read pileups. In this manner, regions with highest accessibility should have the highest number of nearby cut sites nearby, highest number of nearby open windows, and thus the highest rolling sum within the cut site track.

By default, the heights of the cut site tracks are normalized by the number of cells in each cluster, to highlight differences in accessibility between individual clusters. In this manner, the cut site tracks are measures of average accessibility of a particular base for each cell in the cluster. You can also change this setting in the Peak Viewer Options menu.

Gene and transcript annotations

With the cut site tracks visible, it is possible to associate the location of peaks with both genes and functional elements within genes. The Peak Viewer shows gene, transcript, exon and UTR annotations in a bar above the cluster tracks. These annotations come directly from the reference specified in the Cell Ranger ATAC run. Genes are displayed as dashed lines with vertical line boundaries, the selected transcript as a solid line, exons as solid rectangles, and UTRs as open rectangles. In narrow window sizes, gene names are displayed above the annotation, though more information about a gene is available at any point by hovering over the annotation symbol.

Transcript selection

Though there can be multiple transcripts per gene, the Peak Viewer only displays exons and UTRs from one transcript per gene. This is a visual compromise; there is limited screen space to show all transcripts from a reference. The heuristic for picking which transcript to display is as follows:

Though only one transcript per gene is shown in the Peak Viewer, peaks can be marked as promoting genes if they are close to the transcription start sites of alternate transcripts. This is apparent by looking at CD8A below:

The rightmost peak within CD8A is close to the transcription start site of an alternate CD8A transcript specified in the reference, but not drawn in the annotation track.

Peak Viewer options

Clicking on the sliders icon next to the folder icon brings up the Peak Viewer Options menu. The options include:

Export

You can export the peak distributions and cut site tracks from the Peak Viewer, for display or consumption by other bioinformatics tools. Click on the Export arrow icon to bring up the list of export options: