Welcome to UQpy’s documentation!

UQpy (Uncertainty Quantification with python) is a general purpose python toolbox for modeling uncertainty in physical and mathematical systems. The code is organized as a set of modules centered around core capabilities in Uncertainty Quantification (UQ).


Product Owner:

Michael D. Shields

Lead Developers:

Dimitris Giovanis, Audrey Olivier, Dimitris Tsapetis

Development Team:

Aakash Bangalore Satish, Mohit Singh Chauhan, Lohit Vandanapu,

Ketson RM dos Santos, Katiana Kontolati, Dimitris Loukrezis,

Promit Chakroborty, Lukáš Novák, Andrew Solanto, Connor Krill

Contributors:

Michael Gardner, Prateek Bhustali, Julius Schultz, Ulrich Römer

Introduction

Dependencies required:

macOS, Linux, or Windows
Python >= 3.9

Installation

UQpy can be installed with the following commands.

Using Python package index (PyPI):

MacOS or Linux:

pip install UQpy

Windows:

pip3 install UQpy

Using Conda:

conda install --channel  ``SURG_JHU``  uqpy
conda install -c conda-forge uqpy

From GitHub: Clone your fork of the UQpy repo from your GitHub account to your local disk (to get the latest version):

git clone https://github.com/SURGroup/UQpy.git
cd UQpy
python setup.py {version} install

Development

UQpy is designed to serve as a platform for developing new UQ methodologies and algorithms. To install UQpy as a developer, run:

python setup.py {version} develop

Logging

UQpy adopts the built-in logging python library. This allows for a fine-grain logging of events of various severity levels. The available logging levels allowed by the library are:

DEBUG, INFO, WARNING, ERROR, CRITICAL

The default logging level is set to ERROR. The user can change the logging severity level by including the following line in their code and choosing the desired logging level:

1logging.getLogger('UQpy').setLevel(logging.INFO)

Referencing UQpy

If you are using this software in a work that will be published, please cite this paper:

Olivier, A., Giovanis, D.G., Aakash, B.S., Chauhan, M., Vandanapu, L., and Shields, M.D. (2020). “UQpy: A general purpose Python package and development environment for uncertainty quantification”. Journal of Computational Science. Volume 47, 101204

https://doi.org/10.1016/j.jocs.2020.101204

Examples from the above article were performed using UQpy version 3. These examples can be found at:

https://github.com/SURGroup/UQpy_paper

This repository contains a binder link to execute portions of the code.


Contact

To engage in conversations about uncertainty quantification, or ask questions about UQpy usage and functionality refer to the UQpy discussions tab:

Discussions

Help & Support

For assistance with the UQpy software package, please raise an issue on the Github issues page. Please use the appropriate labels to indicate which module you are specifically inquiring about.