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

Built distribution (wheel)

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

Total release size: 448.3 kB

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

Download URL subsurface_terra-2026.2.6.post1.tar.gz
Size 287.1 kB
Tags Source
SHA-256 checksum
How to use checksums
48c623ea2f94304b4046d05188e734d2a9836067dcb8608289dfc9a2ee0bbc1d
BLAKE2b-256 checksum
How to use checksums
b222564f9840ee0527d6b6be358f9d5208b66aa488735078b2e732fba038ca70
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.post1-py3-none-any.whl

Download URL subsurface_terra-2026.2.6.post1-py3-none-any.whl
Size 161.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7c22bbc93e3c6dfcdebca85af26cf8012771780fbb43cd03d0c9ab68cb3ea975
BLAKE2b-256 checksum
How to use checksums
2ec7bfdbda06b3b6e2cb79171274b94b6139a5468de720edb54f3aa5a2ba4423
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.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