{"id":45105173,"url":"https://github.com/ipums/ipumsr","last_synced_at":"2026-02-19T21:59:12.376Z","repository":{"id":38051028,"uuid":"431276553","full_name":"ipums/ipumsr","owner":"ipums","description":"Request, download, and read IPUMS data in R","archived":false,"fork":false,"pushed_at":"2026-02-11T15:02:28.000Z","size":188054,"stargazers_count":39,"open_issues_count":4,"forks_count":8,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-02-11T22:36:31.442Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://tech.popdata.org/ipumsr/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ipums.png","metadata":{"files":{"readme":"README.Rmd","changelog":"NEWS.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE.txt","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-11-23T22:47:32.000Z","updated_at":"2026-02-11T14:35:36.000Z","dependencies_parsed_at":"2023-10-03T00:17:44.420Z","dependency_job_id":"3dbb971c-7964-411e-8305-9863956b1dc8","html_url":"https://github.com/ipums/ipumsr","commit_stats":null,"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/ipums/ipumsr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipums%2Fipumsr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipums%2Fipumsr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipums%2Fipumsr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipums%2Fipumsr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ipums","download_url":"https://codeload.github.com/ipums/ipumsr/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ipums%2Fipumsr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29634614,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T18:02:07.722Z","status":"ssl_error","status_checked_at":"2026-02-19T18:01:46.144Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-19T21:59:11.748Z","updated_at":"2026-02-19T21:59:12.370Z","avatar_url":"https://github.com/ipums.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\noutput: github_document\n---\n\n\u003c!-- README.md is generated from README.Rmd. Please edit that file --\u003e\n\n```{r, echo = FALSE}\nknitr::opts_chunk$set(\n  collapse = TRUE,\n  comment = \"#\u003e\",\n  fig.path = \"man/figures/README-\"\n)\n```\n\n# ipumsr \u003cimg src=\"man/figures/logo.png\" align=\"right\" height=\"149\" width=\"128.5\"/\u003e\n\n\u003c!-- badges: start --\u003e\n\n[![Project\nStatus:Active](https://www.repostatus.org/badges/latest/active.svg)](https://www.repostatus.org/#active)\n[![CRAN_Status_Badge](https://www.r-pkg.org/badges/version/ipumsr)](https://CRAN.R-project.org/package=ipumsr)\n[![R build\nstatus](https://github.com/ipums/ipumsr/workflows/R-CMD-check/badge.svg)](https://github.com/ipums/ipumsr/actions/workflows/R-CMD-check.yaml)\n[![Codecov test\ncoverage](https://codecov.io/gh/ipums/ipumsr/branch/main/graph/badge.svg)](https://app.codecov.io/gh/ipums/ipumsr?branch=main)\n\n\u003c!-- badges: end --\u003e\n\nipumsr provides an R interface for handling\n[IPUMS](https://www.ipums.org) data, allowing users to:\n\n-   Easily read files downloaded from the IPUMS extract system\n\n-   Request data, download files, and get metadata from certain IPUMS\ncollections\n\n-   Interpret and process data using the contextual information that is\nincluded with many IPUMS files\n\n## Installation\n\nTo install the package from CRAN, use\n\n```{r, eval=FALSE}\ninstall.packages(\"ipumsr\")\n```\n\nTo install the development version of the package, use\n\n```{r, eval=FALSE}\nremotes::install_github(\"ipums/ipumsr\")\n```\n\n## What is IPUMS?\n\n[IPUMS](https://www.ipums.org) is the world's largest\npublicly available population database, providing census and survey data\nfrom around the world integrated across time and space. IPUMS\nintegration and documentation make it easy to study change, conduct\ncomparative research, merge information across data types, and analyze\nindividuals within family and community context. Data and services are\navailable free of charge.\n\nIPUMS consists of multiple projects, or *collections*, that provide\ndifferent data products.\n\n-   **Microdata** projects distribute data for individual survey units,\nlike people or households.\n-   **Aggregate data** projects distribute summary tables of aggregate\nstatistics for particular geographic units along with corresponding\nGIS mapping files.\n\nipumsr supports different levels of functionality for each IPUMS project, as\nsummarized in the table below.\n\n```{r}\n#| echo: false\n\ncheckmark \u003c- function() {\n  \"\u003cimg src='man/figures/check-solid.svg' class='icon-check' alt='Check mark'\u003e\"\n}\n\n# Difficult to use `proj_config()` to auto-produce this table, as we\n# group projects together (e.g. Global Health projects), which is not\n# reflected in `proj_config()`. Currently we will need to keep this up-to-date\n# manually.\ntbl_config \u003c- list(\n  list(\n    img = \"\u003ca href='https://usa.ipums.org/usa/'\u003e\u003cimg src='man/figures/logo-square_usa_50x50.png' alt='IPUMS USA logo'\u003e\u003c/a\u003e\",\n    proj = \"\u003ca href='https://usa.ipums.org/usa/'\u003eIPUMS USA\u003c/a\u003e\",\n    type = \"Microdata\",\n    desc = \"U.S. Census and American Community Survey microdata (1850-present)\",\n    read = checkmark(),\n    request = checkmark(),\n    metadata = \"\"\n  ),\n  list(\n    img = \"\u003ca href='https://cps.ipums.org/cps/'\u003e\u003cimg src='man/figures/logo-square_cps_50x50.png' alt='IPUMS CPS logo'\u003e\u003c/a\u003e\",\n    proj = \"\u003ca href='https://cps.ipums.org/cps/'\u003eIPUMS CPS\u003c/a\u003e\",\n    type = \"Microdata\",\n    desc = \"Current Population Survey microdata including basic monthly surveys and supplements (1962-present)\",\n    read = checkmark(),\n    request = checkmark(),\n    metadata = \"\"\n  ),\n  list(\n    img = \"\u003ca href='https://international.ipums.org/international/'\u003e\u003cimg src='man/figures/logo-square_international_50x50.png' alt='IPUMS International logo'\u003e\u003c/a\u003e\",\n    proj = \"\u003ca href='https://international.ipums.org/international/'\u003eIPUMS International\u003c/a\u003e\",\n    type = \"Microdata\",\n    desc = \"Census microdata covering over 100 countries, contemporary and historical\",\n    read = checkmark(),\n    request = checkmark(),\n    metadata = \"\"\n  ),\n  list(\n    img = \"\u003ca href='https://www.nhgis.org/'\u003e\u003cimg src='man/figures/logo-square_nhgis50x50.png' alt='IPUMS NHGIS logo'\u003e\u003c/a\u003e\",\n    proj = \"\u003ca href='https://www.nhgis.org/'\u003eIPUMS NHGIS\u003c/a\u003e\",\n    type = \"Aggregate Data\",\n    desc = \"Tabular U.S. Census data and GIS mapping files (1790-present)\",\n    read = checkmark(),\n    request = checkmark(),\n    metadata = checkmark()\n  ),\n  list(\n    img = \"\u003ca href='https://ihgis.ipums.org/'\u003e\u003cimg src='man/figures/logo-square_ihgis_50x50.png' alt='IPUMS IHGIS logo'\u003e\u003c/a\u003e\",\n    proj = \"\u003ca href='https://ihgis.ipums.org/'\u003eIPUMS IHGIS\u003c/a\u003e\",\n    type = \"Aggregate Data\",\n    desc = \"Tabular and GIS data from population, housing, and agricultural censuses around the world\",\n    read = checkmark(),\n    request = checkmark(),\n    metadata = checkmark()\n  ),\n  list(\n    img = \"\u003ca href='https://timeuse.ipums.org/'\u003e\u003cimg src='man/figures/logo-square_time-use_50x50.png' alt='IPUMS Time Use logo'\u003e\u003c/a\u003e\",\n    proj = \"\u003ca href='https://timeuse.ipums.org/'\u003eIPUMS Time Use\u003c/a\u003e\",\n    type = \"Microdata\",\n    desc = \"Time use microdata from the U.S. (1930-present) and thirteen other countries (1965-present)\",\n    read = checkmark(),\n    request = checkmark(),\n    metadata = \"\"\n  ),\n  list(\n    img = \"\u003ca href='https://healthsurveys.ipums.org/'\u003e\u003cimg src='man/figures/logo-square_health-surveys_50x50.png' alt='IPUMS Health Surveys logo'\u003e\u003c/a\u003e\",\n    proj = \"\u003ca href='https://healthsurveys.ipums.org/'\u003eIPUMS Health Surveys\u003c/a\u003e\",\n    type = \"Microdata\",\n    desc = paste0(\n      \"Microdata from the U.S. \",\n      \"\u003ca href='https://nhis.ipums.org/nhis/'\u003eNational Health Interview Survey (NHIS)\u003c/a\u003e (1963-present) and \",\n      \"\u003ca href='https://meps.ipums.org/meps/'\u003eMedical Expenditure Panel Survey (MEPS)\u003c/a\u003e (1996-present)\"\n    ),\n    read = checkmark(),\n    request = checkmark(),\n    metadata = \"\"\n  ),\n  list(\n    img = \"\u003ca href='https://globalhealth.ipums.org/'\u003e\u003cimg src='man/figures/logo-square_global-health_50x50.png' alt='IPUMS Global Health logo'\u003e\u003c/a\u003e\",\n    proj = \"\u003ca href='https://globalhealth.ipums.org/'\u003eIPUMS Global Health\u003c/a\u003e\",\n    type = \"Microdata\",\n    desc = paste0(\n      \"Health survey microdata for low- and middle-income countries, including \",\n      \"harmonized data collections for \u003ca href='https://www.idhsdata.org/'\u003eDemographic and Health Surveys (DHS)\u003c/a\u003e \",\n      \"and \u003ca href='https://pma.ipums.org/'\u003ePerformance Monitoring for Action (PMA)\u003c/a\u003e surveys\"\n    ),\n    read = checkmark(),\n    request = \"DHS only\",\n    metadata = \"\"\n  ),\n  list(\n    img = \"\u003ca href='https://highered.ipums.org/highered/'\u003e\u003cimg src='man/figures/logo-square_higher-ed_50x50.png' alt='IPUMS Higher Ed logo'\u003e\u003c/a\u003e\",\n    proj = \"\u003ca href='https://highered.ipums.org/highered/'\u003eIPUMS Higher Ed\u003c/a\u003e\",\n    type = \"Microdata\",\n    desc = \"Survey microdata on the science and engineering workforce in the U.S. from 1993 to 2013\",\n    read = checkmark(),\n    request = \"\",\n    metadata = \"\"\n  )\n)\n\nknitr::kable(\n  purrr::map_dfr(tbl_config, tibble::as_tibble),\n  table.attr = \"class=\\'table-hover table-proj-summary\\'\",\n  format = \"html\",\n  escape = FALSE,\n  col.names = c(\n    \"\",\n    \"\",\n    \"Data Type\",\n    \"Description\",\n    \"Read Data Extracts\",\n    \"Request \u0026 Download Data\",\n    \"Browse Metadata\"\n  ),\n  align = c(\"clllccc\")\n)\n```\n\nipumsr uses the [IPUMS API](https://developer.ipums.org/) to submit data\nrequests, download data extracts, and get metadata, so the scope of\nfunctionality generally corresponds to that [available via the API](https://developer.ipums.org/docs/v2/apiprogram/apis/). As\nthe IPUMS team extends the API to support more functionality for more\nprojects, we aim to extend ipumsr capabilities accordingly.\n\n## Getting started\n\nIf you're new to IPUMS data, learn more about what's available through\nthe [IPUMS Projects Overview](https://www.ipums.org/overview). Then, see\n`vignette(\"ipums\")` for an overview of how to obtain IPUMS data.\n\nThe package vignettes are the best place to explore what ipumsr has to offer:\n\n-   To read IPUMS data extracts into R, see `vignette(\"ipums-read\")`.\n\n-   To interact with the IPUMS extract and metadata system via the IPUMS API, \n    see `vignette(\"ipums-api\")`.\n    \n-   For additional details about microdata and aggregate data extract requests, \n    see `vignette(\"ipums-api-micro\")` and `vignette(\"ipums-api-agg\")`.\n    \n-   To work with labelled values in IPUMS data, see `vignette(\"value-labels\")`.\n\n-   For techniques for working with large data extracts, see\n    `vignette(\"ipums-bigdata\")`.\n\nThe [IPUMS support website](https://www.ipums.org/support) also houses\nmany project-specific R-based [training\nexercises](https://www.ipums.org/support/exercises). However, note that some\nof these exercises may not be be up to date with ipumsr's current \nfunctionality.\n\n## Related work\n\n-   The [survey](http://r-survey.r-forge.r-project.org/survey/) and\n[srvyr](https://github.com/gergness/srvyr/) packages can help you\nincorporate IPUMS survey weights into your analysis for various\nsurvey designs.\n\n-   See [haven](https://haven.tidyverse.org/index.html) for more\ninformation about value labels and labelled vectors\n\n-   [hipread](https://github.com/ipums/hipread) underlies the\nhierarchical file reading functions in ipumsr\n\n## Getting help + contributing\n\nWe greatly appreciate feedback and development contributions. Please\nsubmit any bug reports, pull requests, or other suggestions on\n[GitHub](https://github.com/ipums/ipumsr/issues). Before contributing,\nplease be sure to read the [Contributing\nGuidelines](https://tech.popdata.org/ipumsr/CONTRIBUTING.html)\nand the \n[Code of Conduct](https://tech.popdata.org/ipumsr/CODE_OF_CONDUCT.html).\n\nIf you have general questions or concerns about IPUMS data, check out\nour [user forum](https://forum.ipums.org) or send an email to\n[ipums\\@umn.edu](mailto:ipums@umn.edu){.email}.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipums%2Fipumsr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fipums%2Fipumsr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fipums%2Fipumsr/lists"}