The VECMAtk tutorials are divided into two formats:
- Static tutorials provide informative read-only information for the VECMAtk components with internal and external application instances.
- Interactive tutorials are easy-to-use as installation of the VECMAtk components are not required and they are versatile because users are able to append with additional remarks, which are hosted in the VECMA JupyterHub environment.
Here, we provide the links to the documentaion of VECMAtk components and tutorials for applications from a diverse range of scientific domains:
-
FabSim3 is an automation toolkit written in Python 3 featuring an integrated test infrastructure and a flexible plugin system. There are several plugins available from a diverse range of scientific domains, such as
- FabUQCampaign for coupling EasyVVUQ with FabSim3;
- FabMD for a molecular dynamics modelling using Large-scale Atomic/Molecular Massively Parallel Simulator (LAMMPS);
- FabFlee for a migration modelling;
- FabMogp for an earthquake modelling;
- FabCovid19 for a Covid-19 modelling.
- FabCovidsim for CovidsSim epidemiological code.
-
EasyVVUQ is a Python library designed to facilitate verification, validation and uncertainty quantification (VVUQ) for a wide variety of simulations. It accounts for uncertainty quantification (UQ) and validation patterns in application to various domains.
We provide tutorials for the basic concepts of EasyVVUQ workflows using Jupyter Notebooks:
- Encoder and Decoder to set-up an input file for a simulation code and to parse the output of the simulation;
- Campaign to operate and run simulations;
- Analysis to analyse the simulation output.
2.1 UQ Sampling techniques and tutorials
EasyVVUQ provides four sampling methods for analysis (see Wright et al. (2020) for explanation of these sampling techniques):
- Stochastic Collocation,
- Polynomial Chaos Expansion,
- Monte Carlo Sensitivity Analysis,
- Markov-Chain Monte Carlo.
We provide the static tutorials for these samplers below:
- Advection Diffusion Equation (ADE) using FabUQCampaign plugin;
- Two-dimensional ocean model (Ocean2D) using FabUQCampaign plugin;
- Flee algorithm sensitivity analysis using FabFlee plugin;
- LAMMPS simulations using FabMD plugin;
- Earthquake model using FabMogp plugin;
Interactive tutorials for EasyVVUQ samplers with examples are available here.
2.2 Verification and Validation (V&V) patterns and tutorials
There are four prominent V&V patterns in VECMAtk, namely:
- Stable Intermediate Forms (SIF)
- Level of Refinement (LoR)
- Ensemble Output Validation (EoV)
- Quantities of Interest Distribution Comparison (QDC)
They are most suitable for multiscale computing applications with source codes available here.
V&V examples:
- Ensemble Output Validation in application to the FabFlee plugin;
- Quantity of Interest Distribution Comparison for the SIR epidemiology model.
-
Quality in Cloud and Grid (QCG) is an integrated system offering advanced job and resource management capabilities to deliver to end-users supercomputer-like performance and structure. QCG consists of the following components:
-
QCG-PilotJob is a Pilot Job system that allows to execute many subordinate jobs in a single scheduling system allocation. We demonstrate how EasyVVUQ workflows can be adapted to enable their executions with QCG-PilotJob on HPC machines here.
-
QCG-Client is a command line client for execution of computing jobs on the clusters offered by QCG middleware.
-
QCG-Now is a desktop, GUI client for easy execution of computing jobs on the clusters offered by QCG middleware.
-
-
EasySurrogate is a toolkit designed to facilitate the creation of surrogate models for multiscale simulations.
-
MUSCLE3 is the third incarnation of the Multiscale Coupling Library and Environment.
- ISR3D is the 3D in-stent restenosis application aiming to simulate smooth muscle cells (SMC) proliferation and restenosis process as a complication after coronary stenting procedure. It is a fully coupled 3D multiscale model, which includes several single-scale submodels as well as utility modules which facilitate communication between the submodels.
We also present the application of these VECMAtk components to five domains, which are forced migration, fusion energy, climate, biomedicine and urban air pollution, in the publication by Suleimenova et al.(2021) to perform uncertainty quantification analysis, use surrogate models, couple multiscale models and execute sensitivity analysis on HPC.