IMobility

module interface

The module interface for mobility models.

Inheritance diagram

The following diagram shows inheritance relationships for this type. Unresolved types are missing from the diagram.

Implemented by

Name	Type	Description
AnsimMobility	simple module	Uses the <position_change> elements of the ANSim tool's trace file.
AttachedMobility	simple module	Provides a mobility that is attached to another mobility at a given offset. The position, velocity, and acceleration are all affected by the respective quantities and the orientation of the mobility where this one is attached.
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.
FacingMobility	simple module	Provides orientation towards the target mobility model as seen from the source mobility model.
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.
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.
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.
MobilityBase	simple module	Abstract base module for mobility models.
MovingMobilityBase	simple module	Abstract base module for mobility models.
Ns2MotionMobility	simple module
RandomWaypointMobility	simple module	Implements the Random Waypoint mobility model.
RectangleMobility	simple module	Moves the node around a rectangle.
StaticConcentricMobility	simple module	Places all hosts on concentric circles
StaticGridMobility	simple module	Places all hosts in a rectangular grid. The usable area (constraint area minus margins on each side) is split into smaller cells (with a `separationX`, `separationY` size). Hosts are placed in the middle of each cell. By default, the number of columns and rows follows the aspect ratio of the usable area. By default, `stepX` and `stepY` are calculated based on the number of columns and rows.
StaticLinearMobility	simple module	Mobility model which places all hosts at constant distances in a line with an orientation
StationaryMobility	simple module	Mobility module for stationary nodes.
SuperpositioningMobility	compound module	Combines the trajectory of several other mobility modules using superposition. In other words, the position, velocity, and acceleration are the sum of the respective quantities of all submodules.
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.

Used in compound modules

Name	Type	Description
AccessPoint	compound module	A wireless access point device that connects wireless stations (like WirelessHost) to a wired network. Supports multiple wireless radios and multiple Ethernet ports.
AntennaBase	compound module	Serves as the base module for antenna models.
MobileHost	compound module	A host for demonstrating mobility models only -- it contains no protocol layers at all.
NodeBase	compound module	The fundamental infrastructure for all network nodes focusing on non-communication aspects of network nodes.
NoiseSource	compound module	A network node that generates periodic noise transmissions that can interfere with wireless communications. Alternates between sleep and transmission states based on configurable intervals. Uses a ~NoiseTransmitter to create noise signals with specified duration, frequency, bandwidth, and power parameters. Useful for testing protocol robustness against interference in wireless networks.
Probe	compound module	A minimal wireless network node that consists only of an antenna and mobility model. Designed for monitoring wireless signals without actively participating in network communication.
SuperpositioningMobility	compound module	Combines the trajectory of several other mobility modules using superposition. In other words, the position, velocity, and acceleration are the sum of the respective quantities of all submodules.

Properties

Name	Value	Description
display	i=block/cogwheel

Signals

Name	Type	Unit	Description
mobilityStateChanged

Source code

//
// The module interface for mobility models.
//
moduleinterface IMobility
{
    parameters:
        @display("i=block/cogwheel");
        @signal[mobilityStateChanged];
}

File: src/inet/mobility/contract/IMobility.ned