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

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.6
File Size Uploaded Provenance Actions
subsurface_terra-2026.2.6.tar.gz 285.8 kB Without provenance Details for subsurface_terra-2026.2.6.tar.gz

Built distribution (wheel)

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

Total release size: 445.4 kB

Release files / subsurface_terra-2026.2.6.tar.gz

Download URL subsurface_terra-2026.2.6.tar.gz
Size 285.8 kB
Tags Source
SHA-256 checksum
How to use checksums
ba7b3ed1e82f547a26de559dff0de7131087f110939eda406969c0349fec090b
BLAKE2b-256 checksum
How to use checksums
f5625ae94a6cef1aa7ba6302912ad55ad56b5b61ae00b56c79542003066889b5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Release files / subsurface_terra-2026.2.6-py3-none-any.whl

Download URL subsurface_terra-2026.2.6-py3-none-any.whl
Size 159.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c21f77660e09a02b858a1b8df007f542491b13162d69acaa53586cb60051fc5d
BLAKE2b-256 checksum
How to use checksums
172110cab2f926eacdc10ee7dc62860bbbc1385eafc5bdb98851f65b4da35cc2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Security for subsurface-terra 2026.2.6

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

2026.2.6 This release

2 release files No provenance

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