diff --git a/osi_common.proto b/osi_common.proto index 9a2c2868b..0c01afc7e 100644 --- a/osi_common.proto +++ b/osi_common.proto @@ -579,3 +579,37 @@ message WavelengthData // optional double samples_number = 3; } + +// +// \brief Definition of a spatial signal strength distribution +// for an emitting / transmitting / receiving entity +// with a horizontal and a vertical angle +// and the corresponding signal strength in dBm (decibels per milliwatt). +// +message SpatialSignalStrength +{ + // Horizontal angle (azimuth) of emission / transmission / reception + // in the entity's coordinate system. + // + // Unit: rad + // + optional double horizontal_angle = 1; + + // Vertical angle (elevation) of emission / transmission / reception + // in the entity's coordinate system. + // + // Unit: rad + // + optional double vertical_angle = 2; + + // Emitted / transmitted /received signal strength + // of the emitting / transmitting / receiving entity + // at the previously defined horizontal and + // vertical angle for one specific wavelength. + // The value for the signal strength + // is given in dBm (decibels per milliwatt). + // + // Unit: dBm + // + optional double signal_strength = 3; +} diff --git a/osi_object.proto b/osi_object.proto index 5a430e092..af2d9a232 100644 --- a/osi_object.proto +++ b/osi_object.proto @@ -96,6 +96,10 @@ message StationaryObject // optional Color color = 4; + // The attributes of the emitting structure if stationary object is classified as such. + // + optional EmittingStructureAttribute emitting_structure_attribute = 5; + // Definition of object types. // enum Type @@ -163,8 +167,8 @@ message StationaryObject // TYPE_OVERHEAD_STRUCTURE = 14; - // Landmarks corresponding to light sources or reflective structures - // in the environment, like street lights or reflective poles on the + // Landmarks corresponding to reflective structures + // in the environment, like reflective poles on the // road boarder. // TYPE_REFLECTIVE_STRUCTURE = 15; @@ -177,6 +181,11 @@ message StationaryObject // Object is a speed bump. // TYPE_SPEED_BUMP = 17; + + // Landmarks corresponding to sources of electromagnetic waves + // in the environment, like street lights. + // + TYPE_EMITTING_STRUCTURE = 18; } // Definition of material types. @@ -303,6 +312,26 @@ message StationaryObject // COLOR_WHITE = 10; } + + // + // \brief Attributes of type emitting structure. The horizontal_angle and the vertical_angle in + // emitted_spatial_intensity are symmetrical across the normal, which is defined by the mounting position + // of the emitting structure. + // + message EmittingStructureAttribute + { + // This message determines the range of the emitted wavelength and its + // desired number of samples. + // + repeated WavelengthData wavelength_data = 1; + + // Spatial signal strength distribution of the emitted electromagnetic wave. + // For every sample in wavelength_data an emitted_spatial_signal_strength has to be defined. + // + // \note emitted_spatial_signal_strength.size() = WavelengthData.samples_number.size() + // + repeated SpatialSignalStrength emitted_spatial_signal_strength = 3; + } } }