basic_metrics
Retrieve a run's core metrics: average heart rate, paces, sliding-window best efforts, run/walk/stand time, and running cadence. Use them as baselines to compare drift and efficiency.
Instructions
§6.0 the run's own description: average HR, three paces, windowed bests, run/walk/stand time, and cadence.
Args:
run: run_id, activity_id or Garmin file id. Empty means the latest run.
THESE ARE ANCHORS, NOT SIGNALS. For a run/walk athlete holding an HR cap,
average HR barely moves from run to run because HR is held nearly flat
across grade — quote it as the level that drift and efficiency are
deviations FROM, not as a finding.
Paces are never pooled: `overall` is Garmin's own basis (distance over
timer time), `running` and `walking` come from the rwd_* splits and are
separate quantities. A class below the minimum time is `gated` with its
time stated, not silently absent.
The bests are SLIDING WINDOWS, never an instantaneous maximum, and they are
NOT comparable across sampling regimes. Read each window's
`walk_time_fraction` and `flagged_record_fraction` before quoting it: a
maximum selects for positive measurement error in a way a mean does not.
Cadence is steps per minute. It is running-only and non-zero-only, so it
does NOT equal Garmin's own averageRunningCadence, which includes standing.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run | No | ||
| last_n | No | ||
| cluster | No | ||
| end_date | No | ||
| run_type | No | ||
| direction | No | ||
| segment_id | No | ||
| start_date | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |