download_extract: Download an IPUMS data extract

In mnpopcenter/ipumsr: Read 'IPUMS' Extract Files

Download an IPUMS data extract

Description

Download an IPUMS data extract via the IPUMS API. For an overview of ipumsr API functionality, see vignette("ipums-api", package = "ipumsr").

Usage

download_extract(
  extract,
  download_dir = getwd(),
  overwrite = FALSE,
  api_key = Sys.getenv("IPUMS_API_KEY")
)

Arguments

extract	One of: An object of class ipums_extract The data collection and extract number formatted as a single string of the form "collection:number" The data collection and extract number formatted as a vector of the form c("collection", "number") The extract number does not need to be zero-padded (e.g., use "usa:1" or c("usa", "1"), not "usa:00001" or c("usa", "00001")). See Examples section below for examples of each form.
download_dir	In what folder should the downloaded files be saved? Defaults to current working directory.
overwrite	Logical indicating whether to overwrite files that already exist. Defaults to FALSE.
api_key	API key associated with your user account. Defaults to the value of environment variable "IPUMS_API_KEY".

Value

Invisibly, the path to the downloaded .xml DDI file.

See Also

Other ipums_api: define_extract_from_json(), define_extract_micro(), extract_list_to_tbl(), extract_tbl_to_list(), get_extract_info(), get_last_extract_info(), get_recent_extracts_info, ipums_data_collections(), is_extract_ready(), revise_extract_micro(), save_extract_as_json(), submit_extract(), wait_for_extract()

Examples

my_extract <- define_extract_micro("usa", "Example", "us2013a", "YEAR")

## Not run: 
submitted_extract <- submit_extract(my_extract)

# Download extract by supplying extract object:
path_to_ddi_file <- download_extract(submitted_extract)

# By supplying the data collection and extract number, as a string:
path_to_ddi_file <- download_extract("usa:1")
# Note that there is no space before or after the colon, and no zero-padding
# of the extract number.

# By supplying the data collection and extract number, as a vector:
path_to_ddi_file <- download_extract(c("usa", "1"))

## End(Not run)

mnpopcenter/ipumsr documentation built on Sept. 30, 2022, 6:56 a.m.