Skip to content

v2.3.2-rc1

Pre-release
Pre-release
Compare
Choose a tag to compare
@smwesten-usgs smwesten-usgs released this 20 Apr 18:16
· 37 commits to master since this release

This is an unofficial release of the code documented in the report found here: https://pubs.er.usgs.gov/publication/tm6A59. Official, approved versions of the code will be released at https://code.usgs.gov once all internal USGS reviews are complete.

Executables are provided for Windows 10 (64-bit). The executables provided here must have the associated netcdf and hdf5 DLLs available (in the same directory as the executable or on the user's path).

DIFFERENCES FROM PREVIOUS VERSIONS

  • several bugfixes, including a segfault that occurred when updating Kcb curves when the year is a leap year.

  • update of build tools; migration from CMake to meson as a build system.

  • add ability to supply a table to provide precipitation and minimum and maximum air temperature values, as opposed to using Arc ASCII grids or netCDF files of gridded data.

  • add new control file keywords to simplify conversion from Kelvin or degrees Celsius to degrees Fahrenheit.

  • projections that specify 'standard_parallel' values (PROJ.4: '+lat_1' and '+lat_2') should now properly form output metadata that plots correctly in ArcMap and ArcGIS Pro.

TABULAR DATA

Tabular data may be used with this version by including PRECIPITATION_METHOD TABULAR in the control file. The table may be specified similar to the manner in which the land-use and irrigation files; for example: WEATHER_DATA_LOOKUP_TABLE 1944-to-2023_weather_data.txt. The weather data table should look like:

DATE         PRCP      TMIN      TMAX
1944-01-01      0         1        21
1944-01-02      0       -10        10
1944-01-03      0        -7        19
1944-01-04      0        -4        28
1944-01-05      0        11        28
1944-01-06      0        25        33

NEW COMMAND-FILE DIRECTIVES

NOTE: these do not work with table-supplied values yet! Several new command-line directives are now active for use in converting from units of millimeters to inches and from units of Kelvin or degrees Celsius to degrees Fahrenheit when the gridded weather data are read in. The new directives are:

PRECIPITATION_UNITS_MILLIMETERS
TMAX_UNITS_KELVIN
TMIN_UNITS_KELVIN
TMAX_UNITS_CELSIUS
TMIN_UNITS_CELSIUS

As always, it is highly recommended that the user verify that the input data are properly read in and converted by examining the netCDF files containing the converted output. This can be done by adding OUTPUT ENABLE tmax tmin gross_precip to the control file.