read_scdf: Load single-case data from files

In scan: Single-Case Data Analyses for Single and Multiple Baseline Designs

Load single-case data from files

Description

Use the read_scdf function to load single-case data csv, excel, or yaml files.

Usage

read_scdf(
  file,
  cvar = "case",
  pvar = "phase",
  dvar = "values",
  mvar = "mt",
  sort_cases = FALSE,
  phase_names = NULL,
  type = NA,
  na = c("", "NA"),
  sort.labels = NULL,
  phase.names = NULL,
  ...
)

Arguments

file	Either a character string defining the file to be loaded (e.g. "SC_Anita.csv" (if left empty a dialog box for choosing will be opened) or a data.frame.
cvar	Sets the variable name of the "case" variable. Defaults to "case".
pvar	Sets the variable name of the "phase" variable. Defaults to "phase".
dvar	Sets the variable name of the "values" variable. Defaults to "values".
mvar	Sets the variable name of the "mt" variable. Defaults to "mt".
sort_cases, sort.labels	If set TRUE, the resulting list is sorted by label names (alphabetically increasing).
phase_names, phase.names	A character vector with phase names. Defaults to the phase names provided in the phase variable.
type	Format of the file to be loaded. Either "csv", "xlsx", "xls", "excel", "yml" is possible. By default (NA) the type is extracted from the file extension.
na	Character vector of strings to interpret as missing values.
...	Further arguments passed to the respective read function.

Value

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

Author(s)

Juergen Wilbert

See Also

read.table(), readRDS()

Other io-functions: convert(), write_scdf()

Examples

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

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

## write_scdf and read_scdf
filename <- file.path(tempdir(), "test.csv")
write_scdf(exampleA1B1A2B2_zvt, filename)
dat <- read_scdf(filename, cvar = "case", pvar = "part", dvar = "zvt", mvar = "day")
res1 <- describe(exampleA1B1A2B2_zvt)$descriptives
res2 <- describe(dat)$descriptives
all.equal(res1,res2)

scan documentation built on Sept. 11, 2025, 5:12 p.m.