Changelog#
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[0.4.0] - 2026-10-07#
Added#
pycea.datasets.colgan26andpycea.datasets.yu26load mouse embryo lineage tracing datasets.Added a mouse embryogenesis tutorial using the
colgan26dataset (docs/notebooks/mouse-embryo.ipynb).pycea.tl.ancestral_linkagenow storestdata.uns['{key_added}_symmetrized_linkage_stats']whensymmetrizeis notFalseandtest='permutation': a table with one row per unordered category pair giving the symmetrized value, permuted value, z-score, and a p-value for the symmetrized linkage.
Changed#
pycea.tl.ancestral_statessupports boolean data (obscolumns orobsmarrays). Formethod='mean'and'sum',TrueandFalseare treated as 1 and 0, giving the fraction and number ofTrueleaves.pycea.tl.ancestral_linkagein single-target mode stores per-cell results intdata.obs['{key_added}_linkage']whenkey_addedis specified, instead oftdata.obs['{target}_linkage'].depth_keynow defaults totdata.uns['default_depth'](falling back to'depth') inpycea.tl.clades,n_extant,tree_distance,tree_neighbors,ancestral_linkageandfitness, matchingpycea.pl.
Fixed#
pycea.tl.tree_neighborswithmetric='path'andn_neighborsnow returns the closest leaves. Previously leaves were collected on discovery rather than in distance order, so farther leaves could displace closer ones. Ties in distance are now also broken randomly.pycea.tl.tree_neighborswith a single observation inobsnow marks the neighbors of that observation intdata.obs['{key_added}_neighbors']instead of only the observation itself.
[0.3.0] - 2026-07-08#
Added#
pycea.tl.parsimonyandpycea.tl.fitch_countfor small-parsimony scoring and the FitchCount transition-count algorithm (migrated from Cassiopeia) (#59)pycea.pl.ancestral_linkagefor plotting the pairwise linkage matrix as a clustered heatmap (#58)Added fast
"sum"method topycea.tl.ancestral_states(#54, #56)Added additional node ploting customization -
outline_widthand option to directly specify color with hex code (#53)pycea.tl.ancestral_linkagefor computing relatedness of cells in different categories, with options for pairwise or target-category linkage permutation testing, and normalization. (#52, #55, #58)Added
angle_rangeparameter for plotting polar trees withpycea.pl.treeandpycea.pl.branches(#51)
Changed#
Added support for
tdata.alignment != 'leaves'to relevant functions inpycea.plandpycea.tl(#50)Vectorized continuous color computation in
pycea.pl.treeandpycea.pl.branchesfor improved node plotting performance (#48)
Fixed#
Fixed
IndexErrorretrievingvar_names/layer data underanndata>=0.13by indexing the column directly instead of via the deprecatedobs_vector(#58)pycea.get.palettenow correctly collects unique categories across all columns of array data, not just the first column (#57)Fixed bug in LCA distance computation when for non-ultrametric tree (#49)
Legend placement now works with tight and constrained layouts (#45)
[0.2.0] - 2025-11-14#
Added#
Added
pycea.tl.expansion_testfor computing expansion p-values to detect clades under selectionpycea.tl.partition_testto test for statistically significant differences between leaf partitions. (#40)pycea.tl.expansion_testfor computing expansion p-values to detect expanding clades. (#38)
Changed#
Replaced
tdata.obs_keys()withtdata.obs.keys()to conform with anndata API changes. (#41)pycea.tl.fitnessno longer returns a multi-indexed DataFrame whentdatacontains a single tree. (#38)
Fixed#
Fixed node plotting when
isinstance(nodes,str). (#39)
[0.1.0] - 2025-09-19#
Added#
pycea.getmodule for data retrieval (#32)Added
pycea.tl.n_extantandpycea.pl.n_extantfor calculating and plotting the number of extant lineages over time (#33)Added
pycea.tl.fitnessfor estimating fitness of nodes in a tree (#35)
Changed#
Only require
treeparameter to be specified when trees intdataactually overlap (#37)
Fixed#
Sorting now preserves edge metadata (#31)
[0.0.1]#
Added#
Basic tool, preprocessing and plotting functions