Sovereign 8s.is mirror of standardgalactic/FeatureMAP
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Yang Yang 8b19315530 Remove deprecated gcn_stop_rw_tol and auto_hybrid_rw
The `gcn_stop_rw_tol` constructor param and `auto_hybrid_rw` stop-mode
alias were already documented as deprecated and ignored. Drop the param,
the alias, the two warning paths, the docstring entry, and the two
warning-only tests. Package is at v0.0.3 with no external installed base.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-04-26 18:50:19 +10:00
BEELINE-data Update optional dependency metadata 2026-04-18 13:51:58 +10:00
datasets update notebook of pancreas 2024-05-27 14:26:00 +10:00
docs Update optional dependency metadata 2026-04-18 13:51:58 +10:00
featuremap Remove deprecated gcn_stop_rw_tol and auto_hybrid_rw 2026-04-26 18:50:19 +10:00
.DS_Store Update optional dependency metadata 2026-04-18 13:51:58 +10:00
.gitignore add gitignore 2026-04-08 11:51:22 +10:00
.readthedocs.yaml added package installation for docs 2024-05-28 13:35:40 +10:00
LICENSE Syn at office from home 2024-05-17 10:43:00 +10:00
pyproject.toml Update optional dependency metadata 2026-04-18 13:51:58 +10:00
README.md Update citation for FeatureMAP algorithm 2026-04-17 22:20:34 +10:00

FeatureMAP Illustration

FeatureMAP: Feature-preserving Manifold Approximation and Projection

Visualizing single-cell data is essential for understanding cellular heterogeneity and dynamics. FeatureMAP enhances this process by introducing gene projection and transition/core states, providing deeper insights into cellular states. While traditional methods like UMAP and t-SNE effectively capture clustering, they often overlook critical gene-level information. FeatureMAP addresses this limitation by integrating concepts from UMAP and PCA, preserving both clustering structures and gene feature variations within a low-dimensional space.

Description

FeatureMAP presents a novel approach by enhancing manifold learning with pairwise tangent space embedding, ensuring the retention of crucial cellular data features. It introduces two visualization plots: expression embedding (GEX) and variation embedding (GVA).

Here, we demonstrate its effectiveness using a synthetic dataset from (BEELINE) based on a bifurcation model. Compared to UMAP, FeatureMAP-GEX better preserves cell density, while FeatureMAP-GVA clearly delineates developmental paths.

Transition and Core States

Besides the two-dimensional visualization, FeatureMAP presents three key concepts:

  1. Gene Projection: Estimating and projecting gene feature loadings, where arrows indicate the direction and magnitude of gene expression changes. Gene Projection

  2. Transition and Core States: Transition and core states are computationally defined based on cell density, curvature, and betweenness centrality. Transition states are characterized by the lowest cell densities, maximal curvature, and highest betweenness centrality, whereas core states exhibit the highest cell densities, minimal curvature, and lowest betweenness centrality.

    Transition and Core States
  3. Differential Gene Variation (DGV) Analysis: The third concept introduces differential gene variation (DGV) analysis, which compares transition and core states to identify genes with significant variability. By quantifying gene variation between dynamic transition states and stable core states, DGV highlights regulatory genes likely driving cell-state transitions and differentiation.

    DGV

FeatureMAP, a feature-preserving method, enhances the visualization and interpretation of single-cell data. Through analyses of both synthetic and real scRNA-seq data (TUTORIAL), FeatureMAP effectively captures intricate clustering structures and identifies key regulatory genes, offering significant advantages for single-cell data analysis.

Getting Started

Dependencies

  • Python 3.8 or higher
  • Required Python libraries: numpy, scipy, matplotlib, umap-learn, scikit-learn
  • Operating System: Any (Windows, macOS, Linux)

Installation

Install directly using pip:

pip install featuremap

How to use FeatureMAP

Data Visualization

To apply FeatureMAP in Python with a data matrix (data), where rows represent cells and columns represent genes, use the following command:

import featuremap
v_emb = featuremap.FeatureMAP(output_variation=True).fit_transform(data)
x_emb = featuremap.FeatureMAP(output_variation=False).fit_transform(data)


Parameters:

output_variation: bool (False by default). Decide to generate expression embedding or variation embedding.

Outputs

x_emb: expession embedding to show the clustering

v_emb: variation embedding to show the trajectory

Documentation

More tutorials are at https://featuremap.readthedocs.io/en/latest/index.html.

Citation

Our FeatureMAP alogrithm is based on the paper

Yang, Y., Gong, J., Sun, H. et al. Feature-preserving manifold approximation and projection to analyze single-cell data. Nat Comput Sci (2026). https://doi.org/10.1038/s43588-026-00970-6

License

The FeatureMAP package is under BSD-3-Clause license.