Nomenclature

One of the main ideas behind Sweatpy is to offer a generic interface to data from different data sources. A big part of this is making sure that the data frames that are returned by the sweat.read_*() methods (read_fit(), read_tcx(), etc.) are similar. I.e. it should not matter if you are importing an activity from a .fit file or a .tcx file: Working with the data should be the same.

For the data frames returned by the read_*() methods, the column and data types are as follows:

Column name	unit	comments
index or datetime	pandas.DatetimeIndex	Be aware that not all activity files are sampled at 1Hz
heartrate	beats per minute
speed	meters/second
power	Watt
latitude	degrees
longitude	degrees
left-right balance	%
cadence	rounds per minute
distance	meter
elevation	meter
temperature	degrees Celsius
lap	-	lap counter, zero-indexed. Only supported for .fit and .tcx files.
session	-	session counter, zero-indexed. Triggered when an activity is (manually or automatically) paused or stopped and then resumed. Only supported for .fit files.