TrafficLightMobility

Package: simu5g.mobility.trafficLightMobility

TrafficLightMobility

simple module

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

The following diagram shows inheritance relationships for this type. Unresolved types are missing from the 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