Jenni Adams in the Piopio forest, Waitango 2007. Credit: Jamie Stewart
Race Start NZ Champs 2015 Middle – The Rockery Onewhero. Credit: Karen Woods
Auckland Orienteering Series 2015 – Woodhill. Credit: Karen Woods
  
Selfs Farm Summer Orienteering
Organisers Guide: How to add events onto NZ RouteGadget
By Online Coordinator - Wed 18 May 2016 11:52am
,
Routegadget Sample

[Note: This guide is work in progress and will be revised and updated. Check back for updates].

Participants and competitors: Links to information on how to draw or upload your GPS track are available on the Routegadget NZ homepage. These links will be updated in the near future.

Guide for Orienteering Event Organisers

rg.orienteering.org.nz provides an open Routegadget service for all NZ orienteering events.

This guide is intended for clubs and event organisers who would like to upload their event to Routegadget.

There are several steps to publish your event in the NZ Routegadget application:

  1. Event Planner prepares required files for RouteGadget (Can be done before or after race)
  2. Controller creates Results and the Splits file (After race)
  3. Log into RouteGadget Manager area and add your event

1. Event Planner prepares required files for RouteGadget (Before Event)

Introduction

Generally, the faster you can upload the event onto RouteGadget following an event, the greater the number of people who will use it.

Four pieces of information are required to setup an event in Route Gadget. Some of this (Background Map, Courses File, and All Controls Map) can be created before the event and kept confidential by the Planner/Controller until the event is completed. (For example, on a USB micro drive kept by Controller).

Once the event is over and the results finalized, the Splits data can be generated and combined with the previously prepared files (or saved onto the USB micro drive) to upload the event onto RouteGadget quickly.

These instructions assume the person uploading results onto the clubs website and adding the event onto RouteGadget will be different to the Planner/Controller of the event, however this may or may not be the case. Suggestion: always have multiple backups of your OCAD/CONDES course setting files.

The four pieces of information required to upload an event onto RouteGadget are:

  • All Controls Map. (optional) This is one jpeg image file of the entire map area used by the event with all controls shown on it. (Optional – This is only used for reference during the setup process to ensure controls are overlaid onto the background map correctly. If the person uploading the event onto RouteGadget will have a printed copy of the all control map or can view it directly in OCAD then you can skip this step).
  • Background Map. This file is generated by OCAD. It is a single jpeg image file of the entire map area used by the event without any controls shown. Ideally it will include copyright and map details.
  • Courses file. This file is generated by OCAD or CONDES. It is created from the OCAD/CONDES event setting file and is generally also used by OE2003 to create the courses. This file tells the software where each control is located on the map, relative to each other, and the course details.
  • Splits file. This file is generated by the event software OE2003 after the event has concluded, and similar to what is uploaded to the winsplits website. It contains all the competitors, split times, and results.

1.1. Creating All Controls Map (optional)

The All Control location map:

  • Is a single image of the entire map area used during the event, showing all controls
  • Can be created before the event and kept confidential
  • (Optional – This is only used for reference during the setup process to ensure controls are overlaid onto the background map correctly. If the person uploading the event onto RouteGadget will have a printed copy of the all control map or can view it directly in OCAD then you can skip this step).

Steps to create the All Controls Map:

  1. Start OCAD and open the Event Course Setting file
  2. In the right hand side Courses panel, In the Course drop down box select All controls and click on the Preview
  3. Export the Map from OCAD by selecting File > Export
    The Export Panel will appear on the right hand side.
  4. In the Export drop down box select JPEG
  5. In the Resolution drop down box select a value between 100 – 200 dpi e.g. 100
  6. Tick the partial map box and use either of the three boxes beside it to specify the area being exported. E.g. click on the Entire map button and then drag the defining edges to limit the area to be included, making it as small as possible to include the area used.
  7. Click OK
    The Select Courses/Classes window displays
  8. Select <All controls> and click OK
    The Export Jpeg File file save window displays.
  9. Save the file to the desired location.

1.2. Creating the Background Map

The Background Map:

  • Is a single image of the entire map area used during the event, and has no controls shown
  • Ideally includes map frame copyright information
  • Is 100-200dpi
  • Is as small a file as possible to reduce download size, without loss of detail when magnified.
  • Can be created before the event and kept confidential

Steps to create the Background Map:

  1. Start OCAD and open background map file used (Not the Event Course Setting file)
  2. Export the Map area required from OCAD by selecting File > Export
    The Export Panel will appear on the right hand side.
  3. In the Export drop down box select JPEG
  4. In the Resolution drop down box select a value between 100 – 200 dpi e.g. 150 (might have to use 175-200dpi if detailed sanddune terrain)
  5. Tick the partial map box and use either of the three boxes beside it to specify the area being exported. E.g. click on the Entire map button and then drag the defining edges to limit the area to be included, making it as small as possible to include the entire area used.
  6. Click OK
    The Export Jpeg File file save window displays.
  7. Save the file to the desired location.

1.3. Creating the Courses file

  • This file tells the software where each control is located on the map, relative to each other, and the course details.
  • Can be created before the event and kept confidential

Steps to create the Courses Data using Condes Software:

  1. Export courses data as XML format: (“File” / “Export Data” / “XML”) – choose IOF XML 2.0.3 format.

Steps to create the Courses Data using OCAD Software:

