Merge pull request #472 from OpenSimulationInterface/455-introducing-emitting-objects

Introducing emitting objects

Author: Stefan Cyliax

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;
+}

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;
+        }
     }
 }