Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Issue #836: Added missing pages and linked them in navigation. #838

Merged
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 14 additions & 4 deletions doc/architecture/architecture_overview.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,21 @@ include::{root-path}_config.adoc[]
endif::[]
= Overview of OSI architecture

OSI contains an object-based environment description that uses the message format of the https://github.com/protocolbuffers/protobuf/wiki[Protocol Buffer] library.
Google developed and maintains the Protocol Buffer library.
OSI contains an object-based environment description that uses the message format of the https://github.com/protocolbuffers/protobuf/wiki[Protocol Buffer^] library developed by Google.
OSI defines top-level messages that are used to exchange data between separate models.
Top-level messages define the `GroundTruth` interface, the `SensorData` interface, and – since OSI version 3.0.0 – the interfaces `SensorView` and `SensorViewConfiguration`.
Further top-level messages that were added in later versions of OSI are `HostVehicleData`, `TrafficCommand`, `TrafficCommandUpdate`, `TrafficUpdate`, `MotionRequest`, and `StreamingUpdate`.

Top-level messages define the following interfaces:

- xref:architecture/ground_truth.adoc[`GroundTruth`]
- xref:architecture/sensor_data.adoc[`SensorData`]
- xref:architecture/sensor_view.adoc[`SensorView`]
- xref:architecture/sensor_view_configuration.adoc[`SensorViewConfiguration`]
- xref:architecture/host_vehicle_data.adoc[`HostVehicleData`]
- xref:architecture/traffic_command.adoc[`TrafficCommand`]
- xref:architecture/traffic_command_update.adoc[`TrafficCommandUpdate`]
- xref:architecture/traffic_update.adoc[`TrafficUpdate`]
- xref:architecture/motion_request.adoc[`MotionRequest`]
- xref:architecture/streaming_update.adoc[`StreamingUpdate`].

The following figure shows the interfaces and models involved in modeling a sensor.

Expand Down
4 changes: 3 additions & 1 deletion doc/architecture/ground_truth.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -6,4 +6,6 @@ endif::[]

`GroundTruth` messages describe the simulated environment containing all simulated objects in the global coordinate system at consecutive time instances.
They are based on data available to the simulation environment.
`GroundTruth` messages are typically contained in `Sensorview` messages.
`GroundTruth` messages are typically contained in `Sensorview` messages.

For more details, see xref:gen:structosi3_1_1GroundTruth.adoc[].
12 changes: 12 additions & 0 deletions doc/architecture/host_vehicle_data.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
ifndef::include-only-once[]
:root-path: ../
include::{root-path}_config.adoc[]
endif::[]
= Host vehicle data

The `HostVehicleData` message targets the perception of the vehicle of its own internal states.

It captures the knowledge the vehicle has internally, which can differ from the actual or global truth for various reasons.
This message can also be understood as an interface container for the signals of a rest bus simulation.

For more details, see xref:gen:structosi3_1_1HostVehicleData.adoc[].
4 changes: 3 additions & 1 deletion doc/architecture/motion_request.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,6 @@ endif::[]
= Motion Request

`MotionRequest` messages are traffic participant internal messages.
They function as a interface between a motion/behavior planning model and a dynamics model including, for example, controllers and vehicle kinematics.
They function as a interface between a motion/behavior planning model and a dynamics model including, for example, controllers and vehicle kinematics.

For more details, see xref:gen:structosi3_1_1MotionRequest.adoc[].
2 changes: 2 additions & 0 deletions doc/architecture/sensor_data.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -13,3 +13,5 @@ Sensor data can be used as input for an automated driving function, a sensor mod
`SensorData` messages include `FeatureData` messages which contain detected features in the reference frame of a sensor.
`FeatureData` messages are generated from `GroundTruth` messages.
They serve, for example, as an input to sensor models simulating object detection or feature fusion models.

For more details, see xref:gen:structosi3_1_1SensorData.adoc[].
4 changes: 3 additions & 1 deletion doc/architecture/sensor_view.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -10,4 +10,6 @@ All information regarding the environment is given with respect to the virtual s

* Physical technology-specific data, given with respect to the physical sensor coordinate system specified in the corresponding physical sensor's mounting position.
One example of technology-specific data is: xref:gen:structosi3_1_1CameraSensorView.adoc#ac58456a34babf78792ea2608eb963f36[`image_data` of `osi3::CameraSensorView`]
* Ground truth given in the global coordinate system.
* Ground truth given in the global coordinate system.

For more details, see xref:gen:structosi3_1_1SensorView.adoc[].
4 changes: 3 additions & 1 deletion doc/architecture/sensor_view_configuration.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -35,4 +35,6 @@ In response to this difference, the sensor model can either accept this differen

The packaging layer defines the specifics of this auto-negotiation mechanism.

After the initialization phase, the environment simulation provides the actual sensor-view configuration as part of each `SensorView` message.
After the initialization phase, the environment simulation provides the actual sensor-view configuration as part of each `SensorView` message.

For more details, see xref:gen:structosi3_1_1SensorViewConfiguration.adoc[].
4 changes: 3 additions & 1 deletion doc/architecture/streaming_update.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -7,4 +7,6 @@ endif::[]
The `StreamingUpdate` message provides an interface to transmit a subset of ground truth and/or vehicle internal data.
This interface mainly addresses applications with low latency requirements and no need for highly consistent and complete data, e.g. visualization applications.
Static and/or non-relevant objects can be omitted as required for the specific use case.
Note that the receiver of partial updates can only rely on the most up-to-date information at the corresponding timestamp. E.g. omitting objects does not indicate static behaviour but it may be sufficient for the use case to update certain objects at a later point in time.
Note that the receiver of partial updates can only rely on the most up-to-date information at the corresponding timestamp. E.g. omitting objects does not indicate static behavior but it may be sufficient for the use case to update certain objects at a later point in time.

For more details, see xref:gen:structosi3_1_1StreamingUpdate.adoc[].
4 changes: 3 additions & 1 deletion doc/architecture/traffic_command.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,6 @@ include::{root-path}_config.adoc[]
endif::[]
= Traffic command

`TrafficCommand` messages contain control commands from the scenario engine to traffic participant models.
`TrafficCommand` messages contain control commands from the scenario engine to traffic participant models.

For more details, see xref:gen:structosi3_1_1TrafficCommand.adoc[].
9 changes: 9 additions & 0 deletions doc/architecture/traffic_command_update.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
ifndef::include-only-once[]
:root-path: ../
include::{root-path}_config.adoc[]
endif::[]
= Traffic command update

`TrafficCommandUpdate` messages enable the traffic participant model to send updates to the scenario engine about the execution of its received xref:architecture/traffic_command.adoc[TrafficCommand] input.

For more details, see xref:gen:structosi3_1_1TrafficCommandUpdate.adoc[].
4 changes: 3 additions & 1 deletion doc/architecture/traffic_update.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,6 @@ endif::[]
= Traffic update

`TrafficUpdate` messages are provided by traffic participants.
They provide updates on the position, state, and future trajectory of a traffic participant back to the simulation environment.
They provide updates on the position, state, and future trajectory of a traffic participant back to the simulation environment.

For more details, see xref:gen:structosi3_1_1TrafficUpdate.adoc[].
4 changes: 4 additions & 0 deletions doc/open-simulation-interface_user_guide.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -21,8 +21,12 @@ include::./architecture/sensor_view_configuration.adoc[leveloffset=+3]

include::./architecture/sensor_data.adoc[leveloffset=+3]

include::./architecture/host_vehicle_data.adoc[leveloffset=+3]

include::./architecture/traffic_command.adoc[leveloffset=+3]

include::./architecture/traffic_command_update.adoc[leveloffset=+3]

include::./architecture/motion_request.adoc[leveloffset=+3]

include::./architecture/traffic_update.adoc[leveloffset=+3]
Expand Down