Skip to content

Latest commit

 

History

317 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HiMaLAYAS

Python PyPI License Tests

Hierarchical Matrix Layout and Annotation Software (HiMaLAYAS) is a framework for post hoc enrichment-based annotation and visualization of hierarchically clustered matrices. HiMaLAYAS treats dendrogram-defined clusters as statistical units, tests categorical annotations for enrichment, controls multiple testing, and renders significant annotations alongside clusters. HiMaLAYAS supports both biological and non-biological domains.

For a full description of HiMaLAYAS and its applications, see:
Horecka, I., and Röst, H. (2026)
HiMaLAYAS: enrichment-based annotation and visualization of hierarchically clustered matrices
bioRxiv. https://www.biorxiv.org/content/10.64898/2026.02.11.705303v3
Submitted to Bioinformatics Advances.

Documentation and Tutorials

Installation

HiMaLAYAS is compatible with Python 3.8 or later and runs on major operating systems.

pip install himalayas
# Optional: faster clustering + richer compressed-label text processing
pip install "himalayas[speed,text]"

Detailed installation options and fallback behavior are documented at himalayas-base.github.io/himalayas-docs/1_installation.

Key Features of HiMaLAYAS

  • Matrix-Based Input: Works with real-valued matrices representing relationships among observations.
  • Configurable Clustering: Supports linkage method, distance metric, dendrogram distance threshold, and minimum cluster size settings.
  • Cluster-Level Enrichment Testing: Treats dendrogram-defined clusters as statistical units and tests categorical annotations for enrichment.
  • Multiple-Testing Control: Controls false discovery rate across cluster-term tests.
  • Annotation-Aware Visualization: Renders significant annotations alongside clustered matrices.
  • Zoomed and Condensed Views: Supports zoomed cluster reanalysis, condensed hierarchy views, and post hoc row data tracks.
  • Publication-Ready Output: Exports configurable figures in raster or vector formats.

Example Usage

We applied HiMaLAYAS to a hierarchically clustered Saccharomyces cerevisiae genetic interaction profile similarity matrix (Costanzo et al., 2016), focusing on 1,053 genes with high profile variance. Dendrogram-defined clusters were tested for Gene Ontology Biological Process (GO BP; Ashburner et al., 2000) enrichment, with top-ranked significant annotations rendered alongside clusters.

Figure 1 HiMaLAYAS workflow and application to a hierarchically clustered yeast genetic interaction profile similarity matrix (Costanzo et al., 2016). A real-valued matrix and categorical annotations serve as inputs. HiMaLAYAS hierarchically clusters the matrix, cuts the dendrogram at a user-defined distance threshold, tests categorical annotations for enrichment, controls multiple testing, and renders significant annotations alongside clusters.

Citation

Primary citation

Horecka, I., and Röst, H. (2026)
HiMaLAYAS: enrichment-based annotation and visualization of hierarchically clustered matrices
bioRxiv. https://www.biorxiv.org/content/10.64898/2026.02.11.705303v3
Submitted to Bioinformatics Advances.

Software archive

HiMaLAYAS software archive.
Zenodo. https://doi.org/10.5281/zenodo.18610373

Contributing

We welcome contributions from the community:

Support

If you encounter issues or have suggestions for new features, please use the Issues Tracker on GitHub.

License

This project is distributed under the BSD 3-Clause License.

Releases

Packages

Contributors

Languages