INET Framework for OMNeT++/OMNEST
inet::physicallayer::ConstantSpeedPropagation Class Reference

#include <ConstantSpeedPropagation.h>

Inheritance diagram for inet::physicallayer::ConstantSpeedPropagation:
inet::physicallayer::PropagationBase inet::physicallayer::IPropagation inet::IPrintableObject

Public Member Functions

 ConstantSpeedPropagation ()
 
virtual std::ostream & printToStream (std::ostream &stream, int level, int evFlags=0) const override
 Prints this object to the provided output stream. More...
 
virtual const IArrivalcomputeArrival (const ITransmission *transmission, IMobility *mobility) const override
 Returns the time and space coordinates when the transmission arrives at the object that moves with the provided mobility. More...
 
- Public Member Functions inherited from inet::physicallayer::PropagationBase
 PropagationBase ()
 
virtual mps getPropagationSpeed () const override
 Returns the theoretical propagation speed of radio signals in the range (0, +infinity). More...
 
- Public Member Functions inherited from inet::IPrintableObject
virtual ~IPrintableObject ()
 
virtual std::string printToString () const
 
virtual std::string printToString (int level, int evFlags=0) const
 
virtual std::string getInfoStringRepresentation (int evFlags=0) const
 
virtual std::string getDetailStringRepresentation (int evFlags=0) const
 
virtual std::string getDebugStringRepresentation (int evFlags=0) const
 
virtual std::string getTraceStringRepresentation (int evFlags=0) const
 
virtual std::string getCompleteStringRepresentation (int evFlags=0) const
 

Protected Member Functions

virtual void initialize (int stage) override
 
virtual const Coord computeArrivalPosition (const simtime_t startTime, const Coord &startPosition, IMobility *mobility) const
 
- Protected Member Functions inherited from inet::physicallayer::PropagationBase
virtual void finish () override
 

Protected Attributes

bool ignoreMovementDuringTransmission
 
bool ignoreMovementDuringPropagation
 
bool ignoreMovementDuringReception
 
- Protected Attributes inherited from inet::physicallayer::PropagationBase
mps propagationSpeed
 
long arrivalComputationCount
 

Additional Inherited Members

- Public Types inherited from inet::IPrintableObject
enum  PrintLevel {
  PRINT_LEVEL_TRACE, PRINT_LEVEL_DEBUG, PRINT_LEVEL_DETAIL, PRINT_LEVEL_INFO,
  PRINT_LEVEL_COMPLETE = INT_MIN
}
 
enum  PrintFlag { PRINT_FLAG_FORMATTED = (1 << 0), PRINT_FLAG_MULTILINE = (1 << 1) }
 

Constructor & Destructor Documentation

◆ ConstantSpeedPropagation()

inet::physicallayer::ConstantSpeedPropagation::ConstantSpeedPropagation ( )

Member Function Documentation

◆ computeArrival()

const IArrival * inet::physicallayer::ConstantSpeedPropagation::computeArrival ( const ITransmission transmission,
IMobility mobility 
) const
overridevirtual

Returns the time and space coordinates when the transmission arrives at the object that moves with the provided mobility.

The result might be an approximation only, because there's a tradeoff between precision and performance. This function never returns nullptr.

Implements inet::physicallayer::IPropagation.

56 {
58  const simtime_t startTime = transmission->getStartTime();
59  const simtime_t endTime = transmission->getEndTime();
60  const Coord& startPosition = transmission->getStartPosition();
61  const Coord& endPosition = transmission->getEndPosition();
62  const Coord& startArrivalPosition = ignoreMovementDuringPropagation ? mobility->getCurrentPosition() : computeArrivalPosition(startTime, startPosition, mobility);
63  const simtime_t startPropagationTime = startPosition.distance(startArrivalPosition) / propagationSpeed.get();
64  const simtime_t startArrivalTime = startTime + startPropagationTime;
65  const Quaternion& startArrivalOrientation = mobility->getCurrentAngularPosition();
67  const Coord& endArrivalPosition = startArrivalPosition;
68  const simtime_t endPropagationTime = startPropagationTime;
69  const simtime_t endArrivalTime = endTime + startPropagationTime;
70  const simtime_t preambleDuration = transmission->getPreambleDuration();
71  const simtime_t headerDuration = transmission->getHeaderDuration();
72  const simtime_t dataDuration = transmission->getDataDuration();
73  const Quaternion& endArrivalOrientation = mobility->getCurrentAngularPosition();
74  return new Arrival(startPropagationTime, endPropagationTime, startArrivalTime, endArrivalTime, preambleDuration, headerDuration, dataDuration, startArrivalPosition, endArrivalPosition, startArrivalOrientation, endArrivalOrientation);
75  }
76  else {
77  const Coord& endArrivalPosition = computeArrivalPosition(endTime, endPosition, mobility);
78  const simtime_t endPropagationTime = endPosition.distance(endArrivalPosition) / propagationSpeed.get();
79  const simtime_t endArrivalTime = endTime + endPropagationTime;
80  const simtime_t preambleDuration = transmission->getPreambleDuration();
81  const simtime_t headerDuration = transmission->getHeaderDuration();
82  const simtime_t dataDuration = transmission->getDataDuration();
83  const Quaternion& endArrivalOrientation = mobility->getCurrentAngularPosition();
84  return new Arrival(startPropagationTime, endPropagationTime, startArrivalTime, endArrivalTime, preambleDuration, headerDuration, dataDuration, startArrivalPosition, endArrivalPosition, startArrivalOrientation, endArrivalOrientation);
85  }
86 }

