bioRxiv Science⌕ Search

bioRxiv · 10.64898/2025.12.29.696912

Python Encoders for Archetypal Convex Hulls (PEACH): PyTorch-Based Archetypal Analysis

Abstract

Samples of closely related cells often contain substantial cell state heterogeneity, which traditional clustering-based analyses struggle to de-convolve. Archetype analysis is an alternative analysis approach that identifies a minimal convex hull enclosing all data points in a dimensionally-reduced space, such as PCA space. The points of this convex manifold, or hull, each represent theoretical extremal states specialized in a subset of functions that are mutually exclusive to the extremal states found at each other vertex. The transition between two points represents a Pareto front of tradeoffs between potential cell states. Cell distances from each archetype and direction between archetypes then carry interpretable biological information revealing features of resource tradeoffs in cell state regulation. The archetypal points themselves are theoretical pure extremal states rarely accessed by real cells, which instead display a combination of archetype weights/mixture coefficients representing a mixture of specializations. By characterizing the relationships between gene expression and archetype distance, archetypal analysis can identify the phenotypic features of theoretically pure specialist states, the phenotypic tradeoffs of real cells, and the boundaries of accessible cell states in the analyzed sample. Here we present Python Encoders for Archetypal Convex Hulls (PEACH), a new PyTorch-based archetype analysis package compatible with the scVerse ecosystem that recapitulates and extends features available in previous archetype analysis packages. This includes a hyperparameter search function to identify the best k archetypes that fit an input dataset. PEACH uses a deliberately constrained autoencoder architecture to directly learn an archetypal latent space, replacing previous alternating least squares methods with a highly performant, GPU-accelerated archetype analysis method that is scalable to modern scRNAseq datasets of hundreds of thousands of cells. Crucially, PEACH includes automated hyperparameter search with cross-validation to identify optimal archetype and initialization configurations, enabling users to implement archetype analysis without extensive manual hyperparameter optimization and testing.

Explore related subjects

Keep this discovery

Explore connections, maps & timelines

BibTeXRIS

Honkala, A.. 2025-12-29. Python Encoders for Archetypal Convex Hulls (PEACH): PyTorch-Based Archetypal Analysis. https://doi.org/10.64898/2025.12.29.696912

Cite the original work for its findings. Save a collection to share your selection of sources.

KEEP EXPLORING

Related preprints

Concentration limits and localization of hydrogen peroxide in the extracellular space of solid tissues

H2O2 released to the extracellular space (ECS) regulates diverse physiological processes, yet its concentrations and spatial distribution in tissues remain poorly defined. This uncertainty hampers mechanistic understanding of redox signaling. Here, we used reaction-diffusion modeling to estimate extracellular H2O2 concentrations and transport ranges in various scenarios. Idealized analytical models were combined with numerical models incorporating localized NADPH oxidase (NOX) clusters, ECS microstructure, membrane permeability, and the thioredoxin- and GSH-dependent clearance systems. Using maximal neutrophil and NOX superoxide/H2O2 release rates, we obtained upper bounds for extracellular H2O2. Adjacent to isolated average-sized, fully active NOX2 clusters H2O2 peaked at ~540 nM at adhesion cell-cell separations, and decreased radially over ~50-100 nm. At the receptor cell surface, peak concentration decreased inversely with intercellular separation, to <5 nM at 1 m separation. Radial decrease here, for this wide separation, was over ~2.5 m. Even the former maximal extracellular concentrations induce just a minimal, highly localized oxidation of the intracellular Prdx, Trx and GSH pools. In turn, maximally activated neutrophils carry ~2000 such NOX2 clusters, inducing 10s of M peak ECS H2O2 concentrations. These cause extensive Prdx and Trx oxidation near the exposed membranes. However, the GSH-dependent system still sustains a strong transmembrane gradient if the permeation barrier remains intact, and ECS H2O2 concentrations decay to sub-M within a few m of the source cell. Extracellular H2O2 concentrations scaled linearly with source flux in all the examined conditions. These results establish stringent constraints on autocrine, juxtacrine and next-cell paracrine H2O2 signaling.

systems biology↗

LSD-pipeline: Causal Inference of miRNA Network Effects in Alzheimer's Disease

MicroRNAs (miRNAs) are implicated in Alzheimer's disease (AD), but research has focused on individual miRNAs and direct targets. Existing approaches to miRNA regulation in AD identify associations rather than causal effects, and few methods estimate multi-stage chains from miRNAs through target genes to target transcription factor (TF) cascades. We developed the LSD pipeline (LASSO-SEM-DoWhy), integrating LASSO feature selection, multi-stage structural equation modeling, and DoWhy causal inference to identify and validate miRNA causal pathways in AD. Applying LSD to six blood miRNA and brain mRNA datasets, we identified four LSD-validated miRNAs (miR-30d-5p, miR-92a-3p, miR-296-5p, miR-193a-5p) as AD biomarkers, achieving >86% ROC accuracy in an independent validation cohort. Several miRNAs with no significant direct association with AD showed significant effects when estimated through their target networks, while others significant in direct analysis were not supported at the network level, underscoring the value of network-level analysis. Extending to the TF layer revealed complete miRNA [->] targets [->] TF cascades [->] AD causal chains, with HMGA1, NKX2-3, and PRRX2 as key intermediaries. Confirmed classic pathways converge primarily on tau pathology and synaptic dysfunction. miRNA effects were largely age-independent, suggesting miRNAs act as early initiators of AD pathogenesis. Beyond AD, the LSD pipeline provides a generalizable framework for uncovering causal regulatory mechanisms in other diseases.

systems biology↗

PyKappa: Rule-based modeling in Python

Rule-based languages have proven effective for modeling systems of interacting structured entities as typically encountered in chemistry and molecular biology. We present PyKappa, a rule-based modeling package written in Python whose interpreted nature enables interactive simulation and analysis, including by agentic AI. The package seeks to broaden the base of developers by utilizing a widely known programming language and serves as an easy-to-deploy teaching tool. Using PyKappa, we conduct a case study of phase separation.

systems biology↗