Skip to main content

Championship Standings

NOTE: This page explains championships for Theme Editor themes. Championships for the ATVO Theme 2023 are explained here.

You can track the live championship standings by adding a Championship object to the theme. Inside the Championship editor tab, you can setup your championship and adjust various rules and settings. Further settings are adjustable via the Property Explorer after selecting the Championship in the Theme Explorer.

In order to calculate and display live championship standings, you need a spreadsheet with the results of previous races, as well as a spreadsheet with the point system that will be used to award points during the current weekend.

Live championship standings update​

Championship standings can be updated live during the race, taking into account the live positions of every driver. ATVO also keeps track of the "previous" points and standings (before the current race weekend) so that it is able to display points gained or positions gained since the previous weekend.

The Update interval can be changed in the properties of the Championship. It is recommended to keep the interval at 2 seconds or slower for performance reasons.

Championship calculation logic​

Championship points and standings are calculated in the following sequence:

  • Calculate the points and standings as they were before the current weekend (e.g. previous races). Including potential drop results.
  • Award new points to entries in all the sessions of the current race weekend, according to their live positions and the specified point system.
  • Apply any rules such as drop results or bonus points.
  • Update the live standings with the new points and positions.

Results / standings tab​

If you wish to import points from previous race weekends, you need to use the Results / standings tab to load a spreadsheet file with those results. The file must have the following format:

  • Identifier/ID: the first column is used to identify to which entry this row belongs, for example by Customer ID or car number. Make sure to select the appropriate identifier type in the spreadsheet properties for the selected Results spreadsheet item.
  • Name: the name of the entry, for displaying in Widgets.
  • Class: in case of multi-class standings, you must specify the ID or name of the class to which this entry belongs.
  • Optional additional columns: any additional information you wish to use as a Data Binding in a Widget.
  • 1 or more Points columns: the final columns are interpreted as a race results per column, and should contain the points that this entry scored for each race. If you are not using drop results, it is also possible to have a single column with the total of all previous results. For drop results support however, you must specify every race separately.

DO NOT include a "Total" column that sums the results, as this will be interpreted as a new race.

Result start column​

The Result start column setting must be used to specify in which column your race result points start. The minimum value is 3 (in case you do not have any optional columns). When changing this value, the red line in the Results data indicates where ATVO starts counting results. The red line should always be to the left of the first result column, as in the example.

Example spreadsheet​

When no Results are selected, the tab will show example data which you can also save to file.

Point System tab​

If you wish to have live updates of the championship standings, then you must specify the points system to use via another spreadsheet. The points system controls how many points are awarded to each position and in each session.

The points system spreadsheet should have just 3 or 4 columns, depending on if you wish to score each class with different points or the same points.

  • (Live)Position: the position to award these points to.
  • Session name: the name of the (sub)session to award these points for.
  • Class: the class for which these points should be awarded (remove this column if Separate class point systems is disabled)
  • Points: the amount of points to award.

The Session name column is necessary to ensure that only the desired subsessions award points. For example, you probably want to award points for the Race session, but not for the Warmup or Qualification. It is also used to support weekend with multiple race sessions, such as heat racing. You can award different amount of points in different heats by specifying a new system per session name.

NOTE: Make sure the session name is spelled exactly like the in-sim session name. For example, inputting "Heat1" without a space will not work if the actual session is named "Heat 1" with a space. The only exception is lower vs uppercase: this is ignored. The correct name is also visible in the Sessions List on the Timing Screen in ATVO.

Live Position vs Start/Finish Position​

The Championship item has a property Use live position to choose between using the "live" positions of each entry (which updates during the lap), or the static position which only updates at the end of each lap.

Rules​

The Rules tab can be used to control various rules for point scoring, such as configuring bonus points or drop results.

Misc Championship settings​

The setting called Score missing entries: ... controls how to handle entries in your current race that do not show up in your Results spreadsheet. When enabled, these missing entries are added to the list of championship drivers and will score points in the current weekend (though they will start with 0 points). If disabled, these entries will not show up as championship drivers and will also not show up in any of the championship Data Sets.

Bonus points and drop results​

You can add the following rules and then configure their properties by selecting them in the list.

  • Bonus: fastest lap: award bonus points to the entry with the fastest lap in the specified sessions.
  • Bonus: most laps in the lead: award bonus points to the entry with the most laps in the lead in the specified sessions.
  • Bonus: one lap in the lead: award bonus points to each entry with at least 1 lap in the lead in the specified sessions.
  • Requirement: minimum distance: only award championship points to entries that have completed at least some percentage of the total race distance.
  • Drop results: remove a specified number of the worst few results for each entry. See the Drop results section below for more details.

Session names setting​

Each rule has its own Session names setting where you can specify for which session(s) this rule applies. You can input multiple session names separated by a comma, such as: "Qualification, Race, Heat 1, Feature". If the Session names setting is empty, the rule is applied to all sessions.

You can use Session names to award bonus points in specific sessions only, or prevent them from being applied in unwanted sessions. For example, to award a "Pole position bonus", you can use the "Fastest lap" bonus rule with Qualification as the session name, to award some points to the winner of the qualification session only.

Drop results​

To support drop results, it is required that you have added each race result separately in the Results spreadsheet. Each entry in the Results is a candidate for a drop result.

When "Include current session" is enabled, the points in the current race weekend may also be dropped.

When "Separate drops per subsession" is enabled, then each subsession or heat in the current weekend is considered separately as a candidate for a drop result. When it is disabled, only the total sum over all heats can be dropped at once.

NOTE: For drop results including the current session, it is almost always necessary to specify the Session names to which drop results should apply, by specifying only those sessions that are actually supposed to award points. If you do not specify session names, then it is likely that Practice, Warmup or Qualification sessions (usually awarding 0 points) are being dropped instead of actual results.

Display Championship standings: Data Sets and Data Bindings​

When adding a Championship item to the theme, this Championship can now be selected as a new Data Set. The Data Set returns the entries in the championship in the specified data order.

Data order​

For Championship Data Sets, only two order modes are supported:

  • Live championship position: sort by live position (include the points scored in the current session)
  • Championship position: sort by previous position before this event Any other sort order will revert to the Live championship position instead.

Data Bindings​

Any Labels inside a Widget using a Championship Data Set will have a choice of Data Bindings related to the championship entries. These include:

  • relevant bindings for the entry such as their ID, name, class
  • all the championship info such as their previous and current points, positions, point gaps, drop points, etc.
  • any additional columns available in the Results spreadsheet

Troubleshooting and Live View​

If we detect any issues with your input spreadsheets, these will be reported in the Troubleshooting tab.

The Live View tab can be used to view the current championship standings, including all kinds of information about each entry. This is useful to debug if your points are working as intended.

The meaning of the various points/positions columns are:

  • LivePosition/Points: the current live position/points in the championship
  • PrevPosition/Points: the position for this entry as it was before the current event (before adding any new points)
  • PrevDrop: the amount of dropped points before the current session (note: PrevPoints already has these points dropped)
  • LiveDrop: the amount of dropped points when taking into account the current session (note: LivePoints already has these points dropped)
  • (Session name)Pos/Points: the position and points awarded for each subsession in the current session (e.g. Qualify, Heat 1, Feature)
  • (Session name)Bonus: any bonus points (or removed points) due to your Rule configurations