10x Genomics
Chromium Single Cell ATAC

Cell Ranger ATAC1.1, printed on 12/21/2024

Understanding Output

The Cell Ranger ATAC software strives to maintain compatibility with common analysis tools by using standard output file formats whenever possible. For example, the barcoded BAM files can be viewed in standard genome browsers such as IGV to verify alignment quality and other features. The Chromium-specific data, including these barcodes, can be accessed via any third-party tools or scripts that can parse the additional element tags utilized by Cell Ranger ATAC.

All pipelines produce all of their output in a single pipeline output directory, whose name depends on the pipeline:

• For cellranger-atac mkfastq, the flowcell serial number is used (e.g., HAWT7ADXX)
• For cellranger-atac count, the --id argument is used

Output files will appear in the outs/ subdirectory within this pipeline output directory. For example, a typical cellranger-atac count may look like:

$ cd /home/jdoe/runs
$ cellranger-atac count --id=sample345 \
                 --reference=/opt/refdata-cellranger-atac-GRCh38-1.1.0 \
                 --fastqs=/home/jdoe/runs/HAWT7ADXX/outs/fastq_path \
                 --sample=mysample

 
Martian Runtime - 3.2.1
 
Running preflight checks (please wait)...
2018-09-17 20:23:52 [runtime] (ready)           ID.sample345.SC_ATAC_COUNTER_CS.SC_ATAC_COUNTER.SETUP_CHUNKS
...
2018-09-17 22:26:56 [runtime] (join_complete)   ID.sample345.SC_ATAC_COUNTER_CS.SC_ATAC_COUNTER.CLOUPE_PREPROCESS
 
Outputs:
-- Per-barcode fragment counts & metrics:        /home/jdoe/runs/sample345/outs/singlecell.csv
-- Position sorted BAM file:                     /home/jdoe/runs/sample345/outs/possorted_bam.bam
-- Position sorted BAM index:                    /home/jdoe/runs/sample345/outs/possorted_bam.bam.bai
-- Summary of all data metrics:                  /home/jdoe/runs/sample345/outs/summary.json
-- HTML file summarizing data & analysis:        /home/jdoe/runs/sample345/outs/web_summary.html
-- Bed file of all called peak locations:        /home/jdoe/runs/sample345/outs/peaks.bed
-- Raw peak barcode matrix in hdf5 format:       /home/jdoe/runs/sample345/outs/raw_peak_bc_matrix.h5
-- Raw peak barcode matrix in mex format:        /home/jdoe/runs/sample345/outs/raw_peak_bc_matrix
-- Directory of analysis files:                  /home/jdoe/runs/sample345/outs/analysis
-- Filtered peak barcode matrix in hdf5 format:  /home/jdoe/runs/sample345/outs/filtered_peak_bc_matrix.h5
-- Filtered peak barcode matrix in mex format:   /home/jdoe/runs/sample345/outs/filtered_peak_bc_matrix
-- Barcoded and aligned fragment file:           /home/jdoe/runs/sample345/outs/fragments.tsv.gz
-- Fragment file index:                          /home/jdoe/runs/sample345/outs/fragments.tsv.gz.tbi
-- Filtered tf barcode matrix in hdf5 format:    /home/jdoe/runs/sample345/outs/filtered_tf_bc_matrix.h5
-- Filtered tf barcode matrix in mex format:     /home/jdoe/runs/sample345/outs/filtered_tf_bc_matrix
-- Loupe Cell Browser input file:                /home/jdoe/runs/sample345/outs/cloupe.cloupe
-- csv summarizing important metrics and values: /home/jdoe/runs/sample345/outs/summary.csv
-- Annotation of peaks with genes:               /home/jdoe/runs/sample345/outs/peak_annotation.csv
 
Pipestance completed successfully!

In this case,

• /home/jdoe/runs/ is where the pipeline was run,
• /home/jdoe/runs/sample345/ is the top-level output directory containing pipeline metadata, and
• /home/jdoe/runs/sample345/outs/ contains the final pipeline output files.

The contents of this outs/ directory contain the data that is described in the remainder of this section: run summary HTML, run analysis, feature-barcode matrices MEX and HDF5, barcoded BAMs, peaks.bed, fragments tsv.gz, per barcode cell calling, mapping and targeting metrics, peak annotations and metrics.

More information about the contents of the pipeline output directory can be found in the Pipestance Structure page.