FacingMobility¶

simple module FacingMobility

Provides orientation towards the target mobility model as seen from the source mobility model.

Inheritance diagram¶

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)
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
sourceMobility	string	“.”	The default source mobility is this
targetMobility	string

Properties¶

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

//
// Provides orientation towards the target mobility model as seen
// from the source mobility model.
//
simple FacingMobility extends MobilityBase
{
    parameters:
        double initialX @unit(m) = default(uniform(this.constraintAreaMinX, this.constraintAreaMaxX));
        double initialY @unit(m) = default(uniform(this.constraintAreaMinY, this.constraintAreaMaxY));
        double initialZ @unit(m) = default(nanToZero(uniform(this.constraintAreaMinZ, this.constraintAreaMaxZ)));
        bool initFromDisplayString = default(true); // Enables one-time initialization from the subject module's display string
        string sourceMobility = default("."); // The default source mobility is this
        string targetMobility @mutable;
        @class(FacingMobility);
}

File: src/inet/mobility/single/FacingMobility.ned