Giters

krp / FatMaxxer

Android Project to find FatMax in real time with a Polar H10

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

FatMaxxer

FatMaxxer for Android may help you exercise at the best intensity for fat burning, measured using just a Polar H10 heart rate strap, according to recent research (see below). This app requires a Polar H10 (or possibly H9).

Public Release: https://play.google.com/store/apps/details?id=online.fatmaxxer.publicRelease1 . The Google Play version may lag significantly behind the open source project hosted on Github and early test builds (https://github.com/IanPeake/FatMaxxer#testers-wanted).

See Bruce Rogers' FAQ (http://www.muscleoxygentraining.com/2021/01/dfa-a1-and-exercise-intensity-faq.html) and review (http://www.muscleoxygentraining.com/2021/06/fatmaxxer-new-app-for-real-time-dfa-a1.html).

Screenshot | Garmin notification | Garmin notification | Garmin notification | Garmin notification

In action:

Overview

FatMaxxer is an Android app which uses the Polar H10 to advise Detrended Fluctuation Analysis alpha1 (DFA, ⍺1) in real time.

There are promising signs that running or cycling at ⍺1 = 0.75 corresponds to the first ventilatory threshold "VT1" or roughly FatMax (https://www.frontiersin.org/articles/10.3389/fphys.2020.596567/full). Measuring VT1 reliably normally requires a lab test. DFA requires only a heart rate strap that can measure inter-heartbeat intervals accurately and reliably. FatMaxxer works just for Polar H10 which is the consumer HR strap validated in research.

FatMaxxer reports ⍺1 for the past two minutes in "near real time" via the GUI, speech (speaker/headphones, configurable) and notifications (configurable). The ⍺1 value and other features are calculated over the two minute rolling window of RR values, with ⍺1 calculated every 20 seconds (configurable). The RR stream is subject to artifact filtering, where adjacent RR intervals change by more than +/- threshold (%). Threshold settings are 5%, 25% and "Auto". The "Auto" setting uses a threshold of 5% when HR > 90 BPM and 25% when HR < 85 BPM.

FatMaxxer now provides experimental 10s ECG snapshot around all detected artifacts when Developer mode is enabled: (http://www.muscleoxygentraining.com/2021/07/ecg-artifact-strips-from-fatmaxxer-guide.html). A test segment (segment 0) is recorded at 10s elapsed time.

Testers Wanted

FatMaxxer is in an early stage of development. Sideload a recent test version from the APK downloadable from the Github repository. Join the https://groups.google.com/g/fatmaxxer-closed-testing for access to Google Play closed test versions.

The app may crash or not work properly. To help me fix your issue efficiently use the Github issue tracker above to report bugs.

License

Apache 2.0 for any code that was authored by me.

Getting started

User Interface

Shows ⍺1, plus detected artifacts, number of samples and therefore artifact rate (%) over the window; elapsed time; instantaneous heart rate and heart rate variablility (RMSSD). Android UI screenshot above shows output after walk/run intervals on an earlier version.

Graph plots:

  • X axis: time (minutes) with a 2 minute viewport
  • primary Y axis (0-200) configurable:
    • red: HR (BPM)
    • green: ⍺1 x 100 (e.g. 0.75 reads as 75). Yellow and red lines at 75 and 50 (HRVVT1100 and HRVVT2100). Grid lines at multiples of 25
    • magenta: RR intervals / 5
    • cyan: RMSSD
  • secondary Y axis (0-10):
    • blue: artifacts (%)

Plots are user-configurable separately for real time and replay mode.

Frequently Asked Questions

  • I cannot find FatMaxxer in the Play Store in my Country: Release is currently limited to a small set of countries due to lack of translations. If your country is not enabled let me know. Only English and Dutch are supported. Additional translations welcome.
  • FatMaxxer hangs / crashes: Can you connect your H10 as a BLE device? Can you see your H10 with Polar Beat / Polar Flow? Have you enabled dual channel mode using Polar Beat / Polar Flow? Have you checked carefully that no other apps/devices are connected via BLE to the H10? By default only one BLE connection can be made to the H10. If you enable dual channel mode in Polar Beat / Polar Flow, then a maximum of two BLE connections can be made to the H10, one of which must be FatMaxxer.
  • FatMaxxer still hangs / crashes: If possible, locate the debug.log file and send it to fatmaxxer@gmail.com. Search for the folder online.fatmaxxer.alpha1 on your phone, or enable Developer Mode and Export the debug.log file.
  • Will it work with my device?: Only the Polar H10 (and maybe H9) are supported. The research only validated the H10. It's believed that other sensors are not reliable enough. The Polar BLE API used by FatMaxxer does not support the H7.
  • (Why) does it have to be the H10/H9?: It doesn't have to be the H9/H10, but they are widely regarded as the least-worst consumer sensors in terms of accuracy/precision, and the experimental research is based on them. I used the H10 for those reasons, and chose the Polar SDK for Android because I am an Android user. The Polar SDK doesn't support other non-Polar sensors unfortunately.
  • Is there any plan for an iOS app?: Not at this stage, sorry. I wrote this app for Android because that's what I currently use. However the project is more or less entirely open source. It would be great if there was an iOS developer prepared to do a port to iOS.
  • FatMaxxer crashes on my device: The app is in a very early stage of development. Please do feel free to open a new issue with as much detail as possible about the fault. I am still working on aligning with Android development best practice for several aspects, including Notifications.

Audio / notification (wearable) updates

Reports ⍺1 and other features via audio and/or notifications (configurable), adjusting to work rate:

Audio updates report ⍺1 at HR above a hardcoded threshold, and RMSSD otherwise. Reports artifacts above a hardcoded threshold, or at higher intensity. Audio updates are more frequent at higher work rates. Audible warning (click) is played on dropped artifact.

Notifications: A notification update is sent whenever ⍺1 is recalculated. Notification title provides ⍺1 and artifacts dropped (%). This provides a basic way to view output on a wearable (see photo above). Some Garmin devices show notification titles during activities (see photo above).

Logs

Log files are recorded to external storage and available for export via the Androd ShareSheet.

  • rr.log as per HRV Logger format
  • artifacts.log - timestamp for artifacts*.log is corresponds to the last processed sample of the window (watch this space) Output to "external" storage; may not work on Android versions later than 9-ish.

Replay

Enable Developer mode, Import a previously recorded RR.csv, then Replay and select the RR.csv file from your logs directory. FatMaxxer will replay the previous session (for review / screen shot). The graph will be slightly quantized for most plots except RRs. Replay is at up to 60x real time.

Known issues / limitations

  • Needless to say, I will not be held responsible for any app malfunction which causes you to overtrain!
  • GraphView plotter is quirky and could be replaced
  • Android may pause (kill) the app unpredictably. Enable the "Leave screen on" option, check on the app regularly, and avoid using other apps while in use.
  • Audio update period should not need to be customized; it should be detectable from metrics like ⍺1---it's an objective measure of effort, after all
  • UI cleanup to show battery, demote RMSSD, remove ugly status line
  • features.csv does not output SDNN

Acknowledgements and References

About

Android Project to find FatMax in real time with a Polar H10

License:Other

Languages

Language:Java 99.7%Language:Shell 0.3%