Uncontrolled Manifold (UCM) analysis of motor variability
Source:R/motor-variability-ucm.R
uncontrolledManifold.RdDecomposes trial-to-trial variance of the elemental variables into the part lying in the uncontrolled manifold (the null space of the task Jacobian – variability that does not change the task variable, "good") and the part orthogonal to it (variability that does, "bad"). A positive synergy index means the elements co-vary to stabilise the task.
Arguments
- theta
An
N x nmatrix:Ntrials (repetitions),nelemental variables (e.g. joint angles).- jacobian
The
d x ntask Jacobian at the mean configuration (d= dimension of the task variable). Provide this, ortask.- task
Optional task function
R^n -> R^d; its Jacobian is computed numerically atcolMeans(theta)whenjacobianis not given.
Value
a ucm_result list: v_ucm, v_ort (variance per DOF, parallel and
orthogonal to the manifold), v_total, delta_v (synergy index,
(v_ucm - v_ort) / v_total; > 0 = task-stabilising synergy), n, d, N.