inet::MovingMobilityBase Class Reference

Base class for moving mobility modules. More...

#include <MovingMobilityBase.h>

Inheritance diagram for inet::MovingMobilityBase:

Public Member Functions
virtual Coord	getCurrentPosition () override
	Returns the current position at the current simulation time. More...
virtual Coord	getCurrentSpeed () override
	Returns the current speed at the current simulation time. More...
virtual EulerAngles	getCurrentAngularPosition () override
	Returns the current angular position at the current simulation time. More...
Public Member Functions inherited from inet::MobilityBase
virtual double	getMaxSpeed () const override
	Returns the maximum possible speed at any future time. More...
virtual EulerAngles	getCurrentAngularSpeed () override
	Returns the current angular speed at the current simulation time. More...
virtual Coord	getConstraintAreaMax () const override
	Returns the current angular acceleration at the current simulation time. More...
virtual Coord	getConstraintAreaMin () const override
Public Member Functions inherited from inet::IMobility
virtual	~IMobility ()

Protected Member Functions
	MovingMobilityBase ()
virtual	~MovingMobilityBase ()
virtual void	initialize (int stage) override
	Initializes mobility model parameters. More...
virtual void	initializePosition () override
	Initializes mobility position. More...
virtual void	handleSelfMessage (cMessage *message) override
	Called upon arrival of a self messages, subclasses must override. More...
void	scheduleUpdate ()
	Schedules the move timer that will update the mobility state. More...
void	moveAndUpdate ()
	Moves and notifies listeners. More...
virtual void	move ()=0
	Moves according to the mobility model to the current simulation time. More...
Protected Member Functions inherited from inet::MobilityBase
	MobilityBase ()
virtual int	numInitStages () const override
	Returns the required number of initialize stages. More...
virtual void	setInitialPosition ()
	Initializes the position from the display string or from module parameters. More...
virtual void	checkPosition ()
	Checks whether the position is valid or not. More...
virtual void	initializeOrientation ()
	Initializes the orientation from module parameters. More...
virtual void	handleMessage (cMessage *msg) override
	This modules should only receive self-messages. More...
virtual void	updateVisualRepresentation ()
	Moves the visual representation module's icon to the new position on the screen. More...
virtual void	emitMobilityStateChangedSignal ()
	Emits a signal with the updated mobility state. More...
virtual Coord	getRandomPosition ()
	Returns a new random position satisfying the constraint area. More...
virtual cModule *	findVisualRepresentation ()
	Returns the module that represents the object moved by this mobility module. More...
virtual bool	isOutside ()
	Returns true if the mobility is outside of the constraint area. More...
virtual void	reflectIfOutside (Coord &targetPosition, Coord &speed, double &angle)
	Utility function to reflect the node if it goes outside the constraint area. More...
virtual void	wrapIfOutside (Coord &targetPosition)
	Utility function to wrap the node to the opposite edge (torus) if it goes outside the constraint area. More...
virtual void	placeRandomlyIfOutside (Coord &targetPosition)
	Utility function to place the node randomly if it goes outside the constraint area. More...
virtual void	raiseErrorIfOutside ()
	Utility function to raise an error if the node gets outside the constraint area. More...
virtual void	handleIfOutside (BorderPolicy policy, Coord &targetPosition, Coord &speed, double &angle)
	Invokes one of reflectIfOutside(), wrapIfOutside() and placeRandomlyIfOutside(), depending on the given border policy. More...

Protected Attributes
cMessage *	moveTimer
	The message used for mobility state changes. More...
simtime_t	updateInterval
	The simulation time interval used to regularly signal mobility state changes. More...
bool	stationary
	A mobility model may decide to become stationary at any time. More...
Coord	lastSpeed
	The last speed that was reported at lastUpdate. More...
simtime_t	lastUpdate
	The simulation time when the mobility state was last updated. More...
simtime_t	nextChange
	The next simulation time when the mobility module needs to update its internal state. More...
Protected Attributes inherited from inet::MobilityBase
cModule *	visualRepresentation
	Pointer to visual representation module, to speed up repeated access. More...
const CanvasProjection *	canvasProjection
	The 2D projection used on the canvas. More...
Coord	constraintAreaMin
	3 dimensional position and size of the constraint area (in meters). More...
Coord	constraintAreaMax
Coord	lastPosition
	The last position that was reported. More...
EulerAngles	lastOrientation
	The last position that was reported. More...

Additional Inherited Members
Public Types inherited from inet::MobilityBase
enum	BorderPolicy { REFLECT, WRAP, PLACERANDOMLY, RAISEERROR }
	Selects how a mobility module should behave if it reaches the edge of the constraint area. More...
Static Public Attributes inherited from inet::IMobility
static simsignal_t	mobilityStateChangedSignal = cComponent::registerSignal("mobilityStateChanged")
	A signal used to publish mobility state changes. More...

