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.

Lineage recorders

Cut the reconstructed cell phylogeny of a mouse embryo into clones every half day from embryonic day 5.0 (E5.0) to E7.0, and measure at each cut which cell types share clones more often than chance. The embryo, E7.5-R1, was collected at E7.5 and profiled by single-cell RNA sequencing, and 1,032 of its 1,342 cells carry the PEtracer lineage recorder Koblan et al., 2025, whose edits Colgan et al. (2026) used to build two clone trees. At E5.0 the clones of two or more cells span five cell types on average, and no pair of types stands out. By E6.5 those clones span 1.7 cell types on average, and two pairs share clones far more often than shuffled cell types would: the extraembryonic mesoderm with the hematoendothelial progenitors, 3.9 standard deviations above the mean of the shuffles, and the epiblast with the primitive streak, 3.6 above it. The cell types of each pair still shared ancestors alive at E6.5.

A lineage recorder writes heritable edits into target sites of the genome as cells divide, so the edits that cells share record their common ancestors. Tree builders reconstruct a phylogeny from the edits: a tree whose leaves are the sampled cells and whose internal nodes are their ancestors. Cutting the tree at a time groups the cells into clones, the descendants of each lineage alive at that time, and cell types that share clones descend from common ancestors. PEtracer’s prime editor writes one of eight five-base insertions, the lineage marks, into the three sites of each integrated copy of its target cassette. The embryo is a chimera: its donor cells descend from injected stem cells that carry the recorder, and its host cells carry none.

This page is one of four on clonal analysis with ds.clones, and here the clones come from trees that a recorder’s edits reconstruct. Lineage tracing follows clones that lentiviral LARRY barcodes mark in mouse hematopoiesis over days 2, 4 and 6, mitochondrial lineage tracing calls clones in a human tumor from somatic mitochondrial DNA variants, and the immune repertoires page groups T and B cells into clonotypes by their receptor chains. Each cut is saved in the store as an artifact, a result recorded with its inputs and parameters, so the clone summaries of ds.clones, from clone sizes to coupling, read the clones of a cut like those of the other three pages.

Download the embryo

GEO series GSE342226 holds embryo E7.5-R1 in two samples: GSM9925879, its expression matrix, and GSM9925880, its character matrix of each cell’s marks and the two trees that the authors reconstructed. The authors also released the data under the MIT License as the Mouse Embryonic Lineage Atlas on Zenodo, with a table of their cell annotation. That table covers every embryo of the atlas and lists the donor cells of E7.5-R1 first, so an HTTP range request downloads only its header and those rows, 0.186 MB. The downloads take 34 MB together. The downloads and the store go to a temporary directory; use a project directory to keep them.

Started: 2026-11-12T17:19:11.164450Z | Wall time: 2.890 s

E7.5-R1_matrix.mtx.gz 33.505 E7.5-R1_features.tsv.gz 0.637 E7.5-R1_barcodes.tsv.gz 0.008 E7.5-R1_characters.csv.gz 0.027 E7.5-R1-C1.nwk.gz 0.017 E7.5-R1-C2.nwk.gz 0.004 E7.5-R1_donor_cells.csv 0.186 Total 34.384 Name: Downloaded MB, dtype: float64

Started: 2026-11-12T17:19:14.056924Z | Wall time: 1.700 s

Build the expression store

The expression matrix holds the UMI counts of 78,258 genes in the 1,342 cells that the authors kept, donor and host. The store built from it holds the cells to which the marks, trees and clones below attach.

DataStore has 1342 (1342) cells with 1 assays: RNA Cell metadata: 'I', 'ids', 'names', 'RNA_nCounts', 'RNA_nFeatures', 'RNA_percentMito', 'RNA_percentRibo' RNA assay has 78258 features and following metadata: 'I', 'ids', 'names', 'dropOuts', 'feature_type', 'nCells'

Started: 2026-11-12T17:19:15.759833Z | Wall time: 14.816 s

The authors annotated the donor cells only. Label each donor cell with its cell type and each host cell as host, in a cell_type column that later steps group the cells by.

Cells
Cell type
Nascent mesoderm325
host310
Rostral ectoderm215
Epiblast175
Extraembryonic mesoderm134
Primitive streak91
Definitive endoderm39
Hematoendothelial progenitor32
Notochord17
Primordial germ cell3
Prechordal plate1

Started: 2026-11-12T17:19:30.579929Z | Wall time: 0.059 s

