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.3.tar.gz (250.5 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.3-py3-none-any.whl (115.7 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for subsurface_terra-2026.2.3.tar.gz
Algorithm Hash digest
SHA256 3bc53627b18bf7e94a99815ad6dc79dc93693179fb4038e867084917900deb16
MD5 7b50a8fbf0234d8bcbe807dc3dbde277
BLAKE2b-256 7340edae93c7f90c0ab37b51e1525e4f3a3e1e2e1ff2fbccb722ac177c592708

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for subsurface_terra-2026.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 4a0a8bd6d9f491c782842aa18beb2dd33e50af53fdfe78a5a77dab6fdd3c1034
MD5 a4ccc8fc6c1507e5d5cc98106c9bd38e
BLAKE2b-256 90dad66c9c0bbe17018bb95f07a79b3959f5262d7c7fe2bfe375830166e6122e

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