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.2.tar.gz (250.1 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.2-py3-none-any.whl (118.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: subsurface_terra-2026.2.2.tar.gz
  • Upload date:
  • Size: 250.1 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.2.tar.gz
Algorithm Hash digest
SHA256 8423387a09ac7c99ac7d9f947ba199a6dafcaead362c49aa99ed3d4fc9ae4644
MD5 dbe41f4bdc717b07f35024b79e4f02d0
BLAKE2b-256 4a3ae1fe7ad71e3150967c9479a2e202a2e59b42de11716cb2d3bb38cf8018f4

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for subsurface_terra-2026.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 20567245c826cac5d560066be5b2af645d0047cec22cc71117b85a04f47108b3
MD5 9f0ca662e49f38cf60ba62ef2b853994
BLAKE2b-256 cde4b514eb7f386d9cf8ba5f32b06ed7b3ea4fdcea8737fbcb10909ea6a6d764

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