Skip to content

Tutorial code with FEniCS-hIPPYlib framework for adjoint inversions

License

Notifications You must be signed in to change notification settings

SimonePuel/Coseismic-Slip-Inversion

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Coseismic Slip Inversion

This repository contains finite-element (FE) models of earthquake problems using the open-source libraries FEniCS and hIPPYlib for the forward and inverse problems, respectively. In particular, the goal is to invert surface displacement data for the coseismic slip distribution using adjoint-based optimization methods and a mixed FE elastic formulation.

  1. FEniCS (Logg_Wells, 2010; Logg et al., 2012) is a high-level parallel FE collection of software components for automated and efficient solution of PDEs. It includes several libraries for the FE discretization, assembly and solution of linear and non-linear systems of equations. In FEniCS, any PDE can be explicitly and easily expressed in variational form using the Unified Form Language (Alnaes et al., 2014) Python library. This makes a problem coded in this framework transparent, reproducible, flexible for multi-physics formulations, and easy to implement.

  2. hIPPYlib (Villa et al., 2016; Villa et al., 2018; Villa et al., 2021) implements state-of-the-art scalable adjoint-based algorithms for PDE-based deterministic and Bayesian inverse problems. In hIPPYlib, derivative information, gradients and actions of the second derivative of objective functions (Hessian), are efficiently computed using the adjoint method while leveraging the automated symbolic differentiation and assembly of variational forms in FEniCS.

Installation of the FEniCS and hIPPYlib libraries

For the installation of the two open-source libraries and all their dependeciens, please look at the file FEniCS_hIPPYlib_installation.md.

Mesh Generation and Visualization

For models with complex geometries, the open-source mesh geration software, Gmsh (Geuzaine & Remacle, 2009), can be used to create the mesh which is then imported to FEniCS.

Matplotlib and Paraview can be used to visualize the results in 2D and 3D, repsectively.

Jupyter notebooks of GJI manuscript

In the folder Manuscript_GJI_2022 there are the Jupyter notebook tutorials and the files to reproduce the results contained in the manuscript titled "A Mixed, Unified Forward/Inverse Framework for Earthquake Problems: Fault Implementation and Coseismic Slip Estimate" by Puel et al. (2022), accepted in Geophysical Journal International (GJI) on February 1st, 2022.

Copyright and distribution

All the material contained in this repository is open-source and can be distributed under the GNU General Public License v3.0.

If you have any questions/suggestions or you are simply interested in this forward-inverse FE framework, please contact Simone Puel ([email protected]).