SOUPy

SOUPy: Stochastic PDE-constrained optimization under high-dimensional uncertainty in Python - Published in JOSS (2024)

https://github.com/hippylib/soupy

Science Score: 95.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 9 DOI reference(s) in README and JOSS metadata
  • Academic publication links
    Links to: sciencedirect.com, joss.theoj.org, zenodo.org
  • Committers with academic emails
    2 of 5 committers (40.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
    Published in Journal of Open Source Software

Keywords from Contributors

pde
Last synced: 6 months ago · JSON representation

Repository

Stochastic Optimization under Uncertainty in Python.

Basic Info
  • Host: GitHub
  • Owner: hippylib
  • License: gpl-3.0
  • Language: Jupyter Notebook
  • Default Branch: main
  • Size: 1.97 MB
Statistics
  • Stars: 36
  • Watchers: 4
  • Forks: 4
  • Open Issues: 1
  • Releases: 2
Created about 3 years ago · Last pushed 9 months ago
Metadata Files
Readme Changelog Contributing License Code of conduct

README.md

Build Status Documentation Status DOI DOI

Stochastic Optimization under high-dimensional Uncertainty in Python

Stochastic Optimization under high-dimensional Uncertainty in Python—SOUPy, implements scalable algorithms for the optimization of large-scale complex systems governed by partial differential equations (PDEs) under high-dimensional uncertainty. The library features various risk measures (such as mean, variance, and superquantile/condition-value-at-risk), probability/chance constraints, and optimization/state constraints. SOUPy enables efficient PDE-constrained optimization under uncertainty through parallel computation of the risk measures and their derivatives (gradients and Hessians). The library also provides built-in parallel implementations of optimization algorithms (e.g. BFGS, Inexact Newton CG), as well as an interface to the scipy.optimize module in SciPy. Besides the benchmark/tutorial examples in the examples folder, SOUPy has been used to solve large-scale and high-dimensional stochastic optimization problems including optimal control of turbulence flow, optimal design of acoustic metamaterials and self-assembly nanomaterials, and optimal management of groundwater extraction, etc.

SOUPy is built on the open-source hIPPYlib library, which provides adjoint-based methods for deterministic and Bayesian inverse problems governed by PDEs, and makes use of FEniCS for the high-level formulation, discretization, and solution of PDEs.

SOUPy is in active development to incorporate advanced approximation algorithms and capabilities, including:

  • Taylor expansion-based approximations for risk measure evaluation
  • High-dimensional quadrature methods such as sparse grids and quasi Monte Carlo
  • Decomposition of high-dimensional uncertain parameter spaces by mixture models
  • Multi-fidelity methods and control variates
  • Interfaces with Bayesian inverse problems

See the SOUPy documentation and our JOSS paper for more information.

Please cite SOUPy as @article{Luo2024, doi = {10.21105/joss.06101}, url = {https://doi.org/10.21105/joss.06101}, year = {2024}, publisher = {The Open Journal}, volume = {9}, number = {99}, pages = {6101}, author = {Dingcheng Luo and Peng Chen and Thomas O'Leary-Roseberry and Umberto Villa and Omar Ghattas}, title = {{SOUPy}: Stochastic PDE-constrained optimization under high-dimensional uncertainty in Python}, journal = {Journal of Open Source Software} }

Acknowledgements

This project is partially supported by NSF grants #2012453 and #2245674.

Owner

  • Name: hippylib
  • Login: hippylib
  • Kind: organization

JOSS Publication

SOUPy: Stochastic PDE-constrained optimization under high-dimensional uncertainty in Python
Published
July 28, 2024
Volume 9, Issue 99, Page 6101
Authors
Dingcheng Luo
Oden Institute for Computational Engineering and Sciences, The University of Texas at Austin, USA
Peng Chen
School of Computational Science and Engineering, Georgia Institute of Technology, USA
Thomas O'Leary-Roseberry
Oden Institute for Computational Engineering and Sciences, The University of Texas at Austin, USA
Umberto Villa
Oden Institute for Computational Engineering and Sciences, The University of Texas at Austin, USA
Omar Ghattas
Oden Institute for Computational Engineering and Sciences, The University of Texas at Austin, USA, Walker Department of Mechanical Engineering, The University of Texas at Austin, USA
Editor
Jed Brown ORCID
Tags
Uncertainty quantification PDE-constrained optimization Optimization under uncertainty Adjoint method

GitHub Events

Total
  • Watch event: 2
  • Delete event: 1
  • Push event: 6
  • Pull request review event: 1
  • Pull request event: 3
  • Fork event: 2
  • Create event: 2
Last Year
  • Watch event: 2
  • Delete event: 1
  • Push event: 6
  • Pull request review event: 1
  • Pull request event: 3
  • Fork event: 2
  • Create event: 2

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 43
  • Total Committers: 5
  • Avg Commits per committer: 8.6
  • Development Distribution Score (DDS): 0.163
Past Year
  • Commits: 2
  • Committers: 1
  • Avg Commits per committer: 2.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Dingcheng Luo 4****o 36
SciML-UQ@Georgia Tech p****2@g****u 3
tomoleary t****y@g****m 2
Jed Brown j****d@j****g 1
Daniel S. Katz d****z@i****g 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 1
  • Total pull requests: 28
  • Average time to close issues: 3 months
  • Average time to close pull requests: 6 days
  • Total issue authors: 1
  • Total pull request authors: 4
  • Average comments per issue: 1.0
  • Average comments per pull request: 0.07
  • Merged pull requests: 24
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 2
  • Average time to close issues: N/A
  • Average time to close pull requests: 3 days
  • Issue authors: 0
  • Pull request authors: 1
  • Average comments per issue: 0
  • Average comments per pull request: 0.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • Himscipy (1)
Pull Request Authors
  • dc-luo (26)
  • jedbrown (2)
  • danielskatz (2)
  • tomoleary (1)
Top Labels
Issue Labels
Pull Request Labels
bug (2) enhancement (1)

Dependencies

.github/workflows/ci.yml actions
  • actions/checkout v2 composite
doc/requirements.txt pypi
  • myst_parser *
  • sphinx *
  • sphinx-rtd-theme *
setup.py pypi