Detailed Description

Base class for moving mobility modules.

Periodically emits a signal with the current mobility state.

Author

Levente Meszaros

Constructor & Destructor Documentation

inet::MovingMobilityBase::MovingMobilityBase ( )

protected

                                       :
    moveTimer(nullptr),
    updateInterval(0),
    stationary(false),
    lastSpeed(Coord::ZERO),
    lastUpdate(0),
    nextChange(-1)
{
}

inet::MovingMobilityBase::~MovingMobilityBase ( )

protectedvirtual

{
    cancelAndDelete(moveTimer);
}

Member Function Documentation

EulerAngles inet::MovingMobilityBase::getCurrentAngularPosition ( )

overridevirtual

Returns the current angular position at the current simulation time.

Reimplemented from inet::MobilityBase.

{
    moveAndUpdate();
    return lastOrientation;
}

Coord inet::MovingMobilityBase::getCurrentPosition ( )

overridevirtual

Returns the current position at the current simulation time.

Implements inet::IMobility.

Reimplemented in inet::MoBANLocal.

Referenced by inet::MoBANLocal::getCurrentPosition(), and inet::MoBANLocal::updateVisualRepresentation().

{
    moveAndUpdate();
    return lastPosition;
}

Coord inet::MovingMobilityBase::getCurrentSpeed ( )

overridevirtual

Returns the current speed at the current simulation time.

Implements inet::IMobility.

Reimplemented in inet::MoBANLocal.

Referenced by inet::MoBANLocal::getCurrentSpeed().

{
    moveAndUpdate();
    return lastSpeed;
}

void inet::MovingMobilityBase::handleSelfMessage ( cMessage *  msg )

overrideprotectedvirtual

Called upon arrival of a self messages, subclasses must override.

Implements inet::MobilityBase.

{
    moveAndUpdate();
    scheduleUpdate();
}

void inet::MovingMobilityBase::initialize ( int  stage )

overrideprotectedvirtual

Initializes mobility model parameters.

Reimplemented from inet::MobilityBase.

Reimplemented in inet::MoBANCoordinator, inet::MoBANLocal, inet::Ns2MotionMobility, inet::MassMobility, inet::TurtleMobility, inet::CircleMobility, inet::RectangleMobility, inet::VehicleMobility, inet::BonnMotionMobility, inet::GaussMarkovMobility, inet::TractorMobility, inet::ANSimMobility, inet::ConstSpeedMobility, inet::LinearMobility, inet::ChiangMobility, and inet::RandomWPMobility.

Referenced by inet::ChiangMobility::initialize(), inet::RandomWPMobility::initialize(), inet::LinearMobility::initialize(), inet::ConstSpeedMobility::initialize(), inet::ANSimMobility::initialize(), inet::BonnMotionMobility::initialize(), inet::GaussMarkovMobility::initialize(), inet::TractorMobility::initialize(), inet::VehicleMobility::initialize(), inet::RectangleMobility::initialize(), inet::CircleMobility::initialize(), inet::MassMobility::initialize(), inet::TurtleMobility::initialize(), inet::Ns2MotionMobility::initialize(), inet::MoBANLocal::initialize(), and inet::MoBANCoordinator::initialize().

{
    MobilityBase::initialize(stage);
    EV_TRACE << "initializing MovingMobilityBase stage " << stage << endl;
    if (stage == INITSTAGE_LOCAL) {
        moveTimer = new cMessage("move");
        updateInterval = par("updateInterval");
    }
}

void inet::MovingMobilityBase::initializePosition ( )

overrideprotectedvirtual

Initializes mobility position.

Reimplemented from inet::MobilityBase.

Reimplemented in inet::LineSegmentsMobilityBase.

{
    MobilityBase::initializePosition();
    lastUpdate = simTime();
    scheduleUpdate();
}

virtual void inet::MovingMobilityBase::move ( )

protectedpure virtual

Moves according to the mobility model to the current simulation time.

Subclasses must override and update lastPosition, lastSpeed, lastUpdate, nextChange and other state according to the mobility model.

Implemented in inet::Ns2MotionMobility, inet::TurtleMobility, inet::CircleMobility, inet::MassMobility, inet::BonnMotionMobility, inet::RectangleMobility, inet::ANSimMobility, inet::ChiangMobility, inet::GaussMarkovMobility, inet::RandomWPMobility, inet::VehicleMobility, inet::LinearMobility, and inet::LineSegmentsMobilityBase.

Referenced by moveAndUpdate().

void inet::MovingMobilityBase::moveAndUpdate ( )

protected

Moves and notifies listeners.

Referenced by getCurrentAngularPosition(), getCurrentPosition(), getCurrentSpeed(), and handleSelfMessage().

