Mark Liversedge edited this page Sep 22, 2018 · 8 revisions


Where is ride data stored?

By default data will be stored in operating system specific directories, assuming you have not changed the location in preferences.

On Apple OS X the data is stored in Library/GoldenCheetah/name in your home directory. On Linux the data is stored in .goldencheetah/name in your home directory. On Microsoft Windows application data folders seemingly change with each release, but typically will be found in AppData within your user home directory (which my be hidden by default).

To assist the about dialog lists the folder where ride data is stored.

Where are settings located?

As of v3.3 most of the Settings are not stored system specific any more, but in .INI files in the Athlete Root (for general Settings) and Athlete /config (for Athlete specific settings)

Only OS/System specific settings - like Fonts, Colors, Window Position, Import Paths are still stored on each PC separately - but they are not stored in PLIST (OSX) or Registry (Windows) any more, but also in an .INI file which is located like described here: http://doc.qt.io/qt-5.9/qsettings.html#platform-specific-notes, see section "if the file format is IniFormat, the following files are used on Unix, OS X, and iOS:...", Organization is "goldencheetah.org" and application is "GoldenCheetah".

How do I restore an athlete's backed up ride data?

The folder/directory where the auto backed up files are found is in "Auto Backup Folder" which is in Menu "Tools -> Options... -> Athlete -> Backup". An example file is GC_3933_John_Smith_2017_09_12_15_57_07.zip, a compressed .zip file. To restore you'll unzip/extract this file into an athlete's directory, see Where is ride data stored.

  1. Locate or create the AthletesDirectory, if it already exists you may want to delete the current files. In linux you could do the following in a default configuration:
$ mkdir -p ~/.goldencheetah/John_Smith
  1. Get the .zip file such as, GC_3933_John_Smith_2017_09_12_15_57_07.zip, from the original computer to the new computer via email, dropbox, usbdrive, etc. and save it in a directory such as ~/Downloads

  2. unzip/extract it into the directory previously created. On Linux you'll need to change the permissions so the files are accessible using chmod:

$ cd ~/.goldencheetah/John_Smith
$ unzip ~/Downloads/GC_3933_John_Smith_2017_09_12_15_57_07.zip
$ sudo chmod -R 0755 .
  1. Now start GoldenCheetah.
$ GoldenCheetah
  1. Select the "new" athlete just added if it's not the current athlete in Menu "Athlete -> Open Window -> John_Smith".

  2. Navigate to menu "Tools -> Options... -> Athlete -> Backup" and change "Auto Backup Folder" to an appropriate value either by typing in the text entry box or using the "Browse" button on the right.

How do I split, merge or join files?

You can split a file by time using the activity->split ride menu item (or toolbar button).

To join two rides together (making one longer ride from two rides) you can copy rows in the activity editor and paste special in the ride editor (right click) and then select append mode.

If you wish to merge rides, in v3.1 there is a new Activity->Merge wizard that will walk you through merging ride files and also provide the ability to synchronise timestamps.

How can I find 'spikes' or specific values in activity data?

The activity editor has a function to find data on its toolbar. You can specify a range or upper or lower limit and find values less than, greater than or between a range of values.

Additionally, the editor will scan the file looking for anomalies -- where the data appears to be out of normal ranges. These are shown with a wiggly red line in the editor and can also be listed by clicking on the anomalies icon on the editor toolbar.

If the anomalies icon is not enabled on the toolbar then there are no anomalies in the currently selected ride.

How can I fix 'spikes' or 'anomalies' in activity data?

You can either manually edit the values in the activity editor (there is full undo and redo in the editor). Or you can use the fix tools that are listed under the tool menu option (fix power spikes, fix gaps in recording, fix gps errors, fix torque.

Each of the fix tools opens a dialog that displays texts to explain what the fix tool does.

How can I add/remove a field to edit on the details screen?

The fields (metadata) that is editable can be configured in the preferences pane under the data fields tab. Where no screen is specified (its left blank) it will not be made available.

GoldenCheetah ships with a number of fields defined in the config but with no screen set. If you wish to use them simply set the screen tab to the tab you would like it to be shown on. To remove a field set the field tab to blank.

What are 'special fields' ?

There are a number of fields that when maintained in the details screen will be used elsewhere in the code to calculate metrics or for other purposes.

Some examples include;

Weight - used in W/KG calculations, Sport and Workout code are used when exporting to other file formats, Identifier is used to assign a UUID to the activity when it is uploaded to online services and so on.

There is a full list of special fields and their meaning in the Golden Cheetah user guide appendices.

How do I find/add/sort/delete/edit intervals ?

The context menu (on the right hand side of the splitter handle) for the interval sidebar in Analysis view contains a number of options for working with intervals.

Additionally, you can click and drag on the performance (aka ride) plot to visually define an interval.

How can I export to a specific file format?

Activity->Export allows you to export the activity to csv, fitlog, gc (xml), json, Training Peaks PWX or Garmin TCX format.

Can I use GC to convert data from one format to another on the command line?

No. It is something we may add in v3.2

Can I delete an athlete and all his/her data?

Yes. From the choose cyclist dialog at startup you can delete an athlete and all their data. Beware, this cannot be undone.

How do I share data using Google Drive?

Assuming the Athlete wants to protect her data and invite the coach to look at it, either side could create the directory.

Athlete Side

  • Create a directory in Google Drive.
  • Share this with your coach, via Google Drive.
  • Authenticate GC with Google using “Drive” credentials in Preferences
  • Select the folder in Preferences
  • Synchronize the data via the GoldenCheetah share menu item for Google Drive

Coach Side

  • Receive the share invite from your athlete
  • In drive.google.com, go to “Shared with me” and right click on the folder, select “Add to my drive”.
  • Authenticate GC with Google using “Drive” credentials in Preferences
  • Select the folder you added to your drive as the Athlete directory
  • Synchronize the data via the GoldenCheetah share menu item for Google Drive

The athlete can now control exactly what data the coach has access to and revoke the access at any point by simply removing access to one or more email address on his end in Google Drive. The athlete can also share the data with more coaches/friends should he want to.

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.