ipums_shape_join: Join tabular data to geographic boundaries

In ipumsr: An R Interface for Downloading, Reading, and Handling IPUMS Data

Join tabular data to geographic boundaries

Description

These functions are analogous to dplyr's joins, except that:

• They operate on a data frame and an sf object

• They retain the variable attributes provided in IPUMS files and loaded by ipumsr data-reading functions

• They handle minor incompatibilities between attributes in spatial and tabular data that emerge in some IPUMS files

Usage

ipums_shape_left_join(
  data,
  shape_data,
  by,
  suffix = c("", "SHAPE"),
  verbose = TRUE
)

ipums_shape_right_join(
  data,
  shape_data,
  by,
  suffix = c("", "SHAPE"),
  verbose = TRUE
)

ipums_shape_inner_join(
  data,
  shape_data,
  by,
  suffix = c("", "SHAPE"),
  verbose = TRUE
)

ipums_shape_full_join(
  data,
  shape_data,
  by,
  suffix = c("", "SHAPE"),
  verbose = TRUE
)

Arguments

data	A tibble or data frame. Typically, this will contain data that has been aggregated to a specific geographic level.
shape_data	An sf object loaded with read_ipums_sf().
by	Character vector of variables to join by. See dplyr::left_join() for syntax.
suffix	If there are non-joined duplicate variables in the two data sources, these suffixes will be added to the output to disambiguate them. Should be a character vector of length 2. Defaults to adding the "SHAPE" suffix to duplicated variables in shape_file.
verbose	If TRUE, display information about any geometries that were unmatched during the join.

Value

An sf object containing the joined data

Examples

data <- read_nhgis(
  ipums_example("nhgis0972_csv.zip"),
  verbose = FALSE
)

sf_data <- read_ipums_sf(ipums_example("nhgis0972_shape_small.zip"))
joined_data <- ipums_shape_inner_join(data, sf_data, by = "GISJOIN")

colnames(joined_data)

ipumsr documentation built on Oct. 20, 2023, 5:10 p.m.