Model:Mosartwmpy

Mosartwmpy

This code has been community reviewed and published in the open access Journal of Open Source Software (JOSS)

Also known as
Model type	Single
Model part of larger framework
Note on status model
Date note status model

Incorporated models or components:

Spatial dimensions	2D
Spatial extent	Global, Continental, Regional-Scale
Model domain	Hydrology
One-line model description	Model for Scale Adaptive River Transport with Water Management in Python
Extended model description	Derived from MOSART-WM (Model for Scale Adaptive River Transport with Water Management), mosasrtwmpy is a large-scale river-routing Python model used to study riverine dynamics of water, energy, and biogeochemistry cycles across local, regional, and global scales. The water management component represents river regulation through reservoir storage and release operations, diversions from reservoir releases, and allocation to sectoral water demands. The model allows an evaluation of the impact of water management over multiple river basins at once (global and continental scales) with consistent representation of human operations over the full domain.

Keywords:	Hydrological model, hydrodynamics, Reservoir, Python, Rainfall-runoff, Water quantity,

Name	Travis Thurber
Type of contact	Model developer
Institute / Organization	Pacific Northwest National Laboratory
Postal address 1
Postal address 2
Town / City	Seattle
Postal code	98109
State	Washington
Country	United States
Email address	travis.thurber@pnnl.gov
Phone
Fax

Supported platforms	Unix, Linux, Mac OS, Windows
Other platform
Programming language	Python
Other program language
Code optimized	Single Processor, Multiple Processors
Multiple processors implemented	Shared memory
Nr of distributed processors
Nr of shared processors
Start year development	2020
Does model development still take place?	Yes
If above answer is no, provide end year model development
Code development status	Active
When did you indicate the 'code development status'?	2021
Model availability	As code
Source code availability (Or provide future intension)	Through web repository
Source web address	https://github.com/IMMM-SFA/mosartwmpy
Source csdms web address
Program license type	BSD or MIT X11
Program license type other
Memory requirements	~8GB
Typical run time	30 minutes per simulated year

Describe input parameters	river channel network, runoff, water demand, reservoir operations
Input format
Other input format	netcdf
Describe output parameters	water volume, water flux, reservoir storage, unmet water demand
Output format
Other output format	netcdf
Pre-processing software needed?	No
Describe pre-processing software
Post-processing software needed?	No
Describe post-processing software
Visualization software needed?	No
If above answer is yes
Other visualization software

Describe processes represented by the model	water volume flux, water supply, reservoir operations
Describe key physical parameters and equations	river channel network geometry, flow direction, and flow coefficients -- Euler equations reservoir operations -- seasonal and data driven water release behavior
Describe length scale and resolution constraints	provided river channel parameters represent the CONUS at 1/8 degree resolution in WGS84 (epsg 4326); other resolutions possible
Describe time scale and resolution constraints	default settings represent a 3 hour time step for larger scale dynamics, and 1 hour time step for water volume flux subdivided into smaller iterations based on localized grid cell parameters (can get as small as ~12 minutes for some cells)
Describe any numerical limitations and issues

Describe available calibration data sets	mosartwmpy was calibrated against historical MOSART-WM 30 year model runs.
Upload calibration data sets if available:
Describe available test data sets	Two years worth of input data is available to download with the model source code as a means to get familiar with the model. Other datasets are available upon request. Work is ongoing to provide generation utilities for input datasets from raw data sources.
Upload test data sets if available:
Describe ideal data for testing	A two year output dataset is available to download with the model source code as a means to validate and compare the effects of changes to the source code and input datasets.

Do you have current or future plans for collaborating with other researchers?	Yes, ongoing model development is underway as part of the IM3 research project (https://im3.pnnl.gov).

Is there a manual available?	Yes
Upload manual if available:
Model website if any	https://github.com/IMMM-SFA/mosartwmpy
Model forum / discussion board	https://github.com/IMMM-SFA/mosartwmpy/discussions

Comments

This part will be filled out by CSDMS staff

OpenMI compliant	Not yet"Not yet" is not in the list (Yes, No but planned, No but possible, No not possible) of allowed values for the "Code openmi compliant or not" property.
BMI compliant	Not yet"Not yet" is not in the list (Yes, No but planned, No but possible, No not possible) of allowed values for the "BMICompliant" property.
WMT component	Not yet"Not yet" is not in the list (Yes, In progress, No but possible, No not possible) of allowed values for the "Code CMT compliant or not" property.
PyMT component	Not yet"Not yet" is not in the list (Yes, In progress, No but possible, No not possible) of allowed values for the "Code PyMT compliant or not" property.
Is this a data component	No

Can be coupled with:

Model info

Authors

Source code

Model citations

QR-code

Link to this page

Other models by author

Featured reference(s)	Open Access Status	Year	Type of Reference	Cited
Thurber, Travis; Vernon, Chris; Sun, Ning; Turner, Sean; Yoon, Jim; Voisin, Nathalie; 2021. mosartwmpy: A Python implementation of the MOSART-WM coupled hydrologic routing and water management model. Journal of Open Source Software, 63221. 10.21105/joss.03221	cc-by · publishedVersion	2021	a module overview describing a module	14