kin.signal.analysis: Analyze trajectory data

In ccamp83/kinesis: R package for the analysis of motion trajectories and movement kinematics

Analyze trajectory data

Description

Repair (check for missing frames), smooth, derive, rotate trajectory data

Usage

kin.signal.analysis(
  signal,
  signal.name = "signal",
  start = c(0, 0, 0),
  end = c(0, 0, 0),
  maxFrames = 20,
  filter = "bw",
  splinepar = 0.05,
  bw.cutoff = 10,
  rotateF = T,
  rotateT = T,
  rotateS = T,
  ...
)

Arguments

signal	dataset to be analyzed. It must contain a time column and three columns for the x, y, z positions of the object (signal) that will be analyzed. See details for the expected names of these columns
signal.name	character indicating the name of the object (signal)
start	3-elements-long vector indicating the x, y, z coordinates of the start position of the trajectory. Default to c(0,0,0), no translation is applied.
end	3-elements-long vector indicating the x, y, z coordinates of the end position of the trajectory. Default to c(0,0,0), no rotation is applied.
maxFrames	integer number of missing frames to be substituted with linear interpolation
filter	filter used for smoothing: "ss" (smoothing spline), "bw" (low-pass Butterworth - default), "sg" (Savitzky-Golay)
splinepar	parameter for smoothing spline (requires filter = "ss". See ?smooth.spline for details)
bw.cutoff	cutoff frequency for the Butterworth filter (requires filter = "bw". See ?kin.bwFilter)
rotateF	logical: should the trajectory be aligned to the frontoparallel plane?
rotateT	logical: should the trajectory be aligned to the transversal plane?
rotateS	logical: should the trajectory be aligned to the sagittal plane?

Details

The names of the input dataset (signal parameter) must adhere to the following standards: i) the name of the time column must be identical to what specified through kin.setDataCols() ii) the other three columns names must be string of the type nameXraw, nameYraw, nameZraw (where "name" must match the signal.name parameter)

ccamp83/kinesis documentation built on Feb. 28, 2024, 12:11 p.m.