From d5b19959cb8fa397fc3adbc8c882962052994141 Mon Sep 17 00:00:00 2001 From: Mark Liversedge Date: Sun, 24 Mar 2013 13:07:08 +0000 Subject: [PATCH] Documentation: Makefile adjusted .. to add a clean rule .. to remove need for html version --- doc/user/GC3-FAQ.html | 2298 ------------------------------------- doc/user/GC3-FAQ.info | 21 +- doc/user/GC3-FAQ.pdf | Bin 148617 -> 148626 bytes doc/user/GC3-Manual.pdf | Bin 365519 -> 365529 bytes doc/user/GC3-Release.html | 748 ------------ doc/user/GC3-Release.pdf | Bin 86758 -> 86767 bytes doc/user/Makefile | 15 +- 7 files changed, 21 insertions(+), 3061 deletions(-) delete mode 100644 doc/user/GC3-FAQ.html delete mode 100644 doc/user/GC3-Release.html diff --git a/doc/user/GC3-FAQ.html b/doc/user/GC3-FAQ.html deleted file mode 100644 index 279da75ed..000000000 --- a/doc/user/GC3-FAQ.html +++ /dev/null @@ -1,2298 +0,0 @@ - - - - - -Golden Cheetah FAQ - - - - - - - - - - - - - - - - - - - - -
[Top][Contents][Index][ ? ]
- -

title

- -

This manual is for GoldenCheetah, version 3.0. -

- - - - - - - - - -
1. MOST COMMON QUESTIONS OF ALL   Most common questions -
2. GENERAL   General Questions -
4. DATA   Working with Data -
3. METRICS   Working with Metrics -
5. UPLOADING AND DOWNLOADING   Uploading and Downloading Data -
6. SEASONS AND EVENTS   Seasons and Events -
7. CHARTS   Configuring and Using Charts -
Index  
- -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
- -

1. MOST COMMON QUESTIONS OF ALL

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.1 How do I override / manually enter TSS for a ride?

- - -

The details chart on the analysis view allows you to override metrics on the metrics tab. -By default the most common metrics are listed, including average HR, distance and so on. -From v3.0 the default setup will also include TSS as a metric you can override here. -

-

If the metric is not there you will need to configure GoldenCheetah to allow it to be shown. -This is simple to do and described in 3.9 below. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.2 How do I add or remove a chart?

- - - -

To add a new chart to the view you can select from the + menu on the right hand side of -the scope bar (the scope bar is underneath the toolbar and lets you select from Home, -Analysis, Train etc). -

-

Depending upon which view you are on the charts available will differ. For example realtime -plots only appear on the Train view, whilst charts that work with individual rides will only -appear on the analysis view. -

-

To remove a chart, when you mouse over a chart (in tabbed or tiled mode) a small triangle -will appear in the top left of the chart. This is a menu drop down, if you click on it -you will see a ‘Close’ option. This is the option to remove (close) the chart. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.3 Can I enter my weight and track/plot it?

- - -

Weight can be maintained in 3 ways; -

-

i. Every athlete is setup with a weight value – this is the fallback value should no - other weight measure be available. It can be found under preferences and athlete. -

-

ii. The ’Weight’ field can be maintained in the details screen. This is found on the - ’Workout’ tab in the details screen by default. Any entry here will be used for this ride - ONLY. -

-

iii. You can download weight from a withings scale. This is performed manually via the - menu option Tools->Get Withings Data. This is then used to update the local measures - database. -

-

When calculating W/KG the Activity value is used if present, if not we then fall back to -the last Withing measure that was collected, and if that is not available we then fall -back to the default value for the athlete. -

-

The weight from withings and weight from the activity can both be plotted separately in -the LTM plots. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.4 How do I plot x sec power best?

- - -

As of v3.0 it is still not possible to plot custom durations for power bests. We are -looking to add this in version 3.1, but for now you can only plot 1s, 5s, 10s, 15s, 20s, -30s, 1min, 2min, 5min, 10min, 20min, 30min and 60min bests. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.5 I can’t find Aerolab / Performance Manager?

- - - -

By default we do not add these charts to the layout. Aerolab can be added to the Analysis -view via the ’+’ menu found to the right hand side of the GoldenCheetah scope bar. -

-

Similarly, the Performance manager can be added to the Home layout via the ’+’ menu. We -may deprecate this chart in the near future since the LTM charts can be used to plot a PMC -and we expect to implement an interactive PMC for planning in v3.1. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.6 What happened to weekly summary?

- - -

It has been deprecated since the Diary view allows you to summarise by day, week and month -and add charts to the view that summarise for the selection. As the weekly summary was fixed -on specific charts and did not handle other selections (e.g. monthly) it has been deprecated -in view of the diary view. -

-

At present you can treat the Diary view as you would have the weekly summary – they offer -the same functionality. We expect the diary view to extend to planned workouts when we -implement planning functionality in v3.1. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.7 Where are all the chart settings?

- - -

All chart settings can be found under the drop down menu that appears in the top left hand -corner of a chart when you mouse over it. They will appear as a popup dialog box. -

-

Additionally, when you move the cursor towards the title of a chart in a view that is tabbed -(not tiled) then a small selection of the most important settings for the chart will appear -for convenience. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.8 Where is the preferences / options panel?

- - - -

On a Mac the configurations page can be found under ’GoldenCheetah -> Preferences’ on the -main menu. Whilst on all other platforms it is found via ’Tools -> Options’. -

-

We do this to match the general guidelines for the operating system. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.9 How do I change the colour of the rides on the calendar/list?

- - -

Activities are coloured according to keywords embedded in their details (metadata) you can -configure the field that is used and the values that are matched and the colours they are -shown in from the preferences pane via the ’Data Fields’ toolbar option then select Notes -Processing. The keywords and related words are scanned for to determine if the associated -colour should be used for this ride. -

-

