StatisticalRateLimiter

Package: inet.queueing.filter

StatisticalRateLimiter

simple module

This module limit the datarate or the packetrate of a stream of packets based on the RateTag attached to the packets.

See also: ExponentialRateMeter

Inheritance diagram

The following diagram shows inheritance relationships for this type. Unresolved types are missing from the diagram.

Extends

Name Type Description
PacketFilterBase simple module

This is a base module for various packet filter modules. Derived modules must implement a single packet matcher function which determines if a packet is to be passed through or filtered out.

Parameters

Name Type Default value Description
displayStringTextFormat string "dropped %d/%p pk (%k/%l)"

determines the text that is written on top of the submodule

backpressure bool false
maxDatarate double nan
maxPacketrate double nan

Properties

Name Value Description
display i=block/downarrow
class StatisticalRateLimiter

Gates

Name Direction Size Description
in input
out output

Signals

Name Type Unit
packetPushedIn inet::Packet
packetPulledIn inet::Packet
packetDropped inet::Packet
packetPushedOut inet::Packet
packetPulledOut inet::Packet

Statistics

Name Title Source Record Unit Interpolation Mode
flowDroppedPacketLengths flow specific dropped packet lengths packetLength(demuxFlow(packetDropped)) sum, histogram, vector b none
incomingDataRate incoming data rate throughput(merge(packetPushedIn, packetPulledIn)) vector bps linear
droppedPacketLengths dropped packet lengths packetLength(packetDropped) sum, histogram, vector b none
incomingPacketLengths incoming packet lengths packetLength(merge(packetPushedIn, packetPulledIn)) sum, histogram, vector b none
droppedDataRate dropped data rate throughput(packetDropped) vector bps linear
flowOutgoingPacketLengths flow specific outgoing packet lengths packetLength(demuxFlow(merge(packetPushedOut, packetPulledOut))) sum, histogram, vector b none
flowDroppedDataRate flow specific dropped data rate throughput(demuxFlow(packetDropped)) vector bps linear
droppedPackets dropped packets packetDropped count pk
flowIncomingDataRate flow specific incoming data rate throughput(demuxFlow(merge(packetPushedIn, packetPulledIn))) vector bps linear
outgoingDataRate outgoing data rate throughput(merge(packetPushedOut, packetPulledOut)) vector bps linear
outgoingPacketLengths outgoing packet lengths packetLength(merge(packetPushedOut, packetPulledOut)) sum, histogram, vector b none
flowIncomingPacketLengths flow specific incoming packet lengths packetLength(demuxFlow(merge(packetPushedIn, packetPulledIn))) sum, histogram, vector b none
flowOutgoingDataRate flow specific outgoing data rate throughput(demuxFlow(merge(packetPushedOut, packetPulledOut))) vector bps linear
incomingPackets incoming packets merge(packetPushedIn, packetPulledIn) count pk
outgoingPackets outgoing packets merge(packetPushedOut, packetPulledOut) count pk

Direct method calls (observed)

call tofunctioninfo
PacketMultiplexerinet::queueing::PacketMultiplexer::pushPacketpushPacket
ExponentialRateMeterinet::queueing::ExponentialRateMeter::handleCanPushPacketChangedhandleCanPushPacketChanged
PassivePacketSinkinet::queueing::PassivePacketSink::pushPacketpushPacket

Called methods (observed)

functioninfocall from
inet::queueing::StatisticalRateLimiter::handleCanPushPacketChangedhandleCanPushPacketChangedPassivePacketSink
inet::queueing::StatisticalRateLimiter::pushPacketpushPacketExponentialRateMeter, SlidingWindowRateMeter

Pushed in messages (observed)

gatemsgkindctrlsrcModuletags
inPacket0ExponentialRateMeterDirectionTag, PacketProtocolTag, RateTag
inPacket0SlidingWindowRateMeterDirectionTag, DispatchProtocolReq, DropEligibleInd, EncapsulationProtocolInd, InterfaceInd, MacAddressInd, PacketProtocolTag, PcpInd, RateTag, StreamInd, UserPriorityInd, VlanInd

Push out messages (observed)

gatemsgkindctrldestModuletags
outPacket0PacketMultiplexerDirectionTag, DispatchProtocolReq, DropEligibleInd, EncapsulationProtocolInd, InterfaceInd, MacAddressInd, PacketProtocolTag, PcpInd, RateTag, StreamInd, UserPriorityInd, VlanInd
outPacket0PassivePacketSinkDirectionTag, PacketProtocolTag, RateTag

Shared Tagging operations (observed)

tagTypetagAction
RateTaggetTag

Region Tagging operations (observed)

tagTypetagAction
FlowTagmapAllTags

Source code

//
// This module limit the datarate or the packetrate of a stream of packets based
// on the ~RateTag attached to the packets.
//
// @see ~ExponentialRateMeter
//
simple StatisticalRateLimiter extends PacketFilterBase like IPacketFilter
{
    parameters:
        double maxDatarate @unit(bps) = default(nan);
        double maxPacketrate = default(nan);
        @class(StatisticalRateLimiter);
}
File: src/inet/queueing/filter/StatisticalRateLimiter.ned