Simple Module MoBANCoordinator

Package: org.mixim.modules.mobility
File: modules/mobility/MoBANCoordinator.ned

C++ definition

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.

After the initialization phase, the MoBAN coordinator decides about the posture and the position of the Logical center of the group (WBAN). The absolute position of the reference point of each belonging node is calculated by adding the current position of the logical center by the reference point of that node in the selected posture. The coordinator publish the position of the reference point as well as the speed and the radius of the local movement of nodes to their blackboards.

MoBANCoordinator

Usage diagram:

The following diagram shows usage relationships between types. Unresolved types are missing from the diagram. Click here to see the full picture.

Inheritance diagram:

The following diagram shows inheritance relationships for this type. Unresolved types are missing from the diagram. Click here to see the full picture.

Networks:

BaseMoBANNetwork (network)

This network is exactly the same as baseNetwork existing among the examples of MiXiM, but the desired number of MoBAN coordinator modules have been added. Some nodes of type BaseNode use MoBANLocal module as their mobility module. Then those nodes will be considered as WBAN nodes. Those node have a parameter named "coordinatorIndex" that determines to which WBAN (coordinator) the node belongs.

Parameters:

Name Type Default value Description
debug bool

debug switch

updateInterval double

Time interval to update the nodes position (seconds).

numNodes int

Number of sendor nodes belong to this WBAN

postureSpecFile xml

The input file that includes the specification of all postures

configFile xml

The configuration file for setting probability vectors, distributions and correlations

useMobilityPattern bool

Set if the logged mobility pattern is used.

mobilityPatternFile string

The input file for mobility pattern if it is going to be used.

Properties:

Name Value Description
class MoBANCoordinator

Source code:

// 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.
//
// After the initialization phase, the MoBAN coordinator decides about the posture and the position of the Logical center of the group (WBAN).
// The absolute position of the reference point of each belonging node is calculated by adding the current position of the logical center
// by the reference point of that node in the selected posture. The coordinator publish the position of the reference point as well as
// the speed and the radius of the local movement of nodes to their blackboards.
simple MoBANCoordinator
{
    parameters:
        @class(MoBANCoordinator);
        bool debug; // debug switch

        double updateInterval @unit(s); // Time interval to update the nodes position (seconds).

        int numNodes;			//Number of sendor nodes belong to this WBAN

        xml postureSpecFile;    // The input file that includes the specification of all postures
        xml configFile;     // The configuration file for setting probability vectors, distributions and correlations

        bool useMobilityPattern; // Set if the logged mobility pattern is used.
        string mobilityPatternFile;  // The input file for mobility pattern if it is going to be used.

}