MovingMobilityBase¶

simple module MovingMobilityBase

Abstract base module for mobility models.

Inheritance diagram¶

Known subclasses¶

Name	Type	Description
MoBanCoordinator	simple module	This is the coordinator module of the MoBAN mobility model. It should be instantiated in the top level simulation network in MiXiM, once per WBAN. The coordinator module is the main module that provides the group mobility and correlation between nodes in a WBAN. In the initialization phase, it reads three user-defined input files which are the posture specification file, a configuration file which includes all required parameters for specific distributions, and the previously logged mobility pattern if it is requested to use a logged pattern. Note that all WBAN instances may use the same input files if they are exactly in the same situation.
MoBanLocal	simple module	This is the local mobility module of MoBAN. It should be instantiated in each node that belongs to a WBAN. The NED parameter `coordinatorIndex` determines to which WBAN (`MoBanCoordinator`) it belongs. The current implementation uses the Random Walk Mobility Model (RWMM) for individual (local) movement with a sphere around the node, with given speed and sphere radius of the current posture. The reference point of the node is the current posture, the sphere radius, and the speed is given by the corresponding coordinator. RWMM determines the location of a node at any time relative to the given reference point.
AnsimMobility	simple module	Uses the <position_change> elements of the ANSim tool’s trace file.
BonnMotionMobility	simple module	Uses the native file format of the BonnMotion tool.
ChiangMobility	simple module	Uses a probabilistic transition matrix to change the state of motion. In this model, the state of the mobile node in each direction (x and y) can be:
CircleMobility	simple module	Moves the node around a circle.
GaussMarkovMobility	simple module	Uses a Gauss-Markov model to control the randomness in the movement. Totally random walk (Brownian motion) is obtained by setting alpha=0, while alpha=1 results in linear motion.
GnssTrackMobility	simple module	Mobility model that follows a recorded GNSS (WGS84) track read from a CSV, GPX, or GeoJSON LineString source, mapping geographic positions into the scene through the `coordinateSystemModule`. Waypoints are interpolated along the great circle, so the path stays on the Earth’s surface even between far-apart points, which works for both cars and aircraft.
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.
MassMobility	simple module	This is a random mobility model for a mobile host with mass. It is the one used in “Optimized Smooth Handoffs in Mobile IP” by Perkins & Wang.
Ns2MotionMobility	simple module
RandomWaypointMobility	simple module	Implements the Random Waypoint mobility model.
RectangleMobility	simple module	Moves the node around a rectangle.
SatelliteMobility	simple module	Mobility model that propagates a satellite orbit from a TLE (two-line element) set using the embedded SGP4 implementation, and reports the position in the simulation scene through the geographic coordinate system referenced by `coordinateSystemModule` (typically a Wgs84EcefGeographicCoordinateSystem); when `coordinateSystemModule` is empty, the position is reported in raw geocentric ECEF coordinates.
TractorMobility	simple module	Moves a tractor through a field with a certain number of rows. Since the tractor also moves around the field, the tractor travels the number of rows PLUS one row. Consider the following piece of ascii-art for rows=2.
TurtleMobility	simple module	A LOGO-style movement model, with the script coming from XML. It can be useful for describing random as well as deterministic scenarios.
VehicleMobility	simple module	Mobility model for ground vehicles that follow waypoints with realistic turning behavior. Reads waypoints from a file and moves the vehicle along them at a specified speed, calculating appropriate angular velocity for turns. Supports terrain following by projecting positions onto the ground and orienting the vehicle according to the ground normal.

Extends¶

Name	Type	Description
MobilityBase	simple module	Abstract base module for mobility models.

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

Properties¶

Name	Value	Description
class	MobilityBase
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¶

//
// Abstract base module for mobility models.
//
simple MovingMobilityBase extends MobilityBase
{
    parameters:
        double updateInterval @unit(s) = default(0.1s); // The simulation time interval used to regularly signal mobility state changes and update the display
        bool faceForward = default(true);
}

File: src/inet/mobility/base/MovingMobilityBase.ned