Skip to main content

PyPI Conda Python Version Status License

Tests Codecov Read the documentation at https://mdio-python.readthedocs.io/

pre-commit Ruff

PyPI Downloads Conda Downloads

🎉 MDIO v1 is out. Ingestion and export for SEG-Y is fully functional with templates! However, there may still be minor issues. Please report any issues you encounter.

🚧👷🏻 We are actively working on updating the documentation and adding missing features to v1 release. Please check back later for more updates!

"MDIO" is a library to work with large multidimensional energy datasets. The primary motivation behind MDIO is to represent multidimensional time series data in a format that makes it easier to use in resource assessment, machine learning, and data processing workflows.

See the documentation for more information.

This is not an official TGS product.

Features

Shared Features

  • Abstractions for common energy data types (see below).
  • Cloud native chunked storage based on Zarr and fsspec.
  • Standardized models for lossy and lossless data compression using Blosc and ZFP.
  • Distributed reads and writes using Dask.
  • Powerful command-line-interface (CLI) based on Click

Domain Specific Features

  • Oil & Gas Data
    • Import and export 2D - 5D seismic data types stored in SEG-Y.
    • Optimized chunking logic for various seismic types using MDIO templates.
    • Native Xarray data model and interface wrapper.
    • Import seismic interpretation, horizon, data. FUTURE

Installing MDIO

Simplest way to install MDIO via pip from PyPI:

$ pip install multidimio

or install MDIO via conda from conda-forge:

$ conda install -c conda-forge multidimio

Extras must be installed separately on Conda environments.

For details, please see the installation instructions in the documentation.

Using MDIO

Please see the Command-line Usage for details.

For Python API please see the API Reference for details.

Requirements

Minimal

Chunked storage and parallelization: zarr, dask, numba, and psutil.
SEG-Y Parsing: TGSAI/segy
CLI and Progress Bars: click, click-params, and tqdm.

Optional

Distributed computing [distributed]: distributed and bokeh.
Cloud Object Store I/O [cloud]: s3fs, gcsfs, and adlfs.
Lossy Compression [lossy]: zfpy

Contributing to MDIO

Contributions are very welcome. To learn more, see the Contributor Guide.

Licensing

Distributed under the terms of the Apache 2.0 license, MDIO is free and open source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Credits

This project was established at TGS. The current maintainer is Brian Michell with the support of many more great colleagues.

Release files for multidimio 1.2.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for multidimio 1.2.3
File Size Uploaded
multidimio-1.2.3.tar.gz 100.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for multidimio 1.2.3
File Interpreter ABI Platform
multidimio-1.2.3-py3-none-any.whl Python 3 none any Details

Total release size: 244.1 kB

Release files / multidimio-1.2.3.tar.gz

Download URL multidimio-1.2.3.tar.gz
Size 100.2 kB
Tags Source
SHA-256 checksum
How to use checksums
e3d6ae33f1a80c1d7f5d1fc535ce1741dd1f1533a210976fb547a3cada58e194
BLAKE2b-256 checksum
How to use checksums
fdb2e073cfaea19d9b89a6d8ef66129acc4db409603f2ea1d05e0def7fd7366f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / multidimio-1.2.3-py3-none-any.whl

Download URL multidimio-1.2.3-py3-none-any.whl
Size 143.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5971a83923505a49266a9bb697a5361e0cadcfeeec1d5314084d5af4e467d796
BLAKE2b-256 checksum
How to use checksums
1c08dce35a643b23e4d671441576b9f555658e7b9150f0c2bbad6a7465a35ad1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

This release

1.2.3 This release

2 release files

1.2.2

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.3

2 release files

1.1.2

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.9

2 release files

1.0.8

2 release files

1.0.7

2 release files

1.0.6

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.9.3

2 release files

0.9.2

2 release files

0.9.1

2 release files

0.9.0

2 release files

0.8.5

2 release files

0.8.4

2 release files

0.8.3

2 release files

0.8.2

2 release files

0.8.1

2 release files

0.8.0

2 release files

0.7.4

2 release files

0.7.3

2 release files

0.7.2

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.0

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.1

2 release files

0.3

2 release files

0.2.12

2 release files

0.2.11

2 release files

0.2.10

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.1

2 release files

0.1.0

2 release files

0.0.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page