They are processed in the order they are defined with the first match being returned. Take -care when using values such as ’TT’ and ’race’ since these can also be part of an English -word (e.g. ATTEMPT contains ’TT’ and graceful contains ’race’. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
- -

2. GENERAL

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

2.1 What is GoldenCheetah?

- -

GoldenCheetah is primarily a program for cyclists that own a power meter. It allows them to -record, track and review their performance against recorded data. It also allows you to ride -your turbo and collect data as you ride. -

-

If you do not have a power meter then some of the functionality will not be of use to you -as a cyclist. But you can still record and track progress. We support HR based TRIMP metrics -for a HR based PMC for example. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

2.2 What is a good book or resource on training with power?

- -

Unquestionably the bible for working with a power meter is Training and Racing with a Power -Meter by Hunter Allan and Andy Coggan. Make sure you look at the 2nd edition since it is -revised quite dramatically. Whilst it is heavily biased towards WKO+ as a software package -most of the functions of note are also available in GoldenCheetah. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

2.3 Where can I download the installer for GoldenCheetah ?

- - - -

Stable releases are available from www.goldencheetah.org whilst the latest and greatest -code build is available from goldencheetah.stand2surf.net. Development builds are for the -brave, since they may contain bugs. In reality the development builds are a changing feast -and often contain latest fixes too. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

2.4 Where can I get the source code?

- - - - -

The GoldenCheetah source code is hosted on github here: -www.github.com/GoldenCheetah/GoldenCheetah. It can be cloned locally using -’git clone git://github.com/GoldenCheetah/GoldenCheetah.git’. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

2.5 I am a triathlete is GoldenCheetah appropriate for me?

- - -

GoldenCheetah is not a multi-sport program. For tracking cycling performance it is a good -choice. But if you are looking for running and swimming metrics and tracking then these -features are not available at present. It is an excellent choice for analysing cycling -aspects of triathlon, or working on the trainer. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

2.6 Is there a mailing list?

- - -

The mailing list for GoldenCheetah users is maintained via Google Groups at -http://groups.google.com/forum/?fromgroups=#forum/golden-cheetah-uers the first post you -make is moderated and may take a while to appear. Once your first post is made you can -make future posts without moderation. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

2.7 How do I report a bug or request a new feature?

- - - - -

We use Github issues to record bugs and feature requests. You will need to create an -account on github and then post a new request or bug at -www.github.com/GoldenCheetah/GoldenCheetah/issues -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

2.8 How can I contribute?

- - -

Patches are most welcome via the mailing list or a pull request in github. Of equal -importance is the timely reporting of bugs and help in testing fixes. We also desperately -need volunteers to translate into non-English languages and help with writing documentation -including the maintenance of this FAQ. -

-

If you want to help, post a note on the golden-cheetah-users mailing list. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

2.9 Can I donate to the project?

- - -

We are an open source project. Our software is developed by a community. We do not have -any facility to collect funding or spend it! We would rather you spread the word if you -think our software is good, and maybe help out with documentation, tutorials or -translations if you can. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
- -

3. METRICS

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

3.1 What is the difference between xPower, NP and Daniels EqP?

- - - - - -

They all serve the same purpose – to express the variable power you have generated over -a given period of time as a single value. This is so you can quantify the intensity of -the ride and therefore the training stress of the ride. -

-

In practice, NP and xPower are largely the same, whilst Daniels EqP place much higher -emphasise on upper intensity work. For more info on xPower see Dr Skiba’s paper on BikeScore -http://www.physfarm.com/bikescore.pdf -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

3.2 What is the difference between CP and FTP?

- - - -

CP is a shorthand for CP60 in GoldenCheetah, and is computed using the Scherer/Monod -protocol using 3 and 20 minutes. Functional Threshold Power (FTP) is an actual measure of -the power an athlete sustains for 60 minutes. -

-

Since it is very difficult for an athlete to maintain the desired intensity FTP ’reality’ -tends to result in a number that is much lower than CP ’theory’. Often users will -consider the two as the same. -

-

In GC we compute TSS and BikeScore using your ’CP’ value. If you set it to your FTP value -TSS will be accurate, BikeScore is likely to be lower. And if you set it to your CP value -BikeScore will be accurate, but TSS will be overstated. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

3.3 Why does my CP chart show higher watts for a longer duration?

- - -

A higher power average for a longer time is possible if an effort has been "book ended". -If, for example, you did a massive 30 second effort, followed by freewheeling for 29:30 -then another massive 30 second effort, then your best average for a continuous 30 minutes -would in fact be lower that your best average for a continuous 30minutes and 30 seconds. -(Thanks for Jon Hill from the Golden Cheetah Users mailing list for this example). -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

3.4 Can I set a different CP/FTP for different reasons e.g. CP/FTP on a trainer?

- - - - -

We allow you to override the CP value for a specific ride by setting the "CP" field to -the value you wish to use for the ride in question. We do not have a concept of ’separate’ -Cps for different purposes – you will need to specify the CP when the data is imported -into GC. But this allows you to make manual adjustments. -

-

We provide this functionality at user request – we do not endorse the concept of multiple -CP values. But we do recognise the ongoing debate regarding physiological stress from -working on a trainer vs on the road. -

- -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

3.5 How do I seed the CTL for my PMC?

- - - - -

You can seed the starting CTL (we call it LTS, for long term stress) when you define a -season. That way it is re-usable in a number of places. To do this you edit the season -(date range) in the Home View and can set the Starting LTS. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

3.6 Why is elevation different in GoldenCheetah to my other training software / website?

- - -

Different programs will use different hysteresis values to smooth the small changes in -altitude. In GC we use a hysteresis value of 3m. -

-

If this is of great concern you can adjust the hysteresis value in preferences under the -general tab. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

3.7 Why is a metric e.g. TSS or average power different in GoldenCheetah to Garmin Connect?

- - - - -

The algorithms for calculating TSS, AP etc are static. They are implemented exactly the -same way in GoldenCheetah, Garmin Connect, TrainingPeaks etc. The algorithms are extremely -simple and not prone to difficulty in implementation. -

-

However, how each application treats pauses and stops or loss of data accounts for most -differences. In GoldenCheetah we always calculate AP,TSS etc including stop time. Other -applications choose to ignore or smooth segments of short duration. -

-

In addition, if there are anomalies in your data, with large gaps or even time going -backwards, this will drastically affect GoldenCheetah’s calculations. -

-

We NEVER attempt to interpret data anomalies – if the results are not as you would expect -you will need to correct the data. We do not ’silently’ fix the data for you. There is no -secret sauce in GoldenCheetah, we are open and transparent with your data. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

3.8 How do I set the metrics shown for intervals in the various summaries?

- -

In the GoldenCheetah preference pane under the Metrics tab you can choose the metrics -that will be shown in the ride summary charts and the metrics that will be shown in the -interval summary in the analysis sidebar. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

3.9 How do I add a metric to the details screen (so I can override it) ?

- - -

If the metric you want (e.g. TSS) is not shown then you will need to add it via the -GoldenCheetah preferences pane. On Mac this is from the menu option -GoldenCheetah->Preferences whilst on Windows and Linux it is under Tools->Options. -

-

You will need to select ’Data Fields’ option from preferences toolbar and then the -’fields’ tab. You will see a list of fields that are associated with a particular screen -tab. If you scroll down you should find entries for the ’Metrics’ screen tab, you can -insert a new entry here with the ’+’ button. You should make sure the new entry is -called exactly the same thing as the metric in question. -

-

For ’TSS’ this is relatively straight forward. For others, e.g. ’Average Heart Rate’ you -must make sure that the name includes spaces etc. Once your metric has been added to the -configuration you should save that and return to the details screen where you can now -maintain it. -

-

If you are creating a manual entry then there is no ’details’ tab in the dialog. Once -you have created the entry (and again in this case TSS can be entered in the dialog) -you should go to the details tab to maintain any other specific fields. The manual entry -dialog is designed to be simple and accept only the most common of entries. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

3.10 Can you calculate gradient, virtual power or other derived series from the ride data?

- -

Not in 3.0. We may introduce derived data series in the future. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

3.11 Can I export metrics or access the metric database GC uses?

- -

The metrics are stored within a Sqlite 3 Database called ’metricDBv3’ that can be found -in the athlete directory. You can use any Sqlite 3 tools to query and work with the db. -

-

Alternatively you can export the db in its entirety using the Activity->Export Metrics -as CSV to export to a format you can use in a spreadsheet program. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
- -

4. DATA

- - - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

4.1 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, that is much harder and would need to be performed outside -of GC or by cutting and pasting columns in the activity editor. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

4.2 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. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

4.3 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. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

4.4 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. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

4.5 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. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

4.6 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. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

4.7 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. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

4.8 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.1 -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

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

- -

No. It must be done manually by removing the athlete directory via the operating -system. Please ensure you do this when GoldenCheetah is not running. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
- -

5. UPLOADING AND DOWNLOADING

- - - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

5.1 Why does upload to TrainingPeaks keep failing?

- - - -

The Sport field in TrainingPeaks must have very specific values, although this is not -documented in the XML Schema. We recommend using a sport of "Bike" if you plan on -uploading rides to training peaks. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

5.2 Why does download from TrainingPeaks say I need a premium account?

- - - -

Training Peaks only allow paid up members to get access to their data. If you are -using a free service they do not let you retrieve your data. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

5.3 Why is data uploaded to Strava all wrong?

- - -

In general Strava will only use GPS data. If your ride does not contain GPS data then -Strava is not likely to play nice. In addition many of the other data series will be -ignored. This is related to Strava data processing in V2.0 of their API. -

-

We always upload as TCX since the JSON flavour of their API appears to have less -functionality. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

5.4 What settings do I need to get GoldenCheetah to upload to my Google Calendar?

- - -

The upload to Google Calendar uses their CalDAV API, and as such needs to specify a -collection. This means when entering the details in the passwords pane of preferences -you should use the following for the caldav url: -

-

https://www.google.com/calendar/dav/xxxx@gmail.com/events/ -

-

Where xxxx is your username. The username will need to be repeated in the username -field and obviously set the password too. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
- -

6. SEASONS AND EVENTS

- - - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

6.1 Why are there different types of seasons?

- - - - -

This is to help with planning functions. As of v3 there is no real distinction made. -Adhoc seasons are expected to be used solely as date ranges and have no associated plan. -Whilst other season types may contain plans. This is only relevant for planning -functions that are not available yet. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

6.2 What is event used for?

- - -

It is only used to annotate a LTM chart – so you can show an ’event’ that happened at -a particular date. There are no rules about what constitutes and event. It could be a -race, a training camp or just a day that was particularly meaningful e.g. illness, crash. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
- -

7. CHARTS

- - - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

7.1 I want to plot month -1,-2 and -3 how do I do that?

- - - -

Assuming the chart allows you to specify a date range you can select ’This’ ’month’ -and select prior ’3’ to specify a month 3 years prior, similarly ’This’ ’month’ and -prior ’2’ is a month 2 months ago, whilst ’This’ ’month’ and prior ’1’ is last month. -

-

’This’ ’month’ prior and 0 is just this month. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

7.2 How does the mean max chart calculate CP when showing power?

- - - -

The CP algorithm searches your best power for two durations; for anaerobic efforts it -looks between 15s and 1min, for aerobic it looks for best efforts between 10mins and -an hour. -

-

Once it has found these two best values it will curve fit the two to enable the -60min value to be extracted. Bear in mind this is a theoretical number and as described -above is applicable to the BikeScore algorithm. The value for FTP that the TSS algorithm -requires is simply the highest value for 60mins for the time period, assuming you have -performed a 60minute test recently. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

7.3 How should I use Aerolab?

- - - - -

The following is a brief piece of advice from Robert Chung, from a discussion on the -Golden Cheetah Users mailing list: -

-

Ideally, you’ll want calm conditions (both in terms of wind and traffic) but here’s a - quickie test you can do just to get a handle on what to do. Try to find a loop without - stop signs, or an out-and-back with maybe a little dip or something in the middle. Make - sure you won’t get hit by a car and have good sight lines. I just go around my block a - few times. Do a loop in the drops, then another loop faster, then a loop slower; then - repeat with your hands on the hoods. -

-

Weigh yourself and the bike and ballpark the air density. -

-

See whether you can come close to modeling the "true" elevation profile by sliding the - CdA slider around. Even with this informal test, as long as the wind isn’t blowing too - hard, you ought to be able to see a difference between the loops where you were in the - drops and the loops where you on the hoods, and to spot little bumps and dips in the road. -

-

There is also an overview of Virtual Elevation to measure aerodynamics in this -YouTube video from the power seminar at Interbike 2011 given by Jim Meyer the founder -of Quarq: -

-

http://www.youtube.com/watch?v=b8tJnFE_BFg&feature=youtu.be&t=27m58s -

-

Finally, Robert Chung’s original paper is included in the docs section of the GoldenCheetah -repository, you can it up here (click on ’View Raw’ to download): -

-

https://github.com/GoldenCheetah/GoldenCheetah/blob/master/doc/contrib/ChungVE.pdf -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

7.4 My map doesn’t show?

- - -

This is most likely because you have a proxy that requires authentication or session -details. We do not have sophisticated support for internet proxy servers. We will -re-use the operating system settings where they are configured. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

7.5 What is the treemap plot used for?

- - -

Typically it is used to visualise where you spend your time or where you get best -results. It is not particularly useful if you do not maintain details for each ride -e.g. workout code, sport et al. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

7.6 Can I change the colors in plot x ?

- - -

With the exception of the Long Term Metric plots the colours on the charts are -configured in the GoldenCheetah preferences pane. -

-

We want to use the same colours to plot each data series across the charts, so you -can change them globally. -

-

The only colours you cannot change are the colours assigned to intervals when plotting -them on scatterplot or PfPv. These colours are assigned according to their sequence. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

7.7 How do you zoom in on a chart?

- - -

You can zoom in on the distribution, scatterplot and PfPv charts by selecting the zoom -area with the left click of the mouse. -

-

On the performance (ride) plot you can zoom with the span slider at the bottom of the -chart (if you select the full plot in the chart settings). -

-

There are no other zoom options for the other charts. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

7.8 I zoomed in but can’t zoom out?

- - - -

Right click will zoom back out to the previous zoom level (in the case of zooming -multiple times). If you select another activity the chart will return to fully -zoomed out. -

- - -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

7.9 GoldenCheetah is saying there is no data for a chart, but I’m sure there is?

- -

You should check in the editor if the data series is present. if the activity is a -manual activity entry it will contain no data. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
- -

Index

- -
Jump to:   A -   -B -   -C -   -D -   -E -   -F -   -G -   -I -   -J -   -L -   -M -   -N -   -O -   -P -   -R -   -S -   -T -   -U -   -V -   -W -   -X -   -Z -   -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Index Entry Section
A
add1.2 How do I add or remove a chart?
adhoc6.1 Why are there different types of seasons?
Aerolab1.5 I can’t find Aerolab / Performance Manager?
Aerolab7.3 How should I use Aerolab?
algorithm7.2 How does the mean max chart calculate CP when showing power?
anomalies4.2 How can I find ’spikes’ or specific values in activity data?
anomalies4.3 How can I fix ’spikes’ or ’anomalies’ in activity data?
AP3.7 Why is a metric e.g. TSS or average power different in GoldenCheetah to Garmin Connect?
B
best1.4 How do I plot x sec power best?
bug2.7 How do I report a bug or request a new feature?
C
Chung7.3 How should I use Aerolab?
clone2.4 Where can I get the source code?
colour1.9 How do I change the colour of the rides on the calendar/list?
colour7.6 Can I change the colors in plot x ?
contribute2.8 How can I contribute?
CP3.2 What is the difference between CP and FTP?
CP3.3 Why does my CP chart show higher watts for a longer duration?
CP3.4 Can I set a different CP/FTP for different reasons e.g. CP/FTP on a trainer?
CP7.2 How does the mean max chart calculate CP when showing power?
CSV4.7 How can I export to a specific file format?
CTL3.5 How do I seed the CTL for my PMC?
cycle6.1 Why are there different types of seasons?
D
Daniels3.1 What is the difference between xPower, NP and Daniels EqP?
donate2.9 Can I donate to the project?
download2.3 Where can I download the installer for GoldenCheetah ?
download5.2 Why does download from TrainingPeaks say I need a premium account?
E
elevation3.6 Why is elevation different in GoldenCheetah to my other training software / website?
EqP3.1 What is the difference between xPower, NP and Daniels EqP?
event6.2 What is event used for?
F
feature2.7 How do I report a bug or request a new feature?
FITLOG4.7 How can I export to a specific file format?
FTP3.2 What is the difference between CP and FTP?
FTP3.4 Can I set a different CP/FTP for different reasons e.g. CP/FTP on a trainer?
G
Garmin Connect3.7 Why is a metric e.g. TSS or average power different in GoldenCheetah to Garmin Connect?
github2.4 Where can I get the source code?
Google5.4 What settings do I need to get GoldenCheetah to upload to my Google Calendar?
I
install2.3 Where can I download the installer for GoldenCheetah ?
J
join4.1 How do I split, merge or join files?
JSON4.7 How can I export to a specific file format?
L
LTS3.5 How do I seed the CTL for my PMC?
M
mail2.6 Is there a mailing list?
map7.4 My map doesn’t show?
merge4.1 How do I split, merge or join files?
month7.1 I want to plot month -1,-2 and -3 how do I do that?
N
NP3.1 What is the difference between xPower, NP and Daniels EqP?
O
options1.8 Where is the preferences / options panel?
override3.9 How do I add a metric to the details screen (so I can override it) ?
P
PMC1.5 I can’t find Aerolab / Performance Manager?
PMC3.5 How do I seed the CTL for my PMC?
preferences1.8 Where is the preferences / options panel?
prior7.1 I want to plot month -1,-2 and -3 how do I do that?
PWX4.7 How can I export to a specific file format?
R
remove1.2 How do I add or remove a chart?
report2.7 How do I report a bug or request a new feature?
S
season6.1 Why are there different types of seasons?
settings1.7 Where are all the chart settings?
source2.4 Where can I get the source code?
spikes4.2 How can I find ’spikes’ or specific values in activity data?
spikes4.3 How can I fix ’spikes’ or ’anomalies’ in activity data?
split4.1 How do I split, merge or join files?
Strava5.3 Why is data uploaded to Strava all wrong?
T
TCX4.7 How can I export to a specific file format?
trainer3.4 Can I set a different CP/FTP for different reasons e.g. CP/FTP on a trainer?
TrainingPeaks5.1 Why does upload to TrainingPeaks keep failing?
TrainingPeaks5.2 Why does download from TrainingPeaks say I need a premium account?
treemap7.5 What is the treemap plot used for?
triathlete2.5 I am a triathlete is GoldenCheetah appropriate for me?
TSS1.1 How do I override / manually enter TSS for a ride?
TSS3.7 Why is a metric e.g. TSS or average power different in GoldenCheetah to Garmin Connect?
U
unzoom7.8 I zoomed in but can’t zoom out?
upload5.1 Why does upload to TrainingPeaks keep failing?
V
VE7.3 How should I use Aerolab?
W
weekly summary1.6 What happened to weekly summary?
weight1.3 Can I enter my weight and track/plot it?
X
xPower3.1 What is the difference between xPower, NP and Daniels EqP?
Z
zoom7.7 How do you zoom in on a chart?
zoom7.8 I zoomed in but can’t zoom out?
-
Jump to:   A -   -B -   -C -   -D -   -E -   -F -   -G -   -I -   -J -   -L -   -M -   -N -   -O -   -P -   -R -   -S -   -T -   -U -   -V -   -W -   -X -   -Z -   -
- -
- - - - - - -
[Top][Contents][Index][ ? ]
-

Table of Contents

-
- - -
-
- - - - - - -
[Top][Contents][Index][ ? ]
-

About This Document

-

- This document was generated by Mark Liversedge on March 23, 2013 using texi2html 1.82. -

-

- The buttons in the navigation panels have the following meaning: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Button Name Go to From 1.2.3 go to
[ < ] BackPrevious section in reading order1.2.2
[ > ] ForwardNext section in reading order1.2.4
[ << ] FastBackBeginning of this chapter or previous chapter1
[ Up ] UpUp section1.2
[ >> ] FastForwardNext chapter2
[Top] TopCover (top) of document  
[Contents] ContentsTable of contents  
[Index] IndexIndex  
[ ? ] AboutAbout (help)  
- -

- where the Example assumes that the current position is at Subsubsection One-Two-Three of a document of the following structure: -

- - - -
-

- - This document was generated by Mark Liversedge on March 23, 2013 using texi2html 1.82. - -
- -

- - diff --git a/doc/user/GC3-FAQ.info b/doc/user/GC3-FAQ.info index 0bdbf8185..9126bdb71 100644 --- a/doc/user/GC3-FAQ.info +++ b/doc/user/GC3-FAQ.info @@ -695,11 +695,11 @@ Index * add: MOST COMMON QUESTIONS OF ALL. (line 21) * adhoc: SEASONS AND EVENTS. (line 9) -* Aerolab <1>: CHARTS. (line 33) -* Aerolab: MOST COMMON QUESTIONS OF ALL. +* Aerolab <1>: MOST COMMON QUESTIONS OF ALL. (line 71) +* Aerolab: CHARTS. (line 33) * algorithm: CHARTS. (line 19) -* anomalies: DATA. (line 23) +* anomalies: DATA. (line 38) * AP: METRICS. (line 81) * best: MOST COMMON QUESTIONS OF ALL. (line 63) @@ -710,22 +710,23 @@ Index * colour: MOST COMMON QUESTIONS OF ALL. (line 117) * contribute: GENERAL. (line 73) -* CP <1>: CHARTS. (line 19) -* CP: METRICS. (line 22) +* CP <1>: METRICS. (line 22) +* CP <2>: CHARTS. (line 19) +* CP: METRICS. (line 50) * CSV: DATA. (line 88) * CTL: METRICS. (line 64) * cycle: SEASONS AND EVENTS. (line 9) * Daniels: METRICS. (line 9) * donate: GENERAL. (line 85) -* download <1>: UPLOADING AND DOWNLOADING. +* download <1>: GENERAL. (line 31) +* download: UPLOADING AND DOWNLOADING. (line 16) -* download: GENERAL. (line 31) * elevation: METRICS. (line 72) * EqP: METRICS. (line 9) * event: SEASONS AND EVENTS. (line 18) * feature: GENERAL. (line 66) * FITLOG: DATA. (line 88) -* FTP: METRICS. (line 22) +* FTP: METRICS. (line 50) * Garmin Connect: METRICS. (line 81) * github: GENERAL. (line 40) * Google: UPLOADING AND DOWNLOADING. @@ -763,7 +764,7 @@ Index * TCX: DATA. (line 88) * trainer: METRICS. (line 50) * TrainingPeaks: UPLOADING AND DOWNLOADING. - (line 9) + (line 16) * treemap: CHARTS. (line 77) * triathlete: GENERAL. (line 47) * TSS <1>: METRICS. (line 81) @@ -778,7 +779,7 @@ Index * weight: MOST COMMON QUESTIONS OF ALL. (line 38) * xPower: METRICS. (line 9) -* zoom: CHARTS. (line 97) +* zoom: CHARTS. (line 109)  diff --git a/doc/user/GC3-FAQ.pdf b/doc/user/GC3-FAQ.pdf index 06d0d3018f91d30e9b1dc4a8cb577e1ceb3f2b92..7e327a979fb76f780c527ce33f608932bd97c29a 100644 GIT binary patch delta 1184 zcmV;R1Yi4!i3yU434nwFv;rzT1~f4F*08?x3)Y283RKyK|w)7LPkbJK`}-`LqRb#H$*ZyML9%8K{YloIW;goAUrZb zK|w=8Mn*(IF-Af|K`}HpL^3%=IYdQ4H8wCgH87VFKmtmCR1{^2cn1Vg5k)rUPS|wtt|>>BKbYuW)F8K$9koGd<5cd9vR9o$s8z_IlUa zDW&w;Qfg0@ir*?UE~g@;nt@6-|6WPUyDbg=q-Y;MYyyR)+Iy{yfW53Wf+o-mYM=#d z2CbkCYyowD&;T1cPJt;f z4Q9Y;Fbn3u888pdf^*?mS*ltW!6l?B zxCAaE8;Guet4RHK8C*jaMAyL$q)c-Y+(K$Yx4|90`;_P|xQE;zS^@Ww>qHO0Lv~uQ z_5}F|tRf#1QJESW&x-WOI&zgrFMW#SZ&4X|YK(0JWy}wW*mG<`^0gqrpuYJ&5vLK& zNVXP#7&uyx_lR(Dw6Z^~kxby{*n+%6gsGz)N#=pGqXT)12z$qNB*zqZJi3rKh%kC| zBRSK+?Lh_eH6kn@eMkxr_&z9YzDk7oV;7QY1sxF7JYOcF4Puy$>*LfnXo!#_E)mfX zF^a?tL8ruiq^yG5;{X!F1(uI-N8t-rl{ZS*B=xOnEm^YqCqR#o-5KIqwsm$ikXkB yl_Xe_U`c`{36`W#l0r!eW!;Jl=?}?@xfkgR(=7+WmtaH!APF)t3MC~)PeuxO!3ll< delta 1170 zcmV;D1a140i3y2`34nwFv;rzT1~W1;G&D1pFgyYm1~W1;G&D1pO*{f)21I3IX<=@+ zzdQmN14A%GH$^o;K`}HqG&nLtGC@T+Lq$O}GBrg;Ml?l4LP0(tJTOEzMKwV|F*GCh3v`3spa=AVKF|*az#!NI_JVz22n>S}pxqw=+HQlTmQTueKPe0W z{uXOsqmpi*5!65%(4NP@VQ>VD0|!UJ1ULpJ!EtZ`oCK%9X>bOd1yf)e%z$%X7R-V3 zU>;lm7r`ZP8H`%$e5*Vb*xwGY3-o`00k97!OBHXC1fNy1RJE>vt4LLF30y-q5M2j1 zkoxa3xQQ%?Zh_lKndT0-i`0hhf%|;-1DnZVDn4SAmkQ%5_J%mZgf2l6fv_KuxMjw$eXbRlmOVf5%ma;AaXg9_%G zL|8uhkQ5;BeNftbg9!7-9wgNYIv}WdzD7hF#4sDz$Ek175FtlgC88l>6p0yvPKiTE zSp~PpVI+nNEFa^@1tNSON0EPcGBAG}L*mn*1L8Om?*?rUCz1F$=!H1V)_PgP=s{P+ zStRBUS|g^BG(^xJaSln7gx2Pe`av(4=Y4~$(NUrAUPS6u+9aKl>AX-zi~K_aKp)o` z&=8q64ILN_k+oeNF%6Mv=TJRph^*XHJQ^a?_MuAC5LpKyTc{xz47$<8 z3Ysk~|0ju+z17mnn&fs+x3n=U*$Fxyq8`DM-f!uf zUnOP2>N@#$Nb&#}vGjk#cajHzHmO%(I6ngLnmfQ|J^^r;PXf&4Cjh?kQ$UtF12B?L z0X*b00Q>kXz&U;%$TSxKR`E+f^Yk*1L9PI7;Y$EV_;r98d>P;azXh;>-vLzL?*R($ z4*)gy6+pTDG0^CH3K)342AFmJ95Ciwmy#x&PF!%!QUUzBII&EdAD?U+X{}j|H-37#B;{1i=SclZ$&McU$`Xwf{X^>I)JZ{Cz8`eq^EJ?5=!IA_^QYcBG kB!#kW#q`@`#oT840?|hT2e6lEL;@fQF)|7zB}Gq03KrP=6aWAK diff --git a/doc/user/GC3-Manual.pdf b/doc/user/GC3-Manual.pdf index 8c6a39699412b31c62ae7c2ae82aa92cdb98a184..e39a1a33f9e912509310b82523de9935f69258b6 100644 GIT binary patch delta 1080 zcmV-81jqZ&rxw|#7J!5SgaU*Egaot&q>3aoF*7hWFfv*x3NKA>WJFF*08?w=jzZm;_HWMMOeGH9|HuLp3!) zHa12?Fhxc+HAX~5FhMdgIYcx*AUrfhL_$P0LN+x+H8nvtHbz7+MMgC>Mnpw0K{7Ep zL^M8K3NK7$ZfA68AUKy%Ed(onC6q}|6j2m~>vq4Q7?eg)0g)L|L7y6;Tmz zLO|B068`{OheYF6a}yW3(1m}&XiVI?G5#0_?C;o%FZaCas(SCBy%f&HKw6hI9)01kp$a0na*M?f8@2MypTXavVV6KDo4pcS-%cF+Mj!Ew+9 zxkoCG@lg;JHN zo%3LUvt4IReZB}5k?Q>=a2ct2Tmef+&FCsvMrv+!ExFF~R$0?PZ-5n~hD=WrUDe>% zz&cW9pxMc7qzrNg+~s*%lXDnFvVoMF?t@LF9JU3vk#gMwu!F>ZiC%JhS3Ui6V-1UX z4&;&8)&s!zu6LAEm4O6_QQXc3rI}k9LqVXYm<68jqq9| z8FaelhmqPTeRfTChl-(i12O;(=*-d^kulgt5)yAh(h?^rE=TMGn@BR_ZAiA8(n%*h z-htepB0?_vC;{Yu$dwcgg$Vg6mAg^EP^1QM?~v2uN-^O98OT}a`7McA)5Jn=QL-9T zTIk!8oC60z!9u#LHT;*>S{VHQ-lO1%h2bel`Kr;v=xfPV&}?Dso22a1W?}rJr25wd zIxS4R(V9$ubHc*pOUcuq+d}b+q{buD^a1%L1+vN@7_xBYv;I76;mMM!5esi0s~WZN z>8q+Si<@dxjaxkPPSu3P_Xku>f_boD@v{xqGIEsh0nIpN)(i+v#wj!6lJQZ^IxK#= yTI%?VN6|kVoW$-5Wo~41baG{3Z3<;>WN%_>3UhRqx|0P93N$b>3MC~)Peuyu%-6yI delta 1046 zcmV+x1nK+Prxwqr7J!5SgaU*Egaot&q>3anFgY_aGC5i)3NKA>WJFK|wb%K`=fbJVr4=I7K)@IYmY}L_{`2FgY+ZLo+ZpLpDW0K{ql%Fg{%hFHB`_ zXLM*FI5#jLm(dOcD3?o+1q^?fq!E-+CP5StDCS9U0L2MV5pZIXl?zip!L380ajUtB z3ti~KzhE>bZrvDvj0*O5?8TRRUUgNyckekBMNwhjiij-AeJCPcDkAw9<)SDlR%L6E zg{s$*267gaKa$LY7zE4z{uS}t&qbC_gY#TSK#Ar5Rz$4Lg0rlZfpULP0V=@(Pz4I0 z8XN>QpcWhghd~{v2MwSRG=XMt1hjxw&<5H;2RI5kK^Hg%y1_}%3r>L(pw#kvb2{&F zc0U777o}eZx4><1A8d0~M^$tBKtC7&DHsGpU>J;mQ7{I^!33BDQ(zkK%47!2f-^v! zJO|Y5dC+4aSbQ|yW14uoJO?m-|X`Ev@M|EvdFQ*Y+izI_i*ZeS2JEhOAsqRuS z6mLWZzyY0EdNVQxJ4iy}El678B*o>3O0b0_Gv0w@yD6P?(&L@T4Jsn!vX2r#j$BF6 zP>7KCAP)kj<)nYidy#jjh?@5yl_TQf1ITqMGUJ0teBcDfhmj3n6-k7A6sbcil7z{} zkto*FslYWbxx?S}OrL3%!3NF>9Jw=$n?T0_7I^_a)~+4JcShA8QT& zrL`7@{=c^g)L9srm6WfVEsVX9YzM6t#=lF-J{=Y&K1r&7-Jr|DG6aS#oc^Lek63uRsA|;0yC - - - -Golden Cheetah v3.0 Release Notes - - - - - - - - - - - - - - - - - - - - -
[Top][Contents][Index][ ? ]
- -

title

- -

These release notes are for GoldenCheetah, version 3.0. -

- - - -
1. Whats New   What’s new in V3.0 -
2. Contributors   List of Contributors to V3.0 -
- -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
- -

1. Whats New

- -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.1 500+ bug fixes and minor enhancements

- -

Over the last 3 years the performance and stability of GoldenCheetah -has been improved considerably. One of the major criticisms of the -software was it crashing. -

-

We have fixed 46 serious issues and over 400 bugs in over 1,500 different -commits. GoldenCheetah is now over 100,000 lines of code and is used by -1000s of users around the world, from Santiago to Singapore and Auckland -to Aberdeen. -

-

In addition to addressing stability issues we have also looked closely at -performance. Whilst the new metric functionality and database means that -a modern PC is recommended, the code is still efficient enough to run on -a netbook. -

-

We have introduced pre-computed metrics alongside a cache of ride bests across -all the main data series to ensure that analysis of long term data is -as quick and responsive as possible. We also introduced our own file format -using JSON as an open file format, with a custom parser. We can now read -a 1hr ride 20x faster using our native format than using an equivalent -and very popular XML format. -

-

In short, we’ve squashed the big bugs and made it run much faster. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.2 Redesigned UI and UX

- -

One of the most immediate changes you will notice with v3.0 are the -major changes to the user experience and user interface. From the -initial help screens for new users through to the redesigned preferences -pane for advanced users, it is slicker and more professional. -

