Route Analyzer: Difference between revisions

From OCAD Wiki - English
Jump to navigation Jump to search
No edit summary
 
(19 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This function is available in course setting projects for sprint orienteering maps.<br>  
This function is available in all types of course setting projects (forest, urban, Ski-O, MTBO-O).<br>  
It helps you to see and evaluate possible routechoises between two controls.<br>  
It shows the fastest route between two controls.<br>  
You will also get the shortest route for each course.


[[File:Hint.jpg]] --> See a '''[https://youtu.be/XbHSJn_2yXU short video on Youtube]''', which explains you the basics.
[[File:Hint.jpg]] See the '''[https://youtu.be/azImCB3ms9Y explanation video on Youtube]''', which gives you an introduction to how the Route Analyzer 2.0 works and how to use it.
 
[[File:Hint.jpg]] To try out the Route Analyzer, you can download sample data [https://www.ocad.com/downloads/RouteAnalyzer2.0-DemoData.zip here].
 
[[File:RouteAnalyzer2p0.gif]]


==Open Route Analyzer [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
==Open Route Analyzer [[File:Space.PNG]][[File:Mas40px.PNG|This function is available in OCAD Mapping Solution.|link=https://www.ocad.com/en/products/ocad-for-cartography]][[File:Ori40px.PNG|This function is available in OCAD Orienteering.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:Sta40px.PNG|This function is available in OCAD Starter.|link=https://www.ocad.com/en/products/ocad-for-orienteering]][[File:CS40px.PNG|This function is available in OCAD Course Setting.|link=https://www.ocad.com/en/products/ocad-for-orienteering]]==
Line 9: Line 12:
[[File:RouteAnalyser bar.png]]
[[File:RouteAnalyser bar.png]]


==How it works==
==Requirements==
When you run the Route Analyzer the first time, the function will need some time to proceed all necessary steps to show possible routes.<br>
To find the fastest route, the Route Analyzer takes into account the '''distance, the relief and the runnability'''. To use the full functionality of the Route Analyzer, you therefore need two things:
This includes:
 
*Up-to-date Map
:The map should be based on a digital Elevation model.
:The map should contain an up-to-date symbol set
 
''In order to take the runnability into account, resistance values are assigned to the individual map symbols. If their properties (symbol number, color values, line thickness, etc.) are within a range defined by OCAD, an assignment is made. An up-to-date symbol set that complies with the map specifications of IOF is therefore advantageous.<br>
See '''[[Symbol_Set_Conversion|here]]''' how to update a symbol set.
 
*Digital Elevation Model (DEM)
:A DEM has to be loaded in the course setting project
:The DEM can be linked or embedded in the map file or course setting file
 
A special compressed and optimized ocdCsDem can be created, which has a greatly reduced file size with no loss of quality for the route calculation.
This makes it easier to pass the DEM to course setters.<br>
See '''[[DEM#Create_optimized_DEM_for_Course_Setting|here]]''' how to create an optimized DEM.
 
==Run the Route Analyzer==
When you run the Route Analyzer the first time, the function will need some time to proceed all necessary steps to create a routing graph.<br>
 
Once the routing graph is created, the calculation of the route itself will be quite fast, depending on the length and complexity of the route.<br>


* Process impassible features
The fastest option is displayed with a solid blue line. Alternative routes will be shown in red color.<br>
* Create graph nodes
* Connect nodes
* Calculate routes


The larger your map is, the more time it will take to prepare the map. The calculation of the route itself will be quite fast. You can follow the progress in the lower left corner of the OCAD window.<br>
For urban sprint courses, alternative routes will be calculated automatically. Other alternative routes can be added with via points.<br>  
If you calculate additional routes, it will be much faster, as the function doesn't need to prepare the map again.<br>
Here, too, the longer and more complex the route is, the longer it takes to calculate.


The shortest option is displayed with a solid blue line. The distance of the route is also shown with a text symbol.<br>
The distance, climbing and expected running time are displayed for each route with a text object or at in the status bar in the lower left corner.<br>
Alternative routes are shown in red color.


==Route Analyzer Box==
==Route Analyzer Box==
You can either calculate only a route between two points, the whole route of a course or the routes for all courses at once.<br>
You can either analyze only a route between two points, the whole route of a course or the routes for all courses at once.<br>
There are many ways to display the routes.
 
[[File:RouteAnalyzer bar.png]]
 
===Perimeter===
* '''Entire Map''': Set by default. The larger your map is, the more time it will take to create the routing graph.
* '''Define on map''': It makes sense to define a perimeter, if the running area covers only a small part of the map. Click the [[File:Properties.PNG]] button to draw a perimeter on the map. The perimeter will be shown with a turquoise line. Routes will only be analyzed in this perimeter.
 
===Settings===
====Elevation====
Activate the checkbox to use the elevation for route calculation.<br>
Click the [[File:Properties.PNG]] button to load a digital elevation model.<br>
If a DEM is already loaded or embeded into the map file or course setting file, it will be shown here.<br>
 
The climb impact factor for route calculation is reduced for sprint courses.
 
====Runnability====
The checkbox to consider the runnabiltiy for route calculation is set by default. It can be uncheck for sprint orienteering courses.<br>
The values are based on assumptions and can be changed here. It is well known that the forest is not equally runnable depending on region and season. Click the '''Reset''' button to restore the default values.
 
'''Base Speed''' is used to estimated the running time between two controls.
200 sec/km for men and 230 sec/km for women can be used for route time calculation on an international level.


[[File:RouteAnalyser bar open.png]]
[[File:Hint.jpg]] If both '''Elevation''' and '''Runnability''' is unchecked (e.g. for flat urban areas or if no DEM is available), OCAD will use a different algorithm to calculate the routes. In this case, elevation and runnability will not be considered and the shortest route will be shown (as in Route Analyzer before August 2023).


===Define the perimeter===
[[File:RA Settings.png]]
* '''Entire Map''': This may take quite long time to prepare the map, depending on its size.
* '''Define perimeter''': Draw a perimeter on the map. The perimeter will be shown with a light blue line. Routes will only be analyzed in this perimeter.


===Draw leg and analyze route===
===Draw leg and analyze route===
Line 47: Line 81:
# Touch an existing route on the map and release where the new route should pass. The route is calculated again.
# Touch an existing route on the map and release where the new route should pass. The route is calculated again.
# Insert multiple via points by pressing the SHIFT key.
# Insert multiple via points by pressing the SHIFT key.
Alternative routes are shown in red color.


===Analyze routes (current course)===
===Analyze routes (current course)===
Line 53: Line 89:
# All routes will be saved in the '''Route Box'''.
# All routes will be saved in the '''Route Box'''.


A Text-File will be created to '''[[Route_Analyzer#Adjust_Course_Length|adjust the course length]].
A Text-File will be created with leg and course details.


===Analyze routes (all courses)===
===Analyze routes (all courses)===
Line 59: Line 95:
# All routes for all courses will be calculated and will be saved in the '''Route Box'''.<br>
# All routes for all courses will be calculated and will be saved in the '''Route Box'''.<br>


A Text-File will be created to '''[[Route_Analyzer#Adjust_Course_Length|adjust the course length]].
A Text-File will be created with leg and course details.


===Reset routing graph===
===Reset routing graph===
Click on '''Reset routing graph''' to process again all impassible features and build up the nodes. <br>
Click on '''Reset routing graph''' to build up the routing graph again next time you calculate a route. <br>
This may be necessary if you detect a mistake in your map (e.g. an unwanted gap between two impassible features), which can be seen in the function '''[[Show_Impassable_Features|Show Impassable Features]]'''.<br>
This may be needed in following situations:
After you corrected the mistake in your ''[Map File]'', you need to reset the routing graph, before calculating new routes.
* Updating map file
* Updating runnability values
* Using another DEM
* Fixing a mistakes in the map file (e.g. an unwanted gap between two impassible features) , which can be seen in the function '''[[Show_Impassable_Features|Show Impassable Features]]'''
* Changing forbidden areas or lines in the course setting project


===Route Box===
===Route Box===
All calculated routes will be shown in the '''Route Box'''.<br>
All calculated routes will be shown in the '''Route Box'''.<br>
You see on the left side, if the route is visible or not. The right side shows you between which two controls the route has been calculated.<br>
You see on the left side, if the route is visible or not. The right side shows you between which two controls the route has been calculated.<br>
Right-click on a route to rename or delete it.
[[File:RouteAnalyser routeBox.png]]
[[File:RouteAnalyser routeBox.png]]


Line 81: Line 124:
Delete all routes in the '''Route Box'''.
Delete all routes in the '''Route Box'''.


==Adjust Course Length==
==Adjust Course Details==
When you click on '''Analyze routes (current course)''' or '''Analyze routes (all courses)''', a .txt-File will be created in the same folder, where your course setting project is saved.<br>
When you click on '''Analyze routes (current course)''' or '''Analyze routes (all courses)''', a .txt-File will be created in the same folder, where your course setting project is saved. This txt file contains a summary of all routes, as well as a summary for each course separately.<br>
 
The values can be added to the '''[[Create_a_New_Course|Courses]]''' dialog, e.g. add ''Extra length'' for sprint courses or add ''Climb used''.
 
Example:
Example:
Course Setting Project.Course 1.shortestRouteLengths.txt
 
Course Setting Project.AllLegsRouteLengths.txt
[[File:CourseLengths.png]]
[[File:ShortestRouteLength.png]]
*'''Length''': The length of your course.
*'''Length''': The length of your course.
*'''Extra length''': The difference between the shortest possible route of the course and the course length.
*'''Extra length''': The difference between the fastest calculated route of the course and the course length.
[[File:Hint.jpg]] For Sprint Orienteering Courses, it is common to show the length of the ideal route and not the course length. Add the '''Extra length''' value to the corresponding field in the '''[[Create_a_New_Course|Courses]]''' dialog.
[[File:Hint.jpg]] For sprint orienteering courses, it is common to show the length of the ideal route and not the course length. Add the '''Extra length''' value to the corresponding field in the '''[[Create_a_New_Course|Courses]]''' dialog.
*'''Climb along route''': If there is a '''[[DEM]]''' loaded in the course setting project, climbing is calculated along the shortest route.
*'''Climb along course''': Total climbing along the fastest calculated route.
*'''Time along course''': Predicted running time of the course.


==Limits of the function==
==Limits of the function==
The Route Analyzer is a great function. However, it's not working in every situation.<br>
The function can't deal with different running levels, e.g. underpass, overpass, bridges or tunnels.<br>
These are the limits of the function:
[[File:RouteAnalyser bridge.png]]<br>
*The function is not (yet) considering the runnability. It only distinguish between passable and impassable features. The fastest route may go through a green area.<br>  
 
*:Positive side effect: You may notice routes that you have not thought off before (e.g. possible route through green area).
===Possible errors===
[[File:RouteAnalyser vegetation.png]]


*The function can't deal with different running levels, e.g. underpass, overpass, bridges or tunnels.<br>
*If symbol assignment is not working (e.g. straight lines from one control to another; routes are going through buildings or private areas), check if the '''[[Symbol#Edit|symbol number]]''' and '''[[Colors|color values]]''' corresponds to the '''[[Symbol_Set_Overview|IOF standard]]'''. Use the function '''[[Symbol_Set_Conversion|Symbol Set Conversion]]''' to update an old symbol set to the lastest version.
[[File:RouteAnalyser bridge.png]]<br>
 
*If no routes are shown at all, check if there is a different '''[[Create_a_New_Map#Set_Scale_and_Coordinate_System|offset]]''' in your Course Setting Project and Map File. If yes, use the '''[[Map_Transform#Center_Map_in_Drawing_Area|Center Map in Drawing Area]]''' function to get the same offset.


*Further mistakes may also be a result of bad map drawing. Check the function '''[[Show_Impassable_Features|Show Impassable Features]]'''.
*Further mistakes may also be a result of bad map drawing. Check the function '''[[Show_Impassable_Features|Show Impassable Features]]'''.
[[File:RouteAnalyser ImpassibleFeatures.png]]
[[File:RouteAnalyser ImpassibleFeatures.png]]


==Editing the routes==
*Feel free to contact OCAD Support if there are questions (ifno@ocad.com).
You can edit the routes and labels manually. Just click on the routes and edit them. The length will not yet be adjusted automatically.
{|
|style="width:200px;" |Shift + Ctrl + [[File:Icon SelectObjectAndEditVertex.PNG]]||[[Vertices#Add_Normal_Vertex|Add Vertex]]
|-
|Ctrl + [[File:Icon SelectObjectAndEditVertex.PNG]]||[[Vertices#Remove_Vertex|Remove Vertex]]
|-
|Ctrl + [[File:Icon RemoveVertex.PNG]] + Mouse||[[Vertices#Remove_Vertex|Remove Vertex]] with ''Mouse Over''.
|}
 
See the '''[[Tips_with_Keyboard_and_Mouse#Editing|Tips with Keyboard and Mouse]]''' page or the '''[[Select#Select_Object_and_Edit_Vertex|Select Object and Edit Vertex]]''' page for more information.


==Last but not least==
==Last but not least==
Line 122: Line 158:




- The graph is automatically saved in the course setting project directory after calculating the first route (if the option "whole map" is selected) and reloaded when the file is opened again.  
- The graph is automatically saved in the course setting project directory after calculating the first route and reloaded when the file is opened again.  
For that, three files are saved in the folder of the course setting project:
For that, different files are saved in the folder of the course setting project:


*[FILENAME CS PROJECT].ocdGraph
*[FILENAME CS PROJECT].ocdGraph
*[FILENAME CS PROJECT]. ~imp.tiff
*[FILENAME CS PROJECT]. ~imp.tiff
*[FILENAME CS PROJECT]. ~imp.tfw
*[FILENAME CS PROJECT]. ~imp.tfw
*[FILENAME CS PROJECT]. ~run.tiff
*[FILENAME CS PROJECT]. ~run.tfw


Whether a graph has been loaded or not can be seen by the fact that the "Reset routing graph" button is active.  
Whether a graph has been loaded or not can be seen by the fact that the "Reset routing graph" button is active.  




 
- Credit goes to Fabian Hertner who helped us to develop the Route Analyzer with his ideas and knowledge.
- Credit goes to Fabian Hertner who helped us to develop this function with his ideas and knowledge.

Latest revision as of 00:10, 22 November 2023

This function is available in all types of course setting projects (forest, urban, Ski-O, MTBO-O).
It shows the fastest route between two controls.

Hint.jpg See the explanation video on Youtube, which gives you an introduction to how the Route Analyzer 2.0 works and how to use it.

Hint.jpg To try out the Route Analyzer, you can download sample data here.

RouteAnalyzer2p0.gif

Open Route Analyzer Space.PNGThis function is available in OCAD Mapping Solution.This function is available in OCAD Orienteering.This function is available in OCAD Starter.This function is available in OCAD Course Setting.

When you are in a Course Setting project, you will see a purple bar at the right side called Route Analyzer. Click on it and the bar will open.
RouteAnalyser bar.png

Requirements

To find the fastest route, the Route Analyzer takes into account the distance, the relief and the runnability. To use the full functionality of the Route Analyzer, you therefore need two things:

  • Up-to-date Map
The map should be based on a digital Elevation model.
The map should contain an up-to-date symbol set

In order to take the runnability into account, resistance values are assigned to the individual map symbols. If their properties (symbol number, color values, line thickness, etc.) are within a range defined by OCAD, an assignment is made. An up-to-date symbol set that complies with the map specifications of IOF is therefore advantageous.
See here how to update a symbol set.

  • Digital Elevation Model (DEM)
A DEM has to be loaded in the course setting project
The DEM can be linked or embedded in the map file or course setting file

A special compressed and optimized ocdCsDem can be created, which has a greatly reduced file size with no loss of quality for the route calculation. This makes it easier to pass the DEM to course setters.
See here how to create an optimized DEM.

Run the Route Analyzer

When you run the Route Analyzer the first time, the function will need some time to proceed all necessary steps to create a routing graph.

Once the routing graph is created, the calculation of the route itself will be quite fast, depending on the length and complexity of the route.

The fastest option is displayed with a solid blue line. Alternative routes will be shown in red color.

For urban sprint courses, alternative routes will be calculated automatically. Other alternative routes can be added with via points.

The distance, climbing and expected running time are displayed for each route with a text object or at in the status bar in the lower left corner.

Route Analyzer Box

You can either analyze only a route between two points, the whole route of a course or the routes for all courses at once.

RouteAnalyzer bar.png

Perimeter

  • Entire Map: Set by default. The larger your map is, the more time it will take to create the routing graph.
  • Define on map: It makes sense to define a perimeter, if the running area covers only a small part of the map. Click the Properties.PNG button to draw a perimeter on the map. The perimeter will be shown with a turquoise line. Routes will only be analyzed in this perimeter.

Settings

Elevation

Activate the checkbox to use the elevation for route calculation.
Click the Properties.PNG button to load a digital elevation model.
If a DEM is already loaded or embeded into the map file or course setting file, it will be shown here.

The climb impact factor for route calculation is reduced for sprint courses.

Runnability

The checkbox to consider the runnabiltiy for route calculation is set by default. It can be uncheck for sprint orienteering courses.
The values are based on assumptions and can be changed here. It is well known that the forest is not equally runnable depending on region and season. Click the Reset button to restore the default values.

Base Speed is used to estimated the running time between two controls. 200 sec/km for men and 230 sec/km for women can be used for route time calculation on an international level.

Hint.jpg If both Elevation and Runnability is unchecked (e.g. for flat urban areas or if no DEM is available), OCAD will use a different algorithm to calculate the routes. In this case, elevation and runnability will not be considered and the shortest route will be shown (as in Route Analyzer before August 2023).

RA Settings.png

Draw leg and analyze route

You can calculate routes only between two points.

  1. Click on Draw leg and analyze route. RouteAnalyzer DrawLeg.png
  2. Click and drag a line in the OCAD window.
  3. Repeat these two steps for further routes.

The routes will be saved in the Route Box.

Add route via point(s)

  1. Click on Add route via point(s). RouteAnalyzer AddViaPoint.png
  2. Touch an existing route on the map and release where the new route should pass. The route is calculated again.
  3. Insert multiple via points by pressing the SHIFT key.

Alternative routes are shown in red color.

Analyze routes (current course)

  1. Select a course in the Course Box.
  2. Click on Analyze routes (current course).
  3. All routes will be saved in the Route Box.

A Text-File will be created with leg and course details.

Analyze routes (all courses)

  1. Click on Calculate routes (all courses).
  2. All routes for all courses will be calculated and will be saved in the Route Box.

A Text-File will be created with leg and course details.

Reset routing graph

Click on Reset routing graph to build up the routing graph again next time you calculate a route.
This may be needed in following situations:

  • Updating map file
  • Updating runnability values
  • Using another DEM
  • Fixing a mistakes in the map file (e.g. an unwanted gap between two impassible features) , which can be seen in the function Show Impassable Features
  • Changing forbidden areas or lines in the course setting project

Route Box

All calculated routes will be shown in the Route Box.
You see on the left side, if the route is visible or not. The right side shows you between which two controls the route has been calculated.

Right-click on a route to rename or delete it.

RouteAnalyser routeBox.png

Show current course routes

Shows the routes of the select course in the Course Box. All routes of this course will be visible in the Route Box, all other routes will be hidden.

Show all routes

Show all routes in the Route Box.

Hide all routes

Hide all routes in the Route Box.

Delete all routes

Delete all routes in the Route Box.

Adjust Course Details

When you click on Analyze routes (current course) or Analyze routes (all courses), a .txt-File will be created in the same folder, where your course setting project is saved. This txt file contains a summary of all routes, as well as a summary for each course separately.

The values can be added to the Courses dialog, e.g. add Extra length for sprint courses or add Climb used.

Example:

CourseLengths.png

  • Length: The length of your course.
  • Extra length: The difference between the fastest calculated route of the course and the course length.

Hint.jpg For sprint orienteering courses, it is common to show the length of the ideal route and not the course length. Add the Extra length value to the corresponding field in the Courses dialog.

  • Climb along course: Total climbing along the fastest calculated route.
  • Time along course: Predicted running time of the course.

Limits of the function

The function can't deal with different running levels, e.g. underpass, overpass, bridges or tunnels.
RouteAnalyser bridge.png

Possible errors

  • If symbol assignment is not working (e.g. straight lines from one control to another; routes are going through buildings or private areas), check if the symbol number and color values corresponds to the IOF standard. Use the function Symbol Set Conversion to update an old symbol set to the lastest version.
  • If no routes are shown at all, check if there is a different offset in your Course Setting Project and Map File. If yes, use the Center Map in Drawing Area function to get the same offset.

RouteAnalyser ImpassibleFeatures.png

  • Feel free to contact OCAD Support if there are questions (ifno@ocad.com).

Last but not least

- Achtung.PNG Before printing/exporting your courses, be sure that all the calculated routes are hidden or deleted.
You probably don't want to give a map to the runners with all measured routes on it.


- The graph is automatically saved in the course setting project directory after calculating the first route and reloaded when the file is opened again. For that, different files are saved in the folder of the course setting project:

  • [FILENAME CS PROJECT].ocdGraph
  • [FILENAME CS PROJECT]. ~imp.tiff
  • [FILENAME CS PROJECT]. ~imp.tfw
  • [FILENAME CS PROJECT]. ~run.tiff
  • [FILENAME CS PROJECT]. ~run.tfw

Whether a graph has been loaded or not can be seen by the fact that the "Reset routing graph" button is active.


- Credit goes to Fabian Hertner who helped us to develop the Route Analyzer with his ideas and knowledge.