1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78
|
<!-- README.md is generated from README.Rmd. Please edit that file -->
# haven <a href='https:/haven.tidyverse.org'><img src='man/figures/logo.png' align="right" height="139" /></a>
<!-- badges: start -->
[![CRAN
status](https://www.r-pkg.org/badges/version/haven)](https://cran.r-project.org/package=haven)
[![Travis build
status](https://travis-ci.org/tidyverse/haven.svg?branch=master)](https://travis-ci.org/tidyverse/haven)
[![AppVeyor build
status](https://ci.appveyor.com/api/projects/status/github/tidyverse/haven?branch=master&svg=true)](https://ci.appveyor.com/project/tidyverse/haven)
[![Codecov test
coverage](https://codecov.io/gh/tidyverse/haven/branch/master/graph/badge.svg)](https://codecov.io/gh/tidyverse/haven?branch=master)
<!-- badges: end -->
## Overview
Haven enables R to read and write various data formats used by other
statistical packages by wrapping the fantastic
[ReadStat](https://github.com/WizardMac/ReadStat) C library written by
[Evan Miller](http://www.evanmiller.org). Haven is part of the
[tidyverse](http://tidyverse.org). Currently it supports:
- **SAS**: `read_sas()` reads `.sas7bdat` + `.sas7bcat` files and
`read_xpt()` reads SAS transport files (version 5 and version 8).
- **SPSS**: `read_sav()` reads `.sav` files and `read_por()` reads the
older `.por` files. `write_sav()` writes `.sav` files.
- **Stata**: `read_dta()` reads `.dta` files (up to version 15).
`write_dta()` writes `.dta` files (versions 8-15).
The output objects:
- Are [tibbles](http://github.com/hadley/tibble), which have a better
print method for very long and very wide files.
- Translate value labels into a new `labelled()` class, which
preserves the original semantics and can easily be coerced to
factors with `as_factor()`. Special missing values are preserved.
See `vignette("semantics")` for more details.
- Dates and times are converted to R date/time classes. Character
vectors are not converted to factors.
## Installation
``` r
# The easiest way to get haven is to install the whole tidyverse:
install.packages("tidyverse")
# Alternatively, install just haven:
install.packages("haven")
# Or the the development version from GitHub:
# install.packages("devtools")
devtools::install_github("tidyverse/haven")
```
## Usage
``` r
library(haven)
# SAS
read_sas("mtcars.sas7bdat")
write_sas(mtcars, "mtcars.sas7bdat")
# SPSS
read_sav("mtcars.sav")
write_sav(mtcars, "mtcars.sav")
# Stata
read_dta("mtcars.dta")
write_dta(mtcars, "mtcars.dta")
```
|