Skip to contents

Fetch PUMA shapefile for study region

get_puma_geom.Rd

Loads or downloads PUMA shapefile for the study region, trimming to region boundaries. Use for spatial joins, mapping, or reference lookups.

Usage

get_puma_geom(settings, year = NULL)

Arguments

settings

list. Must include:

  • pums_year

  • inputs_dir

  • state FIPS (via get_state_fips)

  • puma_buffer (optional, default -100)

year

integer(1), optional. PUMS year. Defaults to settings.

Value

sf object. PUMA polygons for study region, with column 'PUMA' (state+PUMA code).

Details

  • Loads shapefile from disk if available; downloads if missing.

  • Uses settings for PUMS year and input directory.

  • Downloads PUMAs for each state FIPS in study region.

  • Buffers and trims PUMAs to study region using spatial intersection.

  • Concatenates state and PUMA codes for unique PUMA ID.

  • Saves trimmed shapefile to disk for future use.

  • Returns sf object of PUMA polygons.

  • Assumes settings include 'pums_year', 'inputs_dir', and state FIPS.

Settings

  • pums_year (direct): PUMS year for shapefile. Default from settings.

  • inputs_dir (direct): directory for input files. Default from settings.

  • puma_buffer (direct): buffer distance for region trim. Default -100.

See also

fetch_study_region, get_state_fips

Other geo utilities: format_geoids(), geoid_pad(), get_bg_geom(), get_county_fips(), get_state_fips(), pad_geoid_cols()

Examples

## Not run:
get_puma_geom(settings)
#> Error: object 'settings' not found