createEmptyDF {voiceR}

Create an Empty data.frame

Description

Internal function which creates an empty data.frame in which the different audio files represent rows and the extracted measures represent columns. Several options can be configured such as joining dimensions or separating conditions.

Usage

createEmptyDF(
  path = ".",
  audioList = list(),
  fileType = "wav",
  fileNamePattern = "ID_Condition_Dimension",
  sep = "_",
  measures = c(),
  jointDimensions = FALSE,
  separateConditions = TRUE,
  filter = NA,
  recursive = FALSE
)

Arguments

path

An optional character string indicating the path to the folder containing the audio files. Default corresponds to current working directory.

audioList

Optional list with already loaded Wave objects to analyze.

fileType

Character string indicating the file format (wav or mp3) of the audio files. Default corresponds to wav.

fileNamePattern

A character string indicating the naming format, such as "ID-Condition-Dimension", "Condition_ID_Dimension" or "ID". Default corresponds to "ID_Condition_Dimension".

sep

A non alpha-numeric character that acts as separator between the different naming components. Default corresponds to underscore. This field can be ignored if the audio file names only contain an ID component.

measures

A character vector of measures that should appear in the data frame columns.

jointDimensions

Logical value indicating whether dimensions should be joint into a single or not. Default corresponds to FALSE.

separateConditions

Logical value indicating whether conditions should be separated or not. Default corresponds to TRUE.

filter

Optional character vector indicating IDs, Conditions, Dimensions or other name patterns. Default corresponds to NA.

recursive

Logical value indicating whether subdirectories should be included when searching for audio files. Default corresponds to FALSE.

Value

An empty data.frame in which ID's represent rows and dimensions/measures represent columns.