https://github.com/tidyverse/haven

Read SPSS, Stata and SAS files from R
https://github.com/tidyverse/haven

r sas spss stata

Last synced: about 2 months ago
JSON representation

Read SPSS, Stata and SAS files from R

• Host: GitHub
• URL: https://github.com/tidyverse/haven
• Owner: tidyverse
• License: other
• Created: 2015-02-04T16:28:17.000Z (almost 10 years ago)
• Default Branch: main
• Last Pushed: 2024-07-12T06:59:49.000Z (5 months ago)
• Last Synced: 2024-08-01T00:38:02.671Z (5 months ago)
• Topics: r, sas, spss, stata
• Language: C
• Homepage: https://haven.tidyverse.org
• Size: 7.34 MB
• Stars: 423
• Watchers: 21
• Forks: 115
• Open Issues: 48
• Metadata Files:
  • Readme: README.Rmd
  • Contributing: .github/CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: .github/CODE_OF_CONDUCT.md
  • Support: .github/SUPPORT.md

Awesome Lists containing this project

README

        
---

output: github_document

---

```{r, include = FALSE}

knitr::opts_chunk$set(

  collapse = TRUE,

  comment = "#>",

  fig.path = "man/figures/README-",

  out.width = "100%"

)

```

# haven 

[![CRAN status](https://www.r-pkg.org/badges/version/haven)](https://cran.r-project.org/package=haven)

[![R-CMD-check](https://github.com/tidyverse/haven/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/tidyverse/haven/actions/workflows/R-CMD-check.yaml)

[![Codecov test coverage](https://codecov.io/gh/tidyverse/haven/branch/main/graph/badge.svg)](https://app.codecov.io/gh/tidyverse/haven?branch=main)

## 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](https://www.evanmiller.org). Haven is part of the [tidyverse](https://www.tidyverse.org/). Currently it supports:

* __SAS__: `read_sas()` reads `.sas7bdat` + `.sas7bcat` files and `read_xpt()` 

  reads SAS transport files (versions 5 and 8). `write_xpt()` writes SAS

  transport files (versions 5 and 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](https://github.com/tidyverse/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, eval = FALSE}

# The easiest way to get haven is to install the whole tidyverse:

install.packages("tidyverse")

# Alternatively, install just haven:

install.packages("haven")

```

## Usage

```{r, eval = FALSE}

library(haven)

# SAS

read_sas("mtcars.sas7bdat")

write_xpt(mtcars, "mtcars.xpt")

# SPSS

read_sav("mtcars.sav")

write_sav(mtcars, "mtcars.sav")

# Stata

read_dta("mtcars.dta")

write_dta(mtcars, "mtcars.dta")

```

## Related work

* [foreign](https://cran.r-project.org/package=foreign) reads from 

  SAS XPORT, SPSS, and Stata (up to version 12) files.

* [readstat13](https://cran.r-project.org/package=readstata13) reads from 

  and writes to all Stata file format versions.

* [sas7bdat](https://cran.r-project.org/package=sas7bdat) reads from

  SAS7BDAT files.

## Code of Conduct

Please note that the haven project is released with a [Contributor Code of Conduct](https://haven.tidyverse.org/CODE_OF_CONDUCT.html). By contributing to this project, you agree to abide by its terms.