https://github.com/mnpopcenter/ipumsr
Read IPUMS data into R.
https://github.com/mnpopcenter/ipumsr
Last synced: 4 months ago
JSON representation
Read IPUMS data into R.
- Host: GitHub
- URL: https://github.com/mnpopcenter/ipumsr
- Owner: mnpopcenter
- License: mpl-2.0
- Archived: true
- Created: 2017-08-29T20:21:42.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2022-09-21T20:09:12.000Z (about 3 years ago)
- Last Synced: 2024-12-04T09:39:40.342Z (12 months ago)
- Language: R
- Homepage: http://tech.popdata.org/ipumsr
- Size: 61.7 MB
- Stars: 89
- Watchers: 9
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.Rmd
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
- jimsghstars - mnpopcenter/ipumsr - Read IPUMS data into R. (R)
README
---
output: github_document
---
```{r, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-"
)
```
# ipumsr 
[](http://www.repostatus.org/#active)
[](https://CRAN.R-project.org/package=ipumsr)
[](https://github.com/mnpopcenter/ipumsr/actions)
[](https://codecov.io/gh/mnpopcenter/ipumsr?branch=master)
The ipumsr package helps import IPUMS extracts from the
[IPUMS website](https://www.ipums.org) into R. IPUMS provides census and
survey data from around the world integrated across time and space. IPUMS
integration and documentation makes it easy to study change, conduct comparative
research, merge information across data types, and analyze individuals within
family and community context. Data and services are available free of charge.
The ipumsr package can be installed by running the following command:
```{r, eval=FALSE}
install.packages("ipumsr")
```
Or, you can install the development version using the following commands:
```{r, eval=FALSE}
if (!require(devtools)) install.packages("devtools")
devtools::install_github("mnpopcenter/ipumsr")
```
## Learning More ##
The vignettes are a great place to learn more about ipumsr and IPUMS data:
- [See the **ipums** vignette for a general introduction](http://tech.popdata.org/ipumsr/articles/ipums.html)
- For a more detailed look at some of the features, see these vignettes:
- [**value-labels**](http://tech.popdata.org/ipumsr/articles/value-labels.html)
- Provides guidance for using the value labels provided by IPUMS
- [**ipums-geography**](http://tech.popdata.org/ipumsr/articles/ipums-geography.html)
- Provides guidance for using R as GIS tool with IPUMS data
- [**ipums-bigdata**](http://tech.popdata.org/ipumsr/articles/ipums-bigdata.html)
- How to handle large IPUMS data extracts and examples of using the chunked versions of microdata reading functions.
- [**ipums-api**](http://tech.popdata.org/ipumsr/dev/articles/ipums-api.html)
- (In-development features not yet on CRAN) How to use the IPUMS USA microdata extract API to define and submit extract requests, check extract status, and download extract files
- Or to see examples of how to work through data from particular projects,
see these vignettes:
- [**ipums-cps**](http://tech.popdata.org/ipumsr/articles/ipums-cps.html)
- An example of using CPS data with the ipumsr package
- [**ipums-nhgis**](http://tech.popdata.org/ipumsr/articles/ipums-nhgis.html)
- An example of using NHGIS data with the ipumsr package
- [**ipums-terra**](http://tech.popdata.org/ipumsr/articles/ipums-terra.html)
- An example of using IPUMS Terra data with the ipumsr package
- [The IPUMS website](https://ipums.org/support/exercises)
- For more project specific exercises
You can access them from R with the `vignette()` command (eg `vignette("value-labels")`).
If you are installing from github and want the vignettes, you'll need to run the following
commands first:
```{r, eval = FALSE}
devtools::install_github("mnpopcenter/ipumsr/ipumsexamples")
devtools::install_github("mnpopcenter/ipumsr", build_vignettes = TRUE)
```
## Development ##
We greatly appreciate bug reports, suggestions or pull requests. They can
be submitted via github, on our [user forum](https://forum.ipums.org) or by email to ipums@umn.edu
Before contributing, please be sure to read the
[Contributing Guidelines](https://github.com/mnpopcenter/ipumsr/blob/master/CONTRIBUTING.md)
and the [Code of Conduct](https://github.com/mnpopcenter/ipumsr/blob/master/CONDUCT.md).