Setter functions for the ETSI ITS CPM (TS). More...

#include <etsi_its_msgs_utils/impl/checks.h>
#include <etsi_its_msgs_utils/impl/constants.h>
#include <etsi_its_msgs_utils/impl/cdd/cdd_v2-1-1_setters.h>

Classes
struct	etsi_its_cpm_ts_msgs::access::etsi_its_msgs::OneCentimeterHelper< SemiAxisLength, typename >
struct	etsi_its_cpm_ts_msgs::access::etsi_its_msgs::OneCentimeterHelper< SemiAxisLength, std::void_t< decltype(SemiAxisLength::ONE_CENTIMETER)> >

Functions
template<typename T1, typename T2>
void	etsi_its_cpm_ts_msgs::access::throwIfOutOfRange (const T1 &val, const T2 &min, const T2 &max, const std::string val_desc)
	Throws an exception if a given value is out of a defined range.
void	etsi_its_cpm_ts_msgs::access::throwIfNotPresent (const bool is_present, const std::string val_desc)
	Throws an exception if the given value is not present.
uint16_t	etsi_its_cpm_ts_msgs::access::etsi_its_msgs::getLeapSecondInsertionsSince2004 (const uint64_t unix_seconds)
	Get the leap second insertions since 2004 for given unix seconds.
template<typename StationId>
void	etsi_its_cpm_ts_msgs::access::setStationId (StationId &station_id, const uint32_t id_value)
	Set the Station Id object.
template<typename StationType>
void	etsi_its_cpm_ts_msgs::access::setStationType (StationType &station_type, const uint8_t value)
	Set the Station Type.
void	etsi_its_cpm_ts_msgs::access::setTimestampITS (TimestampIts &timestamp_its, const uint64_t unix_nanosecs, const uint16_t n_leap_seconds=etsi_its_msgs::LEAP_SECOND_INSERTIONS_SINCE_2004.rbegin() ->second)
	Set the TimestampITS object.
void	etsi_its_cpm_ts_msgs::access::setLatitude (Latitude &latitude, const double deg)
	Set the Latitude object.
void	etsi_its_cpm_ts_msgs::access::setLongitude (Longitude &longitude, const double deg)
	Set the Longitude object.
void	etsi_its_cpm_ts_msgs::access::setAltitudeValue (AltitudeValue &altitude, const double value)
	Set the AltitudeValue object.
void	etsi_its_cpm_ts_msgs::access::setAltitude (Altitude &altitude, const double value)
	Set the Altitude object.
void	etsi_its_cpm_ts_msgs::access::setSpeedValue (SpeedValue &speed, const double value)
	Set the SpeedValue object.
void	etsi_its_cpm_ts_msgs::access::setSpeedConfidence (SpeedConfidence &speed_confidence, const double value)
	Set the Speed Confidence object.
void	etsi_its_cpm_ts_msgs::access::setSpeed (Speed &speed, const double value, const double confidence=std::numeric_limits< double >::infinity())
	Set the Speed object.
template<typename AccelerationMagnitudeValue>
void	etsi_its_cpm_ts_msgs::access::setAccelerationMagnitudeValue (AccelerationMagnitudeValue &accel_mag_value, const double value)
	Set the Acceleration Magnitude Value object.
template<typename AccelerationConfidence>
void	etsi_its_cpm_ts_msgs::access::setAccelerationMagnitudeConfidence (AccelerationConfidence &accel_mag_confidence, const double value)
	Set the AccelerationMagnitude Confidence object.
template<typename AccelerationMagnitude>
void	etsi_its_cpm_ts_msgs::access::setAccelerationMagnitude (AccelerationMagnitude &accel_mag, const double value, const double confidence=std::numeric_limits< double >::infinity())
	Set the AccelerationMagnitude object.
template<typename AccelerationConfidence>
void	etsi_its_cpm_ts_msgs::access::setAccelerationConfidence (AccelerationConfidence &accel_confidence, const double value)
	Set the Acceleration Confidence object.
template<typename T>
void	etsi_its_cpm_ts_msgs::access::setReferencePosition (T &ref_position, const double latitude, const double longitude, const double altitude=AltitudeValue::UNAVAILABLE)
	Sets the reference position in the given ReferencePostion object.
template<typename T>
void	etsi_its_cpm_ts_msgs::access::setFromUTMPosition (T &reference_position, const gm::PointStamped &utm_position, const int zone, const bool northp)
	Set the ReferencePosition from a given UTM-Position.
template<typename HeadingValue>
void	etsi_its_cpm_ts_msgs::access::setHeadingValue (HeadingValue &heading, const double value)
	Set the HeadingValue object.
template<typename HeadingConfidence>
void	etsi_its_cpm_ts_msgs::access::setHeadingConfidence (HeadingConfidence &heading_confidence, const double value)
	Set the Heading Confidence object.
template<typename Heading, typename HeadingConfidence = decltype(Heading::heading_confidence)>
void	etsi_its_cpm_ts_msgs::access::setHeadingCDD (Heading &heading, const double value, double confidence=std::numeric_limits< double >::infinity())
	Set the Heading object.
template<typename YawRate, typename YawRateValue = decltype(YawRate::yaw_rate_value), typename YawRateConfidence = decltype(YawRate::yaw_rate_confidence)>
void	etsi_its_cpm_ts_msgs::access::setYawRateCDD (YawRate &yaw_rate, const double value, double confidence=std::numeric_limits< double >::infinity())
	Set the Yaw Rate object.
template<typename SemiAxisLength>
void	etsi_its_cpm_ts_msgs::access::setSemiAxis (SemiAxisLength &semi_axis_length, const double length)
	Set the Semi Axis length.
template<typename PosConfidenceEllipse>
void	etsi_its_cpm_ts_msgs::access::setPosConfidenceEllipse (PosConfidenceEllipse &position_confidence_ellipse, const double semi_major_axis, const double semi_minor_axis, const double orientation)
	Set the Pos Confidence Ellipse object.
std::tuple< double, double, double >	etsi_its_cpm_ts_msgs::access::confidenceEllipseFromCovMatrix (const std::array< double, 4 > &covariance_matrix, const double object_heading)
	Gets the values needed to set a confidence ellipse from a covariance matrix.
std::tuple< double, double, double >	etsi_its_cpm_ts_msgs::access::confidenceEllipseFromWGSCovMatrix (const std::array< double, 4 > &covariance_matrix)
	Gets the values needed to set a confidence ellipse from a covariance matrix.
template<typename PosConfidenceEllipse>
void	etsi_its_cpm_ts_msgs::access::setPosConfidenceEllipse (PosConfidenceEllipse &position_confidence_ellipse, const std::array< double, 4 > &covariance_matrix, const double object_heading)
	Set the Pos Confidence Ellipse object.
template<typename PosConfidenceEllipse>
void	etsi_its_cpm_ts_msgs::access::setWGSPosConfidenceEllipse (PosConfidenceEllipse &position_confidence_ellipse, const std::array< double, 4 > &covariance_matrix)
	Set the Pos Confidence Ellipse object.
void	etsi_its_cpm_ts_msgs::access::setItsPduHeader (ItsPduHeader &header, const uint8_t message_id, const uint32_t station_id, const uint8_t protocol_version=0)
	Set the Its Pdu Header object.
void	etsi_its_cpm_ts_msgs::access::setLongitudinalAccelerationValue (AccelerationValue &accel, const double value)
	Set the LongitudinalAccelerationValue object.
void	etsi_its_cpm_ts_msgs::access::setLongitudinalAcceleration (AccelerationComponent &accel, const double value, const double confidence)
	Set the LongitudinalAcceleration object.
void	etsi_its_cpm_ts_msgs::access::setLateralAccelerationValue (AccelerationValue &accel, const double value)
	Set the LateralAccelerationValue object.
void	etsi_its_cpm_ts_msgs::access::setLateralAcceleration (AccelerationComponent &accel, const double value, const double confidence)
	Set the LateralAcceleration object.
template<typename PositionConfidenceEllipse, typename Wgs84AngleValue = decltype(PositionConfidenceEllipse::semi_major_axis_orientation)>
void	etsi_its_cpm_ts_msgs::access::setPositionConfidenceEllipse (PositionConfidenceEllipse &position_confidence_ellipse, const double semi_major_axis, const double semi_minor_axis, const double orientation)
	Set the Position Confidence Ellipse object.
template<typename PositionConfidenceEllipse>
void	etsi_its_cpm_ts_msgs::access::setPositionConfidenceEllipse (PositionConfidenceEllipse &position_confidence_ellipse, const std::array< double, 4 > &covariance_matrix, const double object_heading)
	Set the Position Confidence Ellipse object.
template<typename PositionConfidenceEllipse>
void	etsi_its_cpm_ts_msgs::access::setWGSPositionConfidenceEllipse (PositionConfidenceEllipse &position_confidence_ellipse, const std::array< double, 4 > &covariance_matrix)
	Set the Position Confidence Ellipse object.
void	etsi_its_cpm_ts_msgs::access::setItsPduHeader (CollectivePerceptionMessage &cpm, const uint32_t station_id, const uint8_t protocol_version=0)
	Sets the ITS PDU header of a CPM.
void	etsi_its_cpm_ts_msgs::access::setReferenceTime (CollectivePerceptionMessage &cpm, const uint64_t unix_nanosecs, const uint16_t n_leap_seconds=etsi_its_msgs::LEAP_SECOND_INSERTIONS_SINCE_2004.rbegin() ->second)
	Sets the reference time in a CPM.
