Release Notes

Version 0.2.0 (2026)

The API now names functions after the quantities they actually compute:

calculate_spatial_distribution → calculate_niche_density_ratio. The function computes, per cell and per reference niche, a softmax over log p(e|z) − log p(e) — i.e. a density ratio p(e|z)/p(e) of the environment given the cell state versus its marginal. Docstring now states this explicitly.
aggregate_dist_e → calculate_niche_cluster_membership. The output is a per-cell soft membership over niche clusters (which niche cluster each cell most likely belongs to).
analyze_niche_composition → analyze_niche_membership.
Internal helpers cluster_niche_composition / visualize_niche_composition renamed to cluster_cells_by_niche_membership / plot_niche_membership_clustermap.
Old names are removed (no deprecation aliases). Update call sites to the new names.

analyze_niche_membership previously called the clustermap function twice when file_path was provided.

adata.obsm['dist_e'], adata.uns['dist_e'], adata.obsm['dist_e_agg'], and adata.obs['niche_composition_cluster'] keys are unchanged, so existing h5ad artifacts and downstream figure scripts continue to work.

Initial release of Mievformer.

Core Model Functions
- optimize_nicheformer: Train the Mievformer model with masked self-supervised learning
- calculate_wb_ez: Calculate weight and bias terms for downstream analysis
Distribution Analysis (renamed in 0.2.0; original names shown)
- calculate_spatial_distribution: Compute spatial distribution of cells across microenvironments
- aggregate_dist_e: Aggregate distribution embeddings
Downstream Analysis (renamed in 0.2.0; original names shown)
- estimate_population_density: Estimate cell population density in microenvironments
- analyze_density_correlation: Analyze correlation between density and gene expression
- analyze_niche_composition: Cluster and visualize niche composition