From 28a9ae6cc07b496d15a4d110b547b2ab4afbbec3 Mon Sep 17 00:00:00 2001
From: Filip <filip.strajnar@gmail.com>
Date: Sat, 29 Mar 2025 17:16:01 +0100
Subject: [PATCH] Added first notes for data format.

---
 NOTES.md | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 NOTES.md

diff --git a/NOTES.md b/NOTES.md
new file mode 100644
index 0000000..a9e0a11
--- /dev/null
+++ b/NOTES.md
@@ -0,0 +1,39 @@
+# Recorded data
+
+Format:
+
+```
+Name - [protobuf type] : [unit]
+```
+
+- Speed - `float` : metres / second
+- Cadence - `float` : metres / second
+- Location:
+    - Latitude - `double` : degrees
+    - Longitude - `double` : degrees
+    - Altitude - `float` : metres above sea level
+- Power - `float` : watts
+- Relative wind speed - `float` : metres / second
+- Heart rate - `float` : beats / minute
+- Body temperature - `float` : temperature in kelvin, can be either skin or core temperature
+- Environment temperature - `float` : temperature in kelvin, can be either air temperature or water temperature
+- Oxygen saturation - `float` : percentage, 0-100%, usually peripheral oxygen saturation (SpO2)
+- Blood glucose - `float` : millimoles of glucose per litre of blood
+- Lactic acid - `float` : millimoles of lactic acid per litre of blood
+- Gradient - `float` : percentage, 0-100%
+- Left-Right power balance - `float` : percentage, 0-100% for the right side (55 would imply 45% for the left side, 55% for the right side)
+
+# Comparison of file types
+
+[GPX](https://www.topografix.com/gpx/1/1/gpx.xsd) - GPS Exchange format
+
+[TCX](https://www8.garmin.com/xmlschemas/TrainingCenterDatabasev2.xsd) - Garmin Training Center format
+
+[FIT](https://developer.garmin.com/fit/protocol/) - Flexible and Interoperable Data Transfer protocol
+
+| File type | Location | Cadence | Heart rate | Power | Wind speed | Speed | Body temperature | Environment temperature | Oxygen saturation | Blood glucose | Lactic acid | Gradient | L-R balance |
+| - | - | - | - | - | - | - | - | - | - | - | - | - | - |
+| GPX | 🟢 | 🔴 | 🔴 | 🔴 | 🔴 | 🔴 | 🔴 | 🔴 | 🔴 | 🔴 | 🔴 | 🔴 | 🔴 |
+| TCX | 🟢 | 🟢 | 🟢 | 🔴 | 🔴 | 🔴 | 🔴 | 🔴 | 🔴 | 🔴 | 🔴 | 🔴 | 🔴 |
+| FIT | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🔴 | 🔴 | 🔴 | 🟢 | 🟢 |
+| Proculite JSON | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 | 🟢 |
\ No newline at end of file