fem2geo 0.1.0

Physics-based Modeling to Structural Geology and Seismology

fem2geo

Physics-Based Modeling to Structural Geology and Seismology

A library to perform structural geology and seismology analyses on data generated by finite element (FEM) or boundary element (BEM) models.

Key capabilities:

• Read and load simulation outputs
• Visualize stress orientations in stereonets
• Slip/dilation tendency analysis
• Compare simulations with observational data

Table of Contents

• Installation
• Documentation
• Run
• Roadmap / Known Issues
• Contributing
• License

---

Installation

Latest version

For the newest features:

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 .

Stable version (from PyPI)

Install the latest released version:

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

Tutorials are distributed separately (not included in the PyPI package). Download the tutorials from the latest GitHub release into ./tutorials:

fem2geo download-tutorials

---

Run

Run an example from the tutorials/ folder:

cd tutorials
python3 A_principal_directions.py

Currently supported inputs are .vtk / .vtu files from Adeli 3D FEM models. The workflow is broadly:

1. Parse and subset FEM/BEM outputs (e.g., regions of interest like spheres/boxes).
2. Post-process scalar/vector/tensor data and compute/visualize structural geology variables of interest.

---

Roadmap / Known Issues

• Review/validate core functions; standardize function signatures and discretization defaults.
• Define a minimal .vtu input schema (names/units) and allow user mapping of field names (e.g., Stress1_(MPa) variants).
• Clarify/document effective stress / pore-pressure handling and orientation conventions (strike/dip, axes).