Metrics are fields that are extracted or derived from the GoPro or GPX data.
The metric component draws the value of a bit of data on the screen at the given co-ordinate.
<component type="metric" metric="speed" />
Every metric knows its units, and can be converted to another unit easily. See below for the base unit for each metric.
<component type="metric" metric="speed" />
<component type="metric" metric="speed" units="kph" />
<component type="metric" metric="speed" units="mph" />
<component type="metric" metric="speed" units="knots" />
The following units are supported: mph, kph, mps, knots, degreeF, degreeC, feet, miles, km, nautical_miles, radian, gravity, G, m/s^2, m/s²
gravity and G are synonyms for 9.80665 m/s², so will convert acceleration values to G's
Conversions that don't make sense for a given metric will fail with a suitable message.
GPS Location is just another metric...
cache="false" is suggested for lat & lon metrics, as they will rarely repeat. By default text glyphs are cached, as they are
quite slow to render. This can be ignored really unless there are memory errors while rendering.
<component type="metric" metric="lat" dp="6" size="16" cache="false"/>
Either a number of decimal places, or a specific python formatting string can be used.
use the dp attribute
<component type="metric" metric="speed" dp="0" />
<component type="metric" metric="speed" dp="2" />
<component type="metric" metric="speed" dp="5" />
Use the format attribute.
<component type="metric" metric="speed" format=".4f" />
The same positioning as in the text component
<component type="metric" x="40" metric="speed" />
The same alignment as in the text component
<component type="metric" x="40" metric="speed" align="right" />
The same colour as in the text component
<component type="metric" metric="speed" rgb="255,255,0" />
<component type="metric" metric="speed" rgb="255,255,0,128" />
The following metrics are supported:
hr, cadence, speed, cspeed, temp,
gradient, alt, odo, dist, azi, lat, lon, accl.x, accl.y, accl.z
Currently, there is no mechanism to calculate the overall acceleration, this will come in a future version.
| Metric | Description | Unit |
|---|---|---|
| hr | Heart Rate | beats / minute |
| cadence | Cadence | revolutions / minute |
| speed | Speed (as reported by device if available, or fallback to cspeed) | metres / second |
| cspeed | Computed Speed (derived from location delta) | metres / second |
| temp | Ambient Temperature | degrees C |
| gradient | Gradient of Ascent | - |
| alt | Height above sea level | metres |
| odo | Distance since start | metres |
| dist | Distance since last point | metres |
| azi | Azimuth | degree |
| cog | Course over Ground | degree |
| lat | Latitude | - |
| lon | Longitude | - |
| accl.x | Acceleration - X Axis | m/s² |
| accl.y | Acceleration - Y Axis | m/s² |
| accl.z | Acceleration - Z Axis | m/s² |
Image (C) GoPro - from https://github.com/gopro/gpmf-parser