-

We wanted an elegant and clean user interface that was intuitive to -use and revealed complexity when it was required. We think we’ve -come pretty close. -

-

There are 4 views available with specific and detailed sidebars for -peformancee tracking (home), short term tracking (diary) as well as -the well known analysis and training views from earlier releases. -

-

We now allow you to view charts tabbed and tiled, you can resize and -move charts around and customise them using roll-over controls. The -activity list is fully configurable and can be configured to show any -number of columns. We have overhauled and introduced friendly wizards -for adding devices and athletes through to manual activity entry. -

-

The UI is largely native on a Mac and the same UI and UX has been -replicated on Linux and Windows. We also support full screen including -Lion fullscreen support on a Mac. -

-

We have been through many, many iterations to get to this UX and it has -been widely tested and critiqued by a large community of GC users. -

-

We think this is the best looking and most intuitive version of GoldenCheetah -ever released. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.3 Support for the latest bike computers

- -

We have added direct download support for the Cyclops Joule and Joule GPS -as well as the latest SRM Powercontrol 6 and 7. We also added support for -the O-sync Macro and Macro X. -

-

In addition to this we also fixed a few issues related to importing from -newer Garmin devices since the file format changed. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.4 Support for more telemetry

- -

Alongside the support for the latest bike computers we also added the ability to -track and plot new data series, including; Headwind, LR Balance, Temperature and -Slope. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.5 Export and Batch Export as well as lots of new file formats