The donor cells fall into 10 cell types, from 325 cells of nascent mesoderm to a single prechordal plate cell, beside 310 host cells. Place the cell types on a UMAP with the RNA recipe, ds.pipeline.rna, which selects variable genes, normalizes them, reduces them with PCA, then embeds and clusters the cells. The recipe returns a pipeline run, the saved record of its steps, and run["umap"] is the UMAP that the run saved. The authors already filtered these cells, so filtering=False keeps all of them.

UMAP of the 1,342 cells of embryo E7.5-R1 colored by cell type: the rostral ectoderm at the top above the epiblast, the primitive streak along the left edge, the nascent mesoderm running down to the extraembryonic mesoderm and the hematoendothelial progenitors at the bottom, small groups of notochord and definitive endoderm, and most host cells in a separate group on the right.

Started: 2026-11-12T17:19:30.643951Z | Wall time: 137.752 s

The UMAP places the epiblast between the rostral ectoderm and the primitive streak, and the primitive streak leads through the nascent mesoderm to the extraembryonic mesoderm and the hematoendothelial progenitors, in the order in which gastrulation produces these cell types. Most host cells, which the annotation leaves untyped, form a group of their own. The clone trees below show which of these cell types also share ancestors.

Read the character matrix

PEtracer’s character matrix holds one row per cell and one column per site. Each column is named by its integration (one integrated copy of the cassette) and its site (EMX1, HEK3 or RNF2, the cassette’s three target sites), as in intID250-EMX1. An entry is * for an unedited site, 1 to 8 for a lineage mark, ! for an unknown mark (an insertion other than the eight marks) and - for a site that was not read. clones.import_alleles recognizes the format and joins each row to the cell of the same ID. The import takes the cells as a frozen cell selection, a saved list of cells that the imported alleles record as the cells they were joined to. ds.snapshot_cell_selection("I") freezes the cells of the cell key I, here every cell of the store.

n_integrationsn_edits
minmedianmaxminmedianmax
Origin
Donor2933.0333447.064
Host00.0000.00

Started: 2026-11-12T17:21:48.400211Z | Wall time: 0.680 s

Each donor cell reads 29 to 33 of the 33 integrations and holds an edit at 34 to 64 of the 99 sites, while the host cells, which carry no recorder, read none. The sites differ in how many of the cells that read them carry an edit.

Stacked bars for the 40 of the 99 sites read in the most cells, every second bar named by its integration and site, such as intID250-EMX1, giving the fraction of cells that hold a mark, an unknown mark, an unedited site or no read. The host cells form the missing 23% at the bottom of every bar, and the marked share above it ranges from a few percent of the cells at some sites to every donor cell at others; unknown marks are too rare to see.

Started: 2026-11-12T17:21:49.084829Z | Wall time: 0.685 s

min50%max
site
EMX10.000.230.91
HEK30.000.431.00
RNF20.040.841.00

Started: 2026-11-12T17:21:49.772524Z | Wall time: 0.136 s

The cassette’s three sites fill at different rates: the median RNF2 site is edited in 84% of the cells that read it, the median HEK3 site in 43% and the median EMX1 site in 23%. A fast site is mostly edited within the first divisions, so its marks separate the early lineages, while a slow site keeps unedited copies that later divisions can still mark; together the three sites record both early and late branching.

Export the characters for tree builders

CyteArc reads trees but does not build them. clones.export_characters writes the marks as a character matrix for tree builders: by default a TreeData store for Cassiopeia Jones et al., 2020, or with format="laml" a CSV for LAML Mai et al., 2024. Cells that read no site are left out.

{'cells': 1032, 'characters': 99, 'cellsWithSeveralAlleleRows': 0}

Started: 2026-11-12T17:21:49.911561Z | Wall time: 1.231 s

The export holds the 1,032 donor cells and 99 characters, one per site.

Import the clone trees

Colgan et al. (2026) built one tree per founder clone, the descendants of one injected stem cell, and E7.5-R1 holds two such trees. Their branch lengths are developmental time in days, from day 0 at each root to day 7.5 at the leaves, the embryo’s age at collection, so the time of a node estimates the embryonic day of that ancestor’s division. The stem cells were injected into host embryos of four to eight cells, at about E2, so the times of the first two branchings of the larger tree, before day 2, are not embryonic days. clones.import_phylogeny reads the Newick files and joins each leaf to its cell, and time_unit="days" declares the unit, which the files do not state.

310 cells are in no tree
treen_nodesn_leavesn_cellsroot_timeearliest_leaf_timelatest_leaf_time
0E7.5-R1-C114848508500.07.4999917.500007
1E7.5-R1-C23031821820.07.4999907.500000

