Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

README updates #125

Merged
merged 4 commits into from
May 8, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 10 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,19 +23,19 @@ After completing this module, learners should be able to:
- Apply the `pyemu` Python package to interface with PEST/PEST++.
- Discuss the mathematical concepts that underpin the PEST/PEST++ software.

- part 1: this part covers the Gauss-Levenberg Marquardt approach to parameter estimation and associated uncertainty analysis. This was the foundation of the PEST software for multiple decades and the theory continues to resonate through newer techniques
- part 1: this part covers the Gauss-Levenberg Marquardt (GLM) approach to parameter estimation and associated uncertainty analysis. This was the foundation of the PEST software for multiple decades and the theory continues to resonate through newer techniques
After completing this module, learners should be able to:
- Describe the GLM approach to parameter estimation.
- Explain non-uniqueness, identifiability and equifinality in the context of decision-support modelling.
- Construct a PEST control file and interface files.
- Understand the effect of parameterization schemes on model predictive ability.
- Explain the difference between linear and non-linear uncertainy analysis approaches and the value of each.

- part 2: this part expands largely into ensemble-based parameter estimation and uncertainty analysis methods using PEST++. Advanced topics include management optimization and sequential data assimilation.
- part 2: this part expands largely into ensemble-based parameter estimation and uncertainty analysis methods using PEST++. Advanced topics include management optimization (OPT and MOU) and sequential data assimilation (DA).
After completing this module, learners should be able to:
- Construct a high-dimensional PEST control file and interface files.
- Implement GLM and ensemble-based parameter estimation and uncertainty analysis workflows using PEST++ and associated tools.
- Apply management optimization and sequential data assimilation techniques to decision-support groundwater modelling problems.
- Apply management optimization (OPT and MOU) and sequential data assimilation (DA) techniques to decision-support groundwater modelling problems.


**To run the Part 0 notebooks**
Expand Down Expand Up @@ -78,6 +78,13 @@ PEST++MOU:

IMPORTANT NOTE: When running some of these notebooks, PEST++ undertakes parallel model runs for computational efficiency. These runs are coordinated using internet communication protocols (e.g. TCP/IP). As a result, it is common (but not universal) that the first time a set of parallel runs is launched, a Windows Defender (or similar popup on other operating systems) box appears warning the user. This box can simply be closed by clicking "cancel" and then the model runs should proceed without issue.

## Example Tutorial Notebook Learning Flow
While there is an intentional organization to the notebooks, described above, they can also serve as standalone references, or a subset can be curated to achieve a specific learning outcome. An example of a curated learning flow for a common decision support modeling application is shown in the flowchart below.

<p align="center">
<img src="flowchart.png" alt="flowchart">
</p>

## Installation Instructions

**Download the course repository:**
Expand Down
Binary file added flowchart.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading