Recent Releases of mizuRoute

mizuRoute - v3.1.0

Summary

This is a tag related answer changes from the previous tag.
This tag includes completion of (hopefully) fully functional CTSM coupling and enable CESM coupling run (still need work to complete fully scientifically useful CESM coupling)

What's Changed

River routing related change

Updates on functions/subroutine

Documentation updates

Refactoring (coupling codes)

Clean up

Bugfix

Usability improvements

Miscellaneous

New Contributors

Full Changelog: https://github.com/ESCOMP/mizuRoute/compare/v3.0.1...v3.1.0

Hydrosphere - Freshwater and Hydrology - Fortran
Published by nmizukami about 1 month ago

mizuRoute - v3.0.1

Summary

No answer changes from the previous tag

However, there was additional bugs in MPI domain decomposition (newly found ones). This change make domain decomposition robust for uncommon river network (i.e., network including river segment without associated hrus)

Another bug fixes are related to cesm-coupled mode.

Documentation updates (but no complete)

What's Changed

Documentation updates

New Contributors

Full Changelog: https://github.com/ESCOMP/mizuRoute/compare/v3.0.0...v3.0.1

Hydrosphere - Freshwater and Hydrology - Fortran
Published by nmizukami 5 months ago

mizuRoute - v3.0.0

What's Changed

Full Changelog: https://github.com/ESCOMP/mizuRoute/compare/cesm-coupling.n04_v2.3.0...v3.0.0

Hydrosphere - Freshwater and Hydrology - Fortran
Published by ekluzek 9 months ago

mizuRoute - cesm-coupling.n04_v2.3.0

What's Changed

New Contributors

Full Changelog: https://github.com/ESCOMP/mizuRoute/compare/cesm-coupling.n03_v2.2.0...cesm-coupling.n04_v2.3.0

Hydrosphere - Freshwater and Hydrology - Fortran
Published by nmizukami 9 months ago

mizuRoute - cesm-coupling.n03_v2.2.0

Summary

Answer changes from the previous tag

Floodplain option

new control variable is <floodplain> = T or F

Floodplain is represented with very gentle slope (default 1:1000), extending from the top of side wall of the channel. The channel uses a bankfull depth. Currently bankfull depth is computed based on upstream area for each reach. This default method may change in the future. A user is encouraged to come up with the way to estimate the bankfull depth (and width) outside mizuRoute.

Regardless of whether floodplain is on or off, the method to compute celerity, diffusivity use the section 3.3 in Beg M et al., 2022. This is primary cause of the answer change from the previous version, which use the assumption of "wide" rectangular channel width, that simplifies the flow area computation. Also, from the current version, the channel geometry type can be rectangular (default) or trapezoidal (by providing side wall slope as input parameter).

What's Changed

allow a generic name when using only one routing method

Update external handling

For CESM coupling

routing with floodplain

Cleanup

New Contributors

Full Changelog: https://github.com/ESCOMP/mizuRoute/compare/cesm-coupling.n02_v2.1.4-standalone...cesm-coupling.n03_v2.2.0

Hydrosphere - Freshwater and Hydrology - Fortran
Published by nmizukami over 1 year ago

mizuRoute - cesm-coupling.n02_v2.1.4-standalone

Summary

No answer changes from the previous tag

A few enhancements were included

  • User can specify minimum reach length for routing. For reach below this threshold, inflow is passed as outflow and lateral flow is added to that as normal.
  • User can input lateral flow at the top of reach ONLY for headwater catchments as a option, so that reach routing happens.
  • User can control History file time stamp can be control by specify where in the time step is used (0: start of time step, 86400: end of time step if time step is daily)
  • User can specify time step convention in runoff (for now, start or end)
  • runoff input specification in control file uses just file name with wild card (if multiple the netCDFs exist).
  • Hanasaki (H06) reservoir scheme is enable

What's Changed

enhancement

**Enabling Hanasaki reservoir **

cleaning

Full Changelog: https://github.com/ESCOMP/mizuRoute/compare/cesm-coupling.n02_v2.1.3...cesm-coupling.n02_v2.1.4-standalone

Hydrosphere - Freshwater and Hydrology - Fortran
Published by nmizukami over 1 year ago

mizuRoute - cesm-coupling.n02_v2.1.3

Summary

No answer changes from the previous tag

A few enhancements were included

  • hru id in vector runoff input can be long integer.
  • inflow for each reach can be output in history file
  • For cesm-coupling, the other routing methods can be used, in addition to IRF routing.

What's Changed

makefile cleanup

cleanup

New functions

CESM-coupling

Full Changelog: https://github.com/ESCOMP/mizuRoute/compare/cesm-coupling.n02_v2.1.2...cesm-coupling.n02_v2.1.3

Hydrosphere - Freshwater and Hydrology - Fortran
Published by nmizukami almost 2 years ago

mizuRoute - cesm-coupling.n02_v2.1.2

What's Changed

Model physics

Bugfixes

Miscellaneous improvement

Documentation

Library updates

