v2.3.3-rc0

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

• fix: prevent negative values from entering calculation in 'calculate_fraction_exposed_and_wetted_soil_fc'
• fix: take absolute value of ( TMax - TMin ) in Hargreaves-Samani; keep calculating even when TMax < TMin
• fix: promote reference_et0 to c_double type; promote numerous solar_calculation variables to c_double
• fix: remove 'src/actual_et__thornthwaite_mather_eqns.F90'; this was kludgy leftover code from SWB v 1.0
• fix: force open water ET to respect incoming water availability on daily basis
• feat: eliminate bare 'DUMP_VARIABLES [col] [row]' as a legal control file option
• feat: limit interception storage to user-defined value

v2.3.2-rc2

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

• netCDF attributes 'valid_min', 'valid_max', and 'valid_range' are now updated with actual values (as opposed to typical values before)
• the sum of bare_soil_evap and crop_etc is now prevented from exceeding the remaining soil moisture on a given day

v2.3.2-rc1

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.

SWB2 version 2.2.0

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 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 PERVIOUS VERSIONS:

• feat: FAO-56 bare soil evaporation is now handled in a manner more faithful to the FAO-56 publication; the code now contains a pseudo bare-soil storage reservoir to track a subset of soil moisture in the top centimeters of the soil storage reservoir
• fix: the time attribute within a netCDF file is now re-evaluated each time one file is closed and another opened.
• feat: a new control-file directive (for example, PRECIP_COORDINATE_TOLERANCE) can be specified to tell SWB to allow calculations to proceed even if the SWB grid extents and the extents netCDF coordinate values do not overlap exactly.
• test: more unit testing of datetime calculations.
• test: unit tests that should trigger fatal flaws can be written while allowing the unit test run to continue as though no errors were detected.

SWB2 version 2.0.2

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 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).

SWB 2 version 2.0.1

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 code.usgs.gov once all internal USGS reviews are complete.

NOTE: a bug relating to the netCDF libraries used for the Windows executables was found, which may result in the following error message: