Repository files navigation

hddtools stands for Hydrological Data Discovery Tools. This R packageis an open source project designed to facilitate access to a variety ofonline open data sources relevant for hydrologists and, in general,environmental scientists and practitioners.

This typically implies the download of a metadata catalogue, selectionof information needed, a formal request for dataset(s), de-compression,conversion, manual filtering and parsing. All those operations are mademore efficient by re-usable functions.

Depending on the data license, functions can provide offline and/oronline modes. When redistribution is allowed, for instance, a copy ofthe dataset is cached within the package and updated twice a year. Thisis the fastest option and also allows offline use of package’sfunctions. When re-distribution is not allowed, only online mode isprovided.

Get the stable version from CRAN:

install.packages("hddtools")

Or the development version from GitHub using the packageremotes:

install.packages("remotes")remotes::install_github("ropensci/hddtools")

Load thehddtools package:

library("hddtools")

The package contains functions to interact with the data providerslisted below. For examples of the various functionalities see thevignette.

• KGClimateClass: The KoppenClimate Classification map is used for classifying the world’sclimates based on the annual and monthly averages of temperature andprecipitation.

• GRDC: The Global Runoff Data Centre(GRDC) provides datasets for all the major rivers in the world.

• Data60UK: The Data60UKinitiative collated datasets of areal precipitation and streamflowdischarge across 61 gauging sites in England and Wales (UK).

• MOPEX: This datasetcontains historical hydrometeorological data and river basincharacteristics for hundreds of river basins in the US.

• SEPA: The ScottishEnvironment Protection Agency (SEPA) provides river level data forhundreds of gauging stations in the UK.

• This package and functions herein are part of an experimentalopen-source project. They are provided as is, without any guarantee.
• Please note that this project is released with aContributor Codeof Conduct.By participating in this project you agree to abide by its terms.
• Pleasereport any issues or bugs.
• License:GPL-3
• This package was reviewed byErin LeDell andMichaelSumner for submission to ROpenSci (seereviewhere) andthe Journal of Open Source Software (see review statushere).
• Citehddtools:citation(package = "rdefra")