kin.grasp.analysis: Kinematic Analysis of Grasping Movements

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

Kinematic Analysis of Grasping Movements

Description

Analyzes 3D kinematic data of grasping movements by calculating various parameters including grip aperture, grip position, grip velocity, grip acceleration, and grip orientation angles.

Usage

kin.grasp.analysis(data, signals, splinepar = 0.05, ...)

Arguments

data	A data frame containing the kinematic data
signals	A vector of marker names (e.g., c("index", "thumb"))
splinepar	Smoothing parameter for the spline filter (default = 5e-2)
...	Additional arguments passed to internal functions

Details

The function calculates:

• Grip aperture as the 3D Euclidean distance between two markers (typically index and thumb)

• Grip position as the midpoint between the two markers

• Grip velocity and acceleration using smoothing spline filtering

• Grip orientation angles in three anatomical planes

Value

A data frame containing the following columns:

• deltaTime: Time values from the input data

• GA: Grip aperture (3D Euclidean distance between index and thumb)

• GPX, GPY, GPZ: 3D grip position coordinates

• GPXvel, GPYvel, GPZvel: Velocity components in each dimension

• GPVel: Overall grip velocity magnitude

• GPAcc: Grip acceleration

• GOF: Grip orientation in the frontal (coronal) plane

• GOT: Grip orientation in the transverse plane

• GOS: Grip orientation in the sagittal plane

Examples

## Not run: 
data <- read.csv("kinematic_data.csv")
results <- kin.grasp.analysis(data, signals = c("index", "thumb"))

## End(Not run)

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