{"id":15292993,"url":"https://github.com/nikdata/rclimacell","last_synced_at":"2026-01-06T02:03:03.245Z","repository":{"id":54315561,"uuid":"335985864","full_name":"nikdata/RClimacell","owner":"nikdata","description":"See the package website: https://nikdata.github.io/RClimacell","archived":false,"fork":false,"pushed_at":"2021-03-24T19:24:45.000Z","size":612,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-01T02:11:18.131Z","etag":null,"topics":["climacell","climacell-api","cran","cran-r","r","weather","weather-api"],"latest_commit_sha":null,"homepage":"","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/nikdata.png","metadata":{"files":{"readme":"README.Rmd","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-02-04T14:51:07.000Z","updated_at":"2021-03-24T19:22:13.000Z","dependencies_parsed_at":"2022-08-13T11:50:30.455Z","dependency_job_id":null,"html_url":"https://github.com/nikdata/RClimacell","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikdata%2FRClimacell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikdata%2FRClimacell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikdata%2FRClimacell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikdata%2FRClimacell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nikdata","download_url":"https://codeload.github.com/nikdata/RClimacell/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245273127,"owners_count":20588526,"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":["climacell","climacell-api","cran","cran-r","r","weather","weather-api"],"created_at":"2024-09-30T16:37:09.464Z","updated_at":"2026-01-06T02:02:58.200Z","avatar_url":"https://github.com/nikdata.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput: github_document\n---\n\n```{r, include = FALSE}\nknitr::opts_chunk$set(\n  collapse = TRUE,\n  comment = \"#\u003e\",\n  fig.path = \"man/figures/README-\",\n  out.width = \"100%\"\n)\n```\n\n# RClimacell \u003ca href='https://nikdata.github.io/RClimacell/'\u003e\u003cimg src='man/figures/rclimacell-hex.png' align=\"right\" width=\"150\" height=\"150\" /\u003e\n\n\u003c!-- badges: start --\u003e\n[![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://lifecycle.r-lib.org/articles/figures/lifecycle-experimental.svg)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![GitHub commit](https://img.shields.io/github/last-commit/nikdata/RClimacell)](https://github.com/nikdata/RClimacell/commit/main)\n[![R-CMD-check](https://github.com/nikdata/RClimacell/workflows/R-CMD-check/badge.svg)](https://github.com/nikdata/RClimacell/actions)\n[![CRAN status](https://www.r-pkg.org/badges/version/RClimacell)](https://CRAN.R-project.org/package=RClimacell)\n\u003c!-- badges: end --\u003e\n\nThe {RClimacell} package is an **unofficial** R package that enables basic interaction with [Climacell's](https://www.climacell.co) API using the [Timeline Interface](https://docs.climacell.co/reference/timeline-overview). The functions within this package are tested against some of the [Core data layers](https://docs.climacell.co/reference/data-layers-core). \n\nPlease note that using the functions within this package **require** a valid API key.\n\nMore information about the Climacell API can be found on their [docs](https://docs.climacell.co/reference/api-overview) page.\n\n### Lubridate Issue\n\nAs of 24 Feb, there is a [known issue](https://github.com/tidyverse/lubridate/issues/928) with using the package {lubridate} and it seems to be affecting macOS users. The 'fix' has been to add the following line to the .Renviron file or the .Rprofile (I applied the code into the .Renviron file and it worked):\n\n```r\nTZDIR=\"/Library/Frameworks/R.framework/Resources/share/zoneinfo/\"\n```\n\n{lubridate} version 1.7.10 fixes this issue and is available on CRAN.\n\n## Installation\n\nCRAN version can be installed as follows:\n\n``` r\ninstall.packages('RClimacell')\n```\n\nYou can install the development version from [GitHub](https://github.com/) with:\n\n``` r\n# install.packages(\"devtools\")\ndevtools::install_github(\"nikdata/RClimacell\")\n```\n\n## Usage\n\nNot every variable in each of the functions will have a value. Missing values are denoted by NA and indicate that the API did not return a value for the specific date/time and function call.\n\n### Temperature\n```{r temperature_example}\nlibrary(RClimacell)\nclimacell_temperature(api_key = Sys.getenv(\"CLIMACELL_API\"),\n                      lat = 41.878685,\n                      long = -87.636011,\n                      timestep = '1d',\n                      start_time = lubridate::now(),\n                      end_time = lubridate::now() + lubridate::days(3))\n\n```\n\n### Wind\n```{r wind_example}\nlibrary(RClimacell)\nclimacell_wind(api_key = Sys.getenv(\"CLIMACELL_API\"),\n               lat = 41.878685,\n               long = -87.636011,\n               timestep = '1d',\n               start_time = lubridate::now(),\n               end_time = lubridate::now() + lubridate::days(3))\n```\n\n### Precipitation\n```{r}\nlibrary(RClimacell)\ndf_precip \u003c- climacell_precip(api_key = Sys.getenv(\"CLIMACELL_API\"),\n                 lat = 41.878685,\n                 long = -87.636011,\n                 timestep = '1h',\n                 start_time = lubridate::now(),\n                 end_time = lubridate::now() + lubridate::days(3))\n\ndplyr::glimpse(df_precip)\n```\n\n### Celestial (sunset time, sunrise time, and moon phase)\n\n```{r}\nlibrary(RClimacell)\ndf_celestial \u003c- climacell_celestial(api_key = Sys.getenv(\"CLIMACELL_API\"),\n                 lat = 41.878685,\n                 long = -87.636011,\n                 timestep = '1d',\n                 start_time = lubridate::now(),\n                 end_time = lubridate::now() + lubridate::days(5))\n\ndplyr::glimpse(df_celestial)\n```\n\n### Climacell Core (all Core Layer data)\n\nThis function aims to retrieve all of the Core Layer data using the Timeline Interface. All of the data are retrieved in a single API call. Note that if the timestep is not '1d', then the moon phase, sunrise time, and sunset times will not be available\n\n```{r}\nlibrary(RClimacell)\ndf_core \u003c- climacell_core(api_key = Sys.getenv(\"CLIMACELL_API\"),\n                 lat = 41.878685,\n                 long = -87.636011,\n                 timestep = '1m',\n                 start_time = lubridate::now(),\n                 end_time = lubridate::now() + lubridate::hours(3))\n\ndplyr::glimpse(df_core)\n```\n\n```{r}\nlibrary(RClimacell)\ndf_core2 \u003c- climacell_core(api_key = Sys.getenv(\"CLIMACELL_API\"),\n                 lat = 41.878685,\n                 long = -87.636011,\n                 timestep = '1d',\n                 start_time = lubridate::now(),\n                 end_time = lubridate::now() + lubridate::days(5))\n\ndplyr::glimpse(df_core2)\n```\n\n\nSee the [vignette](https://nikdata.github.io/RClimacell/) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnikdata%2Frclimacell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnikdata%2Frclimacell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnikdata%2Frclimacell/lists"}