Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Mitochondrial lineage tracing

Call clones in a human colorectal tumor from the somatic mutations in its cells’ mitochondrial DNA, and compare its cell types by the clones they share. Lareau et al. (2020) profiled 3,535 cells of a resected colorectal adenocarcinoma, its epithelial cells and the immune cells that infiltrated it, with mtscATAC-seq, which reads each cell’s mitochondrial genome together with its chromatin accessibility. Of the 49,545 variants that the 1,459 singlets with enough mitochondrial reads show, 11 differ between cells by the paper’s thresholds, and they place 895 of these cells in 10 clones. Five clones carry 16147C>T, which marks the tumor’s epithelial cells, and four of them add a second variant that marks a subclone. Each of the other five clones holds basophil-like, T and NK, and myeloid cells, so these three immune types share clones about one standard deviation more often than shuffled cell types.

Cells that share a somatic mutation in their mitochondrial DNA share an ancestor. A cell holds many copies of its 16,569-base mitochondrial genome, and a mutation in one copy can drift until it fills a large share of them. That share is the mutation’s heteroplasmy, and the cell’s descendants inherit it, so mitochondrial mutations trace clones in human tissue, where no engineered barcode can be introduced Ludwig et al., 2019.

This page is one of four on clonal analysis with ds.clones, and here the clones come from mutations that arose naturally in the patient’s cells. Lineage tracing follows clones that lentiviral LARRY barcodes mark in mouse hematopoiesis over days 2, 4 and 6, lineage recorders cuts the PEtracer phylogeny of a mouse embryo into clones, and immune repertoires groups T and B cells into clonotypes by their receptor chains. Each page saves its clones in the store as an artifact, a result recorded with its inputs and parameters, and the clone summaries of ds.clones read the clones of any of them.

Download the data

Zenodo record 3977808 holds processed data of the paper under CC BY 4.0. For the colorectal cancer sample, download two outputs of Cell Ranger ATAC: the counts in peaks of the barcodes it called cells, and its metrics for every barcode. Then download six outputs of mgatk, the paper’s tool for mitochondrial variants: each cell’s reads of A, C, G and T at each mitochondrial position, in one file per base, each cell’s mean depth, and the reference sequence. The eight files take 211 MB. Each download is tried up to 4 times, 30 seconds apart, and checked against the MD5 checksum that Zenodo lists for it. The downloads and the store go to a temporary directory; use a project directory to keep them.

Started: 2026-11-14T15:42:40.792483Z | Wall time: 0.912 s

filtered_peak_bc_matrix.h5 18.8 singlecell.csv 23.2 A.txt.gz 51.4 C.txt.gz 51.7 G.txt.gz 24.2 T.txt.gz 41.8 depthTable.txt 0.1 chrM_refAllele.txt 0.1 Total 211.4 Name: MB, dtype: float64

Started: 2026-11-14T15:42:41.708147Z | Wall time: 136.399 s

Filter the cells as the paper did

CrToZarr writes the peak counts into a store with an ATAC assay, one row per barcode that Cell Ranger called a cell. The paper kept the cells with at least 1,000 unique nuclear fragments, at least 40% of them in DNase hypersensitive sites (regions open in many cell types), and a mitochondrial depth of at least 10 reads per position Lareau et al., 2020. Cell Ranger’s metrics hold the first two: passed_filters counts each barcode’s fragments that remain once duplicate, chimeric, unmapped, low-quality and mitochondrial reads are set aside, and DNase_sensitive_region_fragments those of them in DNase hypersensitive sites. The depth filter follows once the mitochondrial counts are imported.

snapshot_cell_selection saves the passing cells as a cell selection, a frozen list of cells that later steps take as input, so every step analyzes exactly these cells.

Called by Cell Ranger 3535 At least 1,000 nuclear fragments 2004 At least 40% of them in DNase sites 3533 Both 2003 Name: Cells, dtype: int64

Started: 2026-11-14T15:44:58.109711Z | Wall time: 5.909 s

