https://github.com/softwareunderground/gio

Read and write subsurface data files describing surfaces, grids and horizons.
https://github.com/softwareunderground/gio

geology geophysics geospatial grids subsurface

Last synced: 7 months ago
JSON representation

Read and write subsurface data files describing surfaces, grids and horizons.

• Host: GitHub
• URL: https://github.com/softwareunderground/gio
• Owner: softwareunderground
• License: apache-2.0
• Created: 2015-08-26T15:06:24.000Z (about 10 years ago)
• Default Branch: main
• Last Pushed: 2023-10-10T20:42:59.000Z (almost 2 years ago)
• Last Synced: 2024-06-11T17:28:55.729Z (over 1 year ago)
• Topics: geology, geophysics, geospatial, grids, subsurface
• Language: Python
• Homepage: https://code.agilescientific.com/gio/
• Size: 12.3 MB
• Stars: 57
• Watchers: 9
• Forks: 29
• Open Issues: 12
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
# gio

[![Tests](https://github.com/agilescientific/gio/actions/workflows/build-test.yml/badge.svg)](https://github.com/agilescientific/gio/actions/workflows/build-test.yml)

[![Build docs](https://github.com/agilescientific/gio/actions/workflows/build-docs.yml/badge.svg)](https://github.com/agilescientific/gio/actions/workflows/build-docs.yml)

[![PyPI version](https://img.shields.io/pypi/v/gio.svg)](https://pypi.org/project/gio/)

[![PyPI versions](https://img.shields.io/pypi/pyversions/gio.svg)](https://pypi.org/project/gio/)

[![PyPI license](https://img.shields.io/pypi/l/gio.svg)](https://pypi.org/project/gio/)

**Geoscience I/O for grids and horizons.**

The goal of this project is to load and save various geoscience surface data formats (2D and 3D seismic horizons, grids, etc). The interchange formats are the `xarray.DataArray` (and `xarray.Dataset` where we need a collection of arrays). This format is convenient because it allows us to store a NumPy array with Pandas-like indexing (as opposed to ordinary NumPy positional indexing).

We've started with:

- OpendTect horizons

- ZMAP grids

- Surfer grids

- Petrel horizons

**What formats would you like to see? [Make an issue](https://github.com/agilescientific/gio/issues).**

## Installation

This library is on PyPI, so you can install it with:

    pip install gio

 To get the latest unstable release, you can install it from GitHub:

    python -m pip install --upgrade https://github.com/agilescientific/gio/archive/develop.zip

## Basic usage

In general, there's a reader for each supported file format. The reader produces an `xarray.DataArray`, or `xarray.Dataset` if the format supports multiple surfaces in one file.

```python

import gio

da = gio.read_surfer(fname)

da.plot()

```

## Documentation

See [the documentation](https://code.agilescientific.com/gio) for more examples, and for help developing `gio` or making contributions back to this project.