Note: Routegadget does not support IOF XML 3.0 Format. Please export “IOF XML 2.0.3 format” for course data.

  1. Start OCAD and open the Event Course Setting file
  2. In the right hand side Courses panel, In the Course drop down box select All controls and click on the Preview button.
  3. Reset the location of the control letters, as if they are not in their default location problems will occur later on when you try to align everything in routegadget.
    i.e. Courses panel > Course: <All Controls> > Preview >  Reset (All control code text/numbers will move to default position)
  4. Select Menu Course > Export > Courses (XML)…
    The Export Courses (XML) file save window displays.
  5. Save the file to the desired location.

Steps to create the Courses Data using OCAD 8 Software:

  1. Start OCAD and open the Event Course Setting file
  2. In the right hand side Courses panel, In the Course drop down box select All controls and click on the Preview button.
  3. Reset the location of the control letters, as if they are not in their default location problems will occur later on when you try to align everything in routegadget. i.e. Courses panel > Preview > Settings > Default (All control code text/numbers will move to default position)
  4. Export all controls (including start and finish codes) by selecting File > Export > DXF
  5. Export courses by selecting File > Export courses…
    Follow the dialog boxes and save the files. This results in two files being generated: “courses.txt” and “anyname.dxf” (Where anyname is the filename you choose)

2. Controller creates Results and the Splits file (After Event)

The Controller checks the results and finalises the results. Once the results have been finalised and approved, they can generate the results for publishing on the club website and the splits file for upload into winsplits and routegadget.

2.1. Creating the Split file

  • This is created after the event has finished.

Using SportSoftware’s Sport Ident OE2003 software:

  1. Select Competition day > Results
    The Results window displays.
  2. Select Split times
    The Select Report window displays.
  3. In the “Report type:”  section select Classes
  4. In the “Split time results:” section select Standard
  5. Select OK
    The Split Time Results window displays.
  6. Select Interface
  7. In the File format: section specify CSV
  8. Enter the filename
  9. Click OK

3. Log into RouteGadget Manager area and add your event

3.1 Log into Routegadget Manager on rg.orienteering.org.nz

  1. In your Internet web browser visit:
    http://rg.orienteering.org.nz/gadget/cgi-bin/manager/reittimanager.cgi
    The RouteGadgetManager login web page will display.
  2. Enter the username and password and click “OK”.
    The username & password can be requested by emailing webmaster@orienteering.org.nz
    The RouteGadget Manager Menu will display.

3.2 Add Your Event

  1. Click the Link “Add new event”.
    The Adding new event page will display.
  2. Select the appropriate radio button for each section and click “OK”.
    For example, generally for OCAD9 and OE2003:
  • Raster map: select “1. Load new map”
  • Results add split times: select “SportIdent CSV”
  • Course settings: select “IOF-XML (Condes, Ocad9), no forking (Individual race)”
  • Leave “Use pre-loaded split time file”

The Adding new event page will display based on the options selected.

  1. Fill in all the requested fields and select the files for upload by clicking on the “browse” buttons
  2. When completed Click “OK”.
    The results of the upload of the files are displayed.
  3. Click on link “Adjust controls on the map”.
    The RouteGadget java application starts and displays the background map on the left and control panel on the right.
  4. In the Control Panel Choose Competitors section, change the “Choose class/course” drop down box and select All controls.
    The control circles are shown on the map.
  5. Zoom by clicking on the +/ zoom buttons so you can see all of the controls. There may be some outside the map area.
  6. Align the control circles into their correct position on the map.
    Repeat the following steps until they are all positioned in the correct location:

    • Click “Fit
    • Click the center of one control on the top left side of the bunch of controls.
    • Click the center of the correct position of that control on the map.
    • Click the center of one control on the bottom right side of the bunch of controls.
    • Click the center of the correct position of that control on the map.
      On completion, the control circles will reposition on the map.

Note:

  • You can zoom in and out during this process by clicking on +/-.
  • It may take multiple attempts to position them correctly
  • You can drag the map by clicking the mouse on a blank part of the map and dragging the map and then releasing the mouse. If you click and release on the same spot of the map it will assume you are selecting the position.
  • If something goes wrong, you can start adjusting from the beginning by reloading the page in your browser.
  • If you accidentally close the browser window or need to redo it, go back to the Managers menu, delete the event, and add it again.
  • If the controls do not align on the map correctly, go back and recreate the courses data file (XML/dxf/txt file). In OCAD, make sure you reset the location of the control letters, as if they are not in their default location problems will occur. i.e. Courses panel > Preview > Settings > Default (All control code text/numbers will move to default position)
  1. Check all controls are positioned correctly and click “Save”.
    The Select courses for classes page displays.
  2. For each course, make sure the correct class/course from the results file is selected.
  3. When all are correctly matched, Click “OK
    If all everything works correctly, the page will change to display “Ready – Valmis!!!!”
  4.  Click on “Manager Logout
    Logout OK! will be displayed.
  5. Click on link “Back to RouteGadget
    The Routegadget Menu is shown.
  6. Click on your event.
  7. Test the event is working correctly.

Steps to create a link on your club websites results page directly to your event on RouteGadget

  1. Use your internet browser to visit rg.orienteering.org.nz
  2. Click on the link Access NZ RouteGadget
    The list of Events in Routegadget appears.
  3. Right click on the Event name you wish to use
  4. Copy the Internet link.
    Firefox users: Select “Copy Link Location…”
    IE users: Select “Copy Shortcut”
    Safari users: “Copy Link”
  5. Paste the address as the address in the results of your website.
  6. Test the link works as expected.

Contact:

Roger Woodroofe, ONZ Online Coordinator webmaster@orienteering.org.nz

 

Share this on:

LOGIN