read_spss: Read SPSS ('.sav', '.zsav', '.por') files. Write '.sav' and...

In antaldaniel/retroharmonize: Ex Post Survey Data Harmonization

Read SPSS ('.sav', '.zsav', '.por') files. Write '.sav' and '.zsav' files.

Description

This is a wrapper around haven::read_spss with some exception handling.

Usage

read_spss(
  file,
  user_na = TRUE,
  dataset_bibentry = NULL,
  id = NULL,
  doi = NULL,
  .name_repair = "unique"
)

Arguments

file	An SPSS file.
user_na	Should user-defined na_values be imported? Defaults to TRUE.
dataset_bibentry	A bibliographic entry created with dataset::dublincore or dataset::datacite.
id	An identifier of the tibble, if omitted, defaults to the file name without its extension.
doi	An optional document object identifier.
.name_repair	Defaults to "unique" See tibble::as_tibble for details.

Details

'read_sav()' reads both '.sav' and '.zsav' files; 'write_sav()' creates '.zsav' files when 'compress = TRUE'. 'read_por()' reads '.por' files. 'read_spss()' uses either 'read_por()' or 'read_sav()' based on the file extension.

When the SPSS file has columns which are of class labelled, but have no labels, they are read as numeric or character vectors.

Value

A tibble:

Variable labels are stored in the "label" attribute of each variable. It is not printed on the console, but the RStudio viewer will show it.

'write_sav()' returns the input 'data' invisibly.

See Also

Other import functions: pull_survey(), read_csv(), read_dta(), read_rds(), read_surveys()

Examples

path <- system.file("examples", "iris.sav", package = "haven")
haven::read_sav(path)

tmp <- tempfile(fileext = ".sav")
haven::write_sav(mtcars, tmp)
haven::read_sav(tmp)

antaldaniel/retroharmonize documentation built on Dec. 31, 2024, 9:52 p.m.