fem2geo 0.4.1

Physics-Based Modeling to Structural Geology

A Python library for structural geology analyses on outputs from finite element (FEM) or boundary element (BEM) models. fem2geo bridges numerical simulations and field observations: it loads model outputs, extracts regions of interest, computes geomechanical variables, and produces stereonet figures.

Key capabilities:

• Extract spatial subsets from large models
• Compare fracture and fault orientation data with model predictions
• Slip and dilation tendencies on stereonets
• Compare model to Kostrov moment tensor derived from fault populations
• Re-project datasets (catalogs, meshes, rasters) into a model's reference frame
• Run any analysis from reproducible config files

Table of Contents

• Installation
• Run
• Tutorials
• Documentation
• Roadmap
• Contributing
• License

Installation

From source

sudo apt install git python3-pip python3-venv
git clone https://github.com/pabloitu/fem2geo
cd fem2geo
python3 -m venv venv
source venv/bin/activate
pip install -e .

From PyPI

python3 -m venv venv
source venv/bin/activate
pip install fem2geo

Tutorials are not bundled in the PyPI package. Download them separately after installing:

fem2geo download-tutorials

This fetches the tutorials bundle from the latest GitHub release and extracts it into ./tutorials.

Run

Jobs are run by pointing fem2geo at a YAML config file:

fem2geo config.yaml

Supported jobs, each shown in tutorials/:

Roadmap

• Borehole module: sample model variables along a borehole trajectory
• Seismic catalog module: import focal mechanisms and compare with model stress orientations
• Inversion module: find the model configuration that best fits a structural dataset

Contributing

Bug reports and feature requests are welcome at github.com/pabloitu/fem2geo/issues.