How loop3d/loopstructural works
Project type and purpose
• LoopStructural is an open-source Python library for 3D implicit geological modelling.
• It provides: data loading, datatype abstractions, interpolation algorithms, geological model building, export to various formats, and interactive visualisation.
File structure
Top-level packages under LoopStructural/ represent the core subsystems:
• datasets: data loaders and example data
• interpolators: various interpolation engines (finite difference, P1/P2, RBF, discrete folds, plus Cython helpers)
• modelling: core geological model object plus feature builders (faults, folds, intrusions) and input processors
• export: exporters for vtk, geoh5, omf, gocad, csv, obj
• visualisation: wrappers around pyvista/trame for interactive views
• utils: shared utilities (maths, linalg, logging, config, exceptions)
Ancillary directories:
• tests: unit & integration tests
• docs: Sphinx source + Docker/CI scripts
• examples: usage scripts demonstrating workflows
• CI/CD: GitHub Actions workflows, conda recipes, PyPI publish scripts
README for additional insights
• Lists optional dependencies (pyvista, geoh5py, mira-omf, pyevtk, etc.) that plug into export/visualisation subsystems
• Quickstart shows API flow: load data → instantiate GeologicalModel → add feature → update → evaluate → plot