This page contains official release of the MESH code.

 "Interim releases" (e.g., beta versions) are available here.

The latest version of MESH is available here.

Most MESH versions are identified by a string of three numbers: "MESH major.minor.release"

MESH versions 1.3.009 is the last release to use incremental release numbering. The release number for MESH versions 1.3.647 and later correspond to the revision number of that release in the code repository.

Page contents:

Latest Versions

Latest versions are the most recent releases of Standalone MESH. Using the top-listed most recent version is recommended for most users. If possible, users are recommended to upgrade their code. If starting a new project, users are recommended to use only the most recent version of the code.

For development purposes and certain applications, more recent versions of MESH are also available that contain experimental features.

MESH 1.4

MESH 1.4 is the current MESH series.

MESH 1.4.1398

MESH 1.4.1398 includes many bug-fixes and code optimizations, improved message and error handling, a significant update to OUTFIELDSFLAG and enhancements to many output files. It also continues to add more functionality to the new inline routing (RTE) and adds resume functionality to both RTE and SVS.
SIMSTATS (AUTOCALIBRATIONFLAG) and OUTFIELDSFLAG outputs are now created in the general output folder specified in MESH_input_run_options.ini.
MESH 1.4.1398 cannot be used to run in "point mode".
This version of MESH has new instructions for compilation.

In the migration of CLASS to version 3.6 in MESH 1.3.009, the THFC formulation based on Soulis (2009) was incorrectly assigned to the bottom-most layer in mineral soils, instead of to the deepest permeable layer in the soil column. This change was corrected in revision 1336 and impacts all releases of MESH 1.3 from version 1.3.009 and later, and all releases of MESH 1.4 until this version. MESH 1.4.1398 fixes this issue.

There is no impact to previous versions that ran using setups where SDEP occurs inside or below the total depth of the column (ZBOT(NSL)), in which case the deepest permeable layer and the bottom-most layer are the same layer inside the soil column.

An update page for this release is here.

May 11, 2018 (also labelled "r1398")

MESH 1.4.1149

MESH 1.4.1149 adds more functionality to the new inline routing option (RTE), adds a new baseflow option (WF_LZS), adds new optional parameter file formats (including support for fully-distributed gridded inputs), new option flags in MESH_parameters_hydrology.ini, and a "point mode" to run a land surface scheme in a single column to diagnose processes at the observatory scale, which is compatible with existing RUNCLASS benchmark files. The release also adds support for the "tb0" format for the streamflow and reservoir inputs files, and with the addition of MESH_input_reservoir.tb0, supports skipping records for controlled reservoirs (i.e., for streamflow insertion).
MESH 1.4.1149 re-enables the Prairie Blowing Snow Model (PBSM)

An update page for this release is here.

September 22, 2017 (also labelled "r1149")

MESH 1.4.1064

MESH 1.4.1064 introduces a new experimental option for inline routing (RTE). The scheme uses the same physics as in standalone WATROUTE (RPN_watroute), but is not completely implemented and does not include reservoir routing, streamflow insertion, resume functionality, temporally-driven parameterization, or diversions, and is disabled by default.

An update page for this release is here.

May 1, 2017 (also labelled "r1064")

MESH 1.4.1037

The spacing and formatting requirements for many of the input and output files are the same as required for MESH 1.4.1022. If migrating from MESH 1.4.1022, no changes are required. If migrating from earlier versions, like a version of MESH 1.3, review the migration notes and the critical bug fixes that were included with MESH 1.4.1022.
The Prairie Blowing Snow Model (PBSM) remains disabled in MESH 1.4.1037 from concern that mismatched indices are used when exchanging data with CLASS and the driver, after converting the code to use tile-based indexing inside the model loop in MESH 1.3.733 and with the addition of the MPI exchange in MESH 1.4.1022.

An update page for this release is here.

February 31, 2017

MESH 1.4.1022

MESH 1.3.1022 fixes an issue where a fix made in MESH 1.3.003 caused the derived roughness coefficient for the floodplain to be R1=2.0*WF_R2*WF_R2, instead of R1=2.0*WF_R2 as intended. Streamflow outputs and metrics based on them differ, especially around flooding and peak flow events, when MESH 1.3 parameter files are used with the MESH 1.4 series of code. The runoff generated by CLASS remains unchanged.

Hydrology coefficients calibrated to MESH 1.3 may not directly transfer to the MESH 1.4 series of code. A workaround is described here.

MESH 1.4.1022 fixes an issue where previously, the last time-step in the simulation day was incremented before calling WF_ROUTE. Dependent upon how much streamflow is generated within the last time-step of the simulation day, the streamflow outputs and metrics based upon them may differ when MESH 1.3 parameter files are used with the MESH 1.4 series code.

The runoff generated by CLASS remains unchanged.

The spacing and formatting requirements of many input and output files have changed. Review the notes here.
The Prairie Blowing Snow Model (PBSM) is disabled in MESH 1.4.1022 from concern that mismatched indices are used when exchanging data with CLASS and the driver, after converting the code to use tile-based indexing inside the model loop in MESH 1.3.733.

An update page for this release is here.

December 14, 2016

Legacy versions

Legacy versions are those versions of MESH released prior to the latest series of MESH versions. The latest series of MESH versions is the MESH 1.4 series.

MESH 1.3

MESH 1.3 was succeeded with the release of MESH 1.4 and is no longer supported.

MESH 1.3.733

The modification to change the driver to use tile-based indexing may have caused mismatched indices when passing data to and from the Prairie Blowing Snow Model (PBSM). Using PBSM is not advised with MESH 1.3.733.

March 16, 2015

