Add EPANET MSX enhancements #426
Conversation
The class will be similar to the WaterNetworkModel in terms of its structure and options.
Merge main into development branch
Citations
Update to add basic citation class
Exceptions
* Update to exception documentation * Update documentation for EN errors
* Updated MSX binaries, PR issued to EPANETMSX main * Updated toolkit to match modified code in MSX DLL * Fixed an error in the filename encoding
* Move library to new directory * Updates to documentation * New ipynb demo * various bug fixes
There was a problem hiding this comment.
Overall, PR is well organized and well written. The MSX code and API follows the current WNTR style and is integrated clearly with the existing code base. Documentation and examples are provided to help users learn to use the new MSX features. A test suite is provided, but should be expanded to cover more of the code and common use cases.
I have commented on some minor items throughout. Aside from a typo preventing correct code execution in the example, nothing is of high importance. I recommend that we expand the test suite before merging, which I'd be happy to help with.
|
|
||
| The EpanetSimulator can use EPANET-MSX 2.0 :cite:p:`shang2023` to run | ||
| multi-species water quality simulations. | ||
| Additional multi-species simulation options are discussed in :ref:`advanced_simulation`. |
There was a problem hiding this comment.
Could link directly to the "Building MSX models" section here.
There was a problem hiding this comment.
- Suggest adding a direct link to epa msx user manual.
- Suggest making T/T1 consistent (choose one or the other instead of having both throughout) .
- In Cell 11, recommend removal of leftover testing comment.
- Suggest adding axes labels for last figure from cell 9 .
- Cell 17 naming error, need to lowercase mutlisource-cl.
Pull in USEPA/wntr/main
add msx simulation test
…tion is not pulled in this commit
This provides updates to WNTR that integrate EPANET-MSX into the EpanetSimulator.
In addition to the new simulation options, this provides MSX model objects, such as species, terms, etc., that can be added to a water network model in a similar way to how WNTR works currently.
Demonstration is located in examples/demos/