{"id":25726568,"url":"https://github.com/agrdatasci/ag5tools","last_synced_at":"2025-05-07T08:41:42.131Z","repository":{"id":49109246,"uuid":"262373238","full_name":"AgrDataSci/ag5Tools","owner":"AgrDataSci","description":"R toolbox to download and extract data from the \"Agrometeorological indicators from 1979 to present derived from reanalysis\" (AgERA5) dataset.","archived":false,"fork":false,"pushed_at":"2024-11-21T14:57:19.000Z","size":6538,"stargazers_count":7,"open_issues_count":3,"forks_count":6,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-05-03T17:02:57.344Z","etag":null,"topics":["agriculture-research","agrometeorological","climate-data","r","r-package"],"latest_commit_sha":null,"homepage":"https://agrdatasci.github.io/ag5Tools/","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/AgrDataSci.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-08T16:28:53.000Z","updated_at":"2025-03-22T08:13:43.000Z","dependencies_parsed_at":"2023-02-14T17:01:37.720Z","dependency_job_id":"afc22955-efc4-4ca5-a58b-a290131071e6","html_url":"https://github.com/AgrDataSci/ag5Tools","commit_stats":{"total_commits":151,"total_committers":2,"mean_commits":75.5,"dds":"0.019867549668874163","last_synced_commit":"2b23d6c07816b2884220733fb740d5799ad69aa2"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AgrDataSci%2Fag5Tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AgrDataSci%2Fag5Tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AgrDataSci%2Fag5Tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AgrDataSci%2Fag5Tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AgrDataSci","download_url":"https://codeload.github.com/AgrDataSci/ag5Tools/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252844801,"owners_count":21813124,"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","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":["agriculture-research","agrometeorological","climate-data","r","r-package"],"created_at":"2025-02-25T23:17:40.978Z","updated_at":"2025-05-07T08:41:42.109Z","avatar_url":"https://github.com/AgrDataSci.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- badges: start --\u003e\n[![R-CMD-check](https://github.com/AgrDataSci/ag5Tools/workflows/R-CMD-check/badge.svg)](https://github.com/AgrDataSci/ag5Tools/actions)\n[![CRAN](https://www.r-pkg.org/badges/version/ag5Tools)](https://cran.r-project.org/package=ag5Tools)\n[![Downloads](https://cranlogs.r-pkg.org/badges/grand-total/ag5Tools)](https://cran.r-project.org/package=ag5Tools)\n[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](https://agrdatasci.github.io/ag5Tools/CODE_OF_CONDUCT.html)\n \u003c!-- badges: end --\u003e\n\n# ag5Tools\n\n## Toolbox for downloading and extracting data from the Copernicus AgERA5 dataset\n\n## Description\n\nThe R package *ag5Tools* is a toolbox to download and extract data from the \"Agrometeorological indicators from 1979 to present derived from reanalysis\" dataset (AgERA5).\n\nA description of the dataset can found [here](https://cds.climate.copernicus.eu/datasets/sis-agrometeorological-indicators?tab=overview)\n\nThe download function provides programmatic access to the Copernicus Climate Data Store to download AgERA5 data.\n\nA detailed description of the ag5Tools package can be found in the companion paper: https://doi.org/10.1016/j.softx.2022.101267\n\n## Data license\n\nThe *ag5Tools* package does not distribute data, it only provides access to the Climate Data Store through the Python cdsapi.\n\nFor specific details about the license agreement on downloading and using Copernicus Products, please check the license [here](https://cds.climate.copernicus.eu/datasets/sis-agrometeorological-indicators?tab=overview)\n\n### Installation\nThe stable version of *ag5Tools* can be installed from **CRAN** using \n```r\ninstall.packages(\"ag5Tools\")\n```  \nThe development version could be installed using\n``` r\ndevtools::install_github(\"agrdatasci/ag5Tools\", build_vignettes = TRUE)\n```\n\n### Downloading AgERA5 data\n\n#### Install Python and the CDS API\nBefore using the *ag5Tools* package, you need to intall Python and the CDS API, please see the detailsin the [CDSAPI guide](https://cds.climate.copernicus.eu/how-to-api)\n\n#### Get your CDS API-Key\n\nTo download AgERA5 data you should first register at the Climate Data Store and get your API key. Please follow the instructions detailed in the [CDSAPI guide](https://cds.climate.copernicus.eu/how-to-api)\n\nYou need to create a file to store the API key. Please follow the instructions detailed [here](https://cds.climate.copernicus.eu/how-to-api)\n\n#### Examples\n\n#### Downloading data\n\nThe following example downloads daily '2m_temperature' data for year 2015\n\n``` r\nag5_download(variable = \"2m_temperature\",\n             statistic = \"night_time_minimum\",\n             day = \"all\",\n             month = \"all\",\n             year = 2015,\n             path = \"C:/custom_target_folder\"\n             )\n```\n\n#### Extracting data\n\nTo extract maximum day temperature (\"Max-Day-Time\") of \"2m_temperature\"\n\n``` r\nag5_extract(coords = c(35.726364, -2.197162), \n            dates = \"1995-01-23\", \n            variable = \"2m_temperature\",\n            statistic = \"Max-Day-Time\", \n            path = \"C:/agera5_data\")\n```\n\n## Acknowledgements\n\nThe *ag5Tools* package relies on the functionality available from other open source packages.\n\n-   The Python [*cdsapi*](https://pypi.org/project/cdsapi/)\n\n-   The R package [*reticulate*](https://cran.r-project.org/package=reticulate) is used to access the Python CDS API functions from R.\n\n-   The R package [*terra*](https://cran.r-project.org/package=terra) is used to extract data from nc files.\n\n-   The R package [*fs*](https://cran.r-project.org/package=fs) is used for efficiently search and list files.\n\n## License\n\nPlease be aware that *ag5Tools* is released under MIT license, please find details in the [MIT license document](https://agrdatasci.github.io/ag5Tools/LICENSE.html)\n\n## Citation\nTo cite the *ag5Tools* in scientific publications please use:  \n\nBrown, D., de Sousa, K., \u0026 van Etten, J. (2023). ag5Tools: An R package for downloading and extracting agrometeorological data from the AgERA5 database. SoftwareX, 21, 101267. https://doi.org/10.1016/j.softx.2022.101267 \n\n## Code of Conduct\n\nPlease note that the *ag5Tools* project is released with a [Contributor Code of Conduct](https://agrdatasci.github.io/ag5Tools/CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagrdatasci%2Fag5tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagrdatasci%2Fag5tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagrdatasci%2Fag5tools/lists"}