Name: Heart Rate Zones Chart
Rating: 4 (1 reviews)
Author: RonnyWinkler

== Overview ==
This datafield provides a graph showing the percentage of time spent in the defined HR-zones. The bars grow depending on the time you spend in the HR-zone during the activity.
It is designed for use in every screen-layout and field size, keeping the default textsize and style, but showing more information about heart rate in a single field.
User configuration is supported for definition of user-depending HR-zones and options.
For using this field you need a HR sensor (built in or extern HR strap) connected to your watch.

== How to use ==
The datafield is used inside an activity (not as watchface or widget). You have to insert it on a data page of your activity. Go to device settings, choose the activity, select a data page, select a field for changing, select the field type (ConnectIQ for datafields from app store), select this datafield. Then it's assigned to a data page and you will see it after starting the activity.

== User-Configuration ==
The datafield uses the possibility of defining user-settings using Garmin Connect Mobile or Garmin Express. For details on how to change settings please check this thread:
https://apps.garmin.com/settingsHelp

The following options are supported:
-	Use HR-Zones from user profile or definition of independent HR-Zones only for this datafield.
-	Show HR-value as percent
-	Show zone number with decimal value as text behind the zone value 
-	Count only inside zones. If set: only HR values between zone 1 and 5 are added to chart. If not set: HR values smaller than zone 1 are added to zone 1 column, HR values greater than zone 5 are added to zone 5
-	Show HR-value colored in zone color
-	Select a chart design (several variations from transparent to solid)
-	Select dynamic textsize depending on field size or one of several fixed sizes
-	The Datafield supports calculating HR-% based on HR.Max, HR-Rest or LTHR
	HR-Max: HR-% is calculated for the range 0 to HR-Max (HR-Max is read from App-Settings/Zones or from user profile)
	HR-Rest: HR% is calculated for the range HR-Rest to HR-Max (e.g. 50=0%...180=100% if you set 50 as HR-Rest in App settings)
	LTHR: HR% is calculated for the range 0 to LTHR (0=0%, 160=100%, 180=112% if you set 160 as LTHR in App settings)

== Questions? ==
Please use the „contact developer“ form on the right.
...or write a comment in the forum: https://forums.garmin.com/developer/connect-iq/f/showcase/2187/datafield-heart-rate-zones-chart

Heart Rate Zones Chart

== App-Entwicklung unterstützen? ==
Dir gefällt dieses Datenfeld? 
Dann unterstütze die App-Entwicklung durch eine kleine Spende über PayPal (an Freunde). 
https://paypal.me/winklerronny
Bitte wähle "an Freunde senden", um Gebühren zu vermeiden. Vielen Dank!

== Übersicht ==

Dieses Datenfeld zeigt die Herzfequenz sowie ein Diagramm mit der Verteilung der je Herzfequenz-Zone verbrachten Zeit.
Die Höhe der Balken des Diagramms zeigt dabei den prozentualen Zeitanteil an, den man in der jeweiligen Zone trainiert hat.
Das Feld kann in jeder Bildschirmaufteilung und Feldgröße verwendet werden.

Für die Verwendung des Datenfeldes ist ein mit der Uhr verbundener HR-Sensor notwendig.

== Verwendung ==

Das Datenfeld wird innerhalb einer Aktivität verwendet (Nicht als Widget oder Watchface/Ziffernblatt). Dazu muss das Datenfeld einer Datenseite einer Aktivität zugeordnet werden:
- Einstellungsmenü der Uhr aufrufen
-"Apps" wählen
-Aktivität wählen, z.B. Laufen
-"Trainingsseiten" auswählen
-anzupassende Seite wählen
-das zu ersetzende Feld wählen
-Feld-Typ "ConnectIQ-Feld" wählen
-aus der Liste das Feld wählen

== Einstellungen ==

Das Datenfeld unterstützt die Garmin-Benutzeroptionn. Wie man diese verwendet ist in diesem Beitrag beschrieben:
https://apps.garmin.com/settingsHelp

Die folgenden Einstellungen sind möglich:
•	Verwendung der HR-Zonen des Benutzerprofils oder Definition der HR-Zonen speziell für dieses Datenfeld
•	Die HR-Frequenz kann als Prozentwert der maximalen Herzfrequenz angegeben werden
•	Die HR-Zonen-Nummer kann hinter der Herzfrequenz als Zahl ausgegeben werden
•	Nur Werte innerhab der Zonen berücksichtigen: Aktiviert: Nur HR-Werte innerhakb der Zonen 1-5 werden im Diagramm berücksichtigt. Nicht aktiviert: Werte unterhalb Zone 1 werden zur Zone 1 gerechnet; Werte oberhalb Zone 5 werden zu Zone 5 gerechnet.
•	Der Text kann in der Farbe der HR-Zone angezeigt werden
•	Wahl eines Diagramm-Designs (transparent bis ausgefüllt)
•	Textgröße für größere Felder anpassbar (automatsiche Größe abh .von Feldgröße oder verschiedene feste Größen)
•	Das Datafield berechnet HR-% basierend auf HR.Max, HR-Rest oder LTHR
	HR-Max: HR-% wird berechnet für den Bereich 0 bis HR-Max (HR-Max wird aus den Zonen-Definitionen des Benutzerprofil oder der App-Einstellungen gelesen)
	HR-Rest: HR% wird berechnet für den Bereich HR-Rest (Ruhepuls) bis HR-Max (50=0%...180=100% wenn 50 als HR-Rest in den App-Einstellungen angegeben ist)
	LTHR: HR% wird berechnet für den Bereich 0 bis LTHR (0=0%, 160=100%, 180=112% wenn 160 als LTHR in den App-Einstellungen angegeben ist)

== Fragen? ==
Bitte verwende den Link "Mit Entwickler Kontakt aufnehmen" auf der rechten Seite.
...oder schreibe einen Kommentar im Forum: https://forums.garmin.com/developer/connect-iq/f/showcase/2187/datafield-heart-rate-zones-chart