h5glance

Explore HDF5 files in an HTML view

These details have not been verified by PyPI

Project links

Project description

H5Glance lets you explore HDF5 files in the terminal or an HTML interface.

Install it with:

pip install h5glance

In the terminal, you can get a tree view of a file:

$ h5glance sample.h5
sample.h5
└path
  └inside
    └file   [float64: 100 × 100]

The names of datasets, groups and links are colour-coded by default. If you want to disable this, set the environment variable H5GLANCE_COLORS=0. H5Glance also respects the NO_COLOR convention.

Inspect a group or dataset inside it:

$ h5glance sample.h5 path/inside/file
sample.h5/path/inside/file
      dtype: float64
      shape: 100 × 100
   maxshape: 100 × 100
     layout: Contiguous

sample data:
[[-0.27756437  0.36923643 -0.28113527 ...

In bash & zsh, h5glance offers tab-completion for the paths inside HDF5 files. To set this up, run:

python -m h5glance.completer

Alternatively, use - as the second argument, and h5glance will prompt you for the object path with tab completion:

$ h5glance sample.h5 -
Object path: sample.h5/  # try tapping tab

HTML interface

The HTML interface lets you inspect HDF5 files in a Jupyter Notebook. Demo.ipynb shows how to use it.

Why H5Glance?

There are plenty of other tools to view HDF5 files, including HDFView and ViTables, as well as various web-based viewers in development. Why might you choose H5Glance?

Practical terminal interface: if you’re working in a terminal, it’s much quicker to use something there than to start a GUI application and click through it.
- Tab completions are part of this - take a moment to set them up (see above).
Static Jupyter views: H5Glance shows your HDF5 objects in simple HTML, which doesn’t talk to the server. Export your notebook to HTML, or view it on nbviewer, and the H5Glance view is still there.
Deeply nested structure: It was written at European XFEL, where data files can easily have 6 layers of nested groups. It tries to make working with that easy.

Some things it’s not designed for:

Viewing data: The terminal interface can show raw data, but it focuses on the structure of HDF5 files, not their content. H5Glance won’t show you plots or images.
Machine-readable output: It’s meant for people, not programs. In Python, your code can use h5py. For shell pipelines, use tools like h5ls and h5dump.

Project details

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

This version

0.9.0

Nov 19, 2024

0.8.1

Feb 15, 2023

0.8

May 23, 2022

0.7

May 27, 2020

0.6

Aug 16, 2019

0.5

Feb 23, 2019

0.4

Oct 19, 2018

0.3

Sep 30, 2018

0.2

Sep 11, 2018

0.1

May 8, 2018

Download files

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

Source Distribution

h5glance-0.9.0.tar.gz (22.2 kB view details)

Uploaded Nov 19, 2024 Source

Built Distribution

h5glance-0.9.0-py3-none-any.whl (18.4 kB view details)

Uploaded Nov 19, 2024 Python 3

File details

Details for the file h5glance-0.9.0.tar.gz.

File metadata

Download URL: h5glance-0.9.0.tar.gz
Upload date: Nov 19, 2024
Size: 22.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for h5glance-0.9.0.tar.gz
Algorithm	Hash digest
SHA256	`36c4b20d132fdc766efad09939465ebd4836095999420d0ada094da6f475ba6d`
MD5	`1249efa1563a009d7779620f43be84c1`
BLAKE2b-256	`62b29e522e0ecba22de841b59ebe2523817bacd435de49275f9ae0d07aebedc2`

See more details on using hashes here.

Provenance

The following attestation bundles were made for h5glance-0.9.0.tar.gz:

Publisher: tests.yml on European-XFEL/h5glance

Attestations:

Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: h5glance-0.9.0.tar.gz
- Subject digest: 36c4b20d132fdc766efad09939465ebd4836095999420d0ada094da6f475ba6d
- Sigstore transparency entry: 149746794
- Sigstore integration time: Nov 19, 2024