Full Changelog: https://github.com/ESCOMP/mizuRoute/compare/cesm-coupling.n01_v2.1.0...cesm-coupling.n02_v2.1.2

Hydrosphere - Freshwater and Hydrology - Fortran
Published by nmizukami over 2 years ago

mizuRoute - cesm-coupling.n01_v2.1.0

What's Changed

CTSM coupling

CESM system testing

Time management change

Model physics

User specified history output frequency

Gauge location output capability

Continue run capability

Run with multiple routing methods

Code style, cleanup

Miscellaneous improvement

Bugfixes

Documentation

Full Changelog: https://github.com/ESCOMP/mizuRoute/compare/cesm-coupling.n00_v2.0.1...cesm-coupling.n01_v2.1.0

Hydrosphere - Freshwater and Hydrology - Fortran
Published by nmizukami over 2 years ago

mizuRoute - version 1.2.3

What's Changed

Bugfix (science changes):

New features:

Minor updates (cleanup, doc updates, non-science etc.):

Full Changelog: https://github.com/ESCOMP/mizuRoute/compare/v1.2.2...v1.2.3

Hydrosphere - Freshwater and Hydrology - Fortran
Published by nmizukami about 3 years ago

mizuRoute - v1.2.2

What's Changed

Bugfix (science changes):

New features:

Minor updates (cleanup, doc updates, non-science etc.):

New Contributors

Full Changelog: https://github.com/ESCOMP/mizuRoute/compare/v1.2.1...v1.2.2

Hydrosphere - Freshwater and Hydrology - Fortran
Published by nmizukami over 3 years ago

mizuRoute - Hybrid parallel, Lake module, and CTSM coupling

What's Changed

Lake routine implementation

New routing methods and bugfixes

CESM coupling

I/O

style, comment changes, minor bugfixes

Time management (stand-alone)

Miscellaneous

New Contributors

Hydrosphere - Freshwater and Hydrology - Fortran
Published by nmizukami over 4 years ago

mizuRoute - JAMES2021

This is snapshot of mpi version of mizuRoute code, used for publication:

Mizukami et al., 2021: A vector-based river routing model for Earth System Models: Parallelization and global applications, Journal of Advances in Modeling Earth Systems.

Hydrosphere - Freshwater and Hydrology - Fortran
Published by nmizukami almost 5 years ago

mizuRoute - v1.2

mizuRoute v1.2

New features

Hydrosphere - Freshwater and Hydrology - Fortran
Published by nmizukami over 5 years ago

mizuRoute -

New features

  • Output frequency options (annual, month, day or single file)
  • User specified starting and ending time.
  • No-leap or Gregorian calendar allowed for runoff input
  • Runoff mapping capability (require mapping weight netCDF), allowing gridded runoff input
  • Improved performance of network topology augmentation.
  • restart capability
  • Combined ntopo and routing procedures (separated in v1.0 version)

Hydrosphere - Freshwater and Hydrology - Fortran
Published by nmizukami over 5 years ago

mizuRoute - v1.2.1

Enhancements:

  • Large integer is allowed for runoff HRU ID.
  • Improved netcdf I/O performance.
  • Robust mapping file handling. debug option to mapping file check.
  • Performance improvement for IRF routine/flow_accumulation routines.

Bugfixes:

  • ixPrint for on-screen debug printing is now working with format.
  • error in basin unit hydrograph routing at hourly time steps
  • error in reach unit hydrograph construction. make sure sum of unit hydrograph is one.
  • time utility routine - error in julian day computation, error in parsing time string.
  • basin unit hydrograph restart reading.

New features:

  • a simple water abstraction/injection capability for IRF and KWT routines
  • restart write options - Annual, monthly, daily, Last, Specified, and Never. timing in restart file name indicates restart timing not drop-off timing.
  • Modified control specification: added single history file output option
  • New control specification for output netcdf options (classic, 64bit_offset, netcdf4). default netcdf option: netcdf4
  • New control specification for calendar, time unit, and fillvalue in runoff netcdf
  • output file name definition - case_name.h.yyyy-mm-dd-sec.nc (history file) and case_name.r.yyyy-mm-dd-sec.nc (restart file)

Others:

  • various minor code refactoring and cleaning

Hydrosphere - Freshwater and Hydrology - Fortran
Published by nmizukami over 5 years ago

mizuRoute - bugfix

Bugfix- Array bound specification

Hydrosphere - Freshwater and Hydrology - Fortran
Published by nmizukami almost 7 years ago

mizuRoute - mizuRoute v1.0

mizuRoute version used in

Mizukami, N., M. P. Clark, K. Sampson, B. Nijssen, Y. Mao, H. McMillan, R. J. Viger, S. L. Markstrom, L. E. Hay, R. Woods, J. R. Arnold, and L. D. Brekke, 2016: mizuRoute (version 1) - river network routing tool for continental domain water resources applications. Geoscientific Model Development.

Hydrosphere - Freshwater and Hydrology - Fortran
Published by bartnijssen almost 10 years ago