UG_Preferences_Measures - GoldenCheetah/GoldenCheetah GitHub Wiki

Preferences: Measures (New in v3.6)

Select: Menu Bar Tools -> Options...to get to the Options Popup on Windows or Linux. On macOS GoldenCheetah -> Preferences... .

GoldenCheetah v3.6 allows to define new time-dependent measures groups, and to add additional fields to builtin ones.

This feature is a generalization of GoldenCheetah v3.5 Body/Hrv Measures, so the mechanisms to:

  • import the new measures data from CSV
  • add, delete and change measures data
  • access measures data from formulas charts and APIs

Measures Config

General

  • + Add Measures
  • - Delete Measures
  • Edit - Updating an existing Measures
  • Each Group is limited to 16 Fields.

After creating a new Measure, saving it and restarting GoldenCheetah, the Measure group can be accessed at: Menu Bar ->Athlete-> Settings...->Measures There you can manage the measurement data. Enter new measurement data manually.

A manually import via Menu Bar->Share->Get Measures...-> "Measure Group Name" is also possible. See the CSV structure below.

Measures Groups

  • Symbol - used in formulas. Use the underscore _ instead of a space.
  • Name - are the translatable versions to be displayed in the UI.

Measures Fields

  • Symbol - used in formulas. Use the underscore _ instead of a space.
  • Name - are the translatable versions to be displayed in the UI.
  • Metric Units - Imperial Units - metric and imperial settings, can be used together with the corresponding conversion factor to obtain the imperial units valued from the metric value.
  • Units Factor - Enter the conversion factor. The conversion factor is from metric to imperial.
  • CSV headers - are used to identify the corresponding column when importing measures from CSV files, more than one can be entered, separated by commas. Use the underscore _ instead of a space.

CSV structure

The CSV file can be created as a text file or from a spreadsheet.

  • Use for Date and time in ISO 8601 format
    • Year-Month-DayTHours:Minutes:SecondsZ

For decimal numbers, use a period. e.g. 75.5.

  • A table can be created using a spreadsheet program (e.g. libreoffice calc). The file must be saved as .csv .
  • Here is an example of what a table might look like.
  • The first row is the name of the CSV headers.
  • The following rows are the measured values.
date Calories Carbs Protein Fats comment
2023-01-01T12:00:10Z 1200 40 30 5 Test Value
2023-02-10T07:50:00Z 2000 80 35 15 Here the comment text contain commas itself, so it needs quotes
2023-02-19T09:07:32Z 5400 130 60 25

If you can write Python scripts CSV files can be generated from date obtained via web services using readily available Python modules with user/password authentication, s.t. https://pypi.org/project/garminconnect/ or https://pypi.org/project/myfitnesspal/, you can find an example in https://github.com/kaverna/Garmin_to_GoldenCheetah

access measures data from formulas charts and APIs

    measure("group",date, "field") access a measurement on the date of a specific activity
    measures("group", "field" | "date") get a vector of measures for the current date selection
  • group - is the Symbol from Measures Groups
  • date - Returns the date when the measurement was taken
  • field - is the Symbol from Measures Fields

Charts in CloudDB

Menu Bar ->View->Download Chart.

The new User Charts in v3.6 are specially useful to plot custom daily measures, an example available in CloudDB shows macronutrient distribution as % of energy intake and relative to body weight (g/kg) using Nutrition and Body measures groups.

More about Measures

Search for more Measures entries in the Wiki: https://github.com/GoldenCheetah/GoldenCheetah/search?q=Measures&type=wikis

BACK: Preferences: Overview