heartandsole.Activity.elevation.loss

Activity.elevation.loss(source='records')[source]

Return total elevation loss in meters.

Parameters

source (str) –

Source from which to obtain elevation loss.

  • records (default): result when the records DataFrame is passed in reverse to pandas.DataFrame.xyz.z_gain_threshold().

  • summary: loss value in the summary Series.

  • laps: sum of loss column in the laps DataFrame.

Returns

Total elevation loss according to the requested source. If the Activity does not possess the requested data source, return None.

Return type

float or None

Raises

ValueError – If source is not a valid option.

See also

pandas.DataFrame.xyz.z_gain_threshold()

A 5-meter threshold elevation gain algorithm. From the pandas-xyz package.