Skip to content

Introducing emitting objects #472

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

Merged
merged 9 commits into from
Jul 28, 2021
Merged
34 changes: 34 additions & 0 deletions osi_common.proto
Original file line number Diff line number Diff line change
Expand Up @@ -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;
}
33 changes: 31 additions & 2 deletions osi_object.proto
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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;
Expand All @@ -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.
Expand Down Expand Up @@ -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;
}
}
}

Expand Down