sss (version 0.1-0)

read.sss: Reads a triple-s XML (asc) data file, as specified by the triple-s XML standard.

Description

This function reads and parses a .sss XML metadata file as well as its associated .asc data file. The sss standard defines a standard survey structure.

Usage

read.sss(sssFilename, ascFilename, sep = "_")

Arguments

sssFilename

Character string: name of .sss file containing the survey metadata

ascFilename

Character string: name of .asc file containing survey data

sep

Character vector defining the string that separates question and subquestion labels, e.g. c("Q_1", "Q_2")

Value

A data frame with one element (column) for each variable in the data set.

The data.frame contains several attributes:

• variable.labels: a named list of value labels with one element per variable, either NULL or a named character vector

• label.table: a named list with one element per question. Every element is a named character strings, that contains the label codes for that question.

References

http://www.triple-s.org/

Examples

# NOT RUN {
sampleRoot <- system.file("sampledata", package = "sss")
filenameSSS <- file.path(sampleRoot, "sample-1.sss")

read.sss(filenameSSS)
# }