Skip to main content

A tool to view HDF5 file structures in the terminal.

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

h5forest-1.0.2.tar.gz (191.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

h5forest-1.0.2-py3-none-any.whl (85.5 kB view details)

Uploaded Python 3

File details

Details for the file h5forest-1.0.2.tar.gz.

File metadata

  • Download URL: h5forest-1.0.2.tar.gz
  • Upload date:
  • Size: 191.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.8.18

File hashes

Hashes for h5forest-1.0.2.tar.gz
Algorithm Hash digest
SHA256 3ce787930e0410b81c7e4def6662d615217b4bae3cb1429b5be9f7df2267a35d
MD5 e6c057353f73fc71429c37f6f0f3b637
BLAKE2b-256 48c18c9088f67ca9bf6e564d1f4886944251c63d87a84331952790529afd8e70

See more details on using hashes here.

File details

Details for the file h5forest-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: h5forest-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 85.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.8.18

File hashes

Hashes for h5forest-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 1ebc75283fa9a648eea5ca6515d4ac7bad3e9980e8cb901e5cc0f149a698f0c8
MD5 d8ad6666f97f60a5ce6d80a5263eadf9
BLAKE2b-256 2baaee8bd72ae4788c4cdba40522a4dab8b2b3e92a827ed9b9c017ddbcb6c681

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page