Python implementation of ANTI-FASc
(Automatic Numerical Tsunami Initial conditions: on-the-Fly rupture Areas and earthquake Scenarios)
pyANTI-FASc is a software for the fast generation of large ensembles of stochastic slip distributions on complex non-planar fault geometries (Herrero & Murphy 2018; Maesano et al. 2017; Tonini et al. 2021).
These slip models can be used as initial conditions for tsunami simulations in:
- Probabilistic Tsunami Hazard Assessment (PTHA, see Basili et al. 2021)
- Real-time Probabilistic Tsunami Forecasting (PTF, see Selva et al. 2021)
👉 Please cite the software as indicated on Zenodo:
https://doi.org/10.5281/zenodo.13614657
Before running pyANTI-FASc, make sure Docker is installed and running.
Download and install Docker Desktop:
https://www.docker.com/products/docker-desktop
- Launch Docker Desktop after installation
- Make sure it is running before using the software
If you are using pyANTI-FASc on WSL on Windows make sure to enable wsl integration on Docker Desktop. Note that if you are on Windows 11 Home, WSL is the only mode to install Docker pyANTI-FASc image
sudo apt update
sudo apt install -y docker.io
sudo usermod -aG docker $USER
Then restart your terminal or run:
newgrp docker
This allows you to run Docker without sudo.
git clone https://github.com/antonioscalaunina/pyANTI-FASc.git
cd pyANTI-FASc
docker build -t pyantifasc .
chmod +x antifasc
./antifasc
git clone https://github.com/antonioscalaunina/pyANTI-FASc.git
cd pyANTI-FASc
docker build -t pyantifasc .
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
.\antifasc.ps1
The command
./antifasc
or, on Windows Power Shell
.\antifasc.ps1
Runs the full pipeline.
The command
./antifasc notebook
or, on Windows Power Shell:
.\antifasc.ps1 notebook
accesses to the Jupyter Notebook environment see below 👇
After running the notebook command, a URL will appear in the terminal, similar to:
http://127.0.0.1:8888/lab?token=xxxxxxxxxxxxxxxx
👉 To open JupyterLab:
- Linux (also WSL) / Mac: press
Ctrl + Clickon the link (or copy and paste the URL into your browser) - Windows PowerShell: copy and paste the URL into your browser
You can then navigate within the file system of the repository and run the different Jupyter Notebook through the Jupyter interface
the main pipeline is available in the notebook:
bin/antifasc_main.ipynb
Interactive notebook available at:
bin/interactive_slip_maps.ipynb
it can be run after the running of either the CLI pipeline or the notebook.
Running it the user can:
- select the folder via interactive widgets 👆
- visualize slip and rake maps through the GeoJSON output files
- optionally generate, visualize and export HTML interactive maps
Note that to access to the notebooks you should enter in the folder bin
The software is composed of three main modules:
- Mesh reading from slab geometries (soon available interaction with EFSM20 services)
- Area computation
- Connectivity and distances
- Hazard mode → full coverage of mesh
- PTF mode → event-based scenarios
- Refined distance computation
- Stochastic slip generation
- Variable rigidity support
Main configuration file:
config_files/Parameters/input.json
config_files/Parameters/scaling_relationship.json
In the notebook version you can change the input file names
Through these files the users can control:
- application mode (Hazard / PTF)
- magnitude ranges
- rigidity models
- scaling laws
👉 Changes are immediately available inside Docker (no rebuild required)
IMPORTANT: please have a look at the Example1 and Example2 documentation for more details about the input files
Generated in:
output/
Includes:
- ASCII slip files
- GeoJSON
- HTML maps (optionally, look at
bin/plot_interactive_maps.ipynb
IMPORTANT: please have a look at the Example1 and Example2 documentation for more details about the output folder and its folder tree
The command:
./antifasc
runs:
docker run --rm -it -v $(pwd):/app pyantifasc
This ensures:
- full synchronization between container and host
- outputs directly available locally
- reproducibility
- On Windows, containers run as root → this does not affect file usability
- Port
8888is used for Jupyter → change if already in use - Docker must be running
See:
And the corresponding example descriptions:
If you prefer a manual setup without Docker, see:
- Manual installation →
MANUAL_INSTALL.md - Interactive notebooks → included in
bin/ - Wiki → under construction
A special thanks to Stefano Lorito, Fabrizio Romano, Manuela Volpe, Hafize Basak Bayraktar, Jacopo Selva, Gaetano Festa and Antonio Giovanni Iaccarino for participating at the different phases of conceiving, revising, developing and testing of the current version of the platform.
Thanks to Roberto Basili, Francesco Emanuele Maesano, Mara Monica Tiberti and Gareth Davies for their contribution in providing slab geometries.
Thanks to Shane Murphy and Andre Herrero for their work on the k223d module.
Basili R. et al. (2021), The Making of the NEAM Tsunami Hazard Model 2018 (NEAMTHM18), Frontiers in Earth Science, DOI: 10.3389/feart.2020.616594
Herrero and Murphy (2018), Self-similar slip distributions on irregular shaped faults, Geophysical Journal International, DOI: 10.1093/gji/ggy104
Maesano, F.E., Tiberti, M.M. and Basili, R. (2017), The Calabrian Arc: Three-dimensional modelling of the subduction interface, Scientific Reports DOI: 10.1038/s41598-017-09074-8
Murotani, S., Satake, K., and Fujii, Y. (2013), Scaling relations of seismic moment, rupture area, average slip, and asperity size for M~9 subduction-zone earthquakes, Geophysical Research Letters, 40, DOI: 10.1002/grl.50976.
Scala A. et al. (2020), Effect of Shallow Slip Amplification Uncertainty on Probabilistic Tsunami Hazard Analysis in Subduction Zones: Use of Long-Term Balanced Stochastic Slip Models, Pure and Applied Geophysics, DOI: 10.1007/s00024-019-02260-x
Selva, J., Lorito, S., Volpe, M. et al. (2021). Probabilistic tsunami forecasting for early warning. Nat Commun 12, 5677 (2021). DOI: 10.1038/s41467-021-25815-w
Strasser, F. O., Arango, M. C., & Bommer, J. J. (2010), Scaling of the source dimensions of interface and intraslab subduction-zone earthquakes with moment magnitude. Seismological Research Letters, DOI: 10.1785/gssrl.81.6.941.
Tonini et al. (2020), Importance of earthquake rupture geometry on tsunami modelling: The Calabrian Arc subduction interface (Italy) case study, Geophysical Journal International, DOI: 10.1093/gji/ggaa409