---
id: geoh5py
version: "0.13.0"
license: LGPL-3.0-or-later
license_treatment: copyleft
maintenance: active
---

# geoh5py — Python API for geoh5, an open file format for geoscientific data

License: copyleft · Maintenance: active · Downloads: 548.7K/mo

## What it is and what it does

geoh5py is a Python library for working with the geoh5 file format, an open standard for storing and exchanging geoscientific data. It lets you programmatically read, create, and modify geoscientific datasets—points, curves, surfaces, and 2D/3D grids—directly from Python, then visualize them in Geoscience ANALYST or integrate them with other Python scientific tools.

The package wraps h5py and NumPy to handle the underlying HDF5 storage and array operations. It's maintained by Mira Geoscience and targets Python 3.12+, with active development and no known security vulnerabilities. It's useful for geologists, geophysicists, and data engineers who need to automate data workflows, share data across tools, or build custom analysis pipelines around geoscientific datasets.

Use it for:

- Automate batch processing of geological survey data stored in geoh5 format without manual Geoscience ANALYST interaction.
- Convert and integrate geoscientific data from other formats into geoh5 for standardized storage and visualization.
- Build custom analysis pipelines combining geoh5 data with NumPy, SciPy, or other Python scientific libraries.
- Programmatically create synthetic or processed geoscientific grids and surfaces for simulation or modeling workflows.
- Export processed geophysical inversion results or survey interpretations back to geoh5 for team collaboration.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

geoh5py provides a Python API to read, write, and manipulate geoscientific data (points, curves, surfaces, grids) in the geoh5 file format, enabling interoperability with Geoscience ANALYST visualization software.

Yes. geoh5py is actively maintained, has low install friction, no known vulnerabilities, and fills a specific role in the geoscience Python ecosystem. Install it if you work with geoh5 data or need to integrate geoscientific datasets with Geoscience ANALYST. The LGPL-3.0-or-later license is permissive for most use cases but requires source disclosure if you distribute derivative works.

## Install

pip install geoh5py
uv add geoh5py
poetry add geoh5py

## Installing geoh5py

Before you install: Low friction installation with a pure-Python wheel. Active maintenance with a recent release (44 days old) and ongoing repository activity. Depends on well-established packages: NumPy, h5py, Pillow, psutil, and pydantic.

License in practice: Licensed under LGPL-3.0-or-later (copyleft). You may use and modify geoh5py freely, but any derivative works must also be distributed under LGPL-3.0-or-later and include source code availability.

Quickstart:

pip install geoh5py

import geoh5py
# Create or open a geoh5 workspace to manipulate geoscientific data

Requires Python 3.12 or later (supports 3.12, 3.13, 3.14); does not support Python 3.15+.

Verify before relying:

- Whether the package supports reading and writing all geoscientific data types (points, curves, surfaces, 2D/3D grids) with equal feature completeness.
- Performance characteristics and memory efficiency when working with large geoscientific datasets.
- Specific version compatibility or known issues with Geoscience ANALYST software versions.

## Package facts

- License: LGPL-3.0-or-later (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 548.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

geoscientific data format python, geoh5 file format api, geological data storage python, geophysics data manipulation, h5 geoscience data, grid surface curve point data, geoscience analyst interoperability, geoscience, hdf5-format, data-interoperability

[View on SkillFed](https://skillfed.io/packages/geoh5py) · [View on PyPI](https://pypi.org/project/geoh5py/)