2,003 of the 3,535 cells pass, nearly all of the others for too few fragments.

Name the cell types

The ATAC recipe, ds.pipeline.atac, reduces the peak counts of these cells with latent semantic indexing (LSI), then builds, embeds and clusters their neighbor graph. It returns a pipeline run, the saved record of these steps, from which the page reads the clusters, the UMAP and the cells that the recipe analyzed as run["clusters"], run["umap"] and run["analysis_cell_selection"]. The settings are those of the scATAC-seq analysis of PBMCs: 50 LSI components of the 25,000 most prevalent peaks, and 21 neighbors. To name the clusters, sum the accessibility of the peaks that overlap each gene into a GeneScores assay, from gene intervals on the reference of the peaks, hg19 (GRCh37). Two warnings are expected: the peaks leave out the mitochondrial genome, and 35,450 of the 62,446 genes overlap no peak.

WARNING: Chromosome chrM not in the input peak coordinates
WARNING: 35450/62446 features did not overlap with any peak

Started: 2026-11-14T15:45:04.023137Z | Wall time: 121.561 s

Dot plot of 21 marker genes in five groups, epithelial, immune, basophil and mast, T and NK, and myeloid, for the 7 clusters on the x-axis; color shows each gene's standardized mean gene score and size the share of the cluster's cells with a nonzero score. Epithelial genes mark clusters 1, 2 and 7, PTPRC clusters 3 to 6, basophil and mast cell genes clusters 3 and 7, T and NK cell genes cluster 4, and myeloid genes clusters 5 and 6.

Started: 2026-11-14T15:47:05.587370Z | Wall time: 1.805 s

Clusters 1 and 2 are epithelial, accessible at EPCAM, the keratin gene KRT8, the intestinal transcription factor CDX2, and the intestinal epithelial genes VIL1 and LGALS4. PTPRC, the gene of the immune cell marker CD45, is accessible in clusters 3 to 6: in cluster 3 with the genes of basophils and mast cells (the paper calls these cells basophil-like), in cluster 4 with the genes of T and NK cells, and in clusters 5 and 6 with the genes of myeloid cells. Cluster 7 is accessible at both the epithelial genes and those of the basophil-like cells.

CellsMedian counts in peaks
cluster
16464360.0
23946871.5
331612488.0
42388902.0
518715102.0
61678794.0
75519307.0

Started: 2026-11-14T15:47:07.395427Z | Wall time: 0.046 s

Cluster 7 also holds the most counts in peaks, 19,307 per cell at the median against 4,360 to 15,102 in the others, as droplets with two cells do: its 55 cells are doublets of an epithelial and a basophil-like cell.

UMAP of the 2,003 analyzed cells colored by cell type. The epithelial, basophil-like, T and NK, and myeloid cells each occupy a region of their own, and the doublets form a narrow bridge from the epithelial cells to the basophil-like cells.

Started: 2026-11-14T15:47:07.443153Z | Wall time: 0.231 s

The doublets bridge the epithelial and the basophil-like cells on the UMAP.

Import the mitochondrial counts

mgatk counts each cell’s reads of each base at each of the 16,569 positions of the mitochondrial genome, on each strand of DNA. variants.import_counts reads mgatk’s folder and joins each barcode to the store’s cell with the same ID. Import the counts for the cells that the ATAC recipe analyzed, so that the variants and clones share the cells of the UMAP. A cell’s depth at a position is its reads there, and its allele frequency of a variant is its reads of the variant over that depth, an estimate of the variant’s heteroplasmy in the cell. Where a cell has no read at a position, its frequency there is undefined rather than 0.

Barcodes in mgatk's files 3511 Of cells outside the analysis 1508 Matching no cell of the store 0 Analyzed cells with counts 2003 Name: Barcodes, dtype: int64

Started: 2026-11-14T15:47:07.676775Z | Wall time: 10.431 s