Gridded Outputs (OUTFIELDSFLAG)

SIMSTATS (AUTOCALIBRATIONFLAG)

MESH 1.3.686

December 23, 2014

General Updates

Gridded Outputs (OUTFIELDSFLAG)

SIMSTATS (AUTOCALIBRATIONFLAG)

MESH 1.3.647

MESH versions 1.3.647 and later use the underlying revision of the corresponding "tag" in the code repository as the release number.
MESH 1.3.647 includes a bug where the reservoir location in the East-West direction is not derived correctly if the LOCATIONFLAG control flag is on. This issue is fixed in MESH 1.4.1022.
Text format resume files from previous versions are not compatible with MESH 1.3.647.

November 13, 2014

General Updates

Climate Forcing Files

Gridded Outputs (OUTFIELDSFLAG)

CLASS

Standalone WATROUTE (RPN_watroute)

SIMSTATS (AUTOCALIBRATIONFLAG)

MESH 1.3.009 (revision 557)

MESH 1.3.009 is the last release to use incremental release numbering.

In the migration of CLASS to version 3.6 in MESH 1.3.009, the THFC formulation based on Soulis (2009) was incorrectly assigned to the bottom-most layer in mineral soils, instead of to the deepest permeable layer in the soil column. This change was corrected in revision 1336 and impacts all releases of MESH 1.3 from version 1.3.009 and later, and all releases of MESH 1.4 until MESH 1.4.1398.

There is no impact to previous versions that ran using setups where SDEP occurs inside or below the total depth of the column (ZBOT(NSL)), in which case the deepest permeable layer and the bottom-most layer are the same layer inside the soil column.

Both text and r2c format resume files from previous versions are not compatible with MESH 1.3.009.

January 1, 2014

MESH 1.3.008 (revision 548)

Text format resume files from previous versions are not compatible with MESH 1.3.008.

August 12, 2013

MESH 1.3.007 (revision 533)

This release accidentally removes the default options of the PRINTRUNOFFFILEFLAG and PRINTLEAKAGEFILEFLAG control flags such that the runoff and recharge outputs may always be created for use with standalone WATROUTE, dependent upon compiler options. To disable these outputs, the control flags must be listed and set to option 0 in the run options input file.

May 24, 2013

MESH 1.3.006 (revision 523)

August 15, 2012

MESH 1.3.005 (revision 517)

June 13, 2012

MESH 1.3.004 (revision 514)

Text format resume files from previous versions are not compatible with MESH 1.3.004.

May 10, 2012

MESH 1.3.003 (revision 489)

A bug-fix in revision 464 of setting WF_R1 = 2.0*WF_R2 in the WF_ROUTE routing code, based on literature, assumed that WF_R1 was the floodplain routing parameter itself, when it is actually a factor used in the flow equation to derive the parameter implicitly (this parameter implicitly appears as ((WF_R1 = 2.0)*WF_R2) in the equations themselves). With this revision, the derivation of the parameter becomes R1 = 2.0*WF_R2*WF_R2, instead of R1 = 2.0*WF_R2 as intended. This change impacts all releases of MESH 1.3 from version 1.3.003 and later.

In revision 978, the change was reverted by restoring WF_R1 = 2.0 (to again be used as a factor in the implicit derivation of R1). This correction is found in all releases of MESH 1.4 and later.

An effect of the correction is that WF_R2 values that were calibrated using MESH 1.3.003-1.3.733 may add unexpected flashiness during high flow events when used in simulations using MESH 1.4 and later. To emulate the behavior of MESH 1.3.003-1.3.733, WF_R1 must be manually derived (set equal to 2.0*WF_R2) and provided via input files to override the internally derived value.

Released for the MESH modelling workshop (September 8, 2011)

September 6, 2011

MESH 1.3.002 (revision 462)

April 27, 2011

MESH 1.3.001 (revision 453)

April 11, 2011

MESH 1.3.000 (revision 448)

Text format resume files from previous versions are not compatible with MESH 1.3.000.

March 18, 2011

MESH 1.2

MESH 1.2.02 (revision 133)

September 17, 2009 (also labelled "SA_MESH_1.3_unofficial")

MESH 1.2.01 (revision 35)

May 25, 2009

Archaic versions

Archaic versions of MESH are those released prior to the migration of the codes to the new repository in January, 2009. The full change history and the former "HAL-depot" support Web pages for these versions were retired at that time.

MESH 1.2

MESH 1.1

MESH 1.1.a01

MESH 1.1

Includes updates from development versions s-a_mesh_1.0.a01, s-a_mesh_1.0.b01, s-a_mesh_1.0.b02, s-a_mesh_1.0.b03, s-a_mesh_1.0.b04, s-a_mesh_1.0.b05, s-a_mesh_1.0.b06, s-a_mesh_1.0.c01, s-a_mesh_1.0.c02, s-a_mesh_1.0.c03, s-a_mesh_1.0.c04, s-a_mesh_1.0.c05, and s-a_mesh_1.0.c06.

Development Updates

s-a_mesh_1.0.c06 Updates

s-a_mesh_1.0.c05 Updates

s-a_mesh_1.0.c04 Updates

s-a_mesh_1.0.c03 Updates

s-a_mesh_1.0.c02 Updates

s-a_mesh_1.0.c01 Updates

s-a_mesh_1.0.b06 Updates

s-a_mesh_1.0.b05 Updates

s-a_mesh_1.0.b04 Updates

s-a_mesh_1.0.b03 Updates

s-a_mesh_1.0.b02 Updates

s-a_mesh_1.0.b01 Updates

s-a_mesh_1.0.a01 Updates

MESH 1.0

May 21, 2007