Skip to content

UG_Tool Bar_Functions

Paul Johnson edited this page Sep 8, 2025 · 30 revisions

Tool Bar: Functions (v3.7)


ToolBar0

The Tool Bar provides direct access to commonly used functions in GoldenCheetah, from left to right:

Back

Allows to go back to the previous view in the navigation stack.

Forward

Allows to go forward to the next view in the navigation stack.

Perspective Selector

Allows the selection of the active perspective for the current view, create new perspectives, and manage existing ones. To change the active perspective for the current View you can select an existing one from the drop down list s.t General, Run, Swim or Map in this example:

ToolBar_PerspectiveSelector

Additionally automatic change based on conditions is available for Activities and Train view as explained below. Perspectives are collections of charts for a View, together with some settings s.t. tiled/tabed and a filter.

Perspectives are created empty and then charts can be added, removed and configured when it is the active perspective for the view, the same applies to the Tiled/Tabbed setting which is remembered as a property of the Perspective.

Add New Perspective on Activities

When creating a new Perspective, or editing an existing one, on Activities view you need to provide a Name and an optional switch filter:

ToolBar_PerspectiveAddActivities

The switch filter allows the automatic change to a perspective when the newly selected activity fulfills the filter conditions. This is useful to have separate perspectives for different sports and/or data availability, for example isRide && Data contains "P" for rides with power data. After an activity is automatically selected you can still change the current perspective using the selector. The switch filter function is exactly that, it doesn't exclude activities or data not matching the filter, that can be accomplished at the chart level if necessary.

  • The filter switch expressions are evaluated starting from the first entry in the perspective list, therefore when an activity matches more than one perspective, the perspective highest in the list is selected.
  • When a selected activity fails to match any perspective's switch expression, the first perspective in the list is selected (General in example above), therefore it is worth retaining a default "general" perspective at the top of the list.

Add New Perspective on Trends

When creating a new Perspective, or editing an existing one, on Activities view you need to provide a Name and an optional activities filter:

ToolBar_PerspectiveAddTrends

The activities filter allows the filtering of activities in the selected date range when the perspective is active. This is useful to have separate perspectives for different sports and/or data availability, for example isRide && Data contains "P" to select only rides with power data. Automatic switching is not available in the trends view.

Add New Perspective on Train

When creating a new Perspective, or editing an existing one, on Train view you need to provide a Name and an optional switch option: Don't Switch, Erg Workout, Slope Workout, Video and Map (intended for slope workouts with GPS data and no video):

ToolBar_PerspectiveAddTrain

The switch option is used on Workout selection to choose the proper Perspective according to the selected workout type, provided the current perspective allows switching. After a workout is selected you can change the current perspective using the selector.

Manage Perspectives

Allows to create, delete, reorder, import and export Perspectives using the upper pane:

ToolBar_PerspectiveManage

and to move charts from one perspective to another by drag and drop from the lower pane.

Side Bar

Activate/Deactivate the left sidebar, specific for each view.

Bottom Bar

Activate/Deactivate the Compare Pane in Activities and Trends views, or the Intensity Adjustments and Workout Control Pane in Train view.

Tab/Tile

Changes the current view layout between Tabbed and Tiled presentations.

Search/Filter

The Search/Filter box applies to Activities and Trends views, since this powerful functionality is used in multiple parts of GoldenCheetah, it is therefore described just once in: Special Topics: Search/Filter

What's This?

Context sensitive help, once this button is clicked the cursor changes to a pointer with a question mark and, in that state, clicking any element of the user interface will popup a short description of its function plus a link to the wiki entry with the full documentation. This function is also available via the Help > What's This? menu, Shift+F1 keyboard combination, and the question mark icon on dialog titles for Windows builds.

BACK: General UI

Clone this wiki locally