wiki:FS Guide

Version 5 (modified by Stein Tore Erdal, 12 years ago) (diff)

Work in progress, lots of changes to FS in the last month.

The FS Guide

Installing FS

Requirements

  • Windows XP or Vista
  • Microsoft .NET 2.0 (Use Windows update to install directly from Microsoft)
  • 2 MB free harddisk space for FS itself, you might want some more for tracklogs and such.

Download FS from here. You will get the file fssetup.exe, run it. It will ask where you want to install FS. Make a folder somewhere on the disk and click OK. FS will then install itself in that folder you made.

FS will not make any icons for now. In the FS folder you will find some useful programs that you can start directly.

  • FSComp.exe - The main program for setting up and scoring a competiton
  • FSFlight.exe - A tool for visualizing the tracklogs in a task (Very basic)
  • Participants.xlt - A MS Excel sheet for quick and easy registering of users. You need to have macros enabled in Excel.

About the database and data

A competition consists of a folder with a .fsdb file and then eventually a folder for each task containing tracklogs. The FS database is the .fsdb file, this is a XML file that can be edited by hand if needed. The tracklogs are in .kml format.

When using FsComp edits are not committed to the .fsdb file until you save the competition using "File/Save? ...". When saving, you always get the option to choose filename. This way you can keep a backup in case the edits gave unexpected results. When opening a comp (Ctrl-O) FsComp will remember the last .fsdb file saved and suggest to open this.

Always keep a backup of your .fsdb file and tracklogs, especially after finalizing scores for one day. The data folder can be stored on a USB key for easy backup and transportation between computers.

About the pilot ID and CIVL ID

The pilot ID is the unique number of the pilot in the competition. This must be unique and it will save you a lot of time to let the pilots in your clob or organization have the same number over time, as it's written to the GPS, and eventually you will remember each pilot's number.

The CIVL ID is just that, the number on the pilots licence. It's used when you run a Cat 2 or Cat 1 competition, and want to upload the results for the WPRS ranking points.

About the error margin when checking tracklog

Under "Tools/Options?" one can set an error margin in percent of turnpoint radius.

It is default 0,5%. This is 2 meters for a 400 meter radius tp. 200 meters for a 40km radius turnpoint. This is used because there are a number of different ways the GPS devices calculate distance which may give slightly different distance. If you do not believe this is necessary you should do a simple test - create the same two TP task of about 50-100km in a few different types of instruments, then look at the distance shown.

Setting up a new competition

Create a folder for your competition, we recommend to place it under My Documents\FSComps\compname

Start FSComp.exe, you will be greeted will a fairly empty window, don't worry, it will soon be full of data.

Select "File/New? Competition" and enter details then save the competition with "File/Save? Competition..." to the folder you just created. If the competition is a CIVL cat 2 (or 1) comp registered on http://civlrankings.fai.org/?a=303 then you could use the competition_id that is used there! A .fsdb file has now been created with comp details. Tips:

If you've already run another comp using FSComp with mostly the same participants, just copy the .fsdb file, then edit the details, delete the tasks, then remove/add participants...


Adding Participants to the database

When the competition have been set up, you will have an empty list of pilots.

By selecting the empty row and pressing Enter (or right-click and choose Edit or New) you get a dialog for entering a new pilot. Short-cuts: Ins - new pilot Del - delete pilot Enter - edit pilot (or new if on empty row)

