https://github.com/alan-turing-institute/fabmogp
FabSim3 plugin for an earthquake simulation Uncertainty Quantification tutorial
https://github.com/alan-turing-institute/fabmogp
earthquake-simulations fabsim3 hut23 hut23-231 hut23-232 uncertainty-quantification
Last synced: 20 days ago
JSON representation
FabSim3 plugin for an earthquake simulation Uncertainty Quantification tutorial
- Host: GitHub
- URL: https://github.com/alan-turing-institute/fabmogp
- Owner: alan-turing-institute
- License: mit
- Created: 2020-01-14T17:10:14.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-06-15T15:59:55.000Z (almost 2 years ago)
- Last Synced: 2025-02-13T04:51:16.828Z (2 months ago)
- Topics: earthquake-simulations, fabsim3, hut23, hut23-231, hut23-232, uncertainty-quantification
- Language: Python
- Homepage:
- Size: 403 KB
- Stars: 1
- Watchers: 5
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# fabmogp
This is a mogp (Multi-Output Gaussian Process Emulator) plugin for [FabSim3](https://github.com/djgroen/FabSim3.git).
## Tutorial
A detailed tutorial has been written describing the computations carried out
by this plugin. We also provide a docker image with all required software
pre-installed to improve accessibility to the tutorial for novice users.
For more details, see the [VECMA Workshop Tutorial](https://github.com/alan-turing-institute/vecma_workshop_tutorial).
## Dependencies:
* [mogp_emulator](https://www.github.com/alan-turing-institute/mogp-emulator)
* [FabSim3](https://github.com/djgroen/FabSim3)
* [fdfault](https://www.github.com/edaub/fdfault)
Note: Please follow the instructions in fdfault repository to create the fdfault executable and soft links.
## Installation
Simply type `fabsim localhost install_plugin:fabmogp` anywhere inside your FabSim3 install directory.
### FabSim3 Configuration
Once you have installed the required dependencies, you will need to take a few small configuration steps:
1. Go to `(FabSim Home)/deploy`
2. Open `machines_user.yml`
3. Under the section `default:`, please add the following lines:
a. ` mpi_exec: "mpiexec_file_path"`
_NOTE: Please include mpiexec in mpi_file_path.
_Use `which mpiexec` to find the location of mpiexec in your machine (e.g., "/usr/bin/mpiexec")
b. ` fdfault_exec: "fdfault_home"`
_NOTE: Please replace fdfault_home with your actual fdfault install directory._
## Testing
1. To run a single job, simply type:
`fabsim localhost mogp:demo`
2. To run the ensemble, you can type, simply type:
`fabsim localhost mogp_ensemble:demo,sample_points=20`
3. You can copy back any results from completed runs using:
`fabsim localhost fetch_results`
The results will then be in a directory inside `FabSim3/results` directory, which is most likely called `demo_localhost_16`
4. You can analyse the simulation output using:
`fabsim localhost mogp_analysis:demo,demo_localhost_16`
Figures are stored in `FabSim3/results/demo_localhost_16/results`