◆ computeArrivalPosition()

const Coord inet::physicallayer::ConstantSpeedPropagation::computeArrivalPosition ( const simtime_t  startTime,
const Coord startPosition,
IMobility mobility 
) const
protectedvirtual
40 {
41  // TODO return mobility->getPosition(time);
42  throw cRuntimeError("Movement approximation is not implemented");
43 }

Referenced by computeArrival().

◆ initialize()

void inet::physicallayer::ConstantSpeedPropagation::initialize ( int  stage)
overrideprotectedvirtual

Reimplemented from inet::physicallayer::PropagationBase.

27 {
29  if (stage == INITSTAGE_LOCAL) {
30  ignoreMovementDuringTransmission = par("ignoreMovementDuringTransmission");
31  ignoreMovementDuringPropagation = par("ignoreMovementDuringPropagation");
32  ignoreMovementDuringReception = par("ignoreMovementDuringReception");
33  // TODO
35  throw cRuntimeError("ignoreMovementDuringTransmission is yet not implemented");
36  }
37 }

◆ printToStream()

std::ostream & inet::physicallayer::ConstantSpeedPropagation::printToStream ( std::ostream &  stream,
int  level,
int  evFlags = 0 
) const
overridevirtual

Prints this object to the provided output stream.

Reimplemented from inet::physicallayer::PropagationBase.

46 {
47  stream << "ConstantSpeedPropagation";
48  if (level <= PRINT_LEVEL_TRACE)
52  return PropagationBase::printToStream(stream, level);
53 }

Member Data Documentation

◆ ignoreMovementDuringPropagation

bool inet::physicallayer::ConstantSpeedPropagation::ignoreMovementDuringPropagation
protected

◆ ignoreMovementDuringReception

bool inet::physicallayer::ConstantSpeedPropagation::ignoreMovementDuringReception
protected

◆ ignoreMovementDuringTransmission

bool inet::physicallayer::ConstantSpeedPropagation::ignoreMovementDuringTransmission
protected

Referenced by initialize(), and printToStream().


The documentation for this class was generated from the following files:
inet::physicallayer::ConstantSpeedPropagation::ignoreMovementDuringTransmission
bool ignoreMovementDuringTransmission
Definition: ConstantSpeedPropagation.h:20
inet::physicallayer::ConstantSpeedPropagation::computeArrivalPosition
virtual const Coord computeArrivalPosition(const simtime_t startTime, const Coord &startPosition, IMobility *mobility) const
Definition: ConstantSpeedPropagation.cc:39
EV_FIELD
#define EV_FIELD(...)
Definition: INETDefs.h:112
inet::physicallayer::ConstantSpeedPropagation::ignoreMovementDuringPropagation
bool ignoreMovementDuringPropagation
Definition: ConstantSpeedPropagation.h:21
inet::INITSTAGE_LOCAL
INET_API InitStage INITSTAGE_LOCAL
Initialization of local state that don't use or affect other modules includes:
inet::physicallayer::ConstantSpeedPropagation::ignoreMovementDuringReception
bool ignoreMovementDuringReception
Definition: ConstantSpeedPropagation.h:22
inet::physicallayer::PropagationBase::PropagationBase
PropagationBase()
Definition: PropagationBase.cc:14
inet::IPrintableObject::PRINT_LEVEL_TRACE
@ PRINT_LEVEL_TRACE
Definition: IPrintableObject.h:22
inet::physicallayer::PropagationBase::printToStream
virtual std::ostream & printToStream(std::ostream &stream, int level, int evFlags=0) const override
Prints this object to the provided output stream.
Definition: PropagationBase.cc:26
inet::units::value::get
const value_type & get() const
Definition: Units.h:108
inet::physicallayer::PropagationBase::arrivalComputationCount
long arrivalComputationCount
Definition: PropagationBase.h:21
inet::physicallayer::PropagationBase::propagationSpeed
mps propagationSpeed
Definition: PropagationBase.h:20
inet::physicallayer::PropagationBase::initialize
virtual void initialize(int stage) override
Definition: PropagationBase.cc:20