{
    simtime_t now = simTime();
    if (nextChange == now || lastUpdate != now) {
        move();
        // determine orientation based on direction
        Coord direction = lastSpeed;
        direction.normalize();
        lastOrientation.alpha = atan2(-direction.y, direction.x);
        lastOrientation.beta = asin(direction.z);
        lastOrientation.gamma = 0.0;
        lastUpdate = simTime();
        emitMobilityStateChangedSignal();
        updateVisualRepresentation();
    }
}

void inet::MovingMobilityBase::scheduleUpdate ( )

protected

Schedules the move timer that will update the mobility state.

Referenced by handleSelfMessage(), inet::LineSegmentsMobilityBase::initializePosition(), initializePosition(), and inet::MoBANLocal::setMoBANParameters().

{
    cancelEvent(moveTimer);
    if (!stationary && updateInterval != 0) {
        // periodic update is needed
        simtime_t nextUpdate = simTime() + updateInterval;
        if (nextChange != -1 && nextChange < nextUpdate)
            // next change happens earlier than next update
            scheduleAt(nextChange, moveTimer);
        else
            // next update happens earlier than next change or there is no change at all
            scheduleAt(nextUpdate, moveTimer);
    }
    else if (nextChange != -1)
        // no periodic update is needed
        scheduleAt(nextChange, moveTimer);
}

Member Data Documentation

Coord inet::MovingMobilityBase::lastSpeed

protected

The last speed that was reported at lastUpdate.

Referenced by getCurrentSpeed(), inet::LineSegmentsMobilityBase::initializePosition(), inet::LineSegmentsMobilityBase::move(), inet::LinearMobility::move(), inet::VehicleMobility::move(), inet::ChiangMobility::move(), inet::RectangleMobility::move(), inet::MassMobility::move(), inet::CircleMobility::move(), moveAndUpdate(), inet::VehicleMobility::setInitialPosition(), inet::MoBANLocal::setMoBANParameters(), and inet::ChiangMobility::setTargetPosition().

simtime_t inet::MovingMobilityBase::lastUpdate

protected

The simulation time when the mobility state was last updated.

Referenced by inet::LineSegmentsMobilityBase::initializePosition(), initializePosition(), inet::LineSegmentsMobilityBase::move(), inet::LinearMobility::move(), inet::VehicleMobility::move(), inet::RectangleMobility::move(), inet::MassMobility::move(), and moveAndUpdate().

cMessage* inet::MovingMobilityBase::moveTimer

protected

The message used for mobility state changes.

Referenced by initialize(), scheduleUpdate(), and ~MovingMobilityBase().

simtime_t inet::MovingMobilityBase::nextChange

protected

The next simulation time when the mobility module needs to update its internal state.

The -1 value turns off sending a self message for the next mobility state change.

Referenced by inet::TurtleMobility::executeStatement(), inet::ANSimMobility::extractDataFrom(), inet::LineSegmentsMobilityBase::initializePosition(), inet::LineSegmentsMobilityBase::move(), inet::MassMobility::move(), moveAndUpdate(), inet::MoBANCoordinator::refreshDisplay(), inet::TurtleMobility::resumeScript(), scheduleUpdate(), inet::TurtleMobility::setInitialPosition(), inet::MoBANLocal::setMoBANParameters(), inet::RandomWPMobility::setTargetPosition(), inet::ConstSpeedMobility::setTargetPosition(), inet::ChiangMobility::setTargetPosition(), inet::ANSimMobility::setTargetPosition(), inet::TractorMobility::setTargetPosition(), inet::BonnMotionMobility::setTargetPosition(), inet::GaussMarkovMobility::setTargetPosition(), inet::MassMobility::setTargetPosition(), inet::Ns2MotionMobility::setTargetPosition(), inet::MoBANLocal::setTargetPosition(), and inet::MoBANCoordinator::setTargetPosition().

bool inet::MovingMobilityBase::stationary

protected

A mobility model may decide to become stationary at any time.

The true value disables sending self messages.

Referenced by inet::ChiangMobility::initialize(), inet::RandomWPMobility::initialize(), inet::LinearMobility::initialize(), inet::ConstSpeedMobility::initialize(), inet::GaussMarkovMobility::initialize(), inet::RectangleMobility::initialize(), inet::CircleMobility::initialize(), inet::LineSegmentsMobilityBase::initializePosition(), inet::LinearMobility::move(), inet::TurtleMobility::resumeScript(), scheduleUpdate(), inet::ANSimMobility::setTargetPosition(), inet::BonnMotionMobility::setTargetPosition(), and inet::Ns2MotionMobility::setTargetPosition().

simtime_t inet::MovingMobilityBase::updateInterval

protected

The simulation time interval used to regularly signal mobility state changes.

The 0 value turns off the signal.

Referenced by initialize(), scheduleUpdate(), and inet::GaussMarkovMobility::setTargetPosition().

---

The documentation for this class was generated from the following files:

• MovingMobilityBase.h
• MovingMobilityBase.cc