- -

We will now export and batch export your data to a wide variety of file -formats. We believe it is your data and it should not be locked into any -sotfware. We support open formats such as TCX, PWX, JSON and XML as well -as FITLOG and GPX. -

-

We have also added support for reading files from SportTracks, GPX, Tacx -CAF and the SLF/SMF file formats. We have also added legacy WKO+ file -format support (CP 1.0 and 1.1) as well as import of Wattbike TXT exports. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.6 Support for a wide selection of Cloud services

- -

We can now upload and download data from cloud services offered by; Withings, -Zeo, Strava, TrainingPeaks, Training Stage Buch, RideWithGPS as well -as Internet based calendars (calDAV) such as Google Calendar. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.7 Improvements to Aerolab

- -

There is now an autosolver for CdA and Crr Estimation in Aerolab that -removes a lot of the guesswork from curve fitting in Virtual Elevation -as well as a handy Air Density (Rho) estimator. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.8 Realtime training significantly enhanced

- -

We now support Native ANT+ removing the need for quarqd. Video Playback -is built in using VLC/QTKit. We manage a media library to make sure you -can re-use any content you may have from Tacx Ergvideos through Sufferfest. -

-

We support Virtual Power for popular devices from KK, LeMond and many other -trainers. We have added support for the amazing new Wahoo Fitness Kickr trainer -as well as the old Tacx Fortius. -

