Skip to content

FabSim3 plugin for an earthquake simulation Uncertainty Quantification tutorial

License

Notifications You must be signed in to change notification settings

alan-turing-institute/fabmogp

Repository files navigation

fabmogp

This is a mogp (Multi-Output Gaussian Process Emulator) plugin for FabSim3.

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.

Dependencies:

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