kin.extract.parameters: Extract Kinematic Parameters from Movement Data

In ccamp83/kinesis: R package for analyzing kinematic trajectories of reaching and grasping movements.

Extract Kinematic Parameters from Movement Data

Description

Extracts various kinematic parameters from 3D movement data, including temporal, spatial, and dynamic measures for both reaching and grasping movements.

Usage

kin.extract.parameters(data, signals, grasp = F)

Arguments

data	A data frame containing movement data with time series information
signals	Character vector specifying the signal names to analyze
grasp	Logical value indicating whether to analyze grasping parameters (default: FALSE)

Details

The function processes 3D movement data to extract comprehensive kinematic parameters. It handles both reaching movements (default) and optionally grasping movements. Time measures are normalized to movement onset. The function includes error handling through tryCatch and returns NA if processing fails.

Value

A list containing:

• time_info: Data frame with movement onset, offset, and total movement time

• reach_parameters: Data frame with reaching kinematics including:

  • Final positions (FX, FY, FZ)

  • Final velocities (FXVel, FYVel, FZVel, FVel)

  • Peak dynamics (MVel, MAcc, MDec)

  • Timing measures (timeMVel, timeMAcc, timeMDec)

  • Path characteristics (pathLength, Xmax, Ymax, Zmax)

  • Temporal measures (timeToXmax, timeToYmax, timeToZmax)

  • Movement complexity (XlocMinN, YlocMinN, ZlocMinN, XlocMaxN, YlocMaxN, ZlocMaxN)

• grasp_parameters: (If grasp=TRUE) Data frame with grasping kinematics including:

  • All reaching parameters

  • Grip aperture measures (FGA, MGA)

  • Grip timing measures (timeMGA, timeMVelToMGA, timeMGAToMDec)

  • Grip orientation measures (FGOf, FGOt, FGOs)

See Also

kin.signal.arclength for path length calculations

Examples

## Not run: 
# Extract reaching parameters
reach_data <- kin.extract.parameters(movement_data, signals = c("hand"))

# Extract both reaching and grasping parameters
grasp_data <- kin.extract.parameters(movement_data, signals = c("hand"), grasp = TRUE)

## End(Not run)

ccamp83/kinesis documentation built on July 4, 2025, 6:19 p.m.