-

In the train view we have added lots of new ways to ride on the trainer including; -Streetview, SpinScan (on Computrainer) and an enhanced Workout Plot that plots -telemetry against the workout as you ride. -

-

Finally we’ve added Computrainer calibration, a workout wizard and download -from ErgDB as well as Multi-device Support allowing you to ride with with -your ANT+ powermeter on your Computrainer, Kickr or Fortius. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.9 Advanced search and data filtering

- -

We now offer the ability to use free text search across all ativities, enabling -lightning quick searches for past activities. We use a well proven and lightning fast -indexing tool (CLucene) to index all the details of your activities seamlessly. -

-

Additionally we have introduced a data filter (using the same search box) to allow -you to filter activities for specific properties, for example for all rides with a -TSS > 300 or perhaps those with an IF >0.9 and a duration of > 1hr. -

-

Both the search and filter functions can be applied to the charts – which means that -you can plot a PMC only where sport is "Bike" or perhaps power distribution but only -where the workout code is FTPTEST. -

-

We are still discovering how powerful these tools are when applied to long term -performance tracking. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.10 Lots of new charts

- -

It wouldn’t be a new release of GoldenCheeth if we didn’t introduce some new -charts for detailed forensic data analysis. -

-

We’ve added a new HR to Power analysis as well as a more utilitarian 2d scatter -plot. We’ve added Bing as map provider for the Map chart. -

