Wiki

Case Status
Log In

Wiki

 
Venue Racing Application - .RA…
  • RSS Feed

Last modified on 1/7/2011 1:04 PM by User.

Tags:

Venue Racing Application - .RAC file description

The Venue Race Application utilizes a standard text file (using .RAC extension) to save race configuration parameters.  The organization of this file is very specific, with the parameters defined according to the ordering of text fields on certain lines within the document (as opposed to files that use tags to define parameters).

The .RAC file fields are defined as shown in the table below:

 

Line number field name/description legal values/settings
1
 
Race File Signature - used by the VRA to indicate a race file
 
RACE
 
2
 
Race File Version
 
108
 
3
 
Team Type - 0:Singles, 1:Doubles, 2:Fours, 3:Eights
 
0-3
 
4
 
Race Name - Shown in VRA window and on monitors
 
Any text - 16 character limit
 
5
 
Race Duration - in meters for distance race, in seconds for time race
 
50-999999 (distance race)
0-35999 (time race)
 
6
 
Race Type - 0:Distance Race, 1:Time Race, 3:Biathlon Distance 3-Lap, 5: Biathlon Distance 5-Lap
 
0, 1, 3, 5
 
7
 
View Mode - Not used (set the Venue Race display between graphic view and table view in old VRA versions).
 
0
 
8
 
Stroke Data Capture - 0:Disable stroke data recording, 1:Enable stroke data recording
 
0-1
 
9
 
Split Distance in meters - min is 50, and max is dependent on race duration.   PM cannot store more than 30 splits.
 
50-(see text)
 
10
 
Split Time in seconds - min is 30, and max is dependent on race duration.   PM cannot store more than 30 splits.
 
30-(see text)
 
11
 
Number of Boats in Race - min is 2, and max is 100, although the practical limit (due to performance issues) is around 40.
 
2-(see text)
 

 
BOAT INFORMATION - REPEAT FOR EACH of 'n' BOATS
 

 
12+((n-1)*5)
 
Boat Name - Individual name or team name in team races
 
Any text - 16 character limit
 
13+((n-1)*5)
 
Boat Bib Number
 
0-65535
 
14+((n-1)*5)
 
Boat Class Name - Any text, but can only have up to 10 unique class names in a race file.  The VRA assigns class numbers in sequential order according to the order in which the text names appear in the file.
 
Any text
 
15+((n-1)*5)
 
Boat Country - uses international standard 3-character country code
 
3 character country code
 
16+((n-1)*5)
 
Boat Birthdate - mmddyyyy
 
mmddyyyy
 

 
Total Team Race Ergs - This MUST be 0 for individual races, or the total number of PMs for team races
 
0-100
 

 
ADDITIONAL INFORMATION FOR TEAM RACES - Repeat the 3 items below for each individual rower.  The ordering should be: Boat1:Rower1, Boat1:Rower2, etc.
 

 

 
Individual Rower Name
 
Any text - 16 character limit
 

 
Individual Rower Bib Number
 
0-65535
 

 
Individual Rower Class Name (see above)
 
Any text
 

 

 

 

 

 

 
Example follows (do NOT put in the comments when making your own race file):

RACE                         // file type signature
107                             // file format ver 107 including class.
0                                  // team config (singles=0, doubles=1, fours=2, eights=3)
T0830aF02                // race name; see note 1

100                             // distance in meters

0                                  // duration type (distance=0, time=1, biathlon distance 3-lap=3, biathlon distance 5-lap=5)

0                                  // always zero

1                                  // enable stroke data

500                             // splits distance in meters

120                             // splits time seconds

4                                  // actual # of boats in this race (2-40)

Randy Heigel // participant name; see note 2

687                             // identifier (bib number)

E4F1                          // class; see note 3 

63                                // country code; see note 4

02101957                  // DOB; can be left blank

Nick Rockwell            // next record

254

E5F1

63

02101947

Bob Hobkirk

11

E5F1

63

02101949

John Harbaugh

146

E5F1

63

02101945

0

 

Note 1: Race Name is shown on the PM3 monitor. This must be limited to 16 characters or the application will not allow you to start the race.

 

Note 2: Rower Name is shown on the PM3 monitor during WARMUP.  This is approximately 12 characters long, but it is also dependent on width (names with wider characters such as “W” and capital letters take up more space, which will result in fewer characters displayed on the PM3.  Rower Name will be also displayed to the user while rowing. While rowing, the name is a bit shorter, (about 11 characters; as few as 8 characters with wide characters and CAPS).  You can make this string long if you like (but please avoid punctuation, especially commas) the PM3 will truncate as needed.  Finally, this string is also shown on the TV's.  You can make the string longer, and add in class information like "Scott Hamilton 36 HW" although this does not set the class as it is for display only. 

 Note 3: For class—If you are running a single class race, make this string the same for all records (using a blank line is acceptable). If you have 2 classes, then make the string the same for everyone in Class 1, and the same for everyone in Class 2.  To keep it simple, you could simply use "Class1" and "Class2,"  but any string will do.  ErGO! uses class names such as E5F1 which represents Event 5, Flight 1.  This string is only displayed to the computer operator in the class-view options.  Finally, DO NOT mix up the order! Keep them all grouped properly.

 Note 4: This is assumed to be country code. AFG is the default. This variable has no active function and is just a placeholder. Please note that in the example above (pulled from Eileen's documentation) this is a number. At one point it seems that numbers were used, but in any actual files viewed at Concept2, this value has been a 3-digit string containing one of the following: AFG ARE ARG ATA AUS AUT BEL BHR BMU BRA CAN CHE CHN CZE DEU DNK EGY ESP EST FIN FRA FXX GBR GRC GRL GTM HKG HRV HUN IND IRL ISL ISR ITA JAM JPN KOR LUX LVA MAC MEX MWI NCL NER NIC NLD NOR NZL OMN PER PHL POL PRI PRT RUS SAU SGP SWE THA TTO TUR TWN URY USA VIR YUG ZAF ZWE

 In addition, the following Country Codes have been added as “Set Language” codes in a .RAC file.  Only these codes will cause a PM3/PM4 to change language if the appropriate settings are chosen:  CHI=Simplified Chinese (PM4 only), POR=Portuguese, FII=Finish, DAN=Danish, SWD=Swedish, DUT=Dutch, ITL=Italian; GER=German; FRE=French; SPA=Spanish; ENG=English

 Note 5: Only US ASCII is accepted. If you are using other applications and embedding diacritics (letters with dots and other marks above, etc.), most of this information is lost or converted to some similar but still strange characters (for example, boxes, quote marks, and so on).  Try to stick to standard ASCII. Test your race files by loading them into the VRA.

 

Testing Your Race Files

If you are generating your own .RAC files, or even using ErGo, it is advisable to load all the race files in advance and test them to be sure they work acceptably.  To do this:

·        Run the VRA (even without ergs hooked up)

·        Cancel the wizard (and any other popups that appear)

·        Open the race

·        When the Modify Race window is displayed:

·        Check the meters or time, and grouping 

·        Ensure the race name is less than 16 characters (or the race will not load)

·        Click Cancel. The race is now loaded.

 

Things to check for:

·        Do all the names look ok?

·        Are all the names there? Be sure to check the first and last name on the list.

·        Multiclass Races: Are ALL the boats in order (1, 2, 3, etc).  (If classes are not done properly, you can end up with boats out of order.)

 

Format For Race Results File

file type signature ("Race Results")

file version ( currently 101)

blank line

header

boat results: (Place,Time Rowed, Meters Rowed, Boat/Team

Name,Avg. Pace,ID,Bib Number,Class)  - repeat for each record

 

blank line "Detailed Results"

blank line ' boat results (place,boat,boat/team name,finish time,finish

distance,avg. pace,rower's ranking ID,class)

individual results (,,,Rower

Name,Class,Distance Rowed,Avg. Pace) . . . notes: Boats are sorted by place.

For detailed results, the section of repeated for each boat/team.

 

Stroke File

In eRow, this recorded data for every stroke the user took.  In the Venue Racing application, the data is taken periodically.  The default period is about 500mS (1/2 second).   This data can be used with third party programs to re-play the race from start to finish.

 

Splits File

Shows the splits for each participant.

 

LogData Files:

Transaction logs files are created for every race which shows all the data flowing. If you have a problem with a race, we would encourage you to save these log files (they do get VERY big, sometimes 4-5 megabytes!) and send them to Concept2 with some notes as to what happened.  This allows C2 programmers to diagnose the problem better.