fem2geo

From geomechanical models to structural-geology interpretation.

GitHub Repository PyPI - Python Version PyPI - Version DOI

start Installation Guide

theory Theory and Conventions

guide User Guide

jobs Python Examples

api API Reference

tutorials Tutorials

Quickstart

Create an environment and install:

$ python -m venv venv
$ source venv/bin/activate
$ pip install fem2geo

Download the tutorials:

$ fem2geo download-tutorials

Navigate to any tutorial on tutorials/* and run:

$ fem2geo config.yaml

What is fem2geo?

fem2geo is a Python package for structural geology analyses on finite-element and boundary-element model outputs. It provides a workflow to load model results, extract regions of interest, project data into the model space, compute geomechanical quantities, and generate multiple comparisons with geological observations.

EXAMPLE FIGURE HERE (MODEL + PROBE + STEREOPLOT)

Main capabilities

  • Probe principal stress/strain directions in a selected region

  • Compare multiple models at the same location

  • Overlay measured fracture datasets

  • Compare observed and predicted fault-slip directions

  • Compute slip, dilation, and combined tendency fields

  • Compare fault-based Kostrov tensors with model stress or strain axes

fem2geo is built on PyVista for mesh handling (and ParaView visualization) and mplstereonet for Schmidt stereonet projection.