Skip to contents

Clinical gait report dashboard

Source: R/report-gait.R
clinicalGaitReport.Rd

Composes a multi-panel clinical gait report: one waveform panel per gait variable (a colorblind-safe normative \(\pm\)SD corridor from plotNormativeBand overlaid with the subject's Left and Right mean traces and optional event markers), followed by a gait-index dashboard (GDI / GPS / Movement Analysis Profile). Panels are laid out with patchwork.

Usage

clinicalGaitReport(
  pe,
  norm,
  events = NULL,
  sides = c("L", "R"),
  indices = TRUE
)

Arguments

pe

A named list of per-variable side-split cycle waveforms: pe[[variable]] is a list with $left and $right, each a numeric cycle waveform or a points-by-cycles matrix (averaged across cycles). Variables are matched to norm$variables by name; kinetic variables (moments/power) can be included when norm carries their corridors.

norm

A gait_norm-like list (e.g. from PhysioGaitNorm::loadGaitNorm()) with $variables, row-named $mean and $sd matrices (variables x cycle points), and optionally $percent and $features (for the GDI).

events

Optional numeric vector of gait-cycle percentages at which to draw event markers (e.g. toe-off) on every waveform panel.

sides

Which sides to overlay (currently informational; both Left and Right are drawn).

indices

Logical; if TRUE (default) append the gait-index dashboard panel (requires PhysioMoCap and all norm variables present in pe); omitted with a warning if it cannot be computed.

Value

A patchwork composite (a ggplot-compatible object).

See also

gaitIndexDashboard(), plotNormativeBand(), PhysioMoCap::plotSymmetry()

Examples

# \donttest{
# see the package tests for a synthetic gait fixture
# }