view_acs_data() opens an interactive dashboard for
exploring an ACS dataset: a choropleth map, a searchable table of
measures, on-the-fly benchmarking against parent geographies, and tools
for interpolating to custom areas.
The short demo below walks through the interface before we build one ourselves.
df1 = compile_acs_data(
tables = "cost_burden",
states = "CA",
counties = "06037",
years = "2024",
geography = "tract",
spatial = TRUE)
#> ℹ Margins of error for derived variables (suffixed `_M`) are approximations
#> that follow Census Bureau guidance and are an experimental feature; interpret
#> them with care.
#> This message is displayed once per session.
df1 %>%
dplyr::glimpse()
#> Rows: 2,495
#> Columns: 150
#> $ data_source_year <dbl> …
#> $ GEOID <chr> …
#> $ NAME <chr> …
#> $ total_population_universe <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_universe <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000 <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000_less_than_20_0_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000_20_0_24_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000_25_0_29_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000_30_0_34_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000_35_0_39_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000_40_0_49_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000_50_0_percent_more <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000_not_computed <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999 <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999_less_than_20_0_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999_20_0_24_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999_25_0_29_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999_30_0_34_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999_35_0_39_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999_40_0_49_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999_50_0_percent_more <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999_not_computed <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999 <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999_less_than_20_0_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999_20_0_24_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999_25_0_29_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999_30_0_34_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999_35_0_39_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999_40_0_49_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999_50_0_percent_more <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999_not_computed <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999 <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999_less_than_20_0_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999_20_0_24_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999_25_0_29_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999_30_0_34_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999_35_0_39_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999_40_0_49_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999_50_0_percent_more <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999_not_computed <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999 <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999_less_than_20_0_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999_20_0_24_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999_25_0_29_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999_30_0_34_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999_35_0_39_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999_40_0_49_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999_50_0_percent_more <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999_not_computed <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999 <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999_less_than_20_0_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999_20_0_24_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999_25_0_29_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999_30_0_34_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999_35_0_39_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999_40_0_49_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999_50_0_percent_more <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999_not_computed <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more_less_than_20_0_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more_20_0_24_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more_25_0_29_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more_30_0_34_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more_35_0_39_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more_40_0_49_9_pct <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more_50_0_percent_more <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more_not_computed <dbl> …
#> $ cost_burdened_renter_30percentormore_allincomes_percent <dbl> …
#> $ cost_burdened_renter_50percentormore_allincomes_percent <dbl> …
#> $ cost_burdened_renter_30percentormore_incomeslessthan35000_percent <dbl> …
#> $ cost_burdened_renter_50percentormore_incomeslessthan35000_percent <dbl> …
#> $ cost_burdened_renter_30percentormore_incomeslessthan50000_percent <dbl> …
#> $ cost_burdened_renter_50percentormore_incomeslessthan50000_percent <dbl> …
#> $ area_land_sq_kilometer <dbl> …
#> $ area_water_sq_kilometer <dbl> …
#> $ area_land_water_sq_kilometer <dbl> …
#> $ population_density_land_sq_kilometer <dbl> …
#> $ total_population_universe_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_universe_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000_less_than_20_0_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000_20_0_24_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000_25_0_29_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000_30_0_34_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000_35_0_39_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000_40_0_49_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000_50_0_percent_more_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_less_than_10000_not_computed_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999_less_than_20_0_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999_20_0_24_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999_25_0_29_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999_30_0_34_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999_35_0_39_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999_40_0_49_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999_50_0_percent_more_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_10000_19999_not_computed_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999_less_than_20_0_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999_20_0_24_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999_25_0_29_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999_30_0_34_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999_35_0_39_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999_40_0_49_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999_50_0_percent_more_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_20000_34999_not_computed_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999_less_than_20_0_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999_20_0_24_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999_25_0_29_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999_30_0_34_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999_35_0_39_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999_40_0_49_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999_50_0_percent_more_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_35000_49999_not_computed_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999_less_than_20_0_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999_20_0_24_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999_25_0_29_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999_30_0_34_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999_35_0_39_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999_40_0_49_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999_50_0_percent_more_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_50000_74999_not_computed_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999_less_than_20_0_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999_20_0_24_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999_25_0_29_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999_30_0_34_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999_35_0_39_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999_40_0_49_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999_50_0_percent_more_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_75000_99999_not_computed_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more_less_than_20_0_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more_20_0_24_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more_25_0_29_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more_30_0_34_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more_35_0_39_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more_40_0_49_9_pct_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more_50_0_percent_more_M <dbl> …
#> $ household_income_by_gross_rent_as_a_percentage_household_income_in_past_12_months_100000_more_not_computed_M <dbl> …
#> $ cost_burdened_renter_30percentormore_allincomes_percent_M <dbl> …
#> $ cost_burdened_renter_50percentormore_allincomes_percent_M <dbl> …
#> $ cost_burdened_renter_30percentormore_incomeslessthan35000_percent_M <dbl> …
#> $ cost_burdened_renter_50percentormore_incomeslessthan35000_percent_M <dbl> …
#> $ cost_burdened_renter_30percentormore_incomeslessthan50000_percent_M <dbl> …
#> $ cost_burdened_renter_50percentormore_incomeslessthan50000_percent_M <dbl> …
#> $ geometry <MULTIPOLYGON [°]> …
places1 = tigris::places(state = "NJ", cb = TRUE, year = 2024) %>%
sf::st_filter(df1)The geography_extent argument is required: it declares
which higher geographies are valid statistical benchmarks for
these data. Because df1 was pulled for a single county
(counties = "06037", Los Angeles County), only a
county benchmark is appropriate – the tracts here don’t
cover all of California, so a state benchmark would compare each tract
to a partial, misleading “state” value. Had we pulled the full state
(counties = NULL), we could declare
geography_extent = c("county", "state"). Pass
geography_extent = "none" to turn benchmarking off
entirely.
view_acs_data(df1, geography = "tract", geography_extent = "county")Custom target geographies
view_acs_data() can also interpolate the source data
onto a user-supplied polygon set (e.g., neighborhoods, council
districts, school catchments) via area-weighted overlap. Pass an
sf object to target_geographies; it must
contain a GEOID column that uniquely identifies each target
polygon. A “Geography” toggle then appears in the sidebar so you can
switch between the source view and the interpolated target view.
Benchmark values continue to be computed from the source data. In Target view, each target polygon is mapped to a parent (county / state / national) by majority-area overlap of its source-geography components.
Any sf polygon layer with a unique GEOID
works. Here we use Census “places” (incorporated cities and towns) as
the target geographies; an optional NAME column, when
present, is shown in the map popups:
view_acs_data(
df1,
geography = "tract",
geography_extent = "county",
target_geographies = places1)Under the hood, this builds a fractional crosswalk via
sf::st_intersection() and feeds it to
[interpolate_acs()].
Draw your own geographies
You don’t need a target layer in hand. Every map includes a drawing
toolbar at its top-left: draw one or more polygons, then click
Interpolate to drawn area in the sidebar. The source
data are interpolated onto your polygons with the same area-weighted
crosswalk, the map switches to Target view, and
benchmarking (when available) compares each drawn area to the parent
geography it mostly overlaps. Clear target discards the
polygons and returns you to the source view (or to a
target_geographies layer, if you supplied one).