Skip to content

Commit 834083a

Browse files
committed
update npc map navigation doc
1 parent 167dce5 commit 834083a

File tree

3 files changed

+13
-11
lines changed

3 files changed

+13
-11
lines changed

Docs/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ Visit our Github here: [https://github.com/lgsvl/simulator](https://github.com/l
1414
* [Running with Autoware](autoware-instructions.md)
1515
* [Running with Apollo](apollo-instructions.md)
1616
* [Map Annotation](map-annotation.md)
17+
* [NPC Map Navigation](npc-map-navigation.md)
1718
* [Ground truth obstacles](perception-ground-truth.md)
1819
* [Simulator controls](keyboard-shortcuts.md)
1920

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
1-
# Simulator - NPC Map Navigation
1+
# NPC Map Navigation
22

3-
![NPCSetup](images/NPCSetup.jpg)
3+
[![NPCSetup](images/NPCSetup.jpg)](images/full_size_images/NPCSetup.jpg)
44

5-
NPC vehicles now use the MapSegmentBuilder classes to navigate annotated maps.
5+
Non-player character (NPC) vehicles now use the MapSegmentBuilder classes to navigate annotated maps.
66

77

88

99
##### Map Manager
1010

11-
![](images/NPCSetup_MapManager.jpg)
11+
[![](images/NPCSetup_MapManager.jpg)](images/full_size_images/NPCSetup_MapManager.jpg)
1212

1313
Use SanFrancisco.scene as a template to build map data for NPCs.
1414

@@ -17,13 +17,13 @@ Use SanFrancisco.scene as a template to build map data for NPCs.
1717
3. Add MapManager.cs component to this object and save as a <span style='color:blue'>prefab</span> in project assets.
1818
4. The public field, SpawnLanesHolder, of MapManager.cs requires the <span style='color:blue'>MapLaneSegmentBuilder</span> holder transform.
1919
5. The public field, IntersectionsHolder, of MapManager.cs requires the <span style='color:blue'>TrafficLights</span> holder transform. This has intersection meshes and scripts for lights.
20-
6. The public fields, Green, Yellow and Red, are materials for the segmentation camera system. If using the Traffic meshes from SanFrancisco.scene, these need to be added here. If not, IntersectionComponent.cs and associated scripts will need edited.
20+
6. The public fields Green, Yellow, and Red are materials for the segmentation camera system. If using the Traffic meshes from SanFrancisco.scene, these need to be added here. If not, IntersectionComponent.cs and associated scripts will need to be edited.
2121

2222

2323

2424
##### Map Lane and Intersection Grouping
2525

26-
![NPCSetup_IntersectionMapBuilder](images/NPCSetup_MapBuilderIntersectionGroup.jpg)
26+
[![NPCSetup_IntersectionMapBuilder](images/NPCSetup_MapBuilderIntersectionGroup.jpg)](images/full_size_images/NPCSetup_MapBuilderIntersectionGroup.jpg)
2727

2828
1. Create <span style='color:blue'>TrafficLanes</span> holder object as a child of <span style='color:blue'>Map.prefab</span>.
2929
2. Place all <span style='color:blue'>MapLaneSegmentBuilder</span> objects into <span style='color:blue'>TrafficLanes</span> holder object for all non intersection lanes.
@@ -35,23 +35,23 @@ Use SanFrancisco.scene as a template to build map data for NPCs.
3535

3636
##### Map Intersection Builder
3737

38-
![NPCSetup_IntersectionMapBuilder](images/NPCSetup_IntersectionMapBuilder.jpg)
38+
[![NPCSetup_IntersectionMapBuilder](images/NPCSetup_IntersectionMapBuilder.jpg)](images/full_size_images/NPCSetup_IntersectionMapBuilder.jpg)
3939

4040
1. For each <span style='color:blue'>Intersection</span> holder, add the MapIntersectionBuilder.cs component.
4141

4242

4343

4444
##### Traffic Lights
4545

46-
![NPCSetup_TrafficLight01](images/NPCSetup_TrafficLight01.jpg)
46+
[![NPCSetup_TrafficLight01](images/NPCSetup_TrafficLight01.jpg)](images/full_size_images/NPCSetup_TrafficLight01.jpg)
4747

4848
1. Create a <span style='color:blue'>TrafficLights</span> holder object to hold all traffic light meshes or place all traffic meshes under the map annotation <span style='color:blue'>Intersections</span>. Just be sure to have the root holder be in MapManager.cs IntersectionHolder public reference.
4949
2. Create a <span style='color:blue'>Intersection</span> holder object. **Be sure its world position is in the center of each intersection.**
5050
3. Add IntersectionComponent.cs to each <span style='color:blue'>Intersection</span> holder object.
5151

5252

5353

54-
![NPCSetup_TrafficLight02](images/NPCSetup_TrafficLight02.jpg)
54+
[![NPCSetup_TrafficLight02](images/NPCSetup_TrafficLight02.jpg)](images/full_size_images/NPCSetup_TrafficLight02.jpg)
5555

5656
1. Place <span style='color:blue'>TrafficLightPole</span> facing it's corresponding <span style='color:blue'>StopLineSegmentBuilder</span> object. **The transfom needs to be Z axis or gizmo arrow forward, parallel to the StopLineSegmentBuilder object Z axis or gizmo arrow forward.**
5757
2. Add IntersectionTrafficLightSetComponent.cs.
@@ -60,7 +60,7 @@ Use SanFrancisco.scene as a template to build map data for NPCs.
6060

6161

6262

63-
![NPCSetup_TrafficLight03](images/NPCSetup_TrafficLight03.jpg)
63+
[![NPCSetup_TrafficLight03](images/NPCSetup_TrafficLight03.jpg)](images/full_size_images/NPCSetup_TrafficLight03.jpg)
6464

6565
1. Add <span style='color:blue'>TrafficLight</span> meshes as children of the <span style='color:blue'>TrafficLightPole</span>.
6666
2. Add IntersectionTrafficLightSetComponent.cs to each <span style='color:blue'>TrafficLight</span>.
@@ -69,6 +69,6 @@ Use SanFrancisco.scene as a template to build map data for NPCs.
6969

7070
##### StopLine and MapLaneSegmentBuilder overlap
7171

72-
![NPCSetup_StopLineAndLaneOverlap](images/NPCSetup_StopLineAndLaneOverlap.jpg)
72+
[![NPCSetup_StopLineAndLaneOverlap](images/NPCSetup_StopLineAndLaneOverlap.jpg)](images/full_size_images/NPCSetup_StopLineAndLaneOverlap.jpg)
7373

7474
**MapLaneSegmentBuilders final waypoint needs to be slightly overlapping the MapStopLineBuilder**

mkdocs.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,5 +20,6 @@ nav:
2020
- 'Running with Autoware': 'autoware-instructions.md'
2121
- 'Running with Apollo': 'apollo-instructions.md'
2222
- 'Map Annotation': 'map-annotation.md'
23+
- 'NPC Map Navigation': 'npc-map-navigation.md'
2324
- 'Ground truth obstacles': 'perception-ground-truth.md'
2425
- 'Keyboard shortcuts': 'keyboard-shortcuts.md'

0 commit comments

Comments
 (0)