Skip to content

tong10/psuade

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PSUADE

PSUADE is an acronym for Problem Solving environment for Uncertainty Analysis and Design Exploration. It is a software toolkit to facilitate the UQ tasks described below. PSUADE has a rich set of tools for performing uncertainty analysis, global sensitivity analysis, design optimization, model calibration, and more. In particular, PSUADE supports a global sensitivity methodology for models with a large number of parameters and complex parameter correlations.

History

It enjoyed its first public release in 2007 and it has been over 15 years. In 2016, as part of the Carbon Capture Simulation Initiative (CCSI program) software suite (it is the computational workhorse of the CCSI FOQUS software), it has earned the RD100 award. PSUADE has been downloaded and used across several continents for many diverse scientific applications.


Getting Started

For problems with installation, contact:

Charles Tong at [email protected]

Linux

A. To install the PSUADE package, you need to make sure you have cmake on your system. (cmake is open source software availible at www.cmake.org) cmake should also have installed an easier interface program called ccmake, but that isn't required. If you do not have ccmake, you will need to turn on some of the packages manually.

You will also need gcc, g++, and gfortran of version 4.4 or greater. icc 10 or higher will also work.

Follow the steps below:

  1. mkdir build

  2. cd build

  3. if you have a preferred Fortran compiler, set the environment variable FC to it (use setenv in c-shell or export in other shells)

  4. ccmake .. hit 'c'

    BUILD_SHARED, MARS, BOBYQA, and METIS should have been selected (for additional packages, contact us).

    If you would like to install psuade at a designated location accessible to other users, set the installation directory.

    hit 'c' hit 'c' again until you are able to hit 'g'. hit 'g' to generate an exit

    If you do not have ccmake, : cmake .. and then open the CMakeCache.txt file and make sure the packages MARS (set to on from off), BOBYQA, and METIS are turned on.

  5. now do a "make" or "make install" if you desire to install it somewhere

B. After all compilation is done successfully, the executable "psuade" can be found in the bin directory and the libraries will be in the lib directory.

C. You can run a simple test by going to the /Examples/Bungee directory and issuing: cc -o simulator simulator.c -lm ../../build/bin/psuade psuade.in Afterward, you should see a file called 'psuadeData'.

D. You can also run the built in tests my running 'make test' from the build directory. WARNINGS:

  1. This will take a long time. At least 20 minutes
  2. Some tests are expected to fail if you aren't running on LLNL LC cluster. PSUADE is very sensitive to the processor it's running on and the numeric results will be off on different processors and environment variables. As long as a few tests pass you're probably OK.

E. You can install PSUADE by running 'make install'

F. You can build a package for other people to install by running 'make package'

G. Now read the short manual in the Doc/Manual directory and follow the instructions to get a simple application running within minutes.

MacOSX

Requires cmake, and cc/gcc, c++/g++, gfortran >= 4.4.

A. Check to make sure you have cc, c++, gfortran, ccmake

B. Now let's run cmake. Go to your psuade source. mkdir build cd build ccmake .. hit 'c' to get started Make sure BUILD_SHARED, MARS, BOBYQA, and METIS have already been selected. hit 'c' hit 't' to go to advanced options.
I can see in my case cmake has picked up the wrong cc: CMAKE_C_COMPILER /usr/bin/cc
I need to change it to: CMAKE_C_COMPILER /opt/local/bin//gcc

Aside from that it seems OK, so I hit 'c' until I can hit 'g' hit 'g' to generate and exit.

C. Now build: run 'make' It should build for a while.

D. You can run a simple test by going to the Examples/Bungee directory and issuing: cc -o simulator simulator.c -lm ../../build/bin/psuade psuade.in Afterward, you should see a file called 'psuadeData'.

E. You can also run the built in tests my running 'make test' from the build directory. WARNINGS:

  1. This will take a long time. At least 20 minutes
  2. Some tests are expected to fail on MACOSX PSUADE is very sensitive to the system it's running on, and we get different results on OSX than Linux. So the following tests are expected to fail: 8 - ARSM1 (Failed) 10 - Morris20MOAT (Failed) 11 - Morris20LH (Failed) 12 - MCMCTest (Failed)

F. You can install PSUADE by running 'make install'

G. You can build a package for other people to install by running 'make package'

H. Now read the short manual in the Doc/Manual directory and follow the instructions to get a simple application running within minutes.


Citation

If you are referencing in a publication, please cite the following book chapter

C. "Tong, Problem Solving Environment for Uncertainty Analysis and Design Exploration," Handbook of Uncertainty Quantification, edited by R. Ghanem, D. Higdon, and H. Owhadi, doi:10.1007/978-3-319-11259-6_53-1, 2016.


Explanation of directories

Examples : test programs Src : source code Doc : documentations External : external packages


LICENSE

PSUADE is distributed under the terms of both the MIT license and the Apache License (Version 2.0). Users may choose either license, at their option.

All new contributions must be made under both the MIT and Apache-2.0 licenses.

See LICENSE-MIT, LICENSE-APACHE, COPYRIGHT, and NOTICE for details.

SPDX-License-Identifier: (Apache-2.0 OR MIT)

LLNL-CODE-842506

About

Problem Solving environment for Uncertainty Analysis and Design Exploration

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages