{"id":13948467,"url":"https://github.com/ropensci/hydroscoper","last_synced_at":"2025-10-22T03:53:44.426Z","repository":{"id":56934950,"uuid":"114094911","full_name":"ropensci/hydroscoper","owner":"ropensci","description":"R interface to the Greek National Data Bank for Hydrometeorological Information","archived":false,"fork":false,"pushed_at":"2025-10-05T04:23:04.000Z","size":6722,"stargazers_count":14,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-10-05T15:42:47.404Z","etag":null,"topics":["climate","greece","hydrology","hydrometeorology","hydroscope","meteorological-data","meteorological-stations","peer-reviewed","r","r-package","rstats","tidy-data","time-series","water-resources"],"latest_commit_sha":null,"homepage":"https://docs.ropensci.org/hydroscoper","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ropensci.png","metadata":{"files":{"readme":"README.Rmd","changelog":"NEWS.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":"codemeta.json","zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2017-12-13T08:33:53.000Z","updated_at":"2025-07-11T19:13:50.000Z","dependencies_parsed_at":"2024-11-06T00:32:18.339Z","dependency_job_id":"799e9e5c-af4a-4da1-9a1d-655f3148f3c6","html_url":"https://github.com/ropensci/hydroscoper","commit_stats":{"total_commits":301,"total_committers":4,"mean_commits":75.25,"dds":0.3588039867109635,"last_synced_commit":"5f92c0e554c5e22aa235c2fc0bec391976bb65f4"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/ropensci/hydroscoper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Fhydroscoper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Fhydroscoper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Fhydroscoper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Fhydroscoper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ropensci","download_url":"https://codeload.github.com/ropensci/hydroscoper/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ropensci%2Fhydroscoper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279004823,"owners_count":26083783,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["climate","greece","hydrology","hydrometeorology","hydroscope","meteorological-data","meteorological-stations","peer-reviewed","r","r-package","rstats","tidy-data","time-series","water-resources"],"created_at":"2024-08-08T05:01:23.329Z","updated_at":"2025-10-22T03:53:44.421Z","avatar_url":"https://github.com/ropensci.png","language":"R","funding_links":[],"categories":["Hydrosphere","Observation and Conservation of Ecosystems"],"sub_categories":["Freshwater and Hydrology","Ocean and Climate"],"readme":"---\ntitle: hydroscoper\noutput: github_document\neditor_options: \n  chunk_output_type: inline\n---\n\u003c!-- README.md is generated from README.Rmd. Please edit that file --\u003e\n\n```{r, echo=FALSE, message=FALSE}\nknitr::opts_chunk$set(\n  collapse = TRUE,\n  comment = \"#\u003e\",\n  fig.path = \"man/figures/README-\"\n)\n\nchk_online \u003c- FALSE\n\n# helper function to check if a sub-domain is online\nonline \u003c- function(url = \"kyy.hydroscope.gr\") {\n  \n  # test the http capabilities of the current R build\n  if (!capabilities(what = \"http/ftp\")) return(FALSE)\n  \n  # test connection by trying to read first line of url\n  test \u003c- try(suppressWarnings(readLines(url, n = 1)), silent = TRUE)\n  \n  # return FALSE if test inherits 'try-error' class\n  !inherits(test, \"try-error\")\n}\n\n# check if sub-domains are online\nchk_online   \u003c- online()\n\n```\n\n[![tic](https://github.com/ropensci/hydroscoper/workflows/tic/badge.svg?branch=master)](https://github.com/ropensci/hydroscoper/actions)\n[![codecov](https://codecov.io/github/ropensci/hydroscoper/branch/master/graphs/badge.svg)](https://app.codecov.io/gh/ropensci/hydroscoper) \n[![minimal R version](https://img.shields.io/badge/R%3E%3D-3.4-6666ff.svg)](https://cran.r-project.org/)\n[![CRAN_Status_Badge](http://www.r-pkg.org/badges/version/hydroscoper)](https://cran.r-project.org/package=hydroscoper)\n[![packageversion](https://img.shields.io/badge/Package%20version-1.7.0-orange.svg?style=flat-square)](https://github.com/ropensci/hydroscoper)\n[![](https://cranlogs.r-pkg.org/badges/grand-total/hydroscoper)](https://cran.r-project.org/package=hydroscoper)\n[![ropensci](https://badges.ropensci.org/185_status.svg)](https://github.com/ropensci/software-review/issues/185)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.1196540.svg)](https://doi.org/10.5281/zenodo.1196540)\n[![DOI](http://joss.theoj.org/papers/10.21105/joss.00625/status.svg)](https://doi.org/10.21105/joss.00625)\n\n\u003cimg src=\"https://github.com/ropensci/hydroscoper/raw/master/man/figures/hydroscoper_hex.png\" align = \"right\" width = 120/\u003e\n\n`hydroscoper` is an R interface to the  Greek National Data Bank for Hydrological and Meteorological Information,\n*Hydroscope*. For more details checkout the package's [website](https://docs.ropensci.org/hydroscoper/) and the vignettes:\n\n * [An introduction to `hydroscoper`](https://docs.ropensci.org/hydroscoper/articles/intro_hydroscoper.html) with details about the Hydroscope project and the package.\n * [Using `hydroscoper`'s data sets](https://docs.ropensci.org/hydroscoper/articles/stations_with_data.html) with a simple example of how to use the package's internal data sets.\n \n## Installation\n\nInstall the stable release from CRAN with:\n\n```{r cran_installation, eval = FALSE}\ninstall.packages(\"hydroscoper\")\n```\n\nYou can install the development version from GitHub with:\n\n```{r gh-installation, eval = FALSE}\n# install.packages(\"devtools\")\ndevtools::install_github(\"ropensci/hydroscoper\")\n```\n\n## Using hydroscoper\n\nThe functions that are provided by `hydroscoper` are:\n\n* `get_stations, get_timeseries, ..., etc.` family functions, to retrieve tibbles with Hydroscope's data for a given data source.\n* `get_data`, to retrieve a tibble with time series' values.  \n* `hydro_coords`, to convert Hydroscope's points' raw format to a tibble.\n* `hydro_translate` to translate various terms and names from Greek to English.\n\nThe data sets that are provided by `hydroscoper` are:\n\n* `stations` a tibble with stations' data from Hydroscope.\n* `timeseries` a tibble with  time series' data from Hydroscope.\n* `greece_borders` a tibble with the borders of Greece.\n\n## Example\n\nThis is a minimal example which shows how to get the station's *200200* precipitation time series *56*  from the *kyy* sub-domain.\n\nLoad libraries and get data:\n\n```{r load_libraries, eval = chk_online}\nlibrary(hydroscoper)\nlibrary(tibble)\nlibrary(ggplot2)\n\nts_raw \u003c- get_data(subdomain = \"kyy\", time_id = 56)\nts_raw\n```\n\nLet's create a plot:\n\n```{r plot_time_series, eval = chk_online}\nggplot(data = ts_raw, aes(x = date, y = value))+\n  geom_line()+\n  labs(title= \"30 min precipitation for station 200200\",\n       x=\"Date\", y = \"Rain height (mm)\")+\n  theme_classic()\n```\n\n## Meta\n\n* Bug reports, suggestions, and code are welcome. Please see [Contributing](https://github.com/ropensci/hydroscoper/blob/master/CONTRIBUTING.md).\n* License:\n    + All code is licensed MIT.\n    + All data are from the public data sources in `http://www.hydroscope.gr/`.\n* To cite `hydroscoper` please use:\n```\nVantas Konstantinos, (2018). hydroscoper: R interface to the Greek National Data Bank for\nHydrological and Meteorological Information. Journal of Open Source Software,\n3(23), 625 DOI:10.21105/joss.00625\n```\nor the BibTeX entry:\n```\n@Article{kvantas2018,\nauthor = {Konstantinos Vantas},\ntitle = {{hydroscoper}: R interface to the Greek National Data Bank for Hydrological and Meteorological Information},\ndoi = {10.21105/joss.00625},\nyear = {2018},\nmonth = {mar},\npublisher = {The Open Journal},\nvolume = {2},\nnumber = {23},\njournal = {The Journal of Open Source Software}\n}\n```\n\n[![ropensci_footer](http://ropensci.org/public_images/github_footer.png)](https://ropensci.org)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fropensci%2Fhydroscoper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fropensci%2Fhydroscoper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fropensci%2Fhydroscoper/lists"}