fem2geo 0.0.1

Physics-based Modeling to Structural Geology and Seismology

fem2geo

Physics-Based Modeling to Structural Geology and Seismology

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

• Read and Load Simulation
• Visualizing stress orientations in stereo-plots
• Creating slip/dilation tendency analysis.
• Compare simulations to real data

Table of Contents

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

Installation and Setup

Latest version

The package requires a python version >= 3.10 and the following dependencies:

 sudo apt install git python3-pip python3-virtualenv

Create a virtual environment, clone the repository and install fem2geo with:

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

From PyPI

The package requires a python version >= 3.10. Create a virtual environment and install using:

    python -m venv venv
    pip install fem2geo

From conda

1. Install a conda distribution. Anaconda is recommended if you use Windows and want to have a GUI/IDE for python with spyder, but Miniforge is recommended for a lightweight Linux installation. Run in the terminal:

    conda create -n fem2geo python=3.12
    conda install -c conda-forge fem2geo

Run

Run an example from the examples folder with:

cd examples
python3 A_principal_directions.py

The currently supported inputs are .vtk or .vtu files from the Adeli 3D FEM program. The code consists in two parts:

1. Parse and handle vtk files, as well as extracting from region of interests (e.g., a sphere, a box within the model).

2. Post-process the scalar/vector/tensor data and visualize structural-geology variables of interests.

Roadmap and Known Issues