rOpenSci: The hydroscoper package

hydroscoper is an R interface to the Greek National Data Bank for Hydrological and Meteorological Information, Hydroscope. For more details checkout the package’s website and the vignettes:

• An introduction to hydroscoper with details about the Hydroscope project and the package.
• Using hydroscoper’s data sets with a simple example of how to use the package’s internal data sets.

Installation

Install the stable release from CRAN with:

install.packages("hydroscoper")

You can install the development version from GitHub with:

# install.packages("devtools")
devtools::install_github("ropensci/hydroscoper")

Using hydroscoper

The functions that are provided by hydroscoper are:

• get_stations, get_timeseries, ..., etc. family functions, to retrieve tibbles with Hydroscope’s data for a given data source.
• get_data, to retrieve a tibble with time series’ values.
  
• hydro_coords, to convert Hydroscope’s points’ raw format to a tibble.
• hydro_translate to translate various terms and names from Greek to English.

The data sets that are provided by hydroscoper are:

• stations a tibble with stations’ data from Hydroscope.
• timeseries a tibble with time series’ data from Hydroscope.
• greece_borders a tibble with the borders of Greece.

Example

This is a minimal example which shows how to get the station’s 200200 precipitation time series 56 from the kyy sub-domain.

Load libraries and get data:

library(hydroscoper)
library(tibble)
library(ggplot2)

ts_raw <- get_data(subdomain = "kyy", time_id = 56)
ts_raw
#> # A tibble: 147,519 x 3
#>    date                value comment
#>    <dttm>              <dbl> <chr>  
#>  1 1985-05-06 08:00:00     0 1      
#>  2 1985-05-06 08:30:00     0 1      
#>  3 1985-05-06 09:00:00     0 1      
#>  4 1985-05-06 09:30:00     0 1      
#>  5 1985-05-06 10:00:00     0 1      
#>  6 1985-05-06 10:30:00     0 1      
#>  7 1985-05-06 11:00:00     0 1      
#>  8 1985-05-06 11:30:00     0 1      
#>  9 1985-05-06 12:00:00     0 1      
#> 10 1985-05-06 12:30:00     0 1      
#> # … with 147,509 more rows

Let’s create a plot:

ggplot(data = ts_raw, aes(x = date, y = value))+
  geom_line()+
  labs(title= "30 min precipitation for station 200200",
       x="Date", y = "Rain height (mm)")+
  theme_classic()

Meta

• Bug reports, suggestions, and code are welcome. Please see Contributing.
• License:
  • All code is licensed MIT.
  • All data are from the public data sources in http://www.hydroscope.gr/.
• To cite hydroscoper please use:

Vantas Konstantinos, (2018). hydroscoper: R interface to the Greek National Data Bank for
Hydrological and Meteorological Information. Journal of Open Source Software,
3(23), 625 DOI:10.21105/joss.00625

or the BibTeX entry:

@Article{kvantas2018,
author = {Konstantinos Vantas},
title = {{hydroscoper}: R interface to the Greek National Data Bank for Hydrological and Meteorological Information},
doi = {10.21105/joss.00625},
year = {2018},
month = {mar},
publisher = {The Open Journal},
volume = {2},
number = {23},
journal = {The Journal of Open Source Software}
}

References

Hydroscope