TrafficLightMobility¶

Package: simu5g.mobility.trafficLightMobility

simple module TrafficLightMobility

Extends INET’s Linear Mobility model to simulate the movement of a vehicle navigating roads with intersections regulated by traffic lights. The node implementing this mobility model moves at a constant speed and, if it encounters a TrafficLight module with a “red” color, it stops until the traffic light turns “green”. Upon resuming its movement, the node may change its direction if the “enableTurns” parameter is enabled. This module requires the presence of TrafficLight modules in the same network scenario.

Inheritance diagram¶

Extends¶

Name	Type	Description
LinearMobility ↗	simple module	This is a linear mobility model with speed and angle parameters. Angle only changes when the mobile node hits a wall: then it reflects off the wall at the same angle.

Parameters¶

Name	Type	Default value	Description
displayStringTextFormat	string	“p: {position}\nv: {velocity}”	Determines the text that is written on top of the submodule, supports displaying pars, watches, and module-specific information
subjectModule	string	“^”	The module path that determines the subject module, the motion of which this mobility model describes. The default value is the parent module
coordinateSystemModule	string	“”	The module path of the geographic coordinate system module; optional, empty disables geographic conversion (and the {geo_position} directive)
updateDisplayString	bool	true	Enables continuous update of the subject module’s position by modifying its display string
constraintAreaMinX	double	-inf m	The minimum x position of the constraint area. It is unconstrained by default (negative infinity)
constraintAreaMinY	double	-inf m	The minimum y position of the constraint area. It is unconstrained by default (negative infinity)
constraintAreaMinZ	double	-inf m	The minimum z position of the constraint area. It is unconstrained by default (negative infinity)
constraintAreaMaxX	double	inf m	The maximum x position of the constraint area. It is unconstrained by default (positive infinity)
constraintAreaMaxY	double	inf m	The maximum y position of the constraint area. It is unconstrained by default (positive infinity)
constraintAreaMaxZ	double	inf m	The maximum z position of the constraint area. It is unconstrained by default (positive infinity)
updateInterval	double	0.1s	The simulation time interval used to regularly signal mobility state changes and update the display
faceForward	bool	true
initialX	double	uniform(this.constraintAreaMinX, this.constraintAreaMaxX)
initialY	double	uniform(this.constraintAreaMinY, this.constraintAreaMaxY)
initialZ	double	nanToZero(uniform(this.constraintAreaMinZ, this.constraintAreaMaxZ))
initFromDisplayString	bool	true	Enables one-time initialization from the subject module’s display string
speed	double	0mps	Speed of the host
initialMovementHeading	double	uniform(0deg, 360deg)
initialMovementElevation	double	0deg
initialRoadIndex	int	0
trafficLightsList	object	[]
enableTurns	bool	false

Properties¶

Name	Value	Description
class	TrafficLightMobility
display	i=block/cogwheel

Signals¶

Name	Type	Unit	Description
mobilityStateChanged	inet::MobilityBase		It works in inet, but not in the extended module in another namespace

Source code¶

//
// Extends INET's Linear Mobility model to simulate the movement of
// a vehicle navigating roads with intersections regulated by traffic lights.
// The node implementing this mobility model moves at a constant speed and, if it
// encounters a ~TrafficLight module with a "red" color, it stops until the
// traffic light turns "green". Upon resuming its movement, the node may
// change its direction if the "enableTurns" parameter is enabled. This module
// requires the presence of ~TrafficLight modules in the same network scenario.
//
simple TrafficLightMobility extends LinearMobility
{
    parameters:
        @class(TrafficLightMobility);

        int initialRoadIndex = default(0);
        object trafficLightsList = default([]);
        bool enableTurns = default(false);
}

File: src/simu5g/mobility/trafficLightMobility/TrafficLightMobility.ned