Integrated Neuromechanical Vulnerability

Combines EMG activation, kinematic stress, and force data to compute a multi-source vulnerability score for each muscle. Propagates kinematic stress through the MSK incidence matrix and weights by impact deviation.

Usage

neuromechIntegratedVulnerability(
  emg,
  kinematics,
  force_data,
  hg = NULL,
  emg_mapping = NULL,
  kin_mapping = NULL,
  weights = c(1, 1, 1),
  use_proxy = TRUE
)

Arguments

emg

EMG data: SummarizedExperiment, matrix, or vector.

kinematics

Kinematic data: matrix (time x segments) or SummarizedExperiment.

force_data

Force data: named numeric vector, data.frame, or matrix.

hg

An MSKHypergraph object (NULL loads default).

emg_mapping

Optional pre-computed data.frame from emgToMSKMapping().

kin_mapping

Optional pre-computed data.frame from mocapToMSKMapping().

weights

Numeric vector of length 3, weights for EMG, kinematics, force components (default: c(1, 1, 1)).

use_proxy

Logical, use degree-based proxy for impact deviation (default: TRUE).

Value

A list with:

vulnerability

Named numeric vector of muscle vulnerability scores

ranking

Data.frame sorted by vulnerability (descending)

source_correlations

Pairwise correlations between EMG, kin, force sources

Examples

if (FALSE) { # \dontrun{
result <- neuromechIntegratedVulnerability(emg, kinematics, force)
} # }