Releases: brry/rdwd
v1.8
v1.7
Version 1.7.0 (2023-04-14)
dataDWD
: dir default set tolocdir()
- interactive weather comparison app added
findID
+selectDWD
: new argument failempty to stop instead of warn if name does not matchreadDWD.grib2
: rgdal retirement warning addeddataDWD
+readDWD
: new argument hr to auto-merge historical and recent filescreateIndex
: speed and correctness improvedrunLocalTests
: tests expanded, internally restructuredreadDWD
: new argument quietread- the NEWS file is completely reformatted and changed into NEWS.md
v1.6
Version 1.6.0 (2022-05-30)
new functions
plotDWD
locdir
(will replace fixed "DWDdata" folder indataDWD
)readDWD.deriv
readDWD.rklim
readDWD.pdf
validFileTypes
(charstring vector)
improvements
selectDWD
: is completely rewritten and now vectorizes expandingly- reading functions: use latin1 encoding
dataDWD
: new argument method, new default for overwrite- several improvements for input checks, messages, tests and documentation
metaInfo
: accepts custom indexreadDWD.radar
: new argument dividebytenreadDWD.grib2
: new argument pack- website: new use case daily radar files
oldselect
v1.5
Version 1.5.0 (2021-04-08)
API changes:
- readVars: new argument 'quiet' (for updateIndexes)
- readDWD.grib2: initial release
- projectRasterDWD: new argument adjust05
- dataDWD: new default: dbin=TRUE
enhancements / bug fixes:
- readDWD.data: fread checks for system command unzip, prints final value in message
- dataDWD: unfound URL messages also link to website fileIndex in German locale
- updateRdwd: version and date comparison improved, print local version if newer than on github
- createIndex: improved recognition of "Beschreibung_Stationen" meta files
- dwdparams + updateIndexes: missing/duplicate Kurz entry messages improved
- readDWD: subfunction names in elegant message outside the loop to avoid interrupted progbars.
- indexFTP + dirDWD: trailing slashes removed with regexp
- fileType: more informative message for failed type determination
- DEU: now derived from NUTS regions and with new CRS (along with EUR)
- runLocalTests: improved logfiles, false positive messages removed
website changes:
- package structure moved to first chapter
- fread instructions expanded
- FTP Folder list expanded
- more messages / warnings suppressed that are irrelevant to readers
- linked to in seeAlso sections of suitable function documentations
- Website: redirected man pages are now correctly linked to (e.g. fileIndex -> index)
- Documentation and dataset links are now opened in a new window
- new use case: values at locations in grid
- FTP address updated everywhere
v1.4.0
Version 1.4.0 (2020-07-31)
API changes:
- dataDWD: argument 'file' renamed to 'url' to avoid confusion with local file names
- readDWD: 'fread' default set to NA. This is an experiment, see issue #22
- readDWD: now has argument type (determined by new function fileType) to replace the ever growing list of types
- dataDWD, readDWD, selectDWD: order of arguments changed to reflect importance
- plotRadar: gains arguments axes, las, zlim, col, mar, keeppar. main now defaults to (and correctly keeps) x@title.
- selectDWD: gains argument remove_dupli to ignore DWD file upload errors
- readDWD.*: All subfunctions message their identity and have a 'quiet' argument
- new function: rdwdquiet()
- readDWD.meta: station and bundesland names are now char instead of factor (since R 4.0.0)
- indexFTP: new argument 'fast' to read file tree with data.table
- createIndex: gains argument checklog
- runLocalTests: new arguments for devtools::check and checkIndex
- readVars: params now an explicit argument (defaults to dwdparams)
enhancements / bug fixes:
- EUR: extends further east for plots with large width compared to height
- updateRdwd: unloads package before installation and informs about the need to re-load
- checkIndex: new check for duplicate meta files, writes to logfile (append, no overwrite), nicer path print, logs modification time of index files
- lldist: fix error that occurred when a df with a single row was given
- runLocalTests: warning logfile cleared before writing, checkIndex results included, false positives removed, on github
- source code function argument sections all have line breaks (except readDWD.*)
- documentation source code now is written in markdown, source files have been reorganized
- cross-references in documentation improved
- metaInfo: from/to columns date conversion corrected
- indexFTP + dataDWD: up to date and centralized sleep information
- dataDWD: Download failure message improved, refer to fileIndex section on homepage if applicable.
- readDWD.nc: ncdf warning suppressed
- selectDWD: combines all warnings within the loop to a single message
website changes:
- improved (and stand-alone) fileIndex section
- plotRadar used for nice maps
- huxtable fixed
- use global quiet option instead of explicit
quiet=TRUE
all the time - history section added
- package schematic revamped completely
Version 1.3.1 (2020-02-18)
API changes:
- projectRasterDWD: latlon=T/F replaced with targetproj
- readDWD.binary: output list element renamed to 'dat' (from 'data') for consistency with other functions
- dataDWD: new argument dbin
- new functions: updateRdwd, plotRadar
enhancements / bug fixes:
- readDWD.data: now correctly reads 10 minute timestamps
- readDWD.meta: column widths identified more elegantly and safely
- indexFTP: warn about requests to https instead of ftp servers, new argument
exclude.latest.bin
- addBorders: added sp to 'Suggests', moved DEU + EUR to inst/extdata to handle CRAN build+check on systems without sp installed
website changes:
- list of FTP Folders now with clickable URLs
- RQ example added
- order of radar graphs changed for better comparison in pdf
v1.2.0
Version 1.2.0 (2019-10-26)
Highlights:
- Vignettes moved to https://bookdown.org/brry/rdwd with nice structure
- improved reading of gridded data, documented in vignette chapter "Raster data"
- readRadarFile expanded + moved to own package (dwdradar) with proper tests and better warnings
- Hexsticker created
Important changes:
- readDWD.binary: untarring improved
- projectRasterDWD: default extents + projs added for seasonal + nc
- source code directory structure updated
- quiet argument added to many functions
- readDWD: order and documentation of method selection improved
- metaIndex + fileIndex: date columns are now of class Date
- dataDWD: force can now be number of hours after which to re-download
- various minor fixes, see https://github.com/brry/rdwd/commits
New functions + datasets:
- readDWD.radar + readDWD.nc + readDWD.stand
- checkSuggestedPackages
- EUR + addBorders
- formatIndex
- runLocalTests
- updateIndexes (not exported)
v1.1.0
Version 1.1.0 (2019-05-30)
Highlights:
- Binary Radolan data can now be read correctly
- The new FTP server is used
- Raster data can easily be projected
- All readDWD subfunctions now have their own documentation
Important changes:
- dataDWD arguments to readDWD removed (can be passed with ...)
- dataDWD gains joinbf argument to join base and relative url path
- readDWD can expand DWD abbreviations in column names (varnames=TRUE)
- readDWD source code structure is improved.
- readDWD.multia ignores EndOfFile characters in multiannual data on Unix
- readDWD.raster accepts gunzip arguments, reads faster on second calls
- readDWD.data informatively handles empty files
- readDWD.binary+raster+asc overlay Germany maps in example plots
- readDWD.binary unzips into a given exdir (and reads faster on second calls)
- readDWD.binary transforms output to a raster stack
- selectDWD suggests only available data in interactive option
- selectDWD and nearbyStations fail informatively for typical errors
- fileIndex loses the unnnecessary leading slashes
- indexFTP uses tree of files at new FTP server
New user-visible functions + objects:
- newColumnNames
- dwdparams (renamed from parameter_abreviations)
- gridbase
- gridIndex
- projectRasterDWD
- localtestdir (though mainly for internal usage)
New unexported functions:
- readDWD.asc
- readRadarfile + bin2num + FORTRAN code
- checkIndex
v1.0.0
Version 1.0.0 (2019-03-17)
First major version increase!
Tests are now systematic and comprehensive (albeit run locally and manually to reduce CRAN load and enable local file writing).
selectDWD got a very noticable performance boost and an interactive res/var/per selection.
Handling raster files is now supported in rdwd.
Examples and vignettes have been refined.
Detailed changes can be found on https://github.com/brry/rdwd/commits, here's the main overview:
- dataDWD: dots now passed to readDWD, download errors checked and returned as informative warning
- readDWD: reading functions added for binary, raster and multi_annual files, MESS_DATUM POSIXct column added in monthly data, list output now named
- indexFTP: now removes duplicates from file list, sped up in default 1min/prec usage
- rdwd now works fine with multi_annual and subdaily data
- readVars: parameter abbreviations completed, output now visible
- selectDWD: order of arguments changed, interactive res/var/per selection enabled, computing speed extremely increased
- localtests.R heavily expanded, examples reduced and refined
- indexes + vignettes updated, use cases expanded with nearbyStations example
- New functions and objects: readMeta, dwdbase (central package base url)
v0.11.0
Version 0.11.0 (2018-11-26)
dataDWD
: argumentforce
can now be NA to download files older than 24 hours- hourly/solar timestamp now processed automatically
- use cases vignette added
- vignettes precompiled + CRAN tests removed to reduce automated load on DWD Server
indexFTP
: got much smarter in discerning files from folders- indexes expanded for new DWD data
New function:readVars
, along withparameter_abreviations
Version 0.10.0 (2018-03-26)
- created new index with sub-hourly data, reflected in data overview at
selectDWD
dataDWD,readDWD,selectDWD
: file ending checks more elegantcreateIndex
: updated to handle the new files- some minor improvements, see https://github.com/brry/rdwd/commits