-

But the single most asked for feature, and one that has been on the GC wish list -since it was first released is the ability to plot a distribution for a date range. -We can now do that – allowing you to plot power distribution for a season or month -or any number of sophisticated date ranges (we also added lots of advance ways to -express date ranges). -

-

Lastly, we have also extended the CP curve to plot more than just power. It will -now plot a mean max curve for HR, Power, Speed, Cadence, xPower, NP et al. And we -even added VAM too, for you mountain goats. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.11 New metrics, including TrainingPeaks’ TSS and NP

- -

Yes, we’ve been granted permission by our friends at TrainingPeaks to use their -cylcing metrics in the latest version of GoldenCheetah. We know that it is one of -the most popular additions. -

-

Not only have we added them as metrics to plot and track, we’ve also added them to -the realtime training so you can target an intensity of stress for a workout and -monitor and adjust the intensity of the workout as you ride. -

-

We have also added a whole host of new metrics, there are now over 100 different -metrics and measures you can work with including things like; Pace, Maximums, -Gradient, VAM, wpk, time in HR Zones and many, many more. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.12 Build and Platform support

- -

For the technical amongst you we have removed mandatory Boost Dependency, which means -you can build GC with nothing more than QT4.8 installed (we will support QT5 in v3.1). -We now support OpenBSD and have moved to using version 6.1 of the QWT library. -

-

On a related note, you can see all the versions used, contributors involved and build -settigs as we have improved the about box to give much more useful information to -developers. -

-
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

1.13 We wrote some documentation!

- -

Shock. We now have an FAQ covering over 50 of the most commonly asked questions about -GoldenCheetah. And a full user manual to compliment the existing wiki for user generated -content. -

-

One of the other criticisms we often heard about GoldenCheetah was how hard it was to -use, and how you needed to be a cycling nerd to understand it. We feel that the new UI -and User Experience coupled with much better documentation and help mean this should -make this version of GoldenCheetah the easiest to use yet. -

- -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
- -

2. Contributors

- -
- - - - - - - - - - - - - - - - -
[ < ][ > ]   [ << ][ Up ][ >> ]         [Top][Contents][Index][ ? ]
-

2.1 Credits and Contributors

- -

Literally thousands of people regularly download, install, develop, critique and discuss -GoldenCheetah and its features and functions. -

-

Back in 2006 a stupendously gifted guy (and Cat 1 racer) called Sean Rhea bought a -Powertap. Frustrated with the software that was available he set about writing some -utilities to plot the data. But first he had to reverse engineer the protocol to talk to it. -Back then, and to a lesser degree now, these sports and cycling products are closed. You buy -their product and you’re stuck with their software. Sean did something amazing – he open -sourced his code. By doing that he changed power analysis completely. -

-

Here in 2013 with ANT+, BTLE, Wahoo, TrainerRoad, PerfPro and of course GoldenCheetah things -look very different. The cycling world has gone open. Sean can take some of the credit for that. -

-

We stand on his shoulders. -

-