All 2,003 analyzed cells have counts, and the other 1,508 barcodes of mgatk’s files belong to cells outside the analysis.

Two panels. Top: the mean depth at each position of the mitochondrial genome on a log scale, mostly between 20 and 45 reads, falling to about 7 near the start of the genome and to about 13 near position 16,100. Bottom: histograms of each cell's mean depth per position on a log scale, one line per cell type; most cells read between 3 and 100 reads per position, the myeloid cells peak near 15 and the doublets sit at the high end.

Started: 2026-11-14T15:47:18.110424Z | Wall time: 0.606 s

CellsMedian depthDepth of 10 or moreShare of the cells
cell type
epithelial104019.97270.70
basophil-like31621.12710.86
T and NK23824.21810.76
myeloid35416.32800.79
doublet5545.3460.84

Started: 2026-11-14T15:47:18.719009Z | Wall time: 0.031 s

Mean depth is similar along most of the mitochondrial genome and falls near both ends of its numbering. Most cells reach the paper’s bound of 10 reads per position: 70% of the epithelial cells and 76% to 86% of each immune type. The doublets read the mitochondria of two cells and reach the highest median depth, 45.3 reads per position. Call the cells that reach the bound deep cells. The variant analysis uses the deep singlets, the deep cells outside the doublet cluster.

Started: 2026-11-14T15:47:18.752317Z | Wall time: 0.081 s

Find the informative variants

A variant is a base that differs from the reference at a position, such as 16147C>T, a T where the reference holds C at position 16,147. Germline variants, which the patient inherited, are carried by every cell, and informative variants differ between cells. variants.informative scores each variant with the statistics of mgatk Lareau et al., 2020: the variance-to-mean ratio (VMR) of its allele frequency across cells, high when some cells carry the variant and others do not; its strand correlation, the agreement of its reads on the two strands of DNA across cells, since sequencing errors tend to appear on one strand; and the number of cells in which it is detected confidently, with at least two reads of it on each strand. preset="atac" applies the paper’s thresholds: a variant detected confidently in at least 5 cells, with a strand correlation of at least 0.65 and a VMR above 0.01. The masks leave out variants that artifacts mimic: "numt" those that reads of nuclear copies of mitochondrial DNA (NUMTs) cause, and "artifact_prone" every variant at the homopolymers that sequencers misread and at the reference’s unknown base.

11 of 49,545 variants are informative
meanvmrstrand_correlationn_cells_conf_detected
variant
chrM:16147C>T0.6030.4020.913621
chrM:12889G>A0.0210.1410.87588
chrM:9728C>T0.0130.3520.92230
chrM:1227G>A0.0080.2220.96925
chrM:16093T>C0.0080.7380.9948
chrM:2285T>C0.0050.9560.9269
chrM:824T>C0.0050.8750.96810
chrM:9804G>A0.0030.9780.9799
chrM:6081G>A0.0030.2550.8208
chrM:9840T>C0.0020.7370.8555
chrM:3244G>A0.0011.1480.9575

Started: 2026-11-14T15:47:18.835439Z | Wall time: 1.767 s

Scatter plot of each variant's variance-to-mean ratio (VMR), on a log scale, against its strand correlation, titled 11 of 46228 variants informative, with dotted lines at a VMR of 0.01 and a correlation of 0.65. The 11 informative variants sit in blue at the upper right, among gray variants that pass both lines but are detected confidently in fewer than 5 cells, and a few masked variants are drawn as crosses. The other gray variants form a large cloud at negative and low correlations, a column at a correlation of -1, and a group of germline variants at the lower right with a correlation near 1 and a VMR below 0.001.

Started: 2026-11-14T15:47:20.604513Z | Wall time: 0.455 s

Of the 49,545 variants that the deep singlets show, 11 pass. 16147C>T makes up 60% of the reads at its position, and each of the other ten makes up 0.1 to 2.1% of the reads at its own, since each is detected confidently in only 5 to 88 cells. The gray points at the lower right of the plot are germline variants, which every cell carries. The gray points at the upper right pass both dotted lines but are detected confidently in fewer than 5 cells. The plot leaves out the variants without a strand correlation, such as those that a single cell shows, so its title counts fewer variants than the 49,545 printed above.