Started: 2026-11-12T17:21:51.145654Z | Wall time: 2.799 s

The two trees hold 850 and 182 cells, together the 1,032 donor cells, and every leaf ends at day 7.5. The 310 cells in no tree are the host’s.

Cut the trees into clones

clones.phylogeny_clones makes one cut at a given time. Cut every half day from E5.0 to E7.0, the last cut half a day before the embryo was collected, and describe the clones of each cut.

ClonesClones of 2 or more cellsCells in themLargest cloneCell types per clone of 2 or more cells
E5.048411025585.3
E5.51271121017513.6
E6.0289219962222.4
E6.558626270881.7
E7.09477816341.3

Started: 2026-11-12T17:21:53.951219Z | Wall time: 1.668 s

The later the cut, the more and the smaller the clones. At E5.0 the donor cells fall into 48 clones of up to 58 cells, and the 41 clones of two or more cells span 5.3 cell types on average. At E7.0 they fall into 947 clones of up to four cells, and only 78 of them hold two or more cells, 163 cells in all, spanning 1.3 cell types on average.

The two clone trees on a time axis from day 0 to day 7.5, the larger tree, E7.5-R1-C1, above the smaller, E7.5-R1-C2, with a dashed line at day 5. The larger tree branches a few times between days 0.6 and 4, the smaller not until about day 4.4, and most branch points before the cut fall between days 4 and 5. Each of the 48 clones of the cut is a wedge from its first branching to its cells at day 7.5, or a line for a clone of one cell, and the legend names the 19 largest.

Started: 2026-11-12T17:21:55.624170Z | Wall time: 11.600 s

Each wedge is one clone of two or more cells, drawn from the last common ancestor of its cells to day 7.5, and the legend names the largest clones by their tree and the name of each clone’s root node in the authors’ tree files, such as E7.5-R1-C1/cPJid3n6. The trees branch only a few times before day 4, and most of their branching before the cut falls between days 4 and 5, so the cut at day 5 already crosses 48 lineages.

Measure coupling at each cut

clones.coupling measures how much two cell types share clones with CoSpar’s default measure Wang et al., 2022, which lineage tracing defines. It then 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. Measure the eight cell types of 10 or more donor cells, leaving out three primordial germ cells and one prechordal plate cell.

E5.0E5.5E6.0E6.5E7.0
group_1group_2
Extraembryonic mesodermHematoendothelial progenitor0.01.03.33.92.2
EpiblastPrimitive streak1.61.12.73.61.5
Rostral ectoderm0.10.51.71.21.0
Definitive endodermNotochord-1.2-0.31.0-0.4-0.3
Nascent mesodermPrimitive streak-1.0-0.3-0.2-1.00.8

Started: 2026-11-12T17:22:07.228765Z | Wall time: 3.646 s

No pair stands out at E5.0, where the highest z-score is 1.6. At E6.0 and E6.5 the extraembryonic mesoderm couples with the hematoendothelial progenitors, and the epiblast with the primitive streak, 2.7 to 3.9 standard deviations above the mean of their shuffles. Plotting the coupling and the z-score of each pair across the cuts shows why the cuts are compared by z-score.

Two line charts of the 28 pairs of measured cell types at the five cuts from E5.0 to E7.0. On the left, the coupling, the cosine of clone shares, falls toward 0 for every pair by E7.0; the epiblast with the primitive streak, in blue, starts highest, above 0.5 at E5.0. On the right, the z-score against shuffled cell types, with a line at 0: the extraembryonic mesoderm with the hematoendothelial progenitors, in orange, and the epiblast with the primitive streak, in blue, rise to 3.9 and 3.6 at E6.5 and fall back at E7.0, while the other 26 pairs, in gray, stay below 2 and mostly below 0.
Median couplingMedian shuffled meanPairs above their shuffled mean, of 28
Cut
E5.00.220.306
E5.50.110.154
E6.00.030.066
E6.50.010.024
E7.00.000.004

Started: 2026-11-12T17:22:10.878282Z | Wall time: 0.439 s

The coupling of every pair falls toward 0 at later cuts because the clones shrink: the clones of two or more cells hold 1,025 cells at E5.0 and 163 at E7.0. Shuffling keeps each clone’s size, so the shuffled couplings fall as the clones shrink: from E5.0 to E7.0 the median coupling of the 28 pairs drops from 0.22 to 0.00, and the median of their shuffled means from 0.30 to 0.00. The z-score, which compares each cut with its own shuffles, is therefore the value to compare across cuts. The two highlighted pairs peak at E6.5 and fall back at E7.0, to 2.2 and 1.5, when only 78 clones hold two or more cells.

