Skip to main content

LoopStructural: Loop3D Implicit Geological Modelling

3D model of Hamersley created using loopstructural PyPI version GitHub license Documentation loop3d.github.io/LoopStructural/

Overview

LoopStructural is an opensource Python library for 3D geological modelling. The library has been built in the scope of the Loop project (Loop3d.org). LoopStructural can:

  • Model fault networks integrating fault kinematics and overprinting relationships
  • Model folds using structural elements (fold axis, fold axial surface) for multiple fold events
  • Use different implicit interpolation algorithms (Finite Difference, Piecewiese Linear, RBF)
  • Export models to vtk, geoh5, omf, gocad, csv, obj formats
  • Visualise models in an interactive python environment.

Installation

Google colab

LoopStructural can be used inside a google colab notebook, however interactive visualisation using kitware trame does not work. Only static plots can be displayed.

Pip

pip install loopstructural

Optional dependencies are:

  • loopstructuralvisualisation (wrapper for pyvista to interface with loopstructural objects)
  • pyvista (3D visualisation)
  • geoh5py (export to .geoh5 format)
  • mira-omf (export to .omf format to load in Leapfrog)
  • pyevtk
  • dill (serialize loop models to a pickle file)
  • tqdm (progress bars)
  • loopsolver (experimental solver for admm inequality constraints)

You can install all of the optional dependencies using: pip install loopstructural[all]

conda

conda install -c conda-forge -c loop3d loopstructural

to install the working 3D visualisation environment conda install -c conda-forge -c loop3d loopstructural loopstructuralvisualisation pyvista trame trame-vtk trame-vuetify

Quickstart

  • A basic geological model
from LoopStructural import GeologicalModel
from LoopStructural.geometry import BoundingBox
from LoopStructural.visualisation import Loop3DView
from LoopStructural.datasets import load_claudius

import numpy as np
data, bb = load_claudius()

#bb constaints origin and maximum of axis aligned bounding box
#data is a pandas dataframe with X,Y,Z,val,nx,ny,nz, feature_name

model = GeologicalModel(bb[0,:],bb[1,:])
model.data = data
# nelements specifies the number of discrete interpolation elements
# 'stratí' is the feature name in the data dataframe
model.create_and_add_foliation('strati',nelements=1e5)
model.update()
# get the value of the interpolator at some random locations
locations = np.array(
    [
        np.random.uniform(bb[0, 0], bb[1, 0],5),
        np.random.uniform(bb[0, 1], bb[1, 1],5),
        np.random.uniform(bb[0, 2], bb[1, 2],5),
    ]
).T
val = model.evaluate_feature_value('strati', locations)
# get the gradient of the interpolator
gradient = model.evaluate_feature_gradient('strati',locations)

#Plot the scalar field of the model
model['strati'].scalar_field().plot()

Documentation

The LoopStructural documentation can be found here

Problems

Any bugs/feature requests/comments please create a new issue.

Acknowledgements

The Loop platform is an open source 3D probabilistic geological and geophysical modelling platform, initiated by Geoscience Australia and the OneGeology consortium. The project is funded by Australian territory, State and Federal Geological Surveys, the Australian Research Council and the MinEx Collaborative Research Centre.

Metadata

Release files for LoopStructural 1.7.0

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

Source distribution (sdist)

Source distribution for LoopStructural 1.7.0
File Size Uploaded Provenance Actions
loopstructural-1.7.0.tar.gz 493.9 kB Without provenance Details for loopstructural-1.7.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for LoopStructural 1.7.0
File Interpreter ABI Platform Actions
loopstructural-1.7.0-py3-none-any.whl Python 3 none any Details for loopstructural-1.7.0-py3-none-any.whl

Total release size: 1.0 MB

Release files / loopstructural-1.7.0.tar.gz

Download URL loopstructural-1.7.0.tar.gz
Size 493.9 kB
Tags Source
SHA-256 checksum
How to use checksums
cf00a035102d5538b0a6630b35308823257c9c6730274b5a3b74a81ae3e98a63
BLAKE2b-256 checksum
How to use checksums
c81ada68034f8f740f6b02a9706b38b997bf6c9825b4e14c01506a7d76d3a71b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / loopstructural-1.7.0-py3-none-any.whl

Download URL loopstructural-1.7.0-py3-none-any.whl
Size 536.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
2a3670a3c61836c228fead9dbf25fe2c72914483eac5af500c00a3f97e3c078c
BLAKE2b-256 checksum
How to use checksums
0925fac8e6c2aa3c56c3df2ba6d9df8dcfe62f022a85280f2759aa086d5d85c5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Security for LoopStructural 1.7.0

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

1.7.0 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