read_aaa: Read tab separated files with AAA spline data.

In rticulate: Articulatory Data Processing in R

Read tab separated files with AAA spline data.

Description

It reads a file or a list of files with data exported from AAA. The data are automatically transformed from a wide to a long format (each row has values of X or Y axes for each fan line). The imported tibble can then be used for plotting and statistical analysis.

Usage

read_aaa(
  file,
  coordinates = "cartesian",
  format = "long",
  na_rm = FALSE,
  knots = NULL,
  column_names = NULL,
  fan_lines = NULL
)

Arguments

file	The path of the file with AAA data. It can also be a character vector with multiple paths as separate strings..
coordinates	A string specifying the coordinate system. Possible values are "cartesian" (the default) and "polar".
format	A string specifying the data format. Possible values are "long" and "wide" (the default is "long").
na_rm	Remove NAs (the default is FALSE).
knots	The number of spline knots or fan lines.
column_names	The names of the columns without including the splines columns.
fan_lines	The number of fan lines in legacy fan-line data.

Value

A tibble.

Examples

columns <- c("speaker","seconds","rec_date","prompt","label",
"TT_displacement","TT_velocity","TT_abs_velocity","TD_displacement",
"TD_velocity","TD_abs_velocity")
file_path <- system.file("extdata", "it01.tsv", package = "rticulate")

tongue <- read_aaa(file_path, knots = 42, column_names = columns)

rticulate documentation built on April 3, 2025, 7:26 p.m.