mountainMath · mountainMath · Feb 22, 2024 · Mar 9, 2024 · Jul 15, 2024 · Jul 15, 2024
diff --git a/DESCRIPTION b/DESCRIPTION
@@ -1,7 +1,7 @@
 Package: cancensus
 Type: Package
 Title: Access, Retrieve, and Work with Canadian Census Data and Geography
-Version: 0.5.7
+Version: 0.5.8
 Authors@R: c(
     person("Jens", "von Bergmann", email = "[email protected]", role = c("aut"), comment = "API creator and maintainer"),
     person("Dmitry", "Shkolnik", email = "[email protected]", role = c("aut", "cre"), comment = "Package maintainer, responsible for correspondence"),
@@ -24,7 +24,7 @@ Imports: digest (>= 0.1),
     httr (>= 1.0.0),
     jsonlite (>= 1.0),
     rlang
-RoxygenNote: 7.2.3
+RoxygenNote: 7.3.1
 Suggests: knitr,
     ggplot2,
     leaflet,

diff --git a/NEWS.md b/NEWS.md
@@ -1,3 +1,9 @@
+# cancensus 0.5.8
+
+- clarify installing API key and cache path in "getting started" vignette
+- fix caching problem with get_statcan_wds_data
+- support health region level census data for 2021 via WDS
+
 # cancensus 0.5.7
 
 - fix issue with path names not quoted properly when downoading and unpacking geosuite data

diff --git a/R/geographies.R b/R/geographies.R
@@ -5,7 +5,7 @@
 #'
 #' @param census_year census year to get the data for, right now only 2021 is supported
 #' @param level geographic level to return the data for, valid choices are
-#' "PR","CD","CMACA","CSD","CT","ADA","DA","ER","FED","DPL","POPCNTR", "FSA"
+#' "PR","CD","CMACA","CSD","CT","ADA","DA","ER","FED","DPL","POPCNTR", "FSA", "HR"
 #' @param type type of geographic data, valid choices area "cartographic" or "digital"
 #' @param cache_path optional path to cache the data. If the cancensus cache path is set the geographic data gets
 #' cached in the "geographies" subdirectory of the cancensus cache path.
@@ -24,7 +24,7 @@ get_statcan_geographies <- function(census_year,level,type="cartographic",
                                     cache_path = NULL,timeout=1000,
                                     refresh=FALSE,quiet=FALSE) {
   valid_census_years <- c("2021")
-  valid_levels <- c("PR","CD","CMACA","CMA","CA","CSD","CT","ADA","DA","ER","FED","DPL","POPCNTR","POPCTR","FSA")
+  valid_levels <- c("PR","CD","CMACA","CMA","CA","CSD","CT","ADA","DA","ER","FED","DPL","POPCNTR","POPCTR","FSA","HR")
   valid_types <- c("cartographic","digital")
   if (!(census_year %in% valid_census_years)) {
     stop(paste0("Census year must be one of ",paste0(valid_census_years,collapse = ", "),"."))
@@ -51,6 +51,13 @@ get_statcan_geographies <- function(census_year,level,type="cartographic",
       stop(paste0("Problem, don't know how to get geographic data for level ",level,"."))
     }
     url <- paste0("https://www12.statcan.gc.ca/census-recensement/",census_year,"/geo/sip-pis/boundary-limites/files-fichiers/l",tolower(level),filler,typeID,"21a_e.zip")
+    if (level=="HR") {
+      if (type=="cartographic") {
+        url <- "https://www150.statcan.gc.ca/n1/en/pub/82-402-x/2024001/hrbf-flrs/carto/ArcGIS/HR_000b23a_e.zip?st=wQRRL7PQ"
+      } else {
+        url <- "https://www150.statcan.gc.ca/n1/en/pub/82-402-x/2024001/hrbf-flrs/digi/ArcGIS/HR_000a23a_e.zip"
+      }
+    }
     tmp <- tempfile()
     options(timeout = timeout)
     utils::download.file(url,tmp,mode="wb",quiet=quiet)

diff --git a/R/wds.R b/R/wds.R
@@ -6,7 +6,7 @@
 #'
 #' @param census_year census year to get the data for, right now only 2021 is supported
 #' @param level geographic level to return the data for, valid choices are
-#' "PR","CD","CMACA","CSD","CT","ADA","DA","ER","FED","DPL","POPCNTR", "FSA"
+#' "PR","CD","CMACA","CSD","CT","ADA","DA","ER","FED","DPL","POPCNTR", "FSA", "HR"
 #' @param version optionally specify a version of the data to download. For example, for FED level data, version 1.3 will
 #' access the 2013 represenation order, whereas version 2.0 will access the 2023 representation order. By default the latest
 #' available version is accessed.
@@ -21,7 +21,7 @@
 #' @export
 get_statcan_wds_metadata <- function(census_year,level,version=NULL,refresh=FALSE){
   valid_census_years <- c("2021")
-  valid_levels <- c("PR","CD","CMACA","CSD","CT","ADA","DA","ER","FED","DPL","POPCNTR","FSA")
+  valid_levels <- c("PR","CD","CMACA","CSD","CT","ADA","DA","ER","FED","DPL","POPCNTR","FSA","HR")
   if (!(census_year %in% valid_census_years)) {
     stop(paste0("Census year must be one of ",paste0(valid_census_years,collapse = ", "),"."))
   }
@@ -118,9 +118,9 @@ get_statcan_wds_data <- function(DGUIDs,
                           httr::accept("text/csv"),
                           httr::add_headers("Accept-Encoding"="deflate, gzip, br"),
                           httr::write_disk(wds_data_tempfile,overwrite = TRUE))
-  }
-  if (!response$status_code=="200") {
-    stop(paste0("Invalid request.\n",httr::content(response)))
+    if (!response$status_code=="200") {
+      stop(paste0("Invalid request.\n",httr::content(response)))
+    }
   }
   census_year <- "2021"
   meta_data <- get_statcan_wds_metadata(census_year,level=level,version = version,refresh = refresh)

diff --git a/README.md b/README.md
@@ -141,17 +141,18 @@ There are several other jurisdiction where census data is available via R packag
 
 If you wish to cite cancensus:
 
-  von Bergmann, J., Aaron Jacobs, Dmitry Shkolnik (2022). cancensus: R package to
-  access, retrieve, and work with Canadian Census data and geography. v0.5.7.
+  von Bergmann, J., Aaron Jacobs, Dmitry Shkolnik (2024). cancensus: R package to
+  access, retrieve, and work with Canadian Census data and geography. v0.5.8.
 
 
 A BibTeX entry for LaTeX users is
 ```
   @Manual{cancensus,
     author = {Jens {von Bergmann} and Dmitry Shkolnik and Aaron Jacobs},
     title = {cancensus: R package to access, retrieve, and work with Canadian Census data and geography},
-    year = {2022},
-    note = {R package version 0.5.7},
+    year = {2024},
+    doi = {10.32614/CRAN.package.cancensus},
+    note = {R package version 0.5.8},
     url = {https://mountainmath.github.io/cancensus/}
   }
 ```

diff --git a/cran-comments.md b/cran-comments.md
@@ -1,3 +1,9 @@
+# cancensus 0.5.8
+
+- clarify installing API key and cache path in "getting started" vignette
+- fix caching problem with get_statcan_wds_data
+- support health region level census data for 2021 via WDS
+
 # cancensus 0.5.7
 - fix issue with path names not quoted properly when downoading and unpacking geosuite data
 - support versions in WDS data, in paricular for federal electoral districts

diff --git a/docs/404.html b/docs/404.html
diff --git a/docs/LICENSE-text.html b/docs/LICENSE-text.html
diff --git a/docs/articles/Dwellings_by_document_type_cross_tabulation.html b/docs/articles/Dwellings_by_document_type_cross_tabulation.html
diff --git a/docs/articles/Making_maps_with_cancensus.html b/docs/articles/Making_maps_with_cancensus.html
diff --git a/docs/articles/Taxfiler_Data.html b/docs/articles/Taxfiler_Data.html
diff --git a/docs/articles/cancensus.html b/docs/articles/cancensus.html
diff --git a/docs/articles/data_discovery.html b/docs/articles/data_discovery.html
diff --git a/docs/articles/index.html b/docs/articles/index.html
diff --git a/docs/articles/intersecting_geometries.html b/docs/articles/intersecting_geometries.html
diff --git a/docs/articles/statcan_attribute_files.html b/docs/articles/statcan_attribute_files.html
diff --git a/docs/articles/statcan_wds.html b/docs/articles/statcan_wds.html
diff --git a/docs/authors.html b/docs/authors.html
diff --git a/docs/index.html b/docs/index.html
diff --git a/docs/news/index.html b/docs/news/index.html
diff --git a/docs/pkgdown.yml b/docs/pkgdown.yml
@@ -10,7 +10,7 @@ articles:
   intersecting_geometries: intersecting_geometries.html
   statcan_attribute_files: statcan_attribute_files.html
   statcan_wds: statcan_wds.html
-last_built: 2024-02-09T21:32Z
+last_built: 2024-02-22T18:45Z
 urls:
   reference: https://mountainmath.github.io/cancensus/reference
   article: https://mountainmath.github.io/cancensus/articles

diff --git a/docs/reference/CODES_TABLE.html b/docs/reference/CODES_TABLE.html
diff --git a/docs/reference/COV_SKYTRAIN_STATIONS.html b/docs/reference/COV_SKYTRAIN_STATIONS.html
diff --git a/docs/reference/add_unique_names_to_region_list.html b/docs/reference/add_unique_names_to_region_list.html
diff --git a/docs/reference/as_census_region_list.html b/docs/reference/as_census_region_list.html
diff --git a/docs/reference/census_vectors.html b/docs/reference/census_vectors.html
diff --git a/docs/reference/child_census_vectors.html b/docs/reference/child_census_vectors.html
diff --git a/docs/reference/dataset_attribution.html b/docs/reference/dataset_attribution.html
diff --git a/docs/reference/explore_census_regions.html b/docs/reference/explore_census_regions.html
diff --git a/docs/reference/explore_census_vectors.html b/docs/reference/explore_census_vectors.html