/EasyVVUQ

Python 3 framework to facilitate verification, validation and uncertainty quantification (VVUQ) for a wide variety of simulations.

Primary LanguagePythonGNU Lesser General Public License v3.0LGPL-3.0

EasyVVUQ icon

EasyVVUQ

Build Status Language grade: Python Documentation Status Coverage Status CII Best Practices Binder

The aim of this library is to facilitate verification, validation and uncertainty quantification (VVUQ) for a wide variety of simulations.

The easiest way to get started is to follow the tutorials in our Binder.

Development was funded by the EU Horizon 2020 project VECMA.

Requirements

To use the library you will need Python 3.6+.

Installation using pip

If you are unsure of the version of python your default pip works for type:

pip --version

If the output ends with (python 2.7) you should replace pip with pip3 in the following commands.

The following should fully install the library:

pip install easyvvuq

To upgrade the library use:

pip install easyvvuq --upgrade

Manual installation from repository

Alternatively, you can manually install EasyVVUQ. First clone the repository to your computer:

git clone https://github.com/UCL-CCS/EasyVVUQ.git

Note: As above, you need to be sure you are installing for Python 3 - if necessary replace pip with pip3 and python with python3 in the commands below.

We are trying to keep dependencies at a minimum but a few are inevitable, to install them use:

cd EasyVVUQ/

pip install -r requirements.txt

Then the library can be installed using:

python setup.py install

Getting Started

Documentation, including a basic tutorial, is avalable here.

Citing EasyVVUQ

Richardson, R A, Wright, D W, Edeling, W, Jancauskas, V, Lakhlili, J and Coveney, P V. 2020 EasyVVUQ: A Library for Verification, Validation and Uncertainty Quantification in High Performance Computing. Journal of Open Research Software, 8: 11. DOI: 10.5334/jors.303.

Wright, D.W., Richardson, R.A., Edeling, W., Lakhlili, J., Sinclair, R.C., Jancauskas, V., Suleimenova, D., Bosak, B., Kulczewski, M., Piontek, T., Kopta, P., Chirca, I., Arabnejad, H., Luk, O.O., Hoenen, O., Weglarz, J., Crommelin, D., Groen, D. and Coveney, P.V. (2020), Building Confidence in Simulation: Applications of EasyVVUQ. Adv. Theory Simul., 3: 1900246. DOI: 10.1002/adts.201900246.