Cell Ranger3.1, printed on 11/24/2024
Cell Ranger pipelines output key metrics in text format. Below are the definitions of the reported metrics.
The cellranger count pipeline outputs metrics_summary.csv
which contains a number of key metrics about the barcoding and sequencing process.
Metric | Description |
---|---|
Estimated Number of Cells | The number of barcodes associated with cell-containing partitions, estimated from the barcode UMI count distribution. |
Mean Reads per Cell | The total number of reads divided by the estimated number of cells. |
Median Genes per Cell | The median number of genes detected (with nonzero UMI counts) across all cell-associated barcodes. |
Number of Reads | Total number of sequenced reads. |
Valid Barcodes | Fraction of reads with cell-barcodes that match the whitelist. |
Reads Mapped Confidently to Transcriptome | Fraction of reads that mapped to a unique gene in the transcriptome with a high mapping quality score as reported by the aligner. |
Reads Mapped Confidently to Exonic Regions | Fraction of reads that mapped to the exonic regions of the genome with a high mapping quality score as reported by the aligner. |
Reads Mapped Confidently to Intronic Regions | Fraction of reads that mapped to the intronic regions of the genome with a high mapping quality score as reported by the aligner. |
Reads Mapped Confidently to Intergenic Regions | Fraction of reads that mapped to the intergenic regions of the genome with a high mapping quality score as reported by the aligner. |
Sequencing Saturation | Fraction of reads originating from an already-observed UMI. This is a function of library complexity and sequencing depth. More specifically, this is a ratio where: the denominator is the number of confidently-mapped reads with a valid cell-barcode and valid UMI, and the numerator is the subset of those reads that had a non-unique combination of (cell-barcode, UMI, gene). This metric was called "cDNA PCR Duplication" in versions of Cell Ranger prior to 1.2. |
Q30 Bases in Barcode | Fraction of bases with Q-score at least 30 in the cell barcode sequences. This is the i7 index (I1) read for the Single Cell 3' v1 chemistry and the R1 read for the Single Cell 3' v2 chemistry. |
Q30 Bases in RNA Read | Fraction of bases with Q-score at least 30 in the RNA read sequences. This is Illumina R1 for the Single Cell 3' v1 chemistry and Illumina R2 for the Single Cell 3' v2 chemistry. |
Q30 Bases in Sample Index | Fraction of bases with Q-score at least 30 in the sample index sequences. This is the i5 index (I2) read for the Single Cell 3' v1 chemistry and the i7 index (I1) read for the Single Cell 3' v2 chemistry. |
Q30 Bases in UMI | Fraction of bases with Q-score at least 30 in the UMI sequences. This is the R2 read for the Single Cell 3' v1 chemistry and the R1 read for the Single Cell 3' v2 chemistry. |
Fraction Reads in Cells | The fraction of cell-barcoded, confidently mapped reads with cell-associated barcodes. |
Total Genes Detected | The number of genes with at least one UMI count in any cell. |
Median UMI Counts per Cell | The median number of total UMI counts across all cell-associated barcodes. |
The cellranger aggr pipeline outputs summary.json
which contains metrics relating to the aggregated datasets. Note: square brackets denote a variable that depends on the pipeline input,
e.g. [library_id]_frac_reads_kept
means that if your aggregation contains two libraries with IDs sample123
and sample456
, there will be two output metrics sample123_frac_reads_kept
and sample456_frac_reads_kept
.
Metric | Description |
---|---|
filtered_bcs_transcriptome_union | The estimated number of barcodes associated with cell-containing partitions, summed across all input libraries. |
total_reads | Total number of sequenced reads, summed across all input libraries. |
multi_transcriptome_total_raw_reads_per_filtered_bc | total_reads divided by filtered_bcs_transcriptome_union . |
[library_id]_pre_normalization_raw_reads_per_filtered_bc | The mean total reads per cell prior to depth normalization, for the library denoted by library_id . |
[library_id]_pre_normalization_cmb_reads_per_filtered_bc | The mean confidently mapped and barcoded (CMB) reads per cell prior to depth normalization, for the library denoted by library_id . |
[library_id]_frac_reads_kept | The fraction of reads that were retained after depth normalization for the library denoted by library_id . |
lowest_frac_reads_kept | The lowest fraction of reads retained, corresponding to the library which lost the most reads during normalization. A low value may indicate a large disparity in the initial depth of the input libraries. |