LLNL's Themis is a Python-based scientific workflow ensemble manager for running concurrent UQ simulations on high-performance computers. Using a simple, non-intrusive interface to simulation models, it provides the following capabilities:
- generating ensemble of simulations leveraging LC's HPC resources
- analyzing ensemble of simulations output
Themis has been used for simulations in the domains of Inertial Confinement Fusion, National Ignition Facility experiments, climate, as well as other programs and projects.
The themis
package manages the execution of simulations. Given a set of inputs (sample points) to run a simulation on, this package will execute them in parallel, monitor their progress, and collect the results. The themis
package work with Python 2 and 3.
To get the latest public version:
pip install llnl-themis
To get the latest stable from a cloned repo, simply run:
pip install .
Alternatively, add the path to this repo to your PYTHONPATH environment variable or in your code with:
import sys
sys.path.append(path_to_themis_repo)
The documentation can be built from the docs
directory using:
make html
Read the Docs coming soon.
Themis maintainer can be reached at: domyancic1@llnl.gov
Contributing to Themis is relatively easy. Just send us a pull request. When you send your request, make develop the destination branch on the Themis repository.
Your PR must pass Themis' unit tests and documentation tests, and must be PEP 8 compliant. We enforce these guidelines with our CI process. To run these tests locally, and for helpful tips on git, see our Contribution Guide.
Themis' develop
branch has the latest contributions. Pull requests should target develop
, and users who want the latest package versions, features, etc. can use develop
.
Contributions should be submitted as a pull request pointing to the develop
branch, and must pass Themis' CI process; to run the same checks locally, use:
pytest tests/
See our change log for more details.
Please note that Themis has a Code of Conduct. By participating in the Themis community, you agree to abide by its rules.
Themis is distributed under the terms of the MIT license. All new contributions must be made under the MIT license. See LICENSE and NOTICE for details.
LLNL-CODE-838977