Simulation plays a central role in Apollo’s internal development cycle. Dreamland empowers developers and start-ups to run millions of miles of simulation daily, which dramatically accelerates the development cycle.
Simulation plays a central role in Apollo’s internal development cycle.
Dreamland empowers developers and start-ups to run millions of miles of
simulation daily, which dramatically accelerates the development cycle.
So far Apollo simulation allowed external users to access over 200 sample scenarios which includes a diverse range of LogSim scenarios based on real world driving data and WorldSim scenarios that have been manually created by our simulation team. To learn more about Dreamland, refer to [our Dreamland Introduction Guide](../specs/Dreamland_introduction.md)
So far Apollo simulation allowed external users to access over 200 sample
scenarios which includes a diverse range of LogSim scenarios based on real world
driving data and WorldSim scenarios that have been manually created by our
simulation team. To learn more about Dreamland, refer to
Several developers wrote in requesting that our Dreamland platform should support Scenario Creation and Editing which the Apollo team now proudly presents in Apollo 5.0!
Several developers wrote in requesting that our Dreamland platform should
support Scenario Creation and Editing which the Apollo team now proudly presents
in Apollo 5.0!
## Setting up Scenario Editor
1. Login to your Dreamland account. For additional details on How to create an account, please refer to [our Dreamland Introduction Guide](../specs/Dreamland_introduction.md)
1. Login to your Dreamland account. For additional details on How to create an
2. Once inside the platform, the Scenario Editor can be accessed under `Scenario Management` or using the [following link](https://azure.apollo.auto/scenario-management/scenario-editor)
2. Once inside the platform, the Scenario Editor can be accessed under
3. Once inside, you will have to complete the form on the screen as seen in the image below. As this app is in Beta testing, it is not open to all our developers.
3. Once inside, you will have to complete the form on the screen as seen in the
image below. As this app is in Beta testing, it is not open to all our
developers.
4. You should receive the following activation confirmation via email within 3 business days:
4. You should receive the following activation confirmation via email within 3
business days:
## Using Scenario Editor
Congratulations! You are now ready to use our scenario editor.
1. The first step is to select a map. Currently, we offer 2 maps - Sunnyvale and San Mateo
1. The first step is to select a map. Currently, we offer 2 maps - Sunnyvale and
San Mateo
2. Once a map has been selected, you will have access to the editor pane on the right along with other tools as seen below:
2. Once a map has been selected, you will have access to the editor pane on the
right along with other tools as seen below:
You can navigate through the map using your arrow keys. Alternatively, you can right-click the mouse and drag it to move the map. If you are using a trackpad, you will have to double click and then drag with two fingers.
Let's understand each tool along with its purpose
You can navigate through the map using your arrow keys. Alternatively, you can
right-click the mouse and drag it to move the map. If you are using a trackpad,
you will have to double click and then drag with two fingers. Let's understand
each tool along with its purpose
### General Action Tools
The 4 General action tools can be found on the bottom right corner of the map.
1.**Zoom tool**: while you can use your trackpad to zoom in and out of the map, there exists the Zoom tool to help you zoom in and out of the map in case you do not have a trackpad ready.
1.**Zoom tool**: while you can use your trackpad to zoom in and out of the map,
there exists the Zoom tool to help you zoom in and out of the map in case you
do not have a trackpad ready.
2.**Re-center tool**: this tool allows you to locate your ego-car on the map even if you have moved away
2.**Re-center tool**: this tool allows you to locate your ego-car on the map
even if you have moved away
3.**Ruler tool**: this tool allows you to measure the distance between two points. This tool is extremely useful when calculating the distance between the ego-car and obstacles or traffic lights on the map.
3.**Ruler tool**: this tool allows you to measure the distance between two
points. This tool is extremely useful when calculating the distance between
the ego-car and obstacles or traffic lights on the map.
4.**Add Route tool**: this tool can be used both for the ego-car as well as the obstacles you set in its path. For the ego-car you can only set its destination, but for obstacles, you can set multiple points that define their driving behavior.
4.**Add Route tool**: this tool can be used both for the ego-car as well as the
obstacles you set in its path. For the ego-car you can only set its
destination, but for obstacles, you can set multiple points that define their
driving behavior.
### Configuration Tools
There are 4 types of configurations that you will need to set up in order to create a scenario, three of which are listed on the left-side of the map - General, Ego-car and Participants (Obstacles) and the last one is Traffic Light
There are 4 types of configurations that you will need to set up in order to
create a scenario, three of which are listed on the left-side of the map -
General, Ego-car and Participants (Obstacles) and the last one is Traffic Light
#### General Configuration
This configuration tool is selected by default upon the selection of a map. The form on your right requests general scenario information like the scenario name, duration, road structure, ego-car behavior along with which metrics you would like to track. Please note some fields are required while some are based on your discretion. Once you have set and confirmed all the parameters, please proceed to the `Ego Car` configuration tool.
This configuration tool is selected by default upon the selection of a map. The
form on your right requests general scenario information like the scenario name,
duration, road structure, ego-car behavior along with which metrics you would
like to track. Please note some fields are required while some are based on your
discretion. Once you have set and confirmed all the parameters, please proceed
to the `Ego Car` configuration tool.
You can learn more about each parameter by hovering over the `?` sign next to each parameter.
You can learn more about each parameter by hovering over the `?` sign next to
each parameter.
#### Ego Car Configuration
This configuration tool allows you to set your Ego car on the map and configure its parameters. As soon as you select the tool icon, you can then hover over the map and place the car at your desired location. You will notice that your mouse pointer will turn into a cross until you place the ego-car on your map. Once placed, a form should appear on the right-hand side of the map, which allows you to configure the Ego car to set its speed, acceleration, along with your desired destination.
This configuration tool allows you to set your Ego car on the map and configure
its parameters. As soon as you select the tool icon, you can then hover over the
map and place the car at your desired location. You will notice that your mouse
pointer will turn into a cross until you place the ego-car on your map. Once
placed, a form should appear on the right-hand side of the map, which allows you
to configure the Ego car to set its speed, acceleration, along with your desired
destination.
The Ego car's heading can also be set by dragging the arrow linked to the ego car
The Ego car's heading can also be set by dragging the arrow linked to the ego
car
...
...
@@ -87,31 +128,65 @@ Note:
You can set the ego car’s end point by clicking on the “Add Route Point” icon in the lower right corner of the map. Described in the General Action tools section.
```
Once you have placed the Ego car's end point on the map, The end point coordinates will then appear on the right-hand attribute's window. You can drag the end point flag to change the ego car’s end point location. The “End point” coordinates will be automatically updated accordingly.
Once you have placed the Ego car's end point on the map, The end point
coordinates will then appear on the right-hand attribute's window. You can drag
the end point flag to change the ego car’s end point location. The “End point”
coordinates will be automatically updated accordingly.
Finally, you can always come back and edit the existing attributes of the ego car by clicking on the ego car on the map. This will open its attributes tab in the right-hand attributes window.
Finally, you can always come back and edit the existing attributes of the ego
car by clicking on the ego car on the map. This will open its attributes tab in
the right-hand attributes window.
#### Participants' Configuration
If you select `Participant` from the configuration menu, you can place your participant in your scenario by clicking on a desired location on the map. You will notice that your mouse pointer will turn into a cross until you place the new participant on your map. Once you place it, a form will appear on the right-hand attributes window as it did with `Ego Car`. Before you edit the fields on the form, you can change the position of the participant by clicking and dragging it. You can also modify its heading by clicking on the arrow head. Once you have finalized the heading and position of your participant, you can start working on specific details mentioned in the form - type, length, speed and motion type.
If you select `Participant` from the configuration menu, you can place your
participant in your scenario by clicking on a desired location on the map. You
will notice that your mouse pointer will turn into a cross until you place the
new participant on your map. Once you place it, a form will appear on the
right-hand attributes window as it did with `Ego Car`. Before you edit the
fields on the form, you can change the position of the participant by clicking
and dragging it. You can also modify its heading by clicking on the arrow head.
Once you have finalized the heading and position of your participant, you can
start working on specific details mentioned in the form - type, length, speed
and motion type.
In the Basic Information section, you will notice an auto-generated ID along with a description textbox. You could give your participant a suitable ID as well as a description about its expected behavior. You could also specify what is your participant's type, which will be set to `Car` by default. Upon selecting a different type, the participant on your screen will change accordingly. You will also need to determine its initial speed and other attributes including width, length and height. There are predetermined values for each vehicle type, which can be changed.
In the Basic Information section, you will notice an auto-generated ID along
with a description textbox. You could give your participant a suitable ID as
well as a description about its expected behavior. You could also specify what
is your participant's type, which will be set to `Car` by default. Upon
selecting a different type, the participant on your screen will change
accordingly. You will also need to determine its initial speed and other
attributes including width, length and height. There are predetermined values
for each vehicle type, which can be changed.
In the Initial State section, you will need to set the speed of the participant which can be either set in `m/s` or `km/hr`. The coordinates and heading of the participant are preset and can be changed by directly editing the participant's position on the map.
In the Initial State section, you will need to set the speed of the participant
which can be either set in `m/s` or `km/hr`. The coordinates and heading of the
participant are preset and can be changed by directly editing the participant's
position on the map.
In Runtime Configuration, you can set whether the participant is mobile or static. Should you select static, you have finished setting up your participant and are ready to save.
In Runtime Configuration, you can set whether the participant is mobile or
static. Should you select static, you have finished setting up your participant
and are ready to save.
If you select mobile instead, you would need to set its `Trigger Type`. Once you have completed your mobile participant setup, click on the `add route point` button to set the participant's trajectory points as seen in the image below.
If you select mobile instead, you would need to set its `Trigger Type`. Once you
have completed your mobile participant setup, click on the `add route point`
button to set the participant's trajectory points as seen in the image below.
You can set a single destination, or add several points in between. You will also be able to add speed and change the speed of your participant on the form from one point to the next. Also, you can edit the location of the point on the screen by clicking on and dragging it to its desired locaiton.
You can set a single destination, or add several points in between. You will
also be able to add speed and change the speed of your participant on the form
from one point to the next. Also, you can edit the location of the point on the
screen by clicking on and dragging it to its desired locaiton.
Finally, if you have added several trajectory points and do not know how to go back to your participant, you can use the `Re-center tool` (which is similar to the General Action re-center tool), but this re-center tool only works for your participants.
Finally, if you have added several trajectory points and do not know how to go
back to your participant, you can use the `Re-center tool` (which is similar to
the General Action re-center tool), but this re-center tool only works for your
participants.
...
...
@@ -119,21 +194,30 @@ Your final participant screen should appear as follows:
#### Traffic Light Configuration
This configuration tool will allow you to edit the traffic lights that are a part of your scenario. To activate this tool, look for a traffic light on the map and click on it which opens a configuration form on the right-hand side of your window. You will notice 2 constant attricutes ID and its coordinates.
This configuration tool will allow you to edit the traffic lights that are a
part of your scenario. To activate this tool, look for a traffic light on the
map and click on it which opens a configuration form on the right-hand side of
your window. You will notice 2 constant attricutes ID and its coordinates.
However, you will need to select a trigger type for the traffic light:
-**Distance** - the traffic light will be triggered by the distance between the ego car and the light
-**Time** - the light will be triggered by the scenario run time
-**Distance** - the traffic light will be triggered by the distance between the
ego car and the light
-**Time** - the light will be triggered by the scenario run time
You will also be required to set the `Initial State` of the traffic light. And once your trigger type is set, you will also be required to complete the `States` section, in terms of color and light durations for each state. If the traffic lights have reached the end of their configured states before the end of the scenario, the last state will remain until the end.
You will also be required to set the `Initial State` of the traffic light. And
once your trigger type is set, you will also be required to complete the
`States` section, in terms of color and light durations for each state. If the
traffic lights have reached the end of their configured states before the end of
the scenario, the last state will remain until the end.
## Saving a Scenario
You can save your scenario by clicking on `Save` in the file menu.
```
Note:
The minimum requirements of saving a scenario are to configure all required attributes in the “General” and “Ego Car” configurations. If not, a pop-up window with a failure message will highlight what you are still required to configure.
...
...
@@ -141,7 +225,8 @@ The minimum requirements of saving a scenario are to configure all required attr
## Running a New Scenario
1. To locate and run your scenario requires you to trigger a `New Task` under `Task Management`
1. To locate and run your scenario requires you to trigger a `New Task` under
`Task Management`
...
...
@@ -149,6 +234,8 @@ The minimum requirements of saving a scenario are to configure all required attr
3. You can then search for your newly created scenario. An easy way to filter your private scenarios is to perform an instance search for your username in the `Search scenarios` field.
3. You can then search for your newly created scenario. An easy way to filter
your private scenarios is to perform an instance search for your username in
Apollo 3.0 Hardware Development Platform provides 2 types of evaluation for our supported hardware devices - Apollo Platform Supported devices and Apollo Hardware Development Platform Supported devices. In order to view each device's support type, please look under the `Disclaimer` section in each device's insallation guide. We highly recommend that you read through our [Disclaimer](Disclaimer_Hardware.pdf) to understand each device type, before reading through our Hardware platform installation documents.
Apollo 3.0 Hardware Development Platform provides 2 types of evaluation for our
supported hardware devices - Apollo Platform Supported devices and Apollo
Hardware Development Platform Supported devices. In order to view each device's
support type, please look under the `Disclaimer` section in each device's
insallation guide. We highly recommend that you read through our
[Disclaimer](Disclaimer_Hardware.pdf) to understand each device type, before
reading through our Hardware platform installation documents.
