wiki:FS Guide

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

--

The FS Guide

Installing FS

Requirements

  • Any PC running 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.

It has been tested on Windows 2003 Server, Windows XP and Vista but (teoretically) it should work on any platform as long as .NET 2.0 is installed.

Download FS from here: [CurrentVersion]. 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
  • Participants.xlt - A MS Excel template for quick and easy registering of users. You need to have macros enabled in Excel.
  • lc.xls - A MS Excel workbook for viewing Leading Coefficient graphs.

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 CIVLID

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 CIVLID is the ID a pilot is given the first time he/she is registered in the CIVL database. This will normally happen after one has been in a FAI Category 1 or 2 competition. Any pilot that has been in a Cat 1 or 2 competition after 2001 should be in this database.

This ID is used when uploading results to the CIVL database where it is used to generate the World Ranking (WPRS).

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. We wish these differences could be documented by the makers of the instruments, but it have not been successful so far.

Setting up a new competition in FS

You should 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/Usefull? stuff/Import pilotlist from ..." to initially populate the particpant list.

If you have a bunch of tracklogs, you can use "Tools/Usefull? stuff/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 only pilots having id not already in the fsdb will be imported. In other words, all existing participants will stay as is.

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: Select task type "Race" and set which tp is start of speedsection (SS) and end of speedsection (ES) then add a single start gate.

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

Elapsed time race: Select task type "Elapsed time" and 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.

Open distance on a heading: Same as open distance above, but check the "Heading" checkbox and add an extra turnpoint at the end which gives the heading to fly.

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

Lots of other variants of tasks is possible, tps with big or small cylinders, tps inside/outside each other, f.ex. one can fly from start out the edge of a 50km cylinder then back to start again ("Race to nowhere and back").

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 click on the "Open waypoints file" to fill the Waypoints list.

Double-click (or select and press Enter or right-click...) on a waypoint to add it to the Turnpoints list.

Edit a turnpoint double-click (or select and press Enter or right-click...). Remove a turnpoint by selecting it then press the Delete key (or right-click...).

Checking tracklogs etc.

See popup-menus (right-click) in "Tasks" list and "Task participants" list. For the "Task participants" list some of the menuitems work on the rows you selected.

After checking tracklogs, setting status for those not having tracklog, etc. you can produce reports from the "Reports" menu.

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 may 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 or use the menuitem "Check ... NYP".

Note: any penalties is also removed.

Open distance task

Add a 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. Set close time for when the task closes. Turn OFF option to not check the take off turnpoint.

Reports

A set with default reports templates is included. One for task result (task_result.tkr.xsl), one for competition result (comp_result.cpr.xsl), one for team results (team_result.tmr.xsl), and one for participant list (participant_list.ptl.xsl). These can be used from the respective menuitems under the "Reports" menu.

If they do not look the way you like (language etc...) just make a copy 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. Note: Keep the extention (from the first .) the same.

Attachments (5)

Download all attachments as: .zip