scan (version 0.53)

readSC: Read single-case data from files

Description

Use the readSC function to import single-case data from structured .csv or the readSC.excel function for importing excel files.

Usage

readSC(
  filename = NULL,
  data = NULL,
  sep = ",",
  dec = ".",
  sort.labels = FALSE,
  cvar = "case",
  pvar = "phase",
  dvar = "values",
  mvar = "mt",
  phase.names = NULL,
  type = "csv",
  ...
)
readSC.excel(...)

Arguments

filename

A character string defining the file to be imported (e.g. "SC_Anita.csv". If filename is left empty a dialog box for choosing will be opened.

data

A data frame. As an alternative to filname a dataframe could be directly provided.

sep

The field separator string. Values within rows have to be separated by this string. Default is sep = ",".

dec

The string used for decimal points in the file. Must be a single character. Default is dec = "."

sort.labels

If set TRUE, the resulting list is sorted by label names (alphabetically increasing).

cvar

Sets the variable name of the "case" variable. Deafults to "case".

pvar

Sets the variable name of the "phase" variable. Deafults to "phase".

dvar

Sets the variable name of the "values" variable. Deafults to "values".

mvar

Sets the variable name of the "mt" variable. Deafults to "mt".

phase.names

A character vector with phase names. Deafults to the phase names provided in the phase variable.

type

Format of the file to be imported. Either "csv" or "excel" is possible.

…

Further arguments passed to the read.table command.

Value

Returns a single-case data frame. See scdf to learn about the format of these data frames.

See Also

read.table, writeSC, scdf, readRDS

Examples

# NOT RUN {
## Read SC-data from a file named "study1.csv" in your working directory
# study1 <- readSC("study1.csv")

## Read SC-data from a .csv-file with semicolon as field and comma as decimal separator
# study2 <- readSC("study2.csv", sep = ";", dec = ",")

## writeSc and readSC
filename <- file.path(tempdir(),"test.csv")
writeSC(exampleA1B1A2B2_zvt, filename)
dat <- readSC(filename, cvar = "case", pvar = "part", dvar = "zvt", mvar = "day")
res1 <- describeSC(exampleA1B1A2B2_zvt)$descriptives
res2 <- describeSC(dat)$descriptives
identical(res1,res2)

# }