Package: simu5g.mobility.trafficLightMobility
TrafficLightMobility
simple moduleExtends 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