*** v1.0.0 *** Consolidation Release
DGVMTools v1.0.0 release (2022-02-25)
"Version 1.0 release" - no major features, but many refinements and improvements, and also potentially breaking changes. Summary below, but see NEWS.md for more details.
Improvements and Refinements
- plotSubannual() function has been re-worked for increased flexibility and interface consistency with plotTemporal().
- Support for terra package objects (converting to and from).
- Layers may now be selected in getField() calls (potentially saving both time and memory).
- 'Quick read functionality'- getField()/getScheme() arguments 'write' and 'read.full' have been replace with 'quick.read' and 'quick.read.file' (details below)
- Spatial benchmark scores are now area-weighted where possible.
- Argument name consistency in getField() ("var" became "quant").
- Improvements to writeCFD() allowing filling in of missing longitude/latitude bands and customisation of layer axis.
- Units superscripts now rendered properly in plot labels.
- It is now possible to supply only one of first.year and last.year arguments to getField() and selectYears() (as opposed to both or neither).
- Colour palettes are now almost exclusively from viridis (the old fields::tim.colours palette has been purged)
- Automatic legend title in plotSpatial() and plotSpatialComparison().
Breaking Changes
- Arguments to getField(). Sorry, this is annoying but had to be done. Firstly, "var" was changed to "quant" to be consistent with everywhere else. Secondly, 'write' and 'read.full' have been replace with 'quick.read.file' and 'quick.read.autodelete' (also for getScheme()).
- Functions plotResidualHistos() and plotScatterComparison() were removed as they are not up to standard for a v1.0 release. They may be reinstated in an improved form at a later date. If you need these functions, please raise an issue on Github.
- plotSeasonal() was removed, functionality has been fully superseded by plotSubannual()