Learn R Programming

fgdiR (version 0.1.0)

FGDI: Compute the Functional Gait Deviation Index (FGDI)

Description

Computes univariate and multivariate FGDI scores from gait data matrices.

Usage

FGDI(G, ID, PVE_I)

Value

A list with the following elements:

SFGDIB

A numeric vector of scaled FGDI scores for both the left and right side.

zFGDIU

A matrix containing the standardized FGDI scores for each kinematic variable.

zFGDI

A numeric vector of standardized combined FGDI scores.

Fits

A list containing the approximated gait functions evaluated across the gait cycle for each kinematic variable.

RMSE

A numeric vector containing the root mean squared error of the approximated gait functions.

SFGDIL

A numeric vector of standardized FGDI scores for the left side.

SFGDIR

A numeric vector of standardized FGDI scores for the right side.

PVE

A numeric vector with the percentage of variation explained by FPCs for the combined data.

PVEL

A numeric vector with the percentage of variation explained by FPCs for the data on the left side.

PVER

A numeric vector with the percentage of variation explained by FPCs for the data on the right side.

UPVE

A matrix with the percentage of variation explained by FPCs for each kinematic variable.

M

The choosen number of FPCs for the combined data.

M1

The choosen number of FPCs for the data on the left side.

M2

The choosen number of FPCs for the data on the right side.

NPC

The choosen number of FPCs for each kinematic variable.

#' @examples data(A_Data) FGDI_out <- FGDI(A_Data, ID = rep(c("Case", "Control"), times = c(18, 42)), PVE_I = 0.99) FGDI_out$SFGDIL

Arguments

G

A list of matrices representing joint kinematic data. Each list contains the pelvic and hip angles across all three planes, knee flexion/extension, ankle dorsiflexion/plantarflexion, and foot internal/external rotation. The Left side is first and then the right side. It is important to note that since the pelvis is common to both sides, it is appropriate to include pelvic kinematics from only one side.

ID

A vector of group labels (e.g., "Case", "Control").

PVE_I

A numeric value (0–1) for cumulative proportion of variance explained.

References

Minhas, S.K., Sangeux, M., Polak, J., & Carey, M. (2025). The Functional Gait Deviation Index. Journal of Applied Statistics.