Select one or more rows by clicking and dragging, shift-click, or ctrl-click, and use the "Delete" key to remove participants (you're asked to confirm each deletion).

Another option to get participants into a .fsdb file is to use !"UpdateFsdbWithParticipants?.xlt". This is an Excel Template which you just open in Excel to create a new spreadsheet, then add participants directly in Excel anyway you like. Follow the instructions written as comments in the spreadsheet. You will need to have macros enabled in Excel for the spreadsheet to work.

Using Excel gives you the option of adding more information per participant, like paid status, mobile number, etc. It will save you some time in the long run.

Importing pilot lists from external sources

If you have a RACE db or a CompeGps .pil file with participants you can import pilots from these files using "Tools/Odds? & Sods/Import? pilotlist from ..." to initially populate the particpant list.

If you have a bunch of tracklogs, you can use "Tools/Odds? & Sods/Create? pilotlist from tracklogs". The tracklogs must have file name as made by GpsDump in comp mode in order for it to make sense. Also no two tracklogs can have same id.

For any of the import options above any existing participants with same id as the imported ones will be replaced.

Tasks and task types

Each task can have it's own scoring parameters. Normally they would be the same for the whole competition, but there can be cases where f.ex. min. dist. should be different because one use a different take off or different wind-direction etc...

Distance of a task in FS

FS will calculate the "shortest distance needed to take all turnpoints".

Example 1: Two tp (incl. take off and goal)

  • At take off: tp1 radius 400meters
  • Goal 10km away: tp2 radius 400meters.

Task distance will be 9,2km

Example 2: Out and return (Three tp incl. take off and goal)

  • At take off: tp1 radius 400meters
  • 10km away: tp2 radius 400meters.
  • Back to take off: tp3 radius 400meters.

Task distance will be 18,4km

Task types

Race with a single startgate: set which tp is start of speedsection (SS) and end of speedsection (ES) then add a single start gate.

Race with a multiple startgates: set which tp is start of speedsection (SS) and end of speedsection (ES) then add several start gates.

Elapsed time race: set which tp is start of speedsection (SS) and end of speedsection (ES) but do not add any start gates.

Open distance: must have at least one tp. Can have more in which case it is "open dist via turnpoints". See futher description below.

Race to nowhere: Set startpoint, start cyl, and a larger goal cyl around same TP. ES is when pilot cross out of goal cyl.

Waypoints

Waypoint file must be created with GpsDump. Either as the type "Geographical files (*.wpt)" which looks like this inside:

$FormatGEO
TARPOL    S 30 32 50.71    E 150 36 47.81   204  TARPOLY

or as the type "UTM files (*.wpt)" which looks like this inside:

$FormatUTM
TARPOL   56J   0271048   6618129    204  TARPOLY

GpsDump can open waypoint files in a number of different formats so if you don't have a file in correct format there is a good chance you can open it in GpsDump and select the waypoints and save in one of the two formats mentioned above.

Also GpsDump can of course read the waypoints from a GPS so as long as you are able to get your waypoints into a GPS somehow you're set.

In the Task window select "File/Open? Waypoints file" to fill the Waypoints list.

Double-click on a waypoint to add it to the Turnpoints list and select a turnpoint then edit the details below and press "Set".

Remove a turnpoint by selecting it then press the Delete key. Checking tracklogs etc.

Select one or more rows in the grid (under the Task tab) then right-click and you get a menu with some choices...

After checking tracklogs, setting status for those not having tracklog, etc. you can select "Tasks/Score? Task (GAP)" to create results, then produce reports with "Tasks/Task? ..."

If a pilot got several tracklog files the one with last file modified timestamp is checked.

Note: nothing happens to the fsdb file itself until you save it ("File/Save? Competition ..." where you get the option to specify filename). This means you can test different things and discard these by not saving before exiting the program. Editing a task

After editing a task one need to check tracklogs again.

Task validation and scoring is removed for all those that has tracklog and these rows get status NYP again.

Those pilots where one has entered distance or set status manually will keep their data.

This means one can sort the rows on the status column and mark those rows with status NYP and check tracklogs again.

Note: any penalties is also removed.

Open distance task

Add an EXIT turnpoint for take off (or where ever the start of the task should be from). Set open time for when the take off is open, Set close time for when the task closes, meaning tracklog-points after this time will not be checked. Set radius so that the circle covers a bit more than the take off. Note: As pilots often do not have valid tracklogpoints at take off it is possible to set an option to not check the take off turnpoint.

If you want to have take off window close different from task close: Set a radius for take off turnpoint so that one can be sure pilots will have points inside after taking off. Add same turnpoint once more as EXIT. Set close time for when the task closes. Turn OFF option to not check the take off turnpoint. Reporting

Reports

Two report templates is included. "comp_result.xsl", and "task_result.xsl". These can be used from the "Reports" menu.

If they do not look the way you like (language etc...) just copy them to your comp folder and open them in a text editor and edit the content. This requires a little knowledge of xml so that one stay away from content that should not be changed.

There is also a simple html task report under the "Tasks" menu.

Attachments (5)

Download all attachments as: .zip