canadaHCD

Access Canadian Historical Climate Data from R.
https://github.com/gavinsimpson/canadaHCD

Category: Climate Change
Sub Category: Climate Data Access and Visualization

Last synced: about 11 hours ago
JSON representation

Repository metadata

Access Canadian Historical Climate Data from R

• Host: GitHub
• URL: https://github.com/gavinsimpson/canadaHCD
• Owner: gavinsimpson
• License: gpl-3.0
• Created: 2016-05-26T21:08:37.000Z (almost 9 years ago)
• Default Branch: main
• Last Pushed: 2023-09-22T14:01:42.000Z (over 1 year ago)
• Last Synced: 2025-01-30T18:02:37.038Z (3 months ago)
• Language: R
• Size: 4.63 MB
• Stars: 10
• Watchers: 5
• Forks: 5
• Open Issues: 3
• Releases: 0
• Metadata Files:
  • Readme: README.Rmd
  • License: LICENSE.md

README.Rmd

          ```{r, echo = FALSE, message = FALSE}
knitr::opts_chunk$set(collapse = TRUE, comment = "#>", cache = FALSE)
options(tibble.width = 120)
```
# canadaHCD


[![Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public.](https://www.repostatus.org/badges/latest/wip.svg)](https://www.repostatus.org/#wip)
[![R build status](https://github.com/gavinsimpson/canadaHCD/workflows/R-CMD-check/badge.svg)](https://github.com/gavinsimpson/canadaHCD/actions)
[![codecov](https://codecov.io/gh/gavinsimpson/canadaHCD/branch/main/graph/badge.svg?token=vDjUqs13Fb)](https://app.codecov.io/gh/gavinsimpson/canadaHCD)
[![CRAN\_Status\_Badge](https://www.r-pkg.org/badges/version/canadaHCD)](https://cran.r-project.org/package=canadaHCD)
[![CRAN Downloads](https://cranlogs.r-pkg.org/badges/grand-total/canadaHCD)](https://cran.r-project.org/package=canadHCD)


Access Canadian Historical Climate Data from R. The Government of Canada's
Historical Climate Data [website](http://climate.weather.gc.ca/index_e.html)
provides access to hourly, daily, and monthly weather records for stations
throughout Canada.

These are raw data that have undergone some quality control, but issues such
as changes in station location are unmanged; the data for the original
`stationID` stops at a certain point and a new `stationID` continues recording.
For a more curated data set for climate change research at broad spatial and
temporal scales see the [Adjusted and Homogenized Canadian Climate Data (AHCCD)](http://ec.gc.ca/dccha-ahccd/default.asp?lang=En&n=B1F8423A-1).

## Installation

*canadaHCD* is still under active development towards a 0.1 release. In the
meantime, if you wish to use the package, please install it from this github
repo, which is most easily achieved using Hadley Wickham's *remotes* package:

```{r, eval = FALSE}
## install.packages("devtools")
remotes::install_github("gavinsimpson/canadaHCD")
```

## Usage

Say I'm interested in climate data for stations in Yellowknife, I can search
for all known `stationID`s with `"Yellowknife"` in their name using
`find_station()`

```{r find-station}
library("canadaHCD")
find_station("Yellowknife")
```

To download the monthly HCD from `YELLOWKNIFE HYDRO` I can use `hcd_monthly()`,
providing it with the `StationID` for that particular weather station

```{r download-monthly, results = "hide"}
yh <- hcd_monthly(1707)
```

The data are returned as a [*tibble*](https://cran.r-project.org/web/packages/tibble/vignettes/tibble.html)
(a `tbl_df`), which shows a compact version of the data frame.

```{r show-data}
yh
```

You should be able to work with these objects mostly as if they were data frames.

Allthough not yet exposed through any functions in the package, you can
access a snapshot of the station metadata via the `canadaHCD:::station_data`
data frame.

```{r station-data}
canadaHCD:::station_data
```

If we wanted to know which resolutions of data were available for the
`YELLOWKNIFE HYDRO` station, we can extract certain columns from the station
data object

```{r extract-station_data, tidy = TRUE, tidy.opts=list(blank=FALSE, width.cutoff=80)}
id <- grep("YELLOWKNIFE HYDRO", canadaHCD:::station_data$Name)
vars <- c("HourlyFirstYr", "HourlyLastYr", "DailyFirstYr", "DailyLastYr",
    "MonthlyFirstYr", "MonthlyLastYr")
canadaHCD:::station_data[id, vars]
```

The output shows that this station has no hourly data, but daily and monthly
data sets exist.

        

---

Owner metadata

• Name: Gavin Simpson
• Login: gavinsimpson
• Email:
• Kind: user
• Description:
• Website: fromthebottomoftheheap.net
• Location: Denmark
• Twitter: ucfagls
• Company: Aarhus University
• Icon url: https://avatars.githubusercontent.com/u/514696?u=d1a83968af3b73c440d1c003c5f6f47858591bcc&v=4
• Repositories: 194
• Last ynced at: 2024-06-11T15:57:49.314Z
• Profile URL: https://github.com/gavinsimpson

---

GitHub Events

Total

Last Year

---

Committers metadata

Last synced: 7 days ago

Name	Email	Commits
Gavin Simpson	u****s@g****m	136
Conor Anderson	c****r@c****a	15

Committer domains:

• conr.ca: 1

---

Issue and Pull Request metadata

Last synced: 1 day ago

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/gavinsimpson/canadaHCD

---

---

---

Dependencies

Score: 3.258096538021482