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).

Metadata

Release files for subsurface-terra 2026.2.5.post1

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

Source distribution (sdist)

Source distribution for subsurface-terra 2026.2.5.post1
File Size Uploaded Provenance Actions
subsurface_terra-2026.2.5.post1.tar.gz 277.2 kB Without provenance Details for subsurface_terra-2026.2.5.post1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for subsurface-terra 2026.2.5.post1
File Interpreter ABI Platform Actions
subsurface_terra-2026.2.5.post1-py3-none-any.whl Python 3 none any Details for subsurface_terra-2026.2.5.post1-py3-none-any.whl

Total release size: 426.7 kB

Release files / subsurface_terra-2026.2.5.post1.tar.gz

Download URL subsurface_terra-2026.2.5.post1.tar.gz
Size 277.2 kB
Tags Source
SHA-256 checksum
How to use checksums
a5dbf74a170270930f63725ea491deff35123ea0173d12312f42d94eaad30970
BLAKE2b-256 checksum
How to use checksums
e6a51891371459c6641ab0c592d60d0eae2cc2b35115b09f0713964db9bba297
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / subsurface_terra-2026.2.5.post1-py3-none-any.whl

Download URL subsurface_terra-2026.2.5.post1-py3-none-any.whl
Size 149.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6e0e48604f575f08b7aa6c7b805b4eac6d181f23d730f87cfde772d843f66370
BLAKE2b-256 checksum
How to use checksums
d56658a5c1fee76d5870528b321293d3367e8f2bcb3ffd733e09e058f8365cf8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Security for subsurface-terra 2026.2.5.post1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
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