Skip to content

An interactive CLI application for exploring HDF5 files.

License

Notifications You must be signed in to change notification settings

WillJRoper/h5forest

Repository files navigation

h5forest

PyPI - Version PyPI downloads Python versions License: GPL v3 Contributions welcome Test Suite codecov Code style: ruff pre-commit

HDF5 Forest (h5forest) is a Text-based User Interface (TUI) for exploring HDF5 files.

h5ls works, and h5glance is a great improvement, so "Why bother?" I hear you ask.

Well, h5forest brings interactivity and new functionality not available in its long-standing brethren. h5forest includes:

SCR-20241021-belp

  • An interactive interface capable of handling large files with deep hierarchies.
  • Fully asynchronous operation for a blazingly fast (🔥) and responsive feel.
  • A real-time metadata and attribute display.
  • Memory efficiency with lazy loading.
  • Peeking inside Datasets.
  • On-the-fly statistics.
  • Fuzzy search with real-time filtering to quickly find datasets and groups.
  • A fully terminal-based interface with optional vim-style navigation (configurable in ~/.h5forest/config.yaml).

For more details read the documentation for installation, usage guides, and examples.

Getting started

h5forest can be installed through pip:

pip install h5forest

You will now have the h5forest command installed. Simply run

h5forest /path/to/hdf5/file.hdf5

on the command line to get started exploring a file.

Testimonials

"This is the most compelling and useful procrastination I've ever seen" - Frustrated collaborator waiting for actual work to be done.

"Why has no one done this before? Let’s nominate him for a peerage." - Professor incapable of peerage nomination.

"Nice" - PhD supervisor.

About

An interactive CLI application for exploring HDF5 files.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages