NEWS

DWBmodelUN 2.0.1 (2026-07-28)

graphDWB() no longer opens a web browser in non-interactive sessions. For the composed graphs (tp = 3 and tp = 4) the returned object is now only wrapped in htmltools::browsable() when interactive() is TRUE, so R CMD check examples and vignette builds no longer trigger a browser call. Interactive use and the knitted vignette keep rendering the dygraphs as before.
Replaced the retired Travis CI badge with a GitHub Actions R-CMD-check badge and updated the dead thesis URL (bdigital.unal.edu.co, host no longer resolving) to its current location on repositorio.unal.edu.co, in the README, the vignette and the bibliography.
Fixed the sogamoso dataset documentation: the \format section used \itemize with labelled items, which produced "Lost braces in \itemize" notes under the current R CMD check; it now uses \describe.
Updated the codecov badge link to its current address (app.codecov.io) to avoid a permanent-redirect URL note.
Moved raster and sp from Suggests to Depends. The bundled example datasets are stored as raster/sp S4 objects, so these packages must be attached for data() to load them; declaring them only in Suggests caused a checking data for non-ASCII characters WARNING on the CRAN checks.

The spatial engine of the package was migrated from raster/rgdal (retired from CRAN in 2023) to terra. All functions that receive or return spatial objects now work with terra classes:
- buildGRUmaps() returns SpatRaster objects (alpha1R, alpha2R, dR, smaxR) instead of RasterLayer objects.
- printVar() builds and returns (invisibly) a SpatRaster and writes NetCDF files with terra::writeCDF().
- cellBasins() works internally with SpatRaster/SpatVector.
- For backwards compatibility, all these functions still accept legacy raster/sp objects (RasterLayer, RasterStack, SpatialPolygonsDataFrame) and convert them internally with terra::rast()/terra::vect().
rgdal was removed from the dependencies. raster and sp were moved to Suggests and are only needed to load the example datasets, which are still stored in the legacy format.
cellBasins() and varBasins() now stop with an informative error when mandatory arguments are missing, instead of returning NULL with a warning.

upForcing(): the documented format = "NetCDF" option now works (the internal check made it unreachable before).
init_state() no longer emits a spurious warning when a single-layer raster (the documented and most common use case) is provided.
readSetup(): removed an exists() check that could never trigger; the function now validates its arguments and fails with informative messages.
funFU() documentation: P was incorrectly described as the numerator, and alpha can be a vector (as used by DWBCalculator()), not only a single value.
Fixed the partially matched argument star = (instead of start =) in the ts() calls of the examples and the vignette.

All exported functions now validate their inputs (dimensions, parameter ranges, file availability) and fail early with informative error messages.
DWBCalculator() checks the consistency between forcings and parameter vectors, and the physical ranges of the parameters.
dds() validates the search bounds, protects against non-finite objective function values and reflects out-of-range candidate parameters back into the search space.
varBasins() validates that the cell indices are consistent with the simulated domain.
printVar() creates the output directory when it does not exist and checks that ncdf4 is available before writing NetCDF files.
Documentation reviewed and updated: corrected typos, described the accepted spatial classes (terra and legacy raster/sp), modernized the CRS notation in the examples ("EPSG:4326"), and added a runnable example to upForcing().
The vignette was updated to the terra workflow and to the html_vignette format.