Skip to main content

subsurface

DataHub for geoscientific data in Python. Two main purposes:

  • Unify geometric data into data objects (using numpy arrays as memory representation) that all the packages of the stack understand

  • Basic interactions with those data objects:

    • Write/Read
    • Categorized/Meta data
    • Visualization

Data Levels

The difference between data levels is not which data they store but which data they parse and understand. The rationale for this is to be able to pass along any object while keeping the I/O in subsurface::

            HUMAN

\‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾/
= = = = = = = = = = = = = = /. \ -> Additional context/meta information about the data = = = = geo_format= = = = /. .
= = = = = = = = = = = = /. . . \ -> Elements that represent some = = = geo_object= = = /. . . . \ geological concept. E.g: faults, seismic = = = = = = = = = = /. . . . ./ = = element = = = /. . . . / -> type of geometric object: PointSet, = = = = = = = = /. . . ./ TriSurf, LineSet, Tetramesh \primary_struct/. . . / -> Set of arrays that define a geometric object: = = = = = = /. . ./ e.g. StructuredData, UnstructuredData \DF/Xarray /. . / -> Label numpy.arrays = = = = /. ./ \array /. / -> Memory allocation = = /./ = // /

           COMPUTER

Documentation (WIP)

Note that subsurface is still in early days; do expect things to change. We welcome contributions very much, please get in touch if you would like to add support for subsurface in your package.

An early version of the documentation can be found here:

https://softwareunderground.github.io/subsurface/

Direct links:

  • Developers-guide <https://softwareunderground.github.io/subsurface/maintenance.html>_
  • Changelog <https://softwareunderground.github.io/subsurface/changelog.html>_

Installation

.. code-block:: console

pip install subsurface

or

.. code-block:: console

conda install -c conda-forge subsurface

Be aware that to read different formats you will need to manually install the specific dependency (e.g. welly to read well data).

Download files

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

Source Distribution

subsurface_terra-2026.2.0.tar.gz (249.9 kB view details)

Uploaded Source

Built Distribution

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

subsurface_terra-2026.2.0-py3-none-any.whl (118.1 kB view details)

Uploaded Python 3

File details

Details for the file subsurface_terra-2026.2.0.tar.gz.

File metadata

  • Download URL: subsurface_terra-2026.2.0.tar.gz
  • Upload date:
  • Size: 249.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.5

File hashes

Hashes for subsurface_terra-2026.2.0.tar.gz
Algorithm Hash digest
SHA256 05a9d5682af9852a7df3a2fcf8fcc84c686edbf66ef4018f5829688c598e8c98
MD5 6ec865cbeba9951f495062c1d233dc1e
BLAKE2b-256 abcda26c72dfcccc6ed9e6c63ac873e7b5d7f8ef3c75f2863dcfa5dc8502e9ad

See more details on using hashes here.

File details

Details for the file subsurface_terra-2026.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for subsurface_terra-2026.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8cd0f7838edad32bb6aecaa74b7a6c42845005a6dee4c2b105ed93515dcafde3
MD5 13f5447db5b2878e66f481540b2476f8
BLAKE2b-256 945f788e03f97f5cc0b253034c721d22a5238390161b8f9bd4e91444231ae5a3

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 Sentry Error logging StatusPage Status page