cmhc

R-CMD-check CRAN_Status_Badge CRAN_Downloads_Badge

API wrapper for extracting CMHC data out of the CMHC Housing Market Information Portal.

Reference

Documentation is available on the GitHub pages.

The example vignettes contain some common use cases.

Installation

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")

Usage

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.

Contributing

Cite cmhc

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.