Learn R Programming

tigris (version 2.1)

new_england: Download a New England City and Town Area shapefile into R

Description

From the US Census Bureau (see link for source): "In New England (Connecticut, Maine, Massachusetts, New Hampshire, Rhode Island, and Vermont), the OMB has defined an alternative county subdivision (generally city and town) based definition of CBSAs known as New England city and town areas (NECTAs). NECTAs are defined using the same criteria as metropolitan and micropolitan statistical areas and are identified as either metropolitan or micropolitan, based, respectively, on the presence of either an urbanized area of 50,000 or more inhabitants or an urban cluster of at least 10,000 and less than 50,000 inhabitants." Combined NECTAs, or CNECTAs, are two or more NECTAs that have significant employment interchange, like Combined Statistical Areas; NECTA divisions are subdivisions of NECTAs.

Usage

new_england(type = "necta", cb = FALSE, year = NULL, ...)

Arguments

type

Specify whether to download the New England City and Town Areas file ('necta', the default), the combined NECTA file ('combined'), or the NECTA divisions file ('divisions').

cb

If cb is set to TRUE, download a generalized (1:500k) cartographic boundary file. Defaults to FALSE (the most detailed TIGER/Line file). Only available when type = 'necta'.

year

the data year; defaults to 2022

...

arguments to be passed to internal function load_tiger, which is not exported. See Additional Arguments.

Additional Arguments

Additional arguments that can be passed in ... are:

  • class Desired class of return object: "sf" (the default) or "sp". sp classes should be considered deprecated as of tigris version 2.0, but legacy support is still available.

  • progress_bar If set to FALSE, do not display download progress bar (helpful for R Markdown documents). Defaults to TRUE.

  • keep_zipped_shapefile If set to TRUE, do not delete zipped shapefile (stored in temporary directory or TIGRIS_CACHE_DIR depending on the configuration of global option "tigris_use_cache"). Defaults to FALSE.

  • refresh Whether to re-download cached shapefiles (TRUE or FALSE) . The default is either FALSE or the value of global option "tigris_refresh" if it is set. Specifying this argument will override the behavior set in "tigris_refresh" global option.

  • filter_by Geometry used to filter the output returned by the function. Can be an sf object, an object of class bbox, or a length-4 vector of format c(xmin, ymin, xmax, ymax) that can be converted to a bbox. Geometries that intersect the input to filter_by will be returned.

See Also

https://www2.census.gov/geo/pdfs/maps-data/data/tiger/tgrshp2020/TGRSHP2020_TechDoc.pdf

Other metro area functions: combined_statistical_areas(), core_based_statistical_areas(), metro_divisions(), urban_areas()

Examples

Run this code
if (FALSE) {
library(tigris)

ne <- new_england(cb = TRUE)

plot(ne$geometry)

}

Run the code above in your browser using DataLab