void	etsi_its_cpm_ts_msgs::access::setReferencePosition (CollectivePerceptionMessage &cpm, const double latitude, const double longitude, const double altitude=AltitudeValue::UNAVAILABLE)
	Set the ReferencePositionWithConfidence for a CPM TS.
void	etsi_its_cpm_ts_msgs::access::setFromUTMPosition (CollectivePerceptionMessage &cpm, const gm::PointStamped &utm_position, const int &zone, const bool &northp)
	Set the ReferencePosition of a CPM from a given UTM-Position.
void	etsi_its_cpm_ts_msgs::access::setIdOfPerceivedObject (PerceivedObject &object, const uint16_t id)
	Set the ID of a PerceivedObject.
void	etsi_its_cpm_ts_msgs::access::setMeasurementDeltaTimeOfPerceivedObject (PerceivedObject &object, const int16_t delta_time=0)
	Sets the measurement delta time of a PerceivedObject.
void	etsi_its_cpm_ts_msgs::access::setCartesianCoordinateWithConfidence (CartesianCoordinateWithConfidence &coordinate, const double value, const double confidence=std::numeric_limits< double >::infinity())
	Sets the value and confidence of a CartesianCoordinateWithConfidence object.
void	etsi_its_cpm_ts_msgs::access::setPositionOfPerceivedObject (PerceivedObject &object, const gm::Point &point, const double x_std=std::numeric_limits< double >::infinity(), const double y_std=std::numeric_limits< double >::infinity(), const double z_std=std::numeric_limits< double >::infinity())
	Sets the position of a perceived object (relative to the CPM's reference position).
void	etsi_its_cpm_ts_msgs::access::setUTMPositionOfPerceivedObject (CollectivePerceptionMessage &cpm, PerceivedObject &object, const gm::PointStamped &utm_position, const double x_std=std::numeric_limits< double >::infinity(), const double y_std=std::numeric_limits< double >::infinity(), const double z_std=std::numeric_limits< double >::infinity())
	Sets the position of a perceived object based on a UTM position.
void	etsi_its_cpm_ts_msgs::access::setVelocityComponent (VelocityComponent &velocity, const double value, const double confidence=std::numeric_limits< double >::infinity())
	Sets the value and confidence of a VelocityComponent.
void	etsi_its_cpm_ts_msgs::access::setCartesianAngle (CartesianAngle &angle, const double value, double confidence=std::numeric_limits< double >::infinity())
	Set a Cartesian Angle.
void	etsi_its_cpm_ts_msgs::access::setVelocityOfPerceivedObject (PerceivedObject &object, const gm::Vector3 &cartesian_velocity, const double x_std=std::numeric_limits< double >::infinity(), const double y_std=std::numeric_limits< double >::infinity(), const double z_std=std::numeric_limits< double >::infinity())
void	etsi_its_cpm_ts_msgs::access::setPolarVelocityOfPerceivedObject (PerceivedObject &object, const double magnitude, const double angle, const double z=0.0, const double magnitude_std=std::numeric_limits< double >::infinity(), const double angle_std=std::numeric_limits< double >::infinity(), const double z_std=std::numeric_limits< double >::infinity())
void	etsi_its_cpm_ts_msgs::access::setAccelerationComponent (AccelerationComponent &acceleration, const double value, const double confidence=std::numeric_limits< double >::infinity())
	Sets the value and confidence of a AccelerationComponent.
void	etsi_its_cpm_ts_msgs::access::setAccelerationOfPerceivedObject (PerceivedObject &object, const gm::Vector3 &cartesian_acceleration, const double x_std=std::numeric_limits< double >::infinity(), const double y_std=std::numeric_limits< double >::infinity(), const double z_std=std::numeric_limits< double >::infinity())
	Sets the acceleration of a perceived object.
void	etsi_its_cpm_ts_msgs::access::setPolarAccelerationOfPerceivedObject (PerceivedObject &object, const double magnitude, const double angle, const double z=0.0, const double magnitude_std=std::numeric_limits< double >::infinity(), const double angle_std=std::numeric_limits< double >::infinity(), const double z_std=std::numeric_limits< double >::infinity())
	Set the Polar Acceleration Of Perceived Object object.
void	etsi_its_cpm_ts_msgs::access::setYawOfPerceivedObject (PerceivedObject &object, const double yaw, double yaw_std=std::numeric_limits< double >::infinity())
	Sets the yaw angle of a perceived object.
void	etsi_its_cpm_ts_msgs::access::setYawRateOfPerceivedObject (PerceivedObject &object, const double yaw_rate, double yaw_rate_std=std::numeric_limits< double >::infinity())
	Sets the yaw rate of a perceived object.
void	etsi_its_cpm_ts_msgs::access::setObjectDimension (ObjectDimension &dimension, const double value, const double confidence=std::numeric_limits< double >::infinity())
	Sets the object dimension with the given value and confidence.
void	etsi_its_cpm_ts_msgs::access::setXDimensionOfPerceivedObject (PerceivedObject &object, const double value, const double std=std::numeric_limits< double >::infinity())
	Sets the x-dimension of a perceived object.
void	etsi_its_cpm_ts_msgs::access::setYDimensionOfPerceivedObject (PerceivedObject &object, const double value, const double std=std::numeric_limits< double >::infinity())
	Sets the y-dimension of a perceived object.
void	etsi_its_cpm_ts_msgs::access::setZDimensionOfPerceivedObject (PerceivedObject &object, const double value, const double std=std::numeric_limits< double >::infinity())
	Sets the z-dimension of a perceived object.
void	etsi_its_cpm_ts_msgs::access::setDimensionsOfPerceivedObject (PerceivedObject &object, const gm::Vector3 &dimensions, const double x_std=std::numeric_limits< double >::infinity(), const double y_std=std::numeric_limits< double >::infinity(), const double z_std=std::numeric_limits< double >::infinity())
	Sets all dimensions of a perceived object.
void	etsi_its_cpm_ts_msgs::access::initPerceivedObject (PerceivedObject &object, const gm::Point &point, const int16_t delta_time=0)
	Initializes a PerceivedObject with the given point and delta time.
void	etsi_its_cpm_ts_msgs::access::initPerceivedObjectWithUTMPosition (CollectivePerceptionMessage &cpm, PerceivedObject &object, const gm::PointStamped &point, const int16_t delta_time=0)
	Initializes a PerceivedObject with the given point (utm-position) and delta time.
void	etsi_its_cpm_ts_msgs::access::initPerceivedObjectContainer (WrappedCpmContainer &container, const uint8_t n_objects=0)
	Initializes a WrappedCpmContainer as a PerceivedObjectContainer with the given number of objects.
void	etsi_its_cpm_ts_msgs::access::addPerceivedObjectToContainer (WrappedCpmContainer &container, const PerceivedObject &perceived_object)
	Adds a PerceivedObject to the PerceivedObjectContainer / WrappedCpmContainer.
void	etsi_its_cpm_ts_msgs::access::addContainerToCPM (CollectivePerceptionMessage &cpm, const WrappedCpmContainer &container)
	Adds a container to the Collective Perception Message (CPM).
void	etsi_its_cpm_ts_msgs::access::setWGSRefPosConfidence (CollectivePerceptionMessage &cpm, const std::array< double, 4 > &covariance_matrix)
	Set the confidence of the reference position.
void	etsi_its_cpm_ts_msgs::access::initSensorInformationContainer (WrappedCpmContainer &container)
	Initializes a WrappedCpmContainer as a SensorInformationContainer.
void	etsi_its_cpm_ts_msgs::access::setSensorID (SensorInformation &sensor_information, const uint8_t sensor_id=0)
	Sets the sensorId of a SensorInformation object.
void	etsi_its_cpm_ts_msgs::access::setSensorType (SensorInformation &sensor_information, const uint8_t sensor_type=SensorType::UNDEFINED)
	Sets the sensorType of a SensorInformation object.
void	etsi_its_cpm_ts_msgs::access::addSensorInformationToContainer (WrappedCpmContainer &container, const SensorInformation &sensor_information)
	Adds a SensorInformation to the SensorInformationContainer / WrappedCpmContainer.
void	etsi_its_cpm_ts_msgs::access::addSensorInformationContainerToCPM (CollectivePerceptionMessage &cpm, const WrappedCpmContainer &container)
	Adds a container to the Collective Perception Message (CPM).

Variables
const uint64_t	etsi_its_cpm_ts_msgs::access::etsi_its_msgs::UNIX_SECONDS_2004 = 1072915200
const std::map< uint64_t, uint16_t >	etsi_its_cpm_ts_msgs::access::etsi_its_msgs::LEAP_SECOND_INSERTIONS_SINCE_2004
	std::map that stores all leap second insertions since 2004 with the corresponding unix-date of the insertion
constexpr const double	etsi_its_cpm_ts_msgs::access::etsi_its_msgs::ONE_D_GAUSSIAN_FACTOR = 2.0
constexpr const double	etsi_its_cpm_ts_msgs::access::etsi_its_msgs::TWO_D_GAUSSIAN_FACTOR = 2.4477

Detailed Description

Setter functions for the ETSI ITS CPM (TS).

Definition in file cpm_ts_setters.h.

Function Documentation

◆ addContainerToCPM()

void etsi_its_cpm_ts_msgs::access::addContainerToCPM	(	CollectivePerceptionMessage &	cpm,
		const WrappedCpmContainer &	container )

inline

Adds a container to the Collective Perception Message (CPM).

This function adds a WrappedCpmContainer to the CPM's payload. It first checks if the current number of containers is less than the maximum allowed. If so, it appends the container to the array. Otherwise, it throws an exception.

Parameters

cpm	The Collective Perception Message to which the container will be added.
container	The WrappedCpmContainer to be added to the CPM.

Exceptions

std::invalid_argument if the maximum number of CPM-Containers is reached.

Definition at line 710 of file cpm_ts_setters.h.

◆ addPerceivedObjectToContainer()

void etsi_its_cpm_ts_msgs::access::addPerceivedObjectToContainer	(	WrappedCpmContainer &	container,
		const PerceivedObject &	perceived_object )

inline

Adds a PerceivedObject to the PerceivedObjectContainer / WrappedCpmContainer.

This function checks if the provided container is a PerceivedObjectContainer. If it is, the function adds the given PerceivedObject to the container's perceived_objects array and updates the number_of_perceived_objects value. If the container is not a PerceivedObjectContainer, the function throws an std::invalid_argument exception.

Parameters

container	The WrappedCpmContainer to which the PerceivedObject will be added.
perceived_object	The PerceivedObject to add to the container.

Exceptions

std::invalid_argument if the container is not a PerceivedObjectContainer.

Definition at line 688 of file cpm_ts_setters.h.

◆ addSensorInformationContainerToCPM()

void etsi_its_cpm_ts_msgs::access::addSensorInformationContainerToCPM	(	CollectivePerceptionMessage &	cpm,
		const WrappedCpmContainer &	container )

inline

Adds a container to the Collective Perception Message (CPM).

This function adds a SensorInformationContainer / WrappedCpmContainer to the CPM's payload. It first checks if the container is a SensorInformationContainer. If so, it checks if the number of entries is in the allowed range. If the number of entries is valid, it appends the container to the array. Otherwise, it throws an exception.

Parameters

cpm	The Collective Perception Message to which the container will be added.
container	The WrappedCpmContainer to be added to the CPM.

Exceptions

std::invalid_argument	if the container is not a SensorInformationContainer.
std::invalid_argument	if the number of SensorInformation entries is out of range.

Definition at line 822 of file cpm_ts_setters.h.

◆ addSensorInformationToContainer()

void etsi_its_cpm_ts_msgs::access::addSensorInformationToContainer	(	WrappedCpmContainer &	container,
		const SensorInformation &	sensor_information )

inline

Adds a SensorInformation to the SensorInformationContainer / WrappedCpmContainer.

This function checks if the provided container is a SensorInformationContainer. If it is, the function adds the given SensorInformation to the container's sensor_information array. If the container is not a SensorInformationContainer, the function throws an std::invalid_argument exception. If the maximum number of SensorInformation entries is reached, it throws an exception. If the sensor_id or sensor_type is out of range, it throws an exception.

Parameters

container	The WrappedCpmContainer to which the SensorInformation will be added.
sensor_information	The SensorInformation to add to the container.

Exceptions

std::invalid_argument	if the container is not a SensorInformationContainer.
std::invalid_argument	if the maximum number of SensorInformation entries is reached.
std::invalid_argument	if the sensor_id or sensor_type is out of range.

Definition at line 793 of file cpm_ts_setters.h.

◆ confidenceEllipseFromCovMatrix()

std::tuple< double, double, double > etsi_its_cpm_ts_msgs::access::confidenceEllipseFromCovMatrix	(	const std::array< double, 4 > &	covariance_matrix,
		const double	object_heading )

inline

Gets the values needed to set a confidence ellipse from a covariance matrix.

Parameters

covariance_matrix	The four values of the covariance matrix in the order: cov_xx, cov_xy, cov_yx, cov_yy The matrix has to be SPD, otherwise a std::invalid_argument exception is thrown. Its coordinate system is aligned with the object (x = longitudinal, y = lateral)
object_heading	The heading of the object in rad, with respect to WGS84

Returns: std::tuple<double, double, double> semi_major_axis [m], semi_minor_axis [m], orientation [deg], with respect to WGS84

Definition at line 434 of file cpm_ts_setters.h.

inline void setYawOfPerceivedObject(PerceivedObject& object, const double yaw,
                                    double yaw_std = std::numeric_limits<double>::infinity()) {
  // wrap angle to range [0, 360)
  double yaw_in_degrees = yaw * 180 / M_PI;
  while (yaw_in_degrees >= 360.0) yaw_in_degrees -= 360.0;
  while (yaw_in_degrees < 0.0) yaw_in_degrees += 360.0;
  object.angles.z_angle.value.value = yaw_in_degrees * 10;
 
  if(yaw_std == std::numeric_limits<double>::infinity()) {
    object.angles.z_angle.confidence.value = AngleConfidence::UNAVAILABLE;

◆ confidenceEllipseFromWGSCovMatrix()

std::tuple< double, double, double > etsi_its_cpm_ts_msgs::access::confidenceEllipseFromWGSCovMatrix ( const std::array< double, 4 > & covariance_matrix )

inline

Gets the values needed to set a confidence ellipse from a covariance matrix.

Parameters

covariance_matrix	The four values of the covariance matrix in the order: cov_xx, cov_xy, cov_yx, cov_yy The matrix has to be SPD, otherwise a std::invalid_argument exception is thrown. Its coordinate system is aligned with the WGS axes (x = North, y = East)
object_heading	The heading of the object in rad, with respect to WGS84

Returns: std::tuple<double, double, double> semi_major_axis [m], semi_minor_axis [m], orientation [deg], with respect to WGS84

Definition at line 475 of file cpm_ts_setters.h.

◆ getLeapSecondInsertionsSince2004()

uint16_t etsi_its_cpm_ts_msgs::access::etsi_its_msgs::getLeapSecondInsertionsSince2004 ( const uint64_t unix_seconds )

inline

Get the leap second insertions since 2004 for given unix seconds.

Parameters

unix_seconds the current unix seconds for that the leap second insertions since 2004 shall be provided

Returns: uint16_t the number of leap second insertions since 2004 for unix_seconds

Definition at line 61 of file cpm_ts_setters.h.

68 {

69 TimestampIts t_its;

◆ initPerceivedObject()

void etsi_its_cpm_ts_msgs::access::initPerceivedObject	(	PerceivedObject &	object,
		const gm::Point &	point,
		const int16_t	delta_time = 0 )

inline

Initializes a PerceivedObject with the given point and delta time.

This function sets the position and measurement delta time of the PerceivedObject.

Parameters

object	The PerceivedObject to be initialized.
point	The position of the PerceivedObject relative to the CPM's reference position in meters.
delta_time	The measurement delta time of the PerceivedObject in milliseconds (default = 0).

Definition at line 638 of file cpm_ts_setters.h.

                                                                                                           {
  setPositionOfPerceivedObject(object, point);
  setMeasurementDeltaTimeOfPerceivedObject(object, delta_time);
}

◆ initPerceivedObjectContainer()

void etsi_its_cpm_ts_msgs::access::initPerceivedObjectContainer	(	WrappedCpmContainer &	container,
		const uint8_t	n_objects = 0 )

inline

Initializes a WrappedCpmContainer as a PerceivedObjectContainer with the given number of objects.

This function sets the container ID to CHOICE_CONTAINER_DATA_PERCEIVED_OBJECT_CONTAINER and initializes the number of perceived objects in the container to the specified value.

Parameters

container	A reference to the WrappedCpmContainer to be initialized as a PerceivedObjectContainer.
n_objects	The number of perceived objects to initialize in the container. Default is 0.

Definition at line 670 of file cpm_ts_setters.h.

                                                                                                    {
  container.container_id.value = WrappedCpmContainer::CHOICE_CONTAINER_DATA_PERCEIVED_OBJECT_CONTAINER;
  container.container_data_perceived_object_container.number_of_perceived_objects.value = n_objects;
}

◆ initPerceivedObjectWithUTMPosition()

void etsi_its_cpm_ts_msgs::access::initPerceivedObjectWithUTMPosition	(	CollectivePerceptionMessage &	cpm,
		PerceivedObject &	object,
		const gm::PointStamped &	point,
		const int16_t	delta_time = 0 )

inline

Initializes a PerceivedObject with the given point (utm-position) and delta time.

This function initializes a PerceivedObject within a position and measurement delta time. It sets the position of a perceived object using the provided UTM position and the CPM's reference position. It sets the measurement delta time using the provided delta_time value.

Parameters

cpm	The CPM to get the reference position from.
object	The PerceivedObject to be initialized.
point	The gm::PointStamped representing the UTM position of the object including the frame_id (utm_<zone><N/S>).
delta_time	The measurement delta time in milliseconds (default: 0).

Definition at line 655 of file cpm_ts_setters.h.

                                                                                                        {
  setUTMPositionOfPerceivedObject(cpm, object, point);
  setMeasurementDeltaTimeOfPerceivedObject(object, delta_time);
}

◆ initSensorInformationContainer()

void etsi_its_cpm_ts_msgs::access::initSensorInformationContainer ( WrappedCpmContainer & container )

inline

Initializes a WrappedCpmContainer as a SensorInformationContainer.

This function sets the container ID to CHOICE_CONTAINER_DATA_SENSOR_INFORMATION_CONTAINER and initializes an empty vector with SensorInformation.

Parameters

container A reference to the WrappedCpmContainer to be initialized as a SensorInformationContainer.

Definition at line 740 of file cpm_ts_setters.h.

                                                                           {
  container.container_id.value = WrappedCpmContainer::CHOICE_CONTAINER_DATA_SENSOR_INFORMATION_CONTAINER;
  container.container_data_sensor_information_container.array = std::vector<SensorInformation>();
}

◆ setAccelerationComponent()

void etsi_its_cpm_ts_msgs::access::setAccelerationComponent	(	AccelerationComponent &	acceleration,
		const double	value,
		const double	confidence = std::numeric_limits<double>::infinity() )

inline

Sets the value and confidence of a AccelerationComponent.

This function sets the value and confidence of a AccelerationComponent object. The value is limited to a specific range, and the confidence is limited to a specific range as well. If the provided value or confidence is out of range, it will be set to the corresponding out-of-range value.

Parameters

acceleration	The AccelerationComponent object to set the value and confidence for.
value	The value to set for the AccelerationComponent in dm/s^2.
confidence	The confidence to set for the AccelerationComponent in dm/s^2. Default value is infinity, mapping to AccelerationConfidence::UNAVAILABLE.

Definition at line 364 of file cpm_ts_setters.h.

                                                                                                  {
  // limit value range
  if (value < AccelerationValue::NEGATIVE_OUT_OF_RANGE) {
    acceleration.value.value = AccelerationValue::NEGATIVE_OUT_OF_RANGE;
  } else if (value > AccelerationValue::POSITIVE_OUT_OF_RANGE) {
    acceleration.value.value = AccelerationValue::POSITIVE_OUT_OF_RANGE;
  } else {
    acceleration.value.value = static_cast<int16_t>(value);
  }
 
  // limit confidence range
  if(confidence == std::numeric_limits<double>::infinity()) {
    acceleration.confidence.value = AccelerationConfidence::UNAVAILABLE;
  } else if (confidence > AccelerationConfidence::MAX || confidence < AccelerationConfidence::MIN) {
    acceleration.confidence.value = AccelerationConfidence::OUT_OF_RANGE;
  } else {
    acceleration.confidence.value = static_cast<uint8_t>(confidence);
  }
}

◆ setAccelerationConfidence()

template<typename AccelerationConfidence>

void etsi_its_cpm_ts_msgs::access::setAccelerationConfidence	(	AccelerationConfidence &	accel_confidence,
		const double	value )

inline

Set the Acceleration Confidence object.

Parameters

accel_confidence	object to set
value	standard deviation in m/s^2 as decimal number

Definition at line 233 of file cpm_ts_setters.h.

◆ setAccelerationMagnitude()

template<typename AccelerationMagnitude>

void etsi_its_cpm_ts_msgs::access::setAccelerationMagnitude	(	AccelerationMagnitude &	accel_mag,
		const double	value,
		const double	confidence = std::numeric_limits<double>::infinity() )

inline

Set the AccelerationMagnitude object.

AccelerationConfidence is set to UNAVAILABLE

Parameters

accel_mag	object to set
value	AccelerationMagnitudeValue in m/s^2 as decimal number
confidence	standard deviation in m/s^2 as decimal number (default: infinity, mapping to AccelerationConfidence::UNAVAILABLE)

Definition at line 220 of file cpm_ts_setters.h.

◆ setAccelerationMagnitudeConfidence()

template<typename AccelerationConfidence>

void etsi_its_cpm_ts_msgs::access::setAccelerationMagnitudeConfidence	(	AccelerationConfidence &	accel_mag_confidence,
		const double	value )

inline

Set the AccelerationMagnitude Confidence object.

Parameters

accel_mag_confidence	object to set
value	standard deviation in m/s^2 as decimal number

Definition at line 200 of file cpm_ts_setters.h.

                                                                                     : CoordinateConfidence::UNAVAILABLE).
 * @param y_confidence The standard deviation in meters for the y coordinate (default: CoordinateConfidence::UNAVAILABLE).
 * @param z_confidence The standard deviation in meters for the z coordinate (default: CoordinateConfidence::UNAVAILABLE).

◆ setAccelerationMagnitudeValue()

template<typename AccelerationMagnitudeValue>

void etsi_its_cpm_ts_msgs::access::setAccelerationMagnitudeValue	(	AccelerationMagnitudeValue &	accel_mag_value,
		const double	value )

inline

Set the Acceleration Magnitude Value object.

Parameters

accel_mag_value	object to set
value	AccelerationMagnitudeValue in m/s^2 as decimal number

Definition at line 187 of file cpm_ts_setters.h.

                                                                                                 {
  setCartesianCoordinateWithConfidence(object.position.x_coordinate, point.x * 100, x_std * 100 * etsi_its_msgs::ONE_D_GAUSSIAN_FACTOR);
  setCartesianCoordinateWithConfidence(object.position.y_coordinate, point.y * 100, y_std * 100 * etsi_its_msgs::ONE_D_GAUSSIAN_FACTOR);
  if (point.z != 0.0) {

◆ setAccelerationOfPerceivedObject()

void etsi_its_cpm_ts_msgs::access::setAccelerationOfPerceivedObject	(	PerceivedObject &	object,
		const gm::Vector3 &	cartesian_acceleration,
		const double	x_std = std::numeric_limits<double>::infinity(),
		const double	y_std = std::numeric_limits<double>::infinity(),
		const double	z_std = std::numeric_limits<double>::infinity() )

inline

Sets the acceleration of a perceived object.

This function sets the acceleration of a perceived object using the provided Cartesian acceleration components. Optionally, confidence values can be specified for each acceleration component.

Parameters

object	The perceived object for which the acceleration is being set.
cartesian_acceleration	The Cartesian acceleration components (x, y, z) of the object (in m/s^2).
x_std	The standard deviation in m/s^2 for the x acceleration component (default: infinity).
y_std	The standard deviation in m/s^2 for the y acceleration component (default: infinity).
z_std	The standard deviation in m/s^2 for the z acceleration component (default: infinity).

Definition at line 397 of file cpm_ts_setters.h.

                                                                                                     {
  object.acceleration.choice = Acceleration3dWithConfidence::CHOICE_CARTESIAN_ACCELERATION;
  setAccelerationComponent(object.acceleration.cartesian_acceleration.x_acceleration, cartesian_acceleration.x * 10,
                           x_std * 10 * etsi_its_msgs::ONE_D_GAUSSIAN_FACTOR);
  setAccelerationComponent(object.acceleration.cartesian_acceleration.y_acceleration, cartesian_acceleration.y * 10,
                           y_std * 10 * etsi_its_msgs::ONE_D_GAUSSIAN_FACTOR);
  if (cartesian_acceleration.z != 0.0) {
    setAccelerationComponent(object.acceleration.cartesian_acceleration.z_acceleration, cartesian_acceleration.z * 10,
                             z_std * 10 * etsi_its_msgs::ONE_D_GAUSSIAN_FACTOR);
    object.acceleration.cartesian_acceleration.z_acceleration_is_present = true;
  }
  object.acceleration_is_present = true;
}

◆ setAltitude()

void etsi_its_cpm_ts_msgs::access::setAltitude	(	Altitude &	altitude,
		const double	value )

inline

Set the Altitude object.

AltitudeConfidence is set to UNAVAILABLE

Parameters

altitude	object to set
value	Altitude value (above the reference ellipsoid surface) in meter as decimal number

Definition at line 133 of file cpm_ts_setters.h.

                                                                                                {
    throw std::invalid_argument("MeasurementDeltaTime out of range");
  } else {
    object.measurement_delta_time.value = delta_time;

◆ setAltitudeValue()

void etsi_its_cpm_ts_msgs::access::setAltitudeValue	(	AltitudeValue &	altitude,
		const double	value )

inline

Set the AltitudeValue object.

Parameters

altitude	object to set
value	AltitudeValue value (above the reference ellipsoid surface) in meter as decimal number

Definition at line 114 of file cpm_ts_setters.h.

                                                                               {
  object.object_id.value = id;
  object.object_id_is_present = true;
}

◆ setCartesianAngle()

void etsi_its_cpm_ts_msgs::access::setCartesianAngle	(	CartesianAngle &	angle,
		const double	value,
		double	confidence = std::numeric_limits<double>::infinity() )

inline

Set a Cartesian Angle.

Parameters

angle	The CartesianAngle object to be set.
value	Angle in radians to be set in the CartesianAngle object.
confidence	standard deviation of the angle in radians (default: infinity, which will map to AngleConfidence::UNAVAILABLE).

Definition at line 273 of file cpm_ts_setters.h.

◆ setCartesianCoordinateWithConfidence()

void etsi_its_cpm_ts_msgs::access::setCartesianCoordinateWithConfidence	(	CartesianCoordinateWithConfidence &	coordinate,
		const double	value,
		const double	confidence = std::numeric_limits<double>::infinity() )

inline

Sets the value and confidence of a CartesianCoordinateWithConfidence object.

This function sets the value and confidence of a CartesianCoordinateWithConfidence object. The value is limited to the range defined by CartesianCoordinateLarge::NEGATIVE_OUT_OF_RANGE and CartesianCoordinateLarge::POSITIVE_OUT_OF_RANGE. The confidence is limited to the range defined by CoordinateConfidence::MIN and CoordinateConfidence::MAX. If the provided confidence is out of range, the confidence value is set to CoordinateConfidence::OUT_OF_RANGE.

Parameters

coordinate	The CartesianCoordinateWithConfidence object to be modified.
value	The value to be set in centimeters.
confidence	The confidence to be set in centimeters (default: infinity, which will map to CoordinateConfidence::UNAVAILABLE).

Definition at line 153 of file cpm_ts_setters.h.

◆ setDimensionsOfPerceivedObject()

void etsi_its_cpm_ts_msgs::access::setDimensionsOfPerceivedObject	(	PerceivedObject &	object,
		const gm::Vector3 &	dimensions,
		const double	x_std = std::numeric_limits<double>::infinity(),
		const double	y_std = std::numeric_limits<double>::infinity(),
		const double	z_std = std::numeric_limits<double>::infinity() )

inline

Sets all dimensions of a perceived object.

This function sets the dimensions of a perceived object using the provided dimensions and confidence values.

Parameters

object	The perceived object to set the dimensions for.
dimensions	The dimensions of the object as a gm::Vector3 (x, y, z) in meters.
x_std	The standard deviation in meters for the x dimension (optional, default: infinity).
y_std	The standard deviation in meters for the y dimension (optional, default: infinity).
z_std	The standard deviation in meters for the z dimension (optional, default: infinity).

Definition at line 620 of file cpm_ts_setters.h.

◆ setFromUTMPosition() [1/2]

void etsi_its_cpm_ts_msgs::access::setFromUTMPosition	(	CollectivePerceptionMessage &	cpm,
		const gm::PointStamped &	utm_position,
		const int &	zone,
		const bool &	northp )

inline

Set the ReferencePosition of a CPM from a given UTM-Position.

The position is transformed to latitude and longitude by using GeographicLib::UTMUPS The z-Coordinate is directly used as altitude value The frame_id of the given utm_position must be set to 'utm_<zone><N/S>'

Parameters

[out]	cpm	CPM for which to set the ReferencePosition
[in]	utm_position	geometry_msgs::PointStamped describing the given utm position in meters
[in]	zone	the UTM zone (zero means UPS) of the given position
[in]	northp	hemisphere (true means north, false means south)

Definition at line 103 of file cpm_ts_setters.h.

◆ setFromUTMPosition() [2/2]

template<typename T>

void etsi_its_cpm_ts_msgs::access::setFromUTMPosition	(	T &	reference_position,
		const gm::PointStamped &	utm_position,
		const int	zone,
		const bool	northp )

inline

Set the ReferencePosition from a given UTM-Position.

The position is transformed to latitude and longitude by using GeographicLib::UTMUPS The z-Coordinate is directly used as altitude value The frame_id of the given utm_position must be set to 'utm_<zone><N/S>'

Parameters

[out]	reference_position	ReferencePostion or ReferencePositionWithConfidence to set
[in]	utm_position	geometry_msgs::PointStamped describing the given utm position
[in]	zone	the UTM zone (zero means UPS) of the given position
[in]	northp	hemisphere (true means north, false means south)

Definition at line 281 of file cpm_ts_setters.h.

◆ setHeadingCDD()

template<typename Heading, typename HeadingConfidence = decltype(Heading::heading_confidence)>

void etsi_its_cpm_ts_msgs::access::setHeadingCDD	(	Heading &	heading,
		const double	value,
		double	confidence = std::numeric_limits<double>::infinity() )

Set the Heading object.

0.0° equals WGS84 North, 90.0° equals WGS84 East, 180.0° equals WGS84 South and 270.0° equals WGS84 West HeadingConfidence is set to UNAVAILABLE

Parameters

heading	object to set
value	Heading value in degree as decimal number
confidence	standard deviation of heading in degree as decimal number (default: infinity, mapping to HeadingConfidence::UNAVAILABLE)

Definition at line 340 of file cpm_ts_setters.h.

◆ setHeadingConfidence()

template<typename HeadingConfidence>

void etsi_its_cpm_ts_msgs::access::setHeadingConfidence	(	HeadingConfidence &	heading_confidence,
		const double	value )

inline

Set the Heading Confidence object.

Parameters

heading_confidence	object to set
value	standard deviation of heading in degree as decimal number

Definition at line 319 of file cpm_ts_setters.h.

◆ setHeadingValue()

template<typename HeadingValue>

void etsi_its_cpm_ts_msgs::access::setHeadingValue	(	HeadingValue &	heading,
		const double	value )

inline

Set the HeadingValue object.

0.0° equals WGS84 North, 90.0° equals WGS84 East, 180.0° equals WGS84 South and 270.0° equals WGS84 West

Parameters

heading	object to set
value	Heading value in degree as decimal number

Definition at line 306 of file cpm_ts_setters.h.

◆ setIdOfPerceivedObject()

void etsi_its_cpm_ts_msgs::access::setIdOfPerceivedObject	(	PerceivedObject &	object,
		const uint16_t	id )

inline

Set the ID of a PerceivedObject.

Sets the object_id of the PerceivedObject to the given ID.

Parameters

object	PerceivedObject to set the ID for
id	ID to set

Definition at line 116 of file cpm_ts_setters.h.

◆ setItsPduHeader() [1/2]

void etsi_its_cpm_ts_msgs::access::setItsPduHeader	(	CollectivePerceptionMessage &	cpm,
		const uint32_t	station_id,
		const uint8_t	protocol_version = 0 )

inline

Sets the ITS PDU header of a CPM.

This function sets the ITS PDU header of a CPM with the provided station ID and protocol version.

Parameters

cpm	The CPM to set the ITS PDU header for.
station_id	The station ID to set in the ITS PDU header.
protocol_version	The protocol version to set in the ITS PDU header. Default is 0.

Definition at line 50 of file cpm_ts_setters.h.

◆ setItsPduHeader() [2/2]

void etsi_its_cpm_ts_msgs::access::setItsPduHeader	(	ItsPduHeader &	header,
		const uint8_t	message_id,
		const uint32_t	station_id,
		const uint8_t	protocol_version = 0 )

inline

Set the Its Pdu Header object.

Parameters

header	ItsPduHeader to be set
message_id	ID of the message
station_id
protocol_version

Definition at line 48 of file cpm_ts_setters.h.

◆ setLateralAcceleration()

void etsi_its_cpm_ts_msgs::access::setLateralAcceleration	(	AccelerationComponent &	accel,
		const double	value,
		const double	confidence )

inline

Set the LateralAcceleration object.

AccelerationConfidence is set to UNAVAILABLE

Parameters

accel	object to set
value	LaterallAccelerationValue in m/s^2 as decimal number (left is positive)

Definition at line 112 of file cpm_ts_setters.h.

◆ setLateralAccelerationValue()

void etsi_its_cpm_ts_msgs::access::setLateralAccelerationValue	(	AccelerationValue &	accel,
		const double	value )

inline

Set the LateralAccelerationValue object.

Parameters

accel	object to set
value	LateralAccelerationValue in m/s^2 as decimal number (left is positive)

Definition at line 93 of file cpm_ts_setters.h.

◆ setLatitude()

void etsi_its_cpm_ts_msgs::access::setLatitude	(	Latitude &	latitude,
		const double	deg )

inline

Set the Latitude object.

Parameters

latitude	object to set
deg	Latitude value in degree as decimal number

Definition at line 90 of file cpm_ts_setters.h.

◆ setLongitude()

void etsi_its_cpm_ts_msgs::access::setLongitude	(	Longitude &	longitude,
		const double	deg )

inline

Set the Longitude object.

Parameters

longitude	object to set
deg	Longitude value in degree as decimal number

Definition at line 102 of file cpm_ts_setters.h.

◆ setLongitudinalAcceleration()

void etsi_its_cpm_ts_msgs::access::setLongitudinalAcceleration	(	AccelerationComponent &	accel,
		const double	value,
		const double	confidence )

inline

Set the LongitudinalAcceleration object.

AccelerationConfidence is set to UNAVAILABLE

Parameters

accel	object to set
value	LongitudinalAccelerationValue in m/s^2 as decimal number (braking is negative)

Definition at line 82 of file cpm_ts_setters.h.

◆ setLongitudinalAccelerationValue()

void etsi_its_cpm_ts_msgs::access::setLongitudinalAccelerationValue	(	AccelerationValue &	accel,
		const double	value )

inline

Set the LongitudinalAccelerationValue object.

Parameters

accel	object to set
value	LongitudinalAccelerationValue in m/s^2 as decimal number (braking is negative)

Definition at line 63 of file cpm_ts_setters.h.

◆ setMeasurementDeltaTimeOfPerceivedObject()

void etsi_its_cpm_ts_msgs::access::setMeasurementDeltaTimeOfPerceivedObject	(	PerceivedObject &	object,
		const int16_t	delta_time = 0 )

inline

Sets the measurement delta time of a PerceivedObject.

This function sets the measurement delta time of a PerceivedObject. The measurement delta time represents the time difference between the reference time of the CPM and the measurement of the object.

Parameters

object	The PerceivedObject to set the measurement delta time for.
delta_time	The measurement delta time to set in milliseconds. Default value is 0.

Exceptions

std::invalid_argument if the delta_time is out of range.

Definition at line 132 of file cpm_ts_setters.h.

◆ setObjectDimension()

void etsi_its_cpm_ts_msgs::access::setObjectDimension	(	ObjectDimension &	dimension,
		const double	value,
		const double	confidence = std::numeric_limits<double>::infinity() )

inline

Sets the object dimension with the given value and confidence.

This function sets the value and confidence of the object dimension based on the provided parameters. The value is limited to the range defined by ObjectDimensionValue::MIN and ObjectDimensionValue::MAX. If the provided value is outside this range, the dimension value is set to ObjectDimensionValue::OUT_OF_RANGE.

The confidence is limited to the range defined by ObjectDimensionConfidence::MIN and ObjectDimensionConfidence::MAX. If the provided confidence is outside this range, the confidence value is set to ObjectDimensionConfidence::OUT_OF_RANGE.

Parameters

dimension	The object dimension to be set.
value	The value of the object dimension in decimeters.
confidence	The confidence of the object dimension in decimeters (optional, default is infinty, mapping to ObjectDimensionConfidence::UNAVAILABLE).

Definition at line 541 of file cpm_ts_setters.h.

◆ setPolarAccelerationOfPerceivedObject()

void etsi_its_cpm_ts_msgs::access::setPolarAccelerationOfPerceivedObject	(	PerceivedObject &	object,
		const double	magnitude,
		const double	angle,
		const double	z = 0.0,
		const double	magnitude_std = std::numeric_limits<double>::infinity(),
		const double	angle_std = std::numeric_limits<double>::infinity(),
		const double	z_std = std::numeric_limits<double>::infinity() )

inline

Set the Polar Acceleration Of Perceived Object object.

Parameters

object	PerceivedObject to set the Polar Acceleration for
magnitude	The magnitude of the acceleration in m/s^2 in the xy plane.
angle	The angle of the acceleration in radians in the xy plane.
z	The z component of the acceleration in m/s^2 (default: 0.0).
magnitude_std	The standard deviation in m/s^2 for the acceleration magnitude (default: infinity).
angle_std	The standard deviation in radians for the angle (default: infinity).
z_std	The standard deviation in m/s^2 for the z acceleration component (default: infinity).

Definition at line 425 of file cpm_ts_setters.h.

◆ setPolarVelocityOfPerceivedObject()

void etsi_its_cpm_ts_msgs::access::setPolarVelocityOfPerceivedObject	(	PerceivedObject &	object,
		const double	magnitude,
		const double	angle,
		const double	z = 0.0,
		const double	magnitude_std = std::numeric_limits<double>::infinity(),
		const double	angle_std = std::numeric_limits<double>::infinity(),
		const double	z_std = std::numeric_limits<double>::infinity() )

inline

Sets the velocity of a perceived object.

This function sets the velocity of a perceived object using the provided Polar velocity components. Optionally, confidence values can be specified for each velocity component.

Parameters

object	The perceived object for which the velocity is being set.
magnitude	The magnitude of the velocity in m/s in the xy plane.
angle	The angle of the velocity in radians in the xy plane.
z	The z component of the velocity in m/s (default: 0.0).
magnitude_std	The standard deviation in m/s for the velocity magnitude (default: infinity).
angle_std	The standard deviation in radians for the angle (default: infinity).
z_std	The standard deviation in m/s for the z velocity component (default: infinity).

Definition at line 335 of file cpm_ts_setters.h.

◆ setPosConfidenceEllipse() [1/2]

template<typename PosConfidenceEllipse>

void etsi_its_cpm_ts_msgs::access::setPosConfidenceEllipse	(	PosConfidenceEllipse &	position_confidence_ellipse,
		const double	semi_major_axis,
		const double	semi_minor_axis,
		const double	orientation )

inline

Set the Pos Confidence Ellipse object.

Parameters

[out]	position_confidence_ellipse	The PosConfidenceEllipse to set
[in]	semi_major_axis	length of the semi-major axis in meters
[in]	semi_minor_axis	length of the semi-minor axis in meters
[in]	orientation	of the semi-major axis in degrees, with respect to WGS84

Definition at line 418 of file cpm_ts_setters.h.

◆ setPosConfidenceEllipse() [2/2]

template<typename PosConfidenceEllipse>

void etsi_its_cpm_ts_msgs::access::setPosConfidenceEllipse	(	PosConfidenceEllipse &	position_confidence_ellipse,
		const std::array< double, 4 > &	covariance_matrix,
		const double	object_heading )

inline

Set the Pos Confidence Ellipse object.

Parameters

position_confidence_ellipse
covariance_matrix	The four values of the covariance matrix in the order: cov_xx, cov_xy, cov_yx, cov_yy The matrix has to be SPD, otherwise a std::invalid_argument exception is thrown. Its coordinate system is aligned with the object (x = longitudinal, y = lateral)
object_heading	The heading of the object in rad, with respect to WGS84

Definition at line 491 of file cpm_ts_setters.h.

◆ setPositionConfidenceEllipse() [1/2]

template<typename PositionConfidenceEllipse, typename Wgs84AngleValue = decltype(PositionConfidenceEllipse::semi_major_axis_orientation)>

void etsi_its_cpm_ts_msgs::access::setPositionConfidenceEllipse	(	PositionConfidenceEllipse &	position_confidence_ellipse,
		const double	semi_major_axis,
		const double	semi_minor_axis,
		const double	orientation )

inline

Set the Position Confidence Ellipse object.

Parameters

position_confidence_ellipse	The position confidence ellipse to set
semi_major_axis	The length of the semi-major axis in meters
semi_minor_axis	The length of the semi-minor axis in meters
orientation	The orientation of the semi-major axis in degrees, relative to WGS84

Definition at line 126 of file cpm_ts_setters.h.

◆ setPositionConfidenceEllipse() [2/2]

template<typename PositionConfidenceEllipse>

void etsi_its_cpm_ts_msgs::access::setPositionConfidenceEllipse	(	PositionConfidenceEllipse &	position_confidence_ellipse,
		const std::array< double, 4 > &	covariance_matrix,
		const double	object_heading )

inline

Set the Position Confidence Ellipse object.

Parameters

position_confidence_ellipse
covariance_matrix	The four values of the covariance matrix in the order: cov_xx, cov_xy, cov_yx, cov_yy The matrix has to be SPD, otherwise a std::invalid_argument exception is thrown. Its coordinate system is aligned with the object (x = longitudinal, y = lateral)
object_heading	The heading of the object in rad, with respect to WGS84

Definition at line 143 of file cpm_ts_setters.h.

◆ setPositionOfPerceivedObject()

void etsi_its_cpm_ts_msgs::access::setPositionOfPerceivedObject	(	PerceivedObject &	object,
		const gm::Point &	point,
		const double	x_std = std::numeric_limits<double>::infinity(),
		const double	y_std = std::numeric_limits<double>::infinity(),
		const double	z_std = std::numeric_limits<double>::infinity() )

inline

Sets the position of a perceived object (relative to the CPM's reference position).

This function sets the position of a perceived object using the provided coordinates and confidence values.

Parameters

object	The PerceivedObject to set the position for.
point	The gm::Point representing the coordinates of the object in meters.
x_std	The standard deviation in meters for the x-coordinate (default: infinity).
y_std	The standard deviation in meters for the y-coordinate (default: infinity).
z_std	The standard deviation in meters for the z-coordinate (default: infinity).

Definition at line 185 of file cpm_ts_setters.h.

◆ setReferencePosition() [1/2]

void etsi_its_cpm_ts_msgs::access::setReferencePosition	(	CollectivePerceptionMessage &	cpm,
		const double	latitude,
		const double	longitude,
		const double	altitude = AltitudeValue::UNAVAILABLE )

inline

Set the ReferencePositionWithConfidence for a CPM TS.

This function sets the latitude, longitude, and altitude of the CPMs reference position. If the altitude is not provided, it is set to AltitudeValue::UNAVAILABLE.

Parameters

cpm	CPM to set the ReferencePosition
latitude	The latitude value position in degree as decimal number.
longitude	The longitude value in degree as decimal number.
altitude	The altitude value (above the reference ellipsoid surface) in meter as decimal number (optional).

Definition at line 86 of file cpm_ts_setters.h.

◆ setReferencePosition() [2/2]

template<typename T>

void etsi_its_cpm_ts_msgs::access::setReferencePosition	(	T &	ref_position,
		const double	latitude,
		const double	longitude,
		const double	altitude = AltitudeValue::UNAVAILABLE )

inline

Sets the reference position in the given ReferencePostion object.

This function sets the latitude, longitude, and altitude of the reference position. If the altitude is not provided, it is set to AltitudeValue::UNAVAILABLE.

Parameters

ref_position	ReferencePostion or ReferencePositionWithConfidence object to set the reference position in.
latitude	The latitude value position in degree as decimal number.
longitude	The longitude value in degree as decimal number.
altitude	The altitude value (above the reference ellipsoid surface) in meter as decimal number (optional).

Definition at line 255 of file cpm_ts_setters.h.

◆ setReferenceTime()

void etsi_its_cpm_ts_msgs::access::setReferenceTime	(	CollectivePerceptionMessage &	cpm,
		const uint64_t	unix_nanosecs,
		const uint16_t	n_leap_seconds = etsi_its_msgs::LEAP_SECOND_INSERTIONS_SINCE_2004.rbegin()->second )

inline

Sets the reference time in a CPM.

This function sets the reference time in a CPM object. The reference time is represented by a Unix timestamp in nanoseconds including the number of leap seconds. The reference time is stored in the payload management container of the CPM.

Parameters

cpm	The CPM object to set the reference time in.
unix_nanosecs	The Unix timestamp in nanoseconds representing the reference time.
n_leap_seconds	The number of leap seconds to be considered. Defaults to the todays number of leap seconds since 2004.

Definition at line 66 of file cpm_ts_setters.h.

◆ setSemiAxis()

template<typename SemiAxisLength>

void etsi_its_cpm_ts_msgs::access::setSemiAxis	(	SemiAxisLength &	semi_axis_length,
		const double	length )

inline

Set the Semi Axis length.

// See https://godbolt.org/z/Eceavfo99 on how the OneCentimeterHelper works with this template

Parameters

semi_axis_length	The SemiAxisLength to set
length	the desired length in meters

Definition at line 399 of file cpm_ts_setters.h.

◆ setSensorID()

void etsi_its_cpm_ts_msgs::access::setSensorID	(	SensorInformation &	sensor_information,
		const uint8_t	sensor_id = 0 )

inline

Sets the sensorId of a SensorInformation object.

This function sets the sensorId of a SensorInformation object. The sensorId is limited to the range defined by Identifier1B::MIN and Identifier1B::MAX.

Parameters

sensor_information	The SensorInformation object to set the sensorId for.
sensor_id	The sensorId to set (default: 0).

Exceptions

std::invalid_argument if the sensor_id is out of range.

Definition at line 755 of file cpm_ts_setters.h.

◆ setSensorType()

void etsi_its_cpm_ts_msgs::access::setSensorType	(	SensorInformation &	sensor_information,
		const uint8_t	sensor_type = SensorType::UNDEFINED )

inline

Sets the sensorType of a SensorInformation object.

This function sets the sensorType of a SensorInformation object. The sensorType is limited to the range defined by SensorType::MIN and SensorType::MAX.

Parameters

sensor_information	The SensorInformation object to set the sensorType for.
sensor_type	The sensorType to set (default: SensorType::UNDEFINED).

Exceptions

std::invalid_argument if the sensor_type is out of range.

Definition at line 770 of file cpm_ts_setters.h.

◆ setSpeed()

void etsi_its_cpm_ts_msgs::access::setSpeed	(	Speed &	speed,
		const double	value,
		const double	confidence = std::numeric_limits<double>::infinity() )

inline

Set the Speed object.

SpeedConfidence is set to UNAVAILABLE

Parameters

speed	object to set
value	Speed in in m/s as decimal number
confidence	standard deviation in m/s as decimal number (Optional. Default is std::numeric_limits<double>::infinity(), mapping to SpeedConfidence::UNAVAILABLE)

Definition at line 175 of file cpm_ts_setters.h.

◆ setSpeedConfidence()

void etsi_its_cpm_ts_msgs::access::setSpeedConfidence	(	SpeedConfidence &	speed_confidence,
		const double	value )

inline

Set the Speed Confidence object.

Parameters

speed_confidence	object to set
value	standard deviation in m/s as decimal number

Definition at line 156 of file cpm_ts_setters.h.

◆ setSpeedValue()

void etsi_its_cpm_ts_msgs::access::setSpeedValue	(	SpeedValue &	speed,
		const double	value )

inline

Set the SpeedValue object.

Parameters

speed	object to set
value	SpeedValue in m/s as decimal number

Definition at line 144 of file cpm_ts_setters.h.

◆ setStationId()

template<typename StationId>

void etsi_its_cpm_ts_msgs::access::setStationId	(	StationId &	station_id,
		const uint32_t	id_value )

inline

Set the Station Id object.

Parameters

station_id
id_value

Definition at line 51 of file cpm_ts_setters.h.

◆ setStationType()

template<typename StationType>

void etsi_its_cpm_ts_msgs::access::setStationType	(	StationType &	station_type,
		const uint8_t	value )

inline

Set the Station Type.

Parameters

station_type
value

Definition at line 63 of file cpm_ts_setters.h.

◆ setTimestampITS()

void etsi_its_cpm_ts_msgs::access::setTimestampITS	(	TimestampIts &	timestamp_its,
		const uint64_t	unix_nanosecs,
		const uint16_t	n_leap_seconds = etsi_its_msgs::LEAP_SECOND_INSERTIONS_SINCE_2004.rbegin()->second )

inline

Set the TimestampITS object.

Parameters

[in]	timestamp_its	TimestampITS object to set the timestamp
[in]	unix_nanosecs	Unix-Nanoseconds to set the timestamp for
[in]	n_leap_seconds	Number of leap-seconds since 2004. (Defaults to the todays number of leap seconds since 2004.)
[in]	epoch_offset	Unix-Timestamp in seconds for the 01.01.2004 at 00:00:00

Definition at line 76 of file cpm_ts_setters.h.

◆ setUTMPositionOfPerceivedObject()

void etsi_its_cpm_ts_msgs::access::setUTMPositionOfPerceivedObject	(	CollectivePerceptionMessage &	cpm,
		PerceivedObject &	object,
		const gm::PointStamped &	utm_position,
		const double	x_std = std::numeric_limits<double>::infinity(),
		const double	y_std = std::numeric_limits<double>::infinity(),
		const double	z_std = std::numeric_limits<double>::infinity() )

inline

Sets the position of a perceived object based on a UTM position.

This function sets the position of a perceived object using the provided UTM position and the CPM's reference position. It also allows specifying confidence values for the x, y, and z coordinates.

Parameters

cpm	The CPM to get the reference position from.
object	The PerceivedObject to set the position for.
utm_position	gm::PointStamped representing the UTM position of the object including the frame_id (utm_<zone><N/S>).
x_confidence	The standard deviation in meters for the x coordinate (default: CoordinateConfidence::UNAVAILABLE).
y_confidence	The standard deviation in meters for the y coordinate (default: CoordinateConfidence::UNAVAILABLE).
z_confidence	The standard deviation in meters for the z coordinate (default: CoordinateConfidence::UNAVAILABLE).

Exceptions

std::invalid_argument if the UTM-Position frame_id does not match the reference position frame_id.

Definition at line 212 of file cpm_ts_setters.h.

◆ setVelocityComponent()

void etsi_its_cpm_ts_msgs::access::setVelocityComponent	(	VelocityComponent &	velocity,
		const double	value,
		const double	confidence = std::numeric_limits<double>::infinity() )

inline

Sets the value and confidence of a VelocityComponent.

This function sets the value and confidence of a VelocityComponent object. The value is limited to a specific range, and the confidence is limited to a specific range as well. If the provided value or confidence is out of range, it will be set to the corresponding out-of-range value.

Parameters

velocity	The VelocityComponent object to set the value and confidence for.
value	The value to set for the VelocityComponent in cm/s.
confidence	The confidence to set for the VelocityComponent in cm/s. Default value is infinity, mapping to SpeedConfidence::UNAVAILABLE.

Definition at line 245 of file cpm_ts_setters.h.

◆ setVelocityOfPerceivedObject()

void etsi_its_cpm_ts_msgs::access::setVelocityOfPerceivedObject	(	PerceivedObject &	object,
		const gm::Vector3 &	cartesian_velocity,
		const double	x_std = std::numeric_limits<double>::infinity(),
		const double	y_std = std::numeric_limits<double>::infinity(),
		const double	z_std = std::numeric_limits<double>::infinity() )

inline

Sets the velocity of a perceived object.

This function sets the velocity of a perceived object using the provided Cartesian velocity components. Optionally, confidence values can be specified for each velocity component.

Parameters

object	The perceived object for which the velocity is being set.
cartesian_velocity	The Cartesian velocity components (x, y, z) of the object (in m/s).
x_std	The standard deviation in m/s for the x velocity component (default: infinity).
y_std	The standard deviation in m/s for the y velocity component (default: infinity).
z_std	The standard deviation in m/s for the z velocity component (default: infinity).

Definition at line 305 of file cpm_ts_setters.h.

◆ setWGSPosConfidenceEllipse()

template<typename PosConfidenceEllipse>

void etsi_its_cpm_ts_msgs::access::setWGSPosConfidenceEllipse	(	PosConfidenceEllipse &	position_confidence_ellipse,
		const std::array< double, 4 > &	covariance_matrix )

inline

Set the Pos Confidence Ellipse object.

Parameters

position_confidence_ellipse
covariance_matrix	The four values of the covariance matrix in the order: cov_xx, cov_xy, cov_yx, cov_yy The matrix has to be SPD, otherwise a std::invalid_argument exception is thrown. Its coordinate system is aligned with the WGS axes (x = North, y = East)
object_heading	The heading of the object in rad, with respect to WGS84

Definition at line 506 of file cpm_ts_setters.h.

◆ setWGSPositionConfidenceEllipse()

template<typename PositionConfidenceEllipse>

void etsi_its_cpm_ts_msgs::access::setWGSPositionConfidenceEllipse	(	PositionConfidenceEllipse &	position_confidence_ellipse,
		const std::array< double, 4 > &	covariance_matrix )

inline

Set the Position Confidence Ellipse object.

Parameters

position_confidence_ellipse
covariance_matrix	The four values of the covariance matrix in the order: cov_xx, cov_xy, cov_yx, cov_yy The matrix has to be SPD, otherwise a std::invalid_argument exception is thrown. Its coordinate system is aligned with the WGS axes (x = North, y = East)
object_heading	The heading of the object in rad, with respect to WGS84

Definition at line 158 of file cpm_ts_setters.h.

◆ setWGSRefPosConfidence()

void etsi_its_cpm_ts_msgs::access::setWGSRefPosConfidence	(	CollectivePerceptionMessage &	cpm,
		const std::array< double, 4 > &	covariance_matrix )

inline

Set the confidence of the reference position.

Parameters

cpm	CPM-Message to set the confidence
covariance_matrix	The four values of the covariance matrix in the order: cov_xx, cov_xy, cov_yx, cov_yy The matrix has to be SPD, otherwise a std::invalid_argument exception is thrown. Its coordinate system is WGS84 (x = North, y = East)

Definition at line 727 of file cpm_ts_setters.h.

◆ setXDimensionOfPerceivedObject()

void etsi_its_cpm_ts_msgs::access::setXDimensionOfPerceivedObject	(	PerceivedObject &	object,
		const double	value,
		const double	std = std::numeric_limits<double>::infinity() )

inline

Sets the x-dimension of a perceived object.

This function sets the x-dimension of the given PerceivedObject to the specified value. The x-dimension usually represents the length of the object.

Parameters

object	The PerceivedObject to modify.
value	The value to set as the x-dimension in meters.
std	The standard deviation of the x-dimension value in meters (optional, default is infinity).

Definition at line 571 of file cpm_ts_setters.h.

◆ setYawOfPerceivedObject()

void etsi_its_cpm_ts_msgs::access::setYawOfPerceivedObject	(	PerceivedObject &	object,
		const double	yaw,
		double	yaw_std = std::numeric_limits<double>::infinity() )

inline

Sets the yaw angle of a perceived object.

This function sets the yaw angle of a PerceivedObject. The yaw angle is wrapped to the range [0, 360] degrees. The function also allows specifying the confidence level of the yaw angle.

Parameters

object	The PerceivedObject to set the yaw angle for.
yaw	The yaw angle in radians.
yaw_std	The standard deviation of the yaw angle in radians (optional, default is Infinity).

Definition at line 455 of file cpm_ts_setters.h.

◆ setYawRateCDD()

template<typename YawRate, typename YawRateValue = decltype(YawRate::yaw_rate_value), typename YawRateConfidence = decltype(YawRate::yaw_rate_confidence)>

void etsi_its_cpm_ts_msgs::access::setYawRateCDD	(	YawRate &	yaw_rate,
		const double	value,
		double	confidence = std::numeric_limits<double>::infinity() )

inline

Set the Yaw Rate object.

Parameters

yaw_rate	object to set
value	Yaw rate in degrees per second as decimal number
confidence	standard deviation of yaw rate in degrees per second as decimal number (default: infinity, mapping to YawRateConfidence::UNAVAILABLE)

Definition at line 353 of file cpm_ts_setters.h.

◆ setYawRateOfPerceivedObject()

void etsi_its_cpm_ts_msgs::access::setYawRateOfPerceivedObject	(	PerceivedObject &	object,
		const double	yaw_rate,
		double	yaw_rate_std = std::numeric_limits<double>::infinity() )

inline

Sets the yaw rate of a perceived object.

This function sets the yaw rate of a PerceivedObject. The yaw rate is limited to the range defined by CartesianAngularVelocityComponentValue::NEGATIVE_OUTOF_RANGE and CartesianAngularVelocityComponentValue::POSITIVE_OUT_OF_RANGE. The function also allows specifying the confidence level of the yaw rate.

Parameters

object	The PerceivedObject to set the yaw rate for.
yaw_rate	The yaw rate in rad/s.
yaw_rate_std	Standard deviation of the yaw rate in rad/s (optional, default is infinity, mapping to AngularSpeedConfidence::UNAVAILABLE).

Definition at line 489 of file cpm_ts_setters.h.

◆ setYDimensionOfPerceivedObject()

void etsi_its_cpm_ts_msgs::access::setYDimensionOfPerceivedObject	(	PerceivedObject &	object,
		const double	value,
		const double	std = std::numeric_limits<double>::infinity() )

inline

Sets the y-dimension of a perceived object.

This function sets the y-dimension of the given PerceivedObject to the specified value. The y-dimension usually represents the width of the object.

Parameters

object	The PerceivedObject to modify.
value	The value to set as the y-dimension in meters.
std	The standard deviation of the y-dimension value in meters (optional, default is infinity).

Definition at line 587 of file cpm_ts_setters.h.

◆ setZDimensionOfPerceivedObject()

void etsi_its_cpm_ts_msgs::access::setZDimensionOfPerceivedObject	(	PerceivedObject &	object,
		const double	value,
		const double	std = std::numeric_limits<double>::infinity() )

inline

Sets the z-dimension of a perceived object.

This function sets the z-dimension of the given PerceivedObject to the specified value. The z-dimension usually represents the height of the object.

Parameters

object	The PerceivedObject to modify.
value	The value to set as the z-dimension in meters.
std	The standard deviation of the z-dimension value in meters (optional, default is infinity).

Definition at line 603 of file cpm_ts_setters.h.

◆ throwIfNotPresent()

void etsi_its_cpm_ts_msgs::access::throwIfNotPresent	(	const bool	is_present,
		const std::string	val_desc )

inline

Throws an exception if the given value is not present.

Parameters

is_present	Whether the value is present.
val_desc	Description of the value for the exception message.

Definition at line 58 of file cpm_ts_setters.h.

◆ throwIfOutOfRange()

template<typename T1, typename T2>

void etsi_its_cpm_ts_msgs::access::throwIfOutOfRange	(	const T1 &	val,
		const T2 &	min,
		const T2 &	max,
		const std::string	val_desc )

Throws an exception if a given value is out of a defined range.

Template Parameters

T1
T2

Parameters

val	The value to check if it is in the range.
min	The minimum value of the range.
max	The maximum value of the range.
val_desc	Description of the value for the exception message.

Definition at line 47 of file cpm_ts_setters.h.

Variable Documentation

◆ LEAP_SECOND_INSERTIONS_SINCE_2004

const std::map<uint64_t, uint16_t> etsi_its_cpm_ts_msgs::access::etsi_its_msgs::LEAP_SECOND_INSERTIONS_SINCE_2004

Initial value:

std::map that stores all leap second insertions since 2004 with the corresponding unix-date of the insertion

Definition at line 46 of file cpm_ts_setters.h.

◆ ONE_D_GAUSSIAN_FACTOR

const double etsi_its_cpm_ts_msgs::access::etsi_its_msgs::ONE_D_GAUSSIAN_FACTOR = 2.0

constexpr

Definition at line 72 of file cpm_ts_setters.h.

◆ TWO_D_GAUSSIAN_FACTOR

const double etsi_its_cpm_ts_msgs::access::etsi_its_msgs::TWO_D_GAUSSIAN_FACTOR = 2.4477

constexpr

Definition at line 76 of file cpm_ts_setters.h.

◆ UNIX_SECONDS_2004

const uint64_t etsi_its_cpm_ts_msgs::access::etsi_its_msgs::UNIX_SECONDS_2004 = 1072915200

Definition at line 40 of file cpm_ts_setters.h.

Classes

Functions

Variables

Detailed Description

Function Documentation

◆ addContainerToCPM()

◆ addPerceivedObjectToContainer()

◆ addSensorInformationContainerToCPM()

◆ addSensorInformationToContainer()

◆ confidenceEllipseFromCovMatrix()

◆ confidenceEllipseFromWGSCovMatrix()

◆ getLeapSecondInsertionsSince2004()

◆ initPerceivedObject()

◆ initPerceivedObjectContainer()

◆ initPerceivedObjectWithUTMPosition()

◆ initSensorInformationContainer()

◆ setAccelerationComponent()

◆ setAccelerationConfidence()

◆ setAccelerationMagnitude()

◆ setAccelerationMagnitudeConfidence()

◆ setAccelerationMagnitudeValue()

◆ setAccelerationOfPerceivedObject()

◆ setAltitude()

◆ setAltitudeValue()

◆ setCartesianAngle()

◆ setCartesianCoordinateWithConfidence()

◆ setDimensionsOfPerceivedObject()

◆ setFromUTMPosition() [1/2]

◆ setFromUTMPosition() [2/2]

◆ setHeadingCDD()

◆ setHeadingConfidence()

◆ setHeadingValue()

◆ setIdOfPerceivedObject()

◆ setItsPduHeader() [1/2]

◆ setItsPduHeader() [2/2]

◆ setLateralAcceleration()

◆ setLateralAccelerationValue()

◆ setLatitude()

◆ setLongitude()

◆ setLongitudinalAcceleration()

◆ setLongitudinalAccelerationValue()

◆ setMeasurementDeltaTimeOfPerceivedObject()

◆ setObjectDimension()

◆ setPolarAccelerationOfPerceivedObject()

◆ setPolarVelocityOfPerceivedObject()

◆ setPosConfidenceEllipse() [1/2]

◆ setPosConfidenceEllipse() [2/2]

◆ setPositionConfidenceEllipse() [1/2]

◆ setPositionConfidenceEllipse() [2/2]

◆ setPositionOfPerceivedObject()

◆ setReferencePosition() [1/2]

◆ setReferencePosition() [2/2]

◆ setReferenceTime()

◆ setSemiAxis()

◆ setSensorID()

◆ setSensorType()

◆ setSpeed()

◆ setSpeedConfidence()

◆ setSpeedValue()

◆ setStationId()

◆ setStationType()

◆ setTimestampITS()

◆ setUTMPositionOfPerceivedObject()

◆ setVelocityComponent()

◆ setVelocityOfPerceivedObject()

◆ setWGSPosConfidenceEllipse()

◆ setWGSPositionConfidenceEllipse()

◆ setWGSRefPosConfidence()

◆ setXDimensionOfPerceivedObject()

◆ setYawOfPerceivedObject()

◆ setYawRateCDD()

◆ setYawRateOfPerceivedObject()

◆ setYDimensionOfPerceivedObject()

◆ setZDimensionOfPerceivedObject()

◆ throwIfNotPresent()

◆ throwIfOutOfRange()

Variable Documentation

◆ LEAP_SECOND_INSERTIONS_SINCE_2004

◆ ONE_D_GAUSSIAN_FACTOR

◆ TWO_D_GAUSSIAN_FACTOR