- 29 May 2024
- 7 Minutes to read
- Print
- DarkLight
- PDF
Managing Navigation Graphs
- Updated on 29 May 2024
- 7 Minutes to read
- Print
- DarkLight
- PDF
A navigation graph enables Routing and positioning. You can only generate a navigation graph once you have created an alignment bundle.
Generating a Navigation Graph
Note: Only use automatic navigation graph generation for regular indoor environments or spaces with a similar degree of structure. For large open spaces and empty planes, we recommend editing a navigation graph manually.
Go to Site Setup > Dataset Management.
If you are generating a navigation graph for the first time, click Create maps and navgraph next to the Alignment Bundle for which you want to generate a navigation graph.
If you have already added a navigation graph and want to regenerate it, open the Advanced drop-down menu and click Recreate Navgraph.
Click Publish when you have finished.
Editing a Navigation Graph
It may be necessary to manually edit the navigation graph in the case of stairs, elevators, and disconnected areas. Nodes in areas that are not walkable, i.e. nodes on top of tables, should also be removed.
Note: Press ? to view a list of available keyboard shortcuts that you can use when editing your navigation graph.
![A screenshot of a computer shortcut Description automatically generated](http://cdn.document360.io/bf174766-fa1a-4fe1-a4d7-b1db1e7cb996/Images/Documentation/image-1706107153975.png?sv=2022-11-02&spr=https&st=2024-09-08T02%3A27%3A45Z&se=2024-09-08T02%3A37%3A45Z&sr=c&sp=r&sig=EGS7va9qeDKJijjiIjvbHaOxqU2hV8SQMfy7GpZeIS4%3D)
Adding New Nodes
Go to Site Setup > Navigation Graph Editor.
To add nodes in the 2D view:
Select the Path Drawing Tool in the top right corner of your screen.
Select a node to specify a starting point for your path.
Draw a path by clicking each time you want to place a node.
If you want to delete a node, press the backspace key or select the node, right-click on it and select Delete Node.
Click Done.
Click Save.
To add nodes in the 3D view:
Right-click where you want to add a new node.
Select + Create Node from the context menu.
If you want to delete a node, press the backspace key or select the node, right-click on it and select Delete Node.
Select another node to which you can connect the node you have just created.
Click Create Edge in the Edit nodes and edges section of the menu.
Click Save.
Click Publish when you have finished.
Adjusting the Location of Nodes
Go to Site Setup > Navigation Graph Editor.
Select the Node Editing Tool in the top right corner of your screen.
Select the node that you want to move.
Drag the node to the desired location.
Click Save.
![Adjusting_the_location_of_the_nodes](http://cdn.document360.io/bf174766-fa1a-4fe1-a4d7-b1db1e7cb996/Images/Documentation/Adjusting_the_location_of_the_nodes.gif?sv=2022-11-02&spr=https&st=2024-09-08T02%3A27%3A45Z&se=2024-09-08T02%3A37%3A45Z&sr=c&sp=r&sig=EGS7va9qeDKJijjiIjvbHaOxqU2hV8SQMfy7GpZeIS4%3D)
Adjusting the Height of Nodes
The height of the nodes in your path depends on the node you choose as the starting point and, if applicable, as the end point. If you connect two pre-existing nodes with different heights, the nodes in between will gradually increase or decrease in height based on a calculation of distance and height difference between the starting point and the end point. If you only specify a starting point, the height of this node will be applied to the other nodes of the path.
Go to Site Setup > Navigation Graph Editor.
Select a node by clicking on it.
Once you have selected a node, the Change node z-level tool will appear on the right side of your screen.
Select the desired unit of length from the drop-down menu.
Use the arrows pointing up and down to adjust the height of the node.
Click Save.
![Adjusting_the_height_of_the_nodes](http://cdn.document360.io/bf174766-fa1a-4fe1-a4d7-b1db1e7cb996/Images/Documentation/Adjusting_the_height_of_the_nodes.gif?sv=2022-11-02&spr=https&st=2024-09-08T02%3A27%3A45Z&se=2024-09-08T02%3A37%3A45Z&sr=c&sp=r&sig=EGS7va9qeDKJijjiIjvbHaOxqU2hV8SQMfy7GpZeIS4%3D)
6. Click Publish when you have finished.
Auto-Splitting Edges
If you want to use your navigation graph with the Positioning SDK, the graph should have edges that are approximately one meter apart.
Go to Site Setup > Navigation Graph Editor.
Select two nodes.
Open the Advanced menu.
Click Auto-Split Edge.
Click Save.
![auto-slit_edges](http://cdn.document360.io/bf174766-fa1a-4fe1-a4d7-b1db1e7cb996/Images/Documentation/auto-slit_edges.gif?sv=2022-11-02&spr=https&st=2024-09-08T02%3A27%3A45Z&se=2024-09-08T02%3A37%3A45Z&sr=c&sp=r&sig=EGS7va9qeDKJijjiIjvbHaOxqU2hV8SQMfy7GpZeIS4%3D)
6. Click Publish when you have finished.
Connecting Floors via Elevators
In order to allow Routing via elevators, elevators must be added manually to the navigation graph.
Go to Site Setup > Navigation Graph Editor.
Turn on the 3D view to be able to see the elevators clearly and to change between floors easily.
Identify the existing elevators in the building.
Create a node inside each elevator on each floor by right-clicking and selecting + Create Node.
Make sure that the nodes are placed at floor level.
Connect each elevator node to the navigation graph outside the elevator by selecting two nodes and clicking Create Edge.
Connect the elevator nodes to each other vertically by selecting two nodes and clicking Create Edge.
Note: Use only one edge between each pair of nodes and only connect floors directly above and below each other.
8. Click Publish when you have finished.
Connecting Floors via Stairs
In order to route via stairs, you must make sure that the navigation graph fully connects the different floors of your building.
Go to Site Setup > Navigation Graph Editor.
Turn on the 3D view to be able to see the stairs clearly and to change between floors easily.
Identify all stairs in the building.
For each staircase, check whether the navigation graph fully connects both floors.
If the navigation graph does not connect both floors, create a single path of nodes that connects the navigation graph on one floor to the navigation graph on the floor above or below. Right-click and select + Create Node to place new nodes.
Note: Make sure that:
The path is located on top of the stairs.
Stair landings are covered by nodes as well.
Create edges between the nodes by selecting two nodes and clicking Create Edge.
Make sure that the nodes are approximately one meter apart. If necessary, auto-split the edges.
Click Save.
Click Publish when you have finished.
Excluding paths and areas from routing
Exclude path
If you do not want an automatically generated path to be available, exclude it from the navigation graph by deleting the edges and nodes along the path.
Go to Site Setup > Navigation Graph.
Delete all edges and nodes along the path.
To delete an edge, select the two end nodes and click Delete edge.
To delete a node, select the node and click Delete.
Click Save and Publish the changes.
Routing will avoid the excluded path and find a route based on other nodes in the navigation graph.
Exclude Area
To exclude an entire area from the navigation graph, delete all the nodes within the area.
Go to Site Setup > Navigation Graph.
Delete all nodes in an area. Select each node and click Delete.
Click Save and Publish the changes.
A route will not be calculated to or from an area that is excluded from the navigation graph.
![routing_cannot_be_calculated.PNG](http://cdn.document360.io/bf174766-fa1a-4fe1-a4d7-b1db1e7cb996/Images/Documentation/image-1716993682621.png?sv=2022-11-02&spr=https&st=2024-09-08T02%3A27%3A45Z&se=2024-09-08T02%3A37%3A45Z&sr=c&sp=r&sig=EGS7va9qeDKJijjiIjvbHaOxqU2hV8SQMfy7GpZeIS4%3D)
Creating a Navigation Graph in Unmapped Spaces
NavVis IVION does not support the automatic generation of a navigation graph in unmapped spaces. Routes in unmapped spaces, for example between buildings, can only be generated if you manually draw a navigation graph in those areas.
Procedure
Go to Site Setup > Navigation Graph Editor.
Turn on the 2D view.
Check where the unmapped spaces are in your site. These are the areas for which no navigation graph has been generated automatically.
Select the Path Drawing Tool in the top right corner of your screen.
Select a node near an unmapped area.
Draw a path by clicking each time you want to place a node.
Either connect your node path to another existing node or finish the node path in an unmapped area.
Click Done.
Click Save.
![Navgraph_unmapped_areas(1).gif](http://cdn.document360.io/bf174766-fa1a-4fe1-a4d7-b1db1e7cb996/Images/Documentation/Navgraph_unmapped_areas(1).gif?sv=2022-11-02&spr=https&st=2024-09-08T02%3A27%3A45Z&se=2024-09-08T02%3A37%3A45Z&sr=c&sp=r&sig=EGS7va9qeDKJijjiIjvbHaOxqU2hV8SQMfy7GpZeIS4%3D)
10. Click Publish when you have finished.
Refer to Quality Checking a Site on what to look for when checking the quality of your navigation graph.
Deleting a Navigation Graph
Go to Site Setup > Dataset Management.
In the Alignment Bundles section, open the Advanced drop-down menu.
Click Remove navgraph.
Click Publish when you have finished.
Resetting a Navigation Graph
Follow these steps to reset the navigation graph to its first automatically generated version or reinstate it after removing it.
Go to Site Setup > Dataset Management.
In the Alignment Bundles section, open the Advanced drop-down menu.
Click Recreate navgraph.
Click Publish when you have finished.
The automatically generated navigation graph will appear again.