Heatmap of the coupling z-scores of every pair of the eight cell types at E6.5, red above 0 and blue below, with a dendrogram of average linkage on the couplings themselves above it: one branch joins the epiblast, the primitive streak, the rostral ectoderm and the nascent mesoderm, the other the extraembryonic mesoderm, the hematoendothelial progenitors and the definitive endoderm, and the notochord joins last. The extraembryonic mesoderm with the hematoendothelial progenitors, 3.9, and the epiblast with the primitive streak, 3.6, are highest; the rostral ectoderm with the extraembryonic mesoderm, -4.7, and with the nascent mesoderm, -4.4, are lowest. Only four pairs are above 0.

Started: 2026-11-12T17:22:11.323271Z | Wall time: 0.603 s

At E6.5 the dendrogram, which average linkage builds from the couplings rather than their z-scores, joins the epiblast with the primitive streak and the rostral ectoderm, and the extraembryonic mesoderm with the hematoendothelial progenitors, which give the first blood and vessels. The rostral ectoderm shares far fewer clones with the mesoderm than shuffled labels would: its coupling with the extraembryonic and with the nascent mesoderm lies more than 4 standard deviations below the mean of the shuffles.

All but four pairs sit below 0 at E6.5, and at every cut only 4 to 6 of the 28 pairs couple above their shuffled mean. Shuffled labels spread each cell type over the clones in proportion to the clones’ sizes, while real clones favor some cell types over others: at E6.5 the clones of two or more cells hold 1.7 cell types on average. The pairs that share clones then rise above 0 and most other pairs fall below 0, so read the order of the z-scores more than their sign.

Cutting the timed trees every half day turns one embryo into a time course of clones. From E5.0 to E6.5 the clones of two or more cells narrow from 5.3 cell types on average to 1.7, and two pairs stand out: the extraembryonic mesoderm with the hematoendothelial progenitors and the epiblast with the primitive streak still shared ancestors alive at E6.5, while the rostral ectoderm had separated from the nascent and extraembryonic mesoderm.

Analyze your own recorder

  • To analyze your own recorder, export its characters as above, build trees with Cassiopeia or LAML, and import them with clones.import_phylogeny. Trees whose branch lengths are not times take time_unit=None and are cut at a number of branchings below each root with phylogeny_clones(phylogeny, depth=...).

  • Without trees, clones.allele_clones links the cells that share a rare allele into clones, with DARLIN’s allele-frequency threshold (method="graph") or CARLIN’s test of whether an allele arose more than once (method="p_clonal").

  • With clones sampled at several time points, lineage tracing labels early cells by the fates that their clones took and tests a fate map against them.

  • The clones API reference lists the recorder formats that import_alleles reads, from DARLIN to DNA Typewriter, and every clone summary that reads these clones.

References
  1. Koblan, L. W., Yost, K. E., Zheng, P., Colgan, W. N., Jones, M. G., Yang, D., Kumar, A., Sandhu, J., Schnell, A., Sun, D., Ergen, C., Saunders, R. A., Zhuang, X., Allen, W. E., Yosef, N., & Weissman, J. S. (2025). High-resolution spatial mapping of cell state and lineage dynamics in vivo with PEtracer. Science, 390(6770), eadx3800. 10.1126/science.adx3800
  2. Colgan, W. N., Koblan, L. W., Villagrana, J., Hou, T.-C. J., Wang, M., Gowri, G., Chandler, W., Sepúlveda, L. A., Ciftci, D., Smolyar, K., Yost, K. E., Young, A., Wittler, L., Markoulaki, S., Loh, K. M., Zhuang, X., Yosef, N., Smith, Z. D., & Weissman, J. S. (2026). Comprehensive lineage tracing maps the landscape of cell fate decisions in mouse embryogenesis. Cell, 189(22), 7154-7176.e20. 10.1016/j.cell.2026.09.050
  3. Jones, M. G., Khodaverdian, A., Quinn, J. J., Chan, M. M., Hussmann, J. A., Wang, R., Xu, C., Weissman, J. S., & Yosef, N. (2020). Inference of single-cell phylogenies from lineage tracing data using Cassiopeia. Genome Biology, 21(1), 92. 10.1186/s13059-020-02000-8
  4. Mai, U., Chu, G., & Raphael, B. J. (2024). Maximum Likelihood Inference of Time-scaled Cell Lineage Trees with Mixed-type Missing Data. openRxiv. 10.1101/2024.03.05.583638
  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