Here in 2013 by far and away the biggest contributors to this project are Damien Grauser and -Mark Liversedge. Between the two of them they have committed almost 90% of all code to -GoldenCheetah in the last 3 years. Often working on stuff for others they are the reason this -release is written for you the cyclist .. and not us the developers. -

-

Of equal importance is Gareth Coco our devops guru. With unfathomable patience he has built -countless release candidates and development builds for the last 3 years. He has worked with an -ever changing and hideous array of wacky dependencies across Windows, Mac and Linux. He is pretty -much the only reason you can download and install our software. Big, big thanks to Gareth. -

-

Thats not to say that there aren’t many other significant contributions too; Ale Martinez -has masterminded and developed multi-language support in V3. Translations have been undertaken -by Ale himself, but also by Til Schmiedeberg, Keisuke Yamaguchi, Marco Piccirilli, Sergei Chekhovskii -and Rafael Oliveira Ribeiro. -

-

A large number of developers have contributed small and large bits of code, and many clever -coaches and athletes have donated their ideas and best practices. I must shout out to -Dr Andrea Morelli the professional coach, for his encouragement and insight over the last -3 years and Greg Steele for some of the most interesting and inspriring thoughts. -

-

Here are all the contributors, all of them have made this version of GoldenCheetah the best yet; -

-

Alejandro Martinez, Andrew Bryson, Andy Froncioni, Austin Roach, Berend De Schouwer, Bruno Assis, -Chris Cleeland, Claus Assmann, Dag Gruneau, Damien Grauser, Darren Hague, Dean Junk, Eric Brandt, -Eric Murray, Frank Zschockelt, Gareth Coco, Greg Lonnon, Ilja Booij, Jaime Jofre, Jamie Kimberley, -Jim Ley, John Ehrlinger, Josef Gebel, Julian Baumgartner, Julian Simioni, Justin Knotzke, Keisuke Yamaguchi, -Ken Sallot, Luke NRG, Magnus Gille, Marc Boudreau, Mark Liversedge, Mark Rages, Mitsukuni Sato, -Ned Harding, Patrick McNerthney, Rainer Clasen, Robb Romans, Robert Carlsen, Roberto Massa, Ron Alford, -Sean Rhea, Steven Gribble, Thomas Weichmann, Walter Burki. -

-

Finally a big shout out to three amazing people; Jamie Kimberley who has been the glue -that held the GoldenCheetah community together, Robert Carlsen who has always been the -cool guy in the glasses that does the cool stuff. And last but not least, my friend Justin -Knotzke who demands and gets the best from all of us. -

-

Jamie, Robert and Justin have stepped away from regular involvement in GoldenCheetah, but their -contributions have set the standard and will not be forgotten. Cheers Guys. -

-
- - - - - - -
[Top][Contents][Index][ ? ]
-

Table of Contents

-
- - -
-
- - - - - - -
[Top][Contents][Index][ ? ]
-

About This Document

-

- This document was generated by Mark Liversedge on March 20, 2013 using texi2html 1.82. -

-

- The buttons in the navigation panels have the following meaning: -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Button Name Go to From 1.2.3 go to
[ < ] BackPrevious section in reading order1.2.2
[ > ] ForwardNext section in reading order1.2.4
[ << ] FastBackBeginning of this chapter or previous chapter1
[ Up ] UpUp section1.2
[ >> ] FastForwardNext chapter2
[Top] TopCover (top) of document  
[Contents] ContentsTable of contents  
[Index] IndexIndex  
[ ? ] AboutAbout (help)  
- -

- where the Example assumes that the current position is at Subsubsection One-Two-Three of a document of the following structure: -

- -
    -
  • 1. Section One -
      -
    • 1.1 Subsection One-One -
        -
      • ...
        • -
      -
      • -
    • 1.2 Subsection One-Two -
        -
      • 1.2.1 Subsubsection One-Two-One
        • -
      • 1.2.2 Subsubsection One-Two-Two
        • -
      • 1.2.3 Subsubsection One-Two-Three     - <== Current Position
        • -
      • 1.2.4 Subsubsection One-Two-Four
        • -
      -
      • -
    • 1.3 Subsection One-Three -
        -
      • ...
        • -
      -
      • -
    • 1.4 Subsection One-Four
      • -
    -
    • -
- -
-

- - This document was generated by Mark Liversedge on March 20, 2013 using texi2html 1.82. - -
- -

- - diff --git a/doc/user/GC3-Release.pdf b/doc/user/GC3-Release.pdf index e6e7d3d78480d615271e958593e31a4ab2d54d9d..cdc04db1905b3755d7349be4d1dd057c9e1974f7 100644 GIT binary patch delta 211 zcmaF1l=b~m)`l&NXMI&n42=!U3=E?*x%7SWQ(O{DQWZ2@tc(nR!p25W$>|?`8I$;Z z6O#k-i%NCfg(Z7?(0R8yLD68MwNd8X1|n7&^NdTDTavI6J#Ix;dJ#Dc z*eTc$QZn5!kTHZqZ{ewEjp-YXPoEpe_=@rP^o}4#87coSGJVG$WTSTmZ~%KN|o5 diff --git a/doc/user/Makefile b/doc/user/Makefile index 4633f32b7..479d38e30 100644 --- a/doc/user/Makefile +++ b/doc/user/Makefile @@ -5,9 +5,14 @@ all: FAQ RELEASE MANUAL rm -f *.aux *.cp *.cps *.fn *.ky *.log *.pg *.toc *.tp *.vr +clean: + rm -f GC3-Manual.pdf GC3-FAQ.pdf GC3-FAQ.html \ + GC3-FAQ.info GC3-Release.pdf GC3-Release.html GC3-Release.info + rm -f *.aux *.cp *.cps *.fn *.ky *.log *.pg *.toc *.tp *.vr + MANUAL: GC3-Manual.pdf -FAQ: GC3-FAQ.pdf GC3-FAQ.html GC3-FAQ.info -RELEASE: GC3-Release.pdf GC3-Release.html GC3-Release.info +FAQ: GC3-FAQ.pdf GC3-FAQ.info +RELEASE: GC3-Release.pdf GC3-Release.info ## The basic commands, good on Linux/Mac ## need mingw on Windows @@ -18,10 +23,10 @@ MAKEINFO = makeinfo .SUFFIXES: .pdf .texinfo .info .html .texinfo.info: - ${MAKEINFO} $< -o $@ + ${MAKEINFO} $< -o $@ >/dev/null 2>&1 .texinfo.pdf: - ${TEXI2PDF} $< -o $@ + ${TEXI2PDF} $< -o $@ >/dev/null 2>&1 .texinfo.html: - ${TEXI2HTML} $< -o $@ + ${TEXI2HTML} $< -o $@ >/dev/null 2>&1