See which cells carry each variant

Compute the allele frequencies of the informative variants in every deep cell, the doublets included, and set the cell types beside the frequency of 16147C>T.

Two UMAPs of the 2,003 analyzed cells. Left: colored by cell type, as above. Right: colored by the allele frequency of 16147C>T from 0 in purple to 1 in yellow, with cells without a frequency in gray. The epithelial cells sit near 1, the doublets on the bridge to the basophil-like cells at intermediate frequencies, and the immune cells near 0 apart from a few scattered cells near 1.

Started: 2026-11-14T15:47:21.061844Z | Wall time: 1.302 s

16147C>T reaches a frequency near 1 across the epithelial cells and stays near 0 in the immune cells, so it marks the tumor. The doublets on the bridge carry it at intermediate frequencies, as droplets that mix the mitochondria of a tumor cell and a basophil-like cell would. Gray cells have no frequency: they fell below the depth bound, or no read covered the position.

The other ten variants each mark fewer cells. Draw their frequencies, and count the deep cells of each type in which each variant is detected confidently.

Ten UMAPs of the analyzed cells, one per informative variant other than 16147C>T, each colored by that variant's allele frequency on its own scale, with cells without a frequency in gray. 12889G>A, at up to about 0.5, colors many epithelial cells, and 9728C>T, 1227G>A and 6081G>A fewer of them; 16093T>C, 2285T>C, 824T>C, 9804G>A, 9840T>C and 3244G>A each color a few cells scattered over the basophil-like, T and NK, and myeloid cells.

Started: 2026-11-14T15:47:22.365330Z | Wall time: 1.215 s

cell typeepithelialbasophil-likeT and NKmyeloiddoublet
16147C>T60059738
12889G>A8502111
9728C>T290013
1227G>A250001
16093T>C03320
2285T>C05221
824T>C03340
9804G>A06210
6081G>A70012
9840T>C03110
3244G>A01130

Started: 2026-11-14T15:47:23.582612Z | Wall time: 0.033 s

16147C>T is detected confidently in 600 of the 727 deep epithelial cells, in 38 of the 46 deep doublets, and in 5 to 9 cells of each immune type. Four variants mark parts of the epithelial cells, subclones of the tumor: 12889G>A is detected confidently in 85 epithelial cells, 9728C>T in 29, 1227G>A in 25 and 6081G>A in 7. Each of the six others is detected confidently in only 5 to 10 deep singlets, all of them immune cells and spread over all three immune types, so each most likely arose in a hematopoietic progenitor of these lineages.

Call clones

variants.frequency_clones groups the cells whose variants agree, as Signac’s FindClonotypes does Stuart et al., 2021. It finds each cell’s neighborhood of 10 cells by the cosine similarity of the square roots of their allele frequencies, joins the cells whose neighborhoods overlap into a graph, and partitions the graph with the Leiden algorithm Traag et al., 2019. The cosine compares the pattern of a cell’s frequencies across the variants, not their level. Cells that show none of the informative variants get no clone. The resolution of the Leiden algorithm sets how finely it splits the graph; this page uses 0.75, below the default of 1, and checks that choice once the clones are read.

Deep singlets 1459 With a clone 895 Showing no informative variant 564 Name: Cells, dtype: int64

Started: 2026-11-14T15:47:23.616990Z | Wall time: 3.215 s

Heatmap of the allele frequencies of the 11 informative variants, one row each, in the 895 cells with a clone, one column each, ordered by clone under a bar of clone colors. 16147C>T is near 1 in clones 1 to 4 and 6; clones 2, 3, 4 and 6 also show 12889G>A, 9728C>T, 1227G>A and 6081G>A; clones 5 and 7 to 10 each show one of 824T>C, 9804G>A, 2285T>C, 16093T>C and 9840T>C without 16147C>T; and a few cells of clone 2 show 3244G>A.

