API wrapper for extracting CMHC data out of the CMHC Housing Market Information Portal.
Documentation is available on the GitHub pages.
The example vignettes contain some common use cases.
The stable version of cmhc can be easily installed from CRAN.
install.packages("cmhc")
Alternatively, the latest development version can be installed from Github.
remotes::install_github("mountainmath/cmhc")
Consult the example vignette for more information. As an example, this is how to extract time series information for vacancy rate data by bedroom type for the Vancouver Census Metropolitan Area ("59933").
library(cmhc)
vacancy_data <- get_cmhc(survey="Rms",series="Vacancy Rate",dimension="Bedroom Type",
breakdown="Historical Time Periods", geo_uid="59933")
Starting with version v.0.3.2 the package has an interactive query builder helper function select_cmhc_table() that interactively walks through the available data and builds parameters for get_cmhc() like the example above. This makes it easy to discover data and build function calls to CMHC tables.
- We encourage contributions to improve this project. The best way is through issues and pull requests.
- If you want to get in touch, we are pretty good at responding via email or via twitter at @vb_jens.
If you wish to cite cmhc:
von Bergmann, J. cmhc: R package to access, retrieve, and work with CMHC data. v0.2.3.
A BibTeX entry for LaTeX users is
@Manual{,
author = {Jens {von Bergmann}},
title = {cmhc: R package to access, retrieve, and work with CMHC data},
year = {2022},
note = {R package version 0.2.3},
url = {https://mountainmath.github.io/cmhc/},
}
The cmhc package is designed to work well with the cancensus package working with Canadian Census data the cansim package for regular StatCan tables, and matches the census geographies via a GeoUID column that is shared across these packages. The tongfen package facilitates making geographies from different census years that CMHC reports on comparable over time.