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.1.tar.gz (250.4 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.1-py3-none-any.whl (118.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: subsurface_terra-2026.2.1.tar.gz
  • Upload date:
  • Size: 250.4 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.1.tar.gz
Algorithm Hash digest
SHA256 30b9fbb6920343683a0b6f20ff12a164097159132ecc5806f175673575f03c28
MD5 e624f8c62418925abacbfa59cc87318f
BLAKE2b-256 deae3e0d33cdf89b4d18301c185974e8053042d430b5e0459fb4170689552268

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for subsurface_terra-2026.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 181a54c16c2227e0ca4d9d9d4d4a1202a9d53fb2f6e1db80cb9eb5d109947b66
MD5 b93baa4826c3fa590c32b564fc79c4cd
BLAKE2b-256 278cba19eb4182bee6d79d05f65db0446bfeb82b26a05a1b7b4877bc62fb9c30

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