IMobility

module interface

The module interface for mobility models.

Author: Andras Varga

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.
BonnMotionMobility	simple module	Uses the native file format of BonnMotion (http://www.cs.uni-bonn.de/IV/BonnMotion/).
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.
ConstSpeedMobility	simple module	Controls all movement related things of a host
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 a linear motion.
LinearMobility	simple module	This is a linear mobility model with speed, angle and acceleration parameters. Angle only changes when the mobile node hits a wall: then it reflects off the wall at the same angle.
LinearNodeDistributionMobility	simple module	Mobility model which places all hosts at constant distances in a line with an orientation
MassMobility	simple module	This is a random mobility model for a mobile host with a 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 postures specification file, a configuration file which includes all required parameter 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" determine 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 it the current posture, the sphere radius, and the speed is given by the corresponding coordinator. RWMM determines the location of node at ant 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	TODO: why does this comment refer to BonnMotion instead of NS2?
RandomWPMobility	simple module	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 separationX,separationY size). Hosts are placed in the middle of each cell. By default, the number of columns and rows follow the aspect ratio of the usable area. By default stepX and stepY are calculated based on the number of columns and rows.
StationaryMobility	simple module	This mobility module does nothing; it can be used for stationary nodes.
TractorMobility	simple module	Moves a tractor through a field with a certain amount of rows. Since the tractor also moves around the field, the tractor travels the number of rows PLUS one rows. 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	(no description)

Used in compound modules

Name	Type	Description
AccessPoint	compound module	A generic access point supporting multiple wireless radios, and multiple ethernet ports. The type of the ethernet MAC, relay unit and wireless card can be specified as parameters.
NodeBase	compound module	Contains the common lower layers (linklayer and networklayer) of Router, StandardHost, WirelessHost etc.

Properties

Name	Value	Description
display	i=block/cogwheel_s

Signals

Name	Type	Unit
mobilityStateChanged

Source code

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

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