Skip to main content

Metrics Pairing Guide

This guide specifies valid and recommended metric type/unit pairs and per‑exercise‑type expectations to promote consistency across implementations.

Valid Type/Unit Pairs

TypeAllowed UnitsNotes
repscountWhole numbers
weightkg, lbPrefer one system per dataset
durations, minUse seconds for precision
distancem, km, mi
speedm_s, km_h
pacemin_per_km, min_per_mi
powerW
heartRatebpm
stepscount
calorieskcalEstimated
heightcm, inFor jumps/box height
tempocountConvention e.g., 3‑1‑1 as counts
rpecount1–10 scale

Exercise Type Expectations

Exercise TypePrimary MetricCommon Secondary Metrics
strengthrepsweight, tempo, rpe
powerreps or durationweight, power, height
cardioduration or distancepace or speed, heartRate
enduranceduration or distancepace/speed, heartRate, kcal
mobilitydurationtempo
isometricdurationrpe
plyometricrepsheight, duration

Notes:

  • Strength logging SHOULD at minimum support reps; weight is strongly recommended when applicable.
  • Cardio logging SHOULD include duration and either distance or pace (derive one from the other when possible).
  • Mobility/isometric SHOULD use duration as primary; avoid reps unless domain‑specific.

Validation Guidance

  • The Exercise schema constrains metrics structure; this guide clarifies domain expectations and recommended pairings.
  • Producers SHOULD select metrics consistent with classification.exerciseType.
  • Consumers MAY validate pairings to provide better UX and error messaging.