Started: 2026-11-14T15:47:26.833696Z | Wall time: 1.343 s

cell typevariantsepithelialbasophil-likeT and NKmyeloid
clone
clone_116147C>T430121220
clone_216147C>T, 12889G>A1745810
clone_316147C>T, 9728C>T45013
clone_416147C>T, 1227G>A45031
clone_5824T>C0141313
clone_616147C>T, 6081G>A29214
clone_79804G>A0824
clone_82285T>C0634
clone_916093T>C0553
clone_109840T>C0541

Started: 2026-11-14T15:47:28.178793Z | Wall time: 0.082 s

Of the 1,459 deep singlets, 895 get a clone, and the other 564 show none of the informative variants. Clones are numbered by size. Five clones carry 16147C>T: clone_1 carries it alone, and clones 2, 3, 4 and 6 add 12889G>A, 9728C>T, 1227G>A and 6081G>A, the tumor’s subclones. The other five clones each carry one immune variant and hold immune cells of all three types. Total each type’s cells in the tumor clones and in the immune clones.

cell typeepithelialbasophil-likeT and NKmyeloidall immune
clones
tumor72319253882
immune038272590

Started: 2026-11-14T15:47:28.264343Z | Wall time: 0.010 s

The tumor clones hold all 723 epithelial cells with a clone, and also 82 immune cells, nearly as many as the 90 in the immune clones, while 16147C>T is detected confidently in only 5 to 9 deep cells of each immune type. Because the cosine ignores the level of a frequency, a single read of 16147C>T in an immune cell that shows no other informative variant gives the cell the pattern of clone_1. No clone carries 3244G>A, which is detected confidently in 5 cells, and the heatmap shows a few of its carriers in clone_2: a clone of fewer cells than a neighborhood can join the clone its cells resemble most, and a smaller n_neighbors keeps such small clones apart.

To check the resolution, call clones at the default of 1 as well, and count the clones whose cells carry 16147C>T alone.

ClonesCarrying 16147C>T alone
Resolution
1.00112
0.75101

Started: 2026-11-14T15:47:28.276937Z | Wall time: 1.441 s

At the default resolution of 1, the Leiden algorithm calls 11 clones, and two of them carry 16147C>T alone, a split that no variant supports. At 0.75, one clone carries 16147C>T alone, and each of the 10 clones carries a combination of variants of its own, so this page keeps 0.75. With other data, compare resolutions in the same way: a resolution set too high splits cells that carry the same variants into several clones, and one set too low merges clones that carry different variants.

UMAP of the analyzed cells colored by clone. The tumor clones, 1 to 4 and 6, mix across the epithelial cells and also color scattered cells among the basophil-like, T and NK, and myeloid cells; clones 5 and 7 to 10 are scattered over the immune cells only; and the cells without a clone, in gray and labeled NA, are most of the immune cells, the cells below the depth bound and the doublets.

Started: 2026-11-14T15:47:29.720428Z | Wall time: 0.198 s

The subclones mix across the epithelial cells on the UMAP, so their chromatin differs less than that of the cell types. The tumor-clone colors among the immune cells mark the 82 immune cells that the tumor clones hold.

Compare the cell types by their clones

Cell types that share clones descend from common ancestors. clones.coupling measures how much each pair of cell types shares clones with CoSpar’s default measure Wang et al., 2022, which lineage tracing defines. It measures the coupling again on cell types shuffled among the cells with a clone, which keeps each clone’s size and each type’s size, and reports each pair’s z-score: the coupling’s distance from the null mean, the mean of the shuffled couplings, in null standard deviations, positive when a pair shares clones more often than chance.

Heatmap of the coupling z-scores between the four cell types, red above chance and blue below, with a dendrogram above that joins the three immune types before the epithelial cells. The immune pairs score 0.98 to 1.3, and the epithelial cells score -3.3 with the basophil-like cells, -0.85 with the T and NK cells and -0.14 with the myeloid cells.

Started: 2026-11-14T15:47:29.920755Z | Wall time: 2.439 s

couplingnull_meanz_score
group_1group_2
basophil-likeepithelial0.180.68-3.27
epithelialT and NK0.540.66-0.85
myeloid0.680.71-0.14
basophil-likemyeloid0.740.590.98
myeloidT and NK0.750.581.17
basophil-likeT and NK0.780.581.35

Started: 2026-11-14T15:47:32.363004Z | Wall time: 0.012 s

The three immune types couple at 0.74 to 0.78, above their null means of 0.58 and 0.59, with z-scores of 0.98 to 1.35, about one standard deviation above chance, because each of the five immune clones holds cells of all three types. The epithelial cells share clones with the basophil-like cells far less often than chance, at 0.18 against 0.68, a z-score of -3.27, because the tumor clones hold 19 basophil-like cells and the immune clones 38. With the T and NK cells, at 0.54 against 0.66, and with the myeloid cells, at 0.68 against 0.71, the epithelial cells stay within one standard deviation of chance, at z-scores of -0.85 and -0.14, because the tumor clones hold about as many T and NK cells as the immune clones, 25 against 27, and more myeloid cells, 38 against 25.

The raw coupling of the epithelial and myeloid cells nearly matches that of the immune pairs, and only the comparison with the shuffled labels separates them, so this page draws the z-score.

Apply the analysis to other samples and libraries

  • With several samples or donors, pass within="donor" to variants.frequency_clones, so that no clone joins the cells of two people.

  • For MAESTER and other RNA libraries, select variants with preset="rna", which tests depth and base quality instead of strands.

  • Every clone summary, from diversity to fate bias, takes these clones, as the clones API reference describes. The variants API reference covers the other formats that variants.import_counts reads and the genotypes of targeted sites, from GoT, GIFT, Tapestri and DAb-seq.

References
  1. Lareau, C. A., Ludwig, L. S., Muus, C., Gohil, S. H., Zhao, T., Chiang, Z., Pelka, K., Verboon, J. M., Luo, W., Christian, E., Rosebrock, D., Getz, G., Boland, G. M., Chen, F., Buenrostro, J. D., Hacohen, N., Wu, C. J., Aryee, M. J., Regev, A., & Sankaran, V. G. (2020). Massively parallel single-cell mitochondrial DNA genotyping and chromatin profiling. Nature Biotechnology, 39(4), 451–461. 10.1038/s41587-020-0645-6
  2. Ludwig, L. S., Lareau, C. A., Ulirsch, J. C., Christian, E., Muus, C., Li, L. H., Pelka, K., Ge, W., Oren, Y., Brack, A., Law, T., Rodman, C., Chen, J. H., Boland, G. M., Hacohen, N., Rozenblatt-Rosen, O., Aryee, M. J., Buenrostro, J. D., Regev, A., & Sankaran, V. G. (2019). Lineage Tracing in Humans Enabled by Mitochondrial Mutations and Single-Cell Genomics. Cell, 176(6), 1325-1339.e22. 10.1016/j.cell.2019.01.022
  3. Stuart, T., Srivastava, A., Madad, S., Lareau, C. A., & Satija, R. (2021). Single-cell chromatin state analysis with Signac. Nature Methods, 18(11), 1333–1341. 10.1038/s41592-021-01282-5
  4. Traag, V. A., Waltman, L., & van Eck, N. J. (2019). From Louvain to Leiden: guaranteeing well-connected communities. Scientific Reports, 9(1). 10.1038/s41598-019-41695-z
  5. Wang, S.-W., Herriges, M. J., Hurley, K., Kotton, D. N., & Klein, A. M. (2022). CoSpar identifies early cell fate biases from single-cell transcriptomic and lineage information. Nature Biotechnology, 40(7), 1066–1074. 10.1038/s41587-022-01209-1