A Discrete-Event Network Simulator
API
Loading...
Searching...
No Matches
animation-interface.h
Go to the documentation of this file.
1/*
2 * This program is free software; you can redistribute it and/or modify
3 * it under the terms of the GNU General Public License version 2 as
4 * published by the Free Software Foundation;
5 *
6 * This program is distributed in the hope that it will be useful,
7 * but WITHOUT ANY WARRANTY; without even the implied warranty of
8 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
9 * GNU General Public License for more details.
10 *
11 * You should have received a copy of the GNU General Public License
12 * along with this program; if not, write to the Free Software
13 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
14 *
15 * Author: George F. Riley<riley@ece.gatech.edu>
16 * Author: John Abraham <john.abraham@gatech.edu>
17 * Contributions: Eugene Kalishenko <ydginster@gmail.com> (Open Source and Linux Laboratory
18 * http://wiki.osll.ru/doku.php/start)
19 */
20
21// Interface between ns3 and the network animator
22
23#ifndef ANIMATION_INTERFACE__H
24#define ANIMATION_INTERFACE__H
25
26#include "ns3/config.h"
27#include "ns3/ipv4-l3-protocol.h"
28#include "ns3/ipv4.h"
29#include "ns3/log.h"
30#include "ns3/lte-enb-net-device.h"
31#include "ns3/lte-ue-net-device.h"
32#include "ns3/mac48-address.h"
33#include "ns3/net-device.h"
34#include "ns3/node-container.h"
35#include "ns3/node-list.h"
36#include "ns3/nstime.h"
37#include "ns3/ptr.h"
38#include "ns3/random-variable-stream.h"
39#include "ns3/rectangle.h"
40#include "ns3/simulator.h"
41#include "ns3/uan-phy-gen.h"
42#include "ns3/wifi-phy.h"
43
44#include <cstdio>
45#include <map>
46#include <string>
47
48namespace ns3
49{
50
51#define MAX_PKTS_PER_TRACE_FILE 100000
52#define PURGE_INTERVAL 5
53#define NETANIM_VERSION "netanim-3.109"
54#define CHECK_STARTED_INTIMEWINDOW \
55 { \
56 if (!m_started || !IsInTimeWindow()) \
57 { \
58 return; \
59 } \
60 }
61#define CHECK_STARTED_INTIMEWINDOW_TRACKPACKETS \
62 { \
63 if (!m_started || !IsInTimeWindow() || !m_trackPackets) \
64 { \
65 return; \
66 } \
67 }
68
69struct NodeSize;
70class WifiPsdu;
71
88{
89 public:
95 AnimationInterface(const std::string filename);
96
101 {
104 };
105
111 typedef void (*AnimWriteCallback)(const char* str);
112
118
127 void EnableIpv4L3ProtocolCounters(Time startTime,
129 Time pollInterval = Seconds(1));
130
139 void EnableQueueCounters(Time startTime, Time stopTime, Time pollInterval = Seconds(1));
140
149 void EnableWifiMacCounters(Time startTime, Time stopTime, Time pollInterval = Seconds(1));
150
159 void EnableWifiPhyCounters(Time startTime, Time stopTime, Time pollInterval = Seconds(1));
160
172 AnimationInterface& EnableIpv4RouteTracking(std::string fileName,
173 Time startTime,
175 Time pollInterval = Seconds(5));
176
189 AnimationInterface& EnableIpv4RouteTracking(std::string fileName,
190 Time startTime,
192 NodeContainer nc,
193 Time pollInterval = Seconds(5));
194
201 static bool IsInitialized();
202
209 void SetStartTime(Time t);
210
217 void SetStopTime(Time t);
218
227 void SetMaxPktsPerTraceFile(uint64_t maxPktsPerFile);
228
238
246
252
261 static void SetConstantPosition(Ptr<Node> n, double x, double y, double z = 0);
262
269 void UpdateNodeDescription(Ptr<Node> n, std::string descr);
270
277 void UpdateNodeDescription(uint32_t nodeId, std::string descr);
278
285 void UpdateNodeImage(uint32_t nodeId, uint32_t resourceId);
286
294 void UpdateNodeSize(Ptr<Node> n, double width, double height);
295
303 void UpdateNodeSize(uint32_t nodeId, double width, double height);
304
313 void UpdateNodeColor(Ptr<Node> n, uint8_t r, uint8_t g, uint8_t b);
314
323 void UpdateNodeColor(uint32_t nodeId, uint8_t r, uint8_t g, uint8_t b);
324
332 void UpdateNodeCounter(uint32_t nodeCounterId, uint32_t nodeId, double counter);
333
345 void SetBackgroundImage(std::string fileName,
346 double x,
347 double y,
348 double scaleX,
349 double scaleY,
350 double opacity);
351
359 void UpdateLinkDescription(uint32_t fromNode, uint32_t toNode, std::string linkDescription);
360
368 void UpdateLinkDescription(Ptr<Node> fromNode, Ptr<Node> toNode, std::string linkDescription);
369
378 std::string destinationIpv4Address);
379
385 bool IsStarted() const;
386
391 void SkipPacketTracing();
392
400 void EnablePacketMetadata(bool enable = true);
401
408 uint64_t GetTracePktCount() const;
409
418 uint32_t AddNodeCounter(std::string counterName, CounterType counterType);
419
427 uint32_t AddResource(std::string resourcePath);
428
436 double GetNodeEnergyFraction(Ptr<const Node> node) const;
437
438 private:
443
444 {
445 public:
452 AnimPacketInfo(const AnimPacketInfo& pInfo);
460 AnimPacketInfo(Ptr<const NetDevice> tx_nd, const Time fbTx, uint32_t txNodeId = 0);
463 double m_fbTx;
464 double m_lbTx;
465 double m_fbRx;
466 double m_lbRx;
473 void ProcessRxBegin(Ptr<const NetDevice> nd, const double fbRx);
474 };
475
477 struct Rgb
478 {
479 uint8_t r;
480 uint8_t g;
481 uint8_t b;
482 };
483
486 {
489 };
490
493 {
495 std::string toNodeDescription;
496 std::string linkDescription;
497 };
498
501 {
510 {
511 // Check if they are the same node pairs but flipped
512 if (((first.fromNode == second.fromNode) && (first.toNode == second.toNode)) ||
513 ((first.fromNode == second.toNode) && (first.toNode == second.fromNode)))
514 {
515 return false;
516 }
517 std::ostringstream oss1;
518 oss1 << first.fromNode << first.toNode;
519 std::ostringstream oss2;
520 oss2 << second.fromNode << second.toNode;
521 return oss1.str() < oss2.str();
522 }
523 };
524
527 {
528 std::string destination;
530 };
531
534 {
536 std::string nextHop;
537 };
538
541 {
547 LRWPAN
548 };
549
551 struct NodeSize
552 {
553 double width;
554 double height;
555 };
556
557 typedef std::map<P2pLinkNodeIdPair, LinkProperties, LinkPairCompare>
559 typedef std::map<uint32_t, std::string> NodeDescriptionsMap;
560 typedef std::map<uint32_t, Rgb> NodeColorsMap;
561 typedef std::map<uint64_t, AnimPacketInfo>
563 typedef std::map<uint32_t, double> EnergyFractionMap;
564 typedef std::vector<Ipv4RoutePathElement>
566 typedef std::multimap<uint32_t, std::string> NodeIdIpv4Map;
567 typedef std::multimap<uint32_t, std::string> NodeIdIpv6Map;
568 typedef std::pair<uint32_t, std::string> NodeIdIpv4Pair;
569 typedef std::pair<uint32_t, std::string> NodeIdIpv6Pair;
570
571 // Node Counters
572 typedef std::map<uint32_t, uint64_t> NodeCounterMap64;
573
576 {
577 public:
584 AnimXmlElement(std::string tagName, bool emptyElement = true);
585 template <typename T>
592 void AddAttribute(std::string attribute, T value, bool xmlEscape = false);
597 void SetText(std::string text);
608 std::string ToString(bool autoClose = true);
609
610 private:
611 std::string m_tagName;
612 std::string m_text;
613 std::vector<std::string> m_attributes;
614 std::vector<std::string> m_children;
615 };
616
617 // ##### State #####
618
619 FILE* m_f;
622 std::string m_outputFileName;
623 uint64_t gAnimUid;
630 std::string m_originalFileName;
632 std::string m_routingFileName;
645
646 // Counter ID
648
652
656
661
664
671
672 std::map<uint32_t, Vector> m_nodeLocation;
673 std::map<std::string, uint32_t> m_macToNodeIdMap;
674 std::map<std::string, uint32_t> m_ipv4ToNodeIdMap;
675 std::map<std::string, uint32_t> m_ipv6ToNodeIdMap;
678
684 std::vector<Ipv4RouteTrackElement> m_ipv4RouteTrackElements;
685 std::map<uint32_t, NodeSize> m_nodeSizes;
686 std::vector<std::string> m_resources;
687 std::vector<std::string> m_nodeCounters;
688
689 /* Value-added custom counters */
706
712 const std::vector<std::string> GetElementsFromContext(const std::string& context) const;
718 Ptr<Node> GetNodeFromContext(const std::string& context) const;
724 Ptr<NetDevice> GetNetDeviceFromContext(std::string context);
725
726 // ##### General #####
732 void StartAnimation(bool restart = false);
739 void SetOutputFile(const std::string& fn, bool routing = false);
745 void StopAnimation(bool onlyAnimation = false);
751 std::string CounterTypeToString(CounterType counterType);
763 void AddByteTag(uint64_t animUid, Ptr<const Packet> p);
771 int WriteN(const char* data, uint32_t count, FILE* f);
778 int WriteN(const std::string& st, FILE* f);
784 std::string GetMacAddress(Ptr<NetDevice> nd);
790 std::string GetIpv4Address(Ptr<NetDevice> nd);
796 std::string GetIpv6Address(Ptr<NetDevice> nd);
802 std::vector<std::string> GetIpv4Addresses(Ptr<NetDevice> nd);
808 std::vector<std::string> GetIpv6Addresses(Ptr<NetDevice> nd);
809
814 std::string GetNetAnimVersion();
816 void MobilityAutoCheck();
823 bool IsPacketPending(uint64_t animUid, ProtocolType protocolType);
828 void PurgePendingPackets(ProtocolType protocolType);
840 std::string ProtocolTypeToString(ProtocolType protocolType);
847 void AddPendingPacket(ProtocolType protocolType, uint64_t animUid, AnimPacketInfo pktInfo);
859 void AddToIpv4AddressNodeIdTable(std::string ipv4Address, uint32_t nodeId);
865 void AddToIpv4AddressNodeIdTable(std::vector<std::string> ipv4Addresses, uint32_t nodeId);
871 void AddToIpv6AddressNodeIdTable(std::string ipv6Address, uint32_t nodeId);
877 void AddToIpv6AddressNodeIdTable(std::vector<std::string> ipv6Addresses, uint32_t nodeId);
882 bool IsInTimeWindow();
885
893 void TrackQueueCounters();
894 // ##### Routing #####
896 void TrackIpv4Route();
898 void TrackIpv4RoutePaths();
904 std::string GetIpv4RoutingTable(Ptr<Node> n);
911 void RecursiveIpv4RoutePathSearch(std::string from,
912 std::string to,
913 Ipv4RoutePathElements& rpElements);
920 void WriteRoutePath(uint32_t nodeId, std::string destination, Ipv4RoutePathElements rpElements);
921
922 // ##### Trace #####
928 void EnqueueTrace(std::string context, Ptr<const Packet>);
934 void DequeueTrace(std::string context, Ptr<const Packet>);
940 void QueueDropTrace(std::string context, Ptr<const Packet>);
948 void Ipv4TxTrace(std::string context,
950 Ptr<Ipv4> ipv4,
951 uint32_t interfaceIndex);
959 void Ipv4RxTrace(std::string context,
961 Ptr<Ipv4> ipv4,
962 uint32_t interfaceIndex);
972 void Ipv4DropTrace(std::string context,
973 const Ipv4Header& ipv4Header,
976 Ptr<Ipv4> ipv4,
977 uint32_t interfaceIndex);
978
984 void WifiMacTxTrace(std::string context, Ptr<const Packet> p);
990 void WifiMacTxDropTrace(std::string context, Ptr<const Packet> p);
996 void WifiMacRxTrace(std::string context, Ptr<const Packet> p);
1002 void WifiMacRxDropTrace(std::string context, Ptr<const Packet> p);
1008 void WifiPhyTxDropTrace(std::string context, Ptr<const Packet> p);
1015 void WifiPhyRxDropTrace(std::string context,
1017 WifiPhyRxfailureReason reason);
1023 void LrWpanMacTxTrace(std::string context, Ptr<const Packet> p);
1029 void LrWpanMacTxDropTrace(std::string context, Ptr<const Packet> p);
1035 void LrWpanMacRxTrace(std::string context, Ptr<const Packet> p);
1041 void LrWpanMacRxDropTrace(std::string context, Ptr<const Packet> p);
1051 void DevTxTrace(std::string context,
1053 Ptr<NetDevice> tx,
1054 Ptr<NetDevice> rx,
1055 Time txTime,
1056 Time rxTime);
1064 void WifiPhyTxBeginTrace(std::string context,
1065 WifiConstPsduMap psduMap,
1066 WifiTxVector txVector,
1067 double txPowerW);
1075 void WifiPhyRxBeginTrace(std::string context,
1077 RxPowerWattPerChannelBand rxPowersW);
1084 void LrWpanPhyTxBeginTrace(std::string context, Ptr<const Packet> p);
1091 void LrWpanPhyRxBeginTrace(std::string context, Ptr<const Packet> p);
1098 void WimaxTxTrace(std::string context, Ptr<const Packet> p, const Mac48Address& m);
1105 void WimaxRxTrace(std::string context, Ptr<const Packet> p, const Mac48Address& m);
1111 void CsmaPhyTxBeginTrace(std::string context, Ptr<const Packet> p);
1118 void CsmaPhyTxEndTrace(std::string context, Ptr<const Packet> p);
1125 void CsmaPhyRxEndTrace(std::string context, Ptr<const Packet> p);
1132 void CsmaMacRxTrace(std::string context, Ptr<const Packet> p);
1139 void LteTxTrace(std::string context, Ptr<const Packet> p, const Mac48Address& m);
1146 void LteRxTrace(std::string context, Ptr<const Packet> p, const Mac48Address& m);
1152 void LteSpectrumPhyTxStart(std::string context, Ptr<const PacketBurst> pb);
1158 void LteSpectrumPhyRxStart(std::string context, Ptr<const PacketBurst> pb);
1164 void UanPhyGenTxTrace(std::string context, Ptr<const Packet>);
1170 void UanPhyGenRxTrace(std::string context, Ptr<const Packet>);
1177 void RemainingEnergyTrace(std::string context, double previousEnergy, double currentEnergy);
1184 void GenericWirelessTxTrace(std::string context,
1186 ProtocolType protocolType);
1193 void GenericWirelessRxTrace(std::string context,
1195 ProtocolType protocolType);
1196
1198 void ConnectCallbacks();
1200 void ConnectLte();
1207 void ConnectLteUe(Ptr<Node> n, Ptr<LteUeNetDevice> nd, uint32_t devIndex);
1215
1216 // ##### Mobility #####
1222 Vector GetPosition(Ptr<Node> n);
1228 Vector UpdatePosition(Ptr<Node> n);
1235 Vector UpdatePosition(Ptr<Node> n, Vector v);
1241 Vector UpdatePosition(Ptr<NetDevice> ndev);
1248 bool NodeHasMoved(Ptr<Node> n, Vector newLocation);
1253 std::vector<Ptr<Node>> GetMovedNodes();
1259
1260 // ##### XML Helpers #####
1261
1268 void WriteNonP2pLinkProperties(uint32_t id, std::string ipv4Address, std::string channelType);
1280 void OutputWirelessPacketTxInfo(Ptr<const Packet> p, AnimPacketInfo& pktInfo, uint64_t animUid);
1287 void OutputWirelessPacketRxInfo(Ptr<const Packet> p, AnimPacketInfo& pktInfo, uint64_t animUid);
1295 void WriteLinkProperties();
1297 void WriteIpv4Addresses();
1299 void WriteIpv6Addresses();
1301 void WriteNodes();
1303 void WriteNodeColors();
1305 void WriteNodeSizes();
1307 void WriteNodeEnergies();
1312 void WriteXmlAnim(bool routing = false);
1319 void WriteXmlUpdateNodePosition(uint32_t nodeId, double x, double y);
1327 void WriteXmlUpdateNodeColor(uint32_t nodeId, uint8_t r, uint8_t g, uint8_t b);
1339 void WriteXmlUpdateNodeSize(uint32_t nodeId, double width, double height);
1345 void WriteXmlAddResource(uint32_t resourceId, std::string resourcePath);
1352 void WriteXmlAddNodeCounter(uint32_t counterId,
1353 std::string counterName,
1354 CounterType counterType);
1360 void WriteXmlUpdateNodeImage(uint32_t nodeId, uint32_t resourceId);
1367 void WriteXmlUpdateNodeCounter(uint32_t counterId, uint32_t nodeId, double value);
1375 void WriteXmlNode(uint32_t id, uint32_t sysId, double locX, double locY);
1382 void WriteXmlLink(uint32_t fromId, uint32_t toLp, uint32_t toId);
1389 void WriteXmlUpdateLink(uint32_t fromId, uint32_t toId, std::string linkDescription);
1401 void WriteXmlP(std::string pktType,
1402 uint32_t fId,
1403 double fbTx,
1404 double lbTx,
1405 uint32_t tId,
1406 double fbRx,
1407 double lbRx,
1408 std::string metaInfo = "");
1417 void WriteXmlP(uint64_t animUid, std::string pktType, uint32_t fId, double fbTx, double lbTx);
1425 void WriteXmlPRef(uint64_t animUid, uint32_t fId, double fbTx, std::string metaInfo = "");
1431 void WriteXmlClose(std::string name, bool routing = false);
1438 void WriteXmlNonP2pLinkProperties(uint32_t id, std::string ipAddress, std::string channelType);
1444 void WriteXmlRouting(uint32_t id, std::string routingInfo);
1451 void WriteXmlRp(uint32_t nodeId, std::string destination, Ipv4RoutePathElements rpElements);
1461 void WriteXmlUpdateBackground(std::string fileName,
1462 double x,
1463 double y,
1464 double scaleX,
1465 double scaleY,
1466 double opacity);
1472 void WriteXmlIpv4Addresses(uint32_t nodeId, std::vector<std::string> ipv4Addresses);
1478 void WriteXmlIpv6Addresses(uint32_t nodeId, std::vector<std::string> ipv6Addresses);
1479};
1480
1491class AnimByteTag : public Tag
1492{
1493 public:
1498 static TypeId GetTypeId();
1499
1504 TypeId GetInstanceTypeId() const override;
1505
1510 uint32_t GetSerializedSize() const override;
1511
1516 void Serialize(TagBuffer i) const override;
1517
1522 void Deserialize(TagBuffer i) override;
1523
1528 void Print(std::ostream& os) const override;
1529
1534 void Set(uint64_t AnimUid);
1535
1540 uint64_t Get() const;
1541
1542 private:
1543 uint64_t m_AnimUid;
1544};
1545
1546} // namespace ns3
1547#endif
Byte tag using by Anim to uniquely identify packets.
TypeId GetInstanceTypeId() const override
Get Instance Type Id.
void Serialize(TagBuffer i) const override
Serialize function.
void Print(std::ostream &os) const override
Print tag info.
uint32_t GetSerializedSize() const override
Get Serialized Size.
uint64_t Get() const
Get Uid in tag.
static TypeId GetTypeId()
Get Type Id.
void Deserialize(TagBuffer i) override
Deserialize function.
uint64_t m_AnimUid
the UID
void Set(uint64_t AnimUid)
Set global Uid in tag.
Ptr< const NetDevice > m_txnd
transmit device
void ProcessRxBegin(Ptr< const NetDevice > nd, const double fbRx)
Process receive begin.
Ptr< const NetDevice > m_rxnd
receive device
void AppendChild(AnimXmlElement e)
Append child function.
std::vector< std::string > m_children
list of children
void SetText(std::string text)
Set text function.
std::vector< std::string > m_attributes
list of attributes
std::string ToString(bool autoClose=true)
Get text for the element function.
void AddAttribute(std::string attribute, T value, bool xmlEscape=false)
Add attribute function.
Interface to network animator.
FILE * m_f
File handle for output (0 if none)
Time m_wifiMacCountersPollInterval
wifi MAC counters poll interval
void CsmaPhyRxEndTrace(std::string context, Ptr< const Packet > p)
CSMA Phy receive end trace function.
void WriteNodeSizes()
Write node sizes function.
uint32_t AddNodeCounter(std::string counterName, CounterType counterType)
Setup a node counter.
void TrackQueueCounters()
Track queue counters function.
void SetMobilityPollInterval(Time t)
Set mobility poll interval:WARNING: setting a low interval can cause slowness.
uint32_t m_wifiMacRxCounterId
wifi MAC receive counter ID
bool IsPacketPending(uint64_t animUid, ProtocolType protocolType)
Is packet pending function.
bool NodeHasMoved(Ptr< Node > n, Vector newLocation)
Node has moved function.
void LrWpanPhyTxBeginTrace(std::string context, Ptr< const Packet > p)
LR-WPAN Phy receive begin trace function.
uint32_t m_queueDropCounterId
queue drop counter ID
void WimaxTxTrace(std::string context, Ptr< const Packet > p, const Mac48Address &m)
WIMax transmit trace function.
void LrWpanPhyRxBeginTrace(std::string context, Ptr< const Packet > p)
LR-WPAN Phy receive begin trace function.
Time m_routingPollInterval
routing poll interval
void OutputCsmaPacket(Ptr< const Packet > p, AnimPacketInfo &pktInfo)
Output CSMA packet function.
uint64_t GetAnimUidFromPacket(Ptr< const Packet >)
Get anim UID from packet function.
EnergyFractionMap m_nodeEnergyFraction
node energy fraction
void GenericWirelessTxTrace(std::string context, Ptr< const Packet > p, ProtocolType protocolType)
Generic wireless transmit trace function.
std::map< uint32_t, Rgb > NodeColorsMap
NodeColorsMap typedef.
void LteRxTrace(std::string context, Ptr< const Packet > p, const Mac48Address &m)
LTE receive trace function.
std::string ProtocolTypeToString(ProtocolType protocolType)
Protocol type to string function.
NodeCounterMap64 m_nodeLrWpanMacRx
node LR-WPAN MAC receive
std::string m_routingFileName
routing file name
NodeCounterMap64 m_nodeIpv4Tx
node IPv4 transmit
std::map< std::string, uint32_t > m_ipv6ToNodeIdMap
IPv6 to node ID map.
void MobilityAutoCheck()
Mobility auto check function.
void WriteXmlRouting(uint32_t id, std::string routingInfo)
Write XML routing function.
void WifiPhyRxDropTrace(std::string context, Ptr< const Packet > p, WifiPhyRxfailureReason reason)
wifi Phy receive drop trace function
void WifiMacRxDropTrace(std::string context, Ptr< const Packet > p)
wifi MAC receive drop trace function
NodeCounterMap64 m_nodeQueueDrop
node queue drop
void ConnectLteUe(Ptr< Node > n, Ptr< LteUeNetDevice > nd, uint32_t devIndex)
Connect LTE ue function.
void DequeueTrace(std::string context, Ptr< const Packet >)
Dequeue trace function.
void ConnectCallbacks()
Connect callbacks function.
void WriteRoutePath(uint32_t nodeId, std::string destination, Ipv4RoutePathElements rpElements)
Write route path function.
AnimUidPacketInfoMap * ProtocolTypeToPendingPackets(ProtocolType protocolType)
Protocol type to pending packets function.
void RemainingEnergyTrace(std::string context, double previousEnergy, double currentEnergy)
Remaining energy trace function.
void Ipv4DropTrace(std::string context, const Ipv4Header &ipv4Header, Ptr< const Packet > p, Ipv4L3Protocol::DropReason dropReason, Ptr< Ipv4 > ipv4, uint32_t interfaceIndex)
IPv4 drop trace function.
NodeColorsMap m_nodeColors
node colors
std::multimap< uint32_t, std::string > NodeIdIpv6Map
NodeIdIpv6Map typedef.
void UpdateNodeCounter(uint32_t nodeCounterId, uint32_t nodeId, double counter)
Helper function to update a node's counter referenced by the nodeCounterId.
void WifiPhyRxBeginTrace(std::string context, Ptr< const Packet > p, RxPowerWattPerChannelBand rxPowersW)
wifi Phy receive begin trace function
void LrWpanMacRxDropTrace(std::string context, Ptr< const Packet > p)
LR-WPAN MAC receive drop trace function.
void LteSpectrumPhyTxStart(std::string context, Ptr< const PacketBurst > pb)
LTE Spectrum Phy transmit start function.
NodeCounterMap64 m_nodeLrWpanMacTx
node LR-WPAN MAC transmit
void WriteXmlAddNodeCounter(uint32_t counterId, std::string counterName, CounterType counterType)
Write XML add node counter function.
void WriteXmlPRef(uint64_t animUid, uint32_t fId, double fbTx, std::string metaInfo="")
Write XMLP Ref function.
NodeCounterMap64 m_nodeWifiPhyTxDrop
node wifi Phy transmit drop
void WriteLinkProperties()
Write link properties function.
void WriteIpv4Addresses()
Write IPv4 Addresses function.
const std::vector< std::string > GetElementsFromContext(const std::string &context) const
Get elements from context.
void WriteXmlAddResource(uint32_t resourceId, std::string resourcePath)
Write XML add resource function.
void OutputWirelessPacketTxInfo(Ptr< const Packet > p, AnimPacketInfo &pktInfo, uint64_t animUid)
Output wireless packet transmit info.
void LteSpectrumPhyRxStart(std::string context, Ptr< const PacketBurst > pb)
LTE Spectrum Phy receive start function.
void SetOutputFile(const std::string &fn, bool routing=false)
Set output file function.
NodeCounterMap64 m_nodeWifiMacTx
node wifi MAC transmit
std::map< uint32_t, std::string > NodeDescriptionsMap
NodeDescriptionsMap typedef.
AnimUidPacketInfoMap m_pendingWimaxPackets
pending wimax packets
void LteTxTrace(std::string context, Ptr< const Packet > p, const Mac48Address &m)
LTE transmit trace function.
void EnableIpv4L3ProtocolCounters(Time startTime, Time stopTime, Time pollInterval=Seconds(1))
Enable tracking of Ipv4 L3 Protocol Counters such as Tx, Rx, Drop.
int WriteN(const char *data, uint32_t count, FILE *f)
WriteN function.
std::map< std::string, uint32_t > m_macToNodeIdMap
MAC to node ID map.
Ptr< Node > GetNodeFromContext(const std::string &context) const
Get node from context.
std::map< uint32_t, Vector > m_nodeLocation
node location
Ptr< NetDevice > GetNetDeviceFromContext(std::string context)
Get net device from context.
FILE * m_routingF
File handle for routing table output (0 if None);.
void UpdateNodeImage(uint32_t nodeId, uint32_t resourceId)
Helper function to update the image of a node.
void TrackWifiPhyCounters()
Track wifi phy counters function.
AnimUidPacketInfoMap m_pendingUanPackets
pending UAN packets
void TrackIpv4RoutePaths()
Track IPv4 route paths function.
double GetNodeEnergyFraction(Ptr< const Node > node) const
Get node's energy fraction (This used only for testing)
bool IsInTimeWindow()
Is in time window function.
void CsmaPhyTxBeginTrace(std::string context, Ptr< const Packet > p)
CSMA Phy transmit begin trace function.
bool m_enablePacketMetadata
enable packet metadata
void PurgePendingPackets(ProtocolType protocolType)
Purge pending packets function.
void SetMaxPktsPerTraceFile(uint64_t maxPktsPerFile)
Set Max packets per trace file.
uint64_t m_maxPktsPerFile
maximum packets per file
uint32_t m_ipv4L3ProtocolRxCounterId
IPv4 L3 protocol receive counter ID.
NodeCounterMap64 m_nodeIpv4Rx
node IPv4 receive
~AnimationInterface()
Destructor for the animator interface.
void AddToIpv4AddressNodeIdTable(std::string ipv4Address, uint32_t nodeId)
Add to IPv4 address node ID table function.
NodeIdIpv4Map m_nodeIdIpv4Map
node ID to IPv4 map
Time m_queueCountersPollInterval
queue counters poll interval
std::map< P2pLinkNodeIdPair, LinkProperties, LinkPairCompare > LinkPropertiesMap
LinkPropertiesMap typedef.
std::vector< std::string > GetIpv6Addresses(Ptr< NetDevice > nd)
Get IPv6 addresses.
void UpdateLinkDescription(uint32_t fromNode, uint32_t toNode, std::string linkDescription)
Helper function to update the description for a link.
void Ipv4RxTrace(std::string context, Ptr< const Packet > p, Ptr< Ipv4 > ipv4, uint32_t interfaceIndex)
IPv4 receive trace function.
NodeCounterMap64 m_nodeQueueEnqueue
node queue enqueue
void WriteXmlUpdateNodeCounter(uint32_t counterId, uint32_t nodeId, double value)
Write XML update node counter function.
std::vector< std::string > GetIpv4Addresses(Ptr< NetDevice > nd)
Get IPv4 addresses.
Time m_wifiPhyCountersPollInterval
wifi Phy counters poll interval
uint32_t m_queueDequeueCounterId
queue dequeue counter ID
NodeCounterMap64 m_nodeWifiMacRx
node wifi MAC receive
void AddToIpv6AddressNodeIdTable(std::string ipv6Address, uint32_t nodeId)
Add to IPv6 address node ID table function.
AnimationInterface & AddSourceDestination(uint32_t fromNodeId, std::string destinationIpv4Address)
Helper function to print the routing path from a source node to destination IP.
NodeCounterMap64 m_nodeIpv4Drop
node IPv4 drop
Time m_ipv4L3ProtocolCountersStopTime
IPv4 L3 protocol counters stop time.
uint32_t m_queueEnqueueCounterId
queue enqueue counter ID
void AddByteTag(uint64_t animUid, Ptr< const Packet > p)
Add byte tag function.
Time m_ipv4L3ProtocolCountersPollInterval
IPv4 L3 protocol counters poll interval.
void WriteNonP2pLinkProperties(uint32_t id, std::string ipv4Address, std::string channelType)
Write non P2P link properties function.
void StopAnimation(bool onlyAnimation=false)
Stop animation function.
std::vector< Ipv4RoutePathElement > Ipv4RoutePathElements
Ipv4RoutePathElements typedef.
void UanPhyGenTxTrace(std::string context, Ptr< const Packet >)
UAN Phy gen transmit trace function.
void WifiMacTxDropTrace(std::string context, Ptr< const Packet > p)
wifi MAC transmit drop trace function
uint32_t m_ipv4L3ProtocolTxCounterId
IPv4 L3 protocol transmit counter ID.
Time m_queueCountersStopTime
queue counters stop time
std::string CounterTypeToString(CounterType counterType)
Counter type to string function.
ProtocolType
ProtocolType enumeration.
std::string GetMacAddress(Ptr< NetDevice > nd)
Get MAC address function.
std::vector< Ptr< Node > > GetMovedNodes()
Get moved nodes function.
uint32_t m_wifiMacTxCounterId
wifi MAC transmit counter ID
void SkipPacketTracing()
Do not trace packets.
NodeCounterMap64 m_nodeWifiMacRxDrop
node wifi MAC receive drop
NodeDescriptionsMap m_nodeDescriptions
node description
void WriteXmlAnim(bool routing=false)
Write XML anim function.
std::map< uint32_t, double > EnergyFractionMap
EnergyFractionMap typedef.
void SetStartTime(Time t)
Specify the time at which capture should start.
uint32_t AddResource(std::string resourcePath)
Add a resource such as the path to an image file.
std::string GetIpv6Address(Ptr< NetDevice > nd)
Get IPv6 address.
void WriteNodeEnergies()
Write node energies function.
std::map< uint32_t, uint64_t > NodeCounterMap64
NodeCounterMap64 typedef.
static Rectangle * userBoundary
user boundary
void CsmaMacRxTrace(std::string context, Ptr< const Packet > p)
CSMA MAC receive trace function.
void WifiPhyTxBeginTrace(std::string context, WifiConstPsduMap psduMap, WifiTxVector txVector, double txPowerW)
wifi Phy transmit PSDU begin trace function
void UanPhyGenRxTrace(std::string context, Ptr< const Packet >)
UAN Phy gen receive trace function.
LinkPropertiesMap m_linkProperties
link properties
void WriteXmlUpdateNodeDescription(uint32_t nodeId)
Write XML update node description function.
void UpdateNodeSize(Ptr< Node > n, double width, double height)
Helper function to update the size of a node.
std::map< uint32_t, NodeSize > m_nodeSizes
node sizes
std::pair< uint32_t, std::string > NodeIdIpv6Pair
NodeIdIpv6Pair typedef.
void(* AnimWriteCallback)(const char *str)
typedef for WriteCallBack used for listening to AnimationInterface write messages
void ConnectLte()
Connect LTE function.
bool m_trackPackets
track packets
std::string GetNetAnimVersion()
Get netanim version function.
void WriteXmlNonP2pLinkProperties(uint32_t id, std::string ipAddress, std::string channelType)
Write XML non P2P link properties function.
AnimationInterface & EnableIpv4RouteTracking(std::string fileName, Time startTime, Time stopTime, Time pollInterval=Seconds(5))
Enable tracking of the Ipv4 routing table for all Nodes.
void WriteXmlClose(std::string name, bool routing=false)
Write XML close function.
uint64_t gAnimUid
Packet unique identifier used by AnimationInterface.
void CheckMaxPktsPerTraceFile()
Check maximum packets per trace file function.
NodeCounterMap64 m_nodeLrWpanMacTxDrop
node LR-WPAN MAC transmit drop
NodeIdIpv6Map m_nodeIdIpv6Map
node ID to IPv6 map
void TrackIpv4Route()
Track IPv4 router function.
void EnableWifiPhyCounters(Time startTime, Time stopTime, Time pollInterval=Seconds(1))
Enable tracking of Wifi Phy Counters such as TxDrop, RxDrop.
AnimUidPacketInfoMap m_pendingWifiPackets
pending wifi packets
void EnablePacketMetadata(bool enable=true)
Enable Packet metadata.
Time m_routingStopTime
routing stop time
void SetStopTime(Time t)
Specify the time at which capture should stop.
void MobilityCourseChangeTrace(Ptr< const MobilityModel > mob)
Mobility course change trace function.
void EnableWifiMacCounters(Time startTime, Time stopTime, Time pollInterval=Seconds(1))
Enable tracking of Wifi Mac Counters such as Tx, TxDrop, Rx, RxDrop.
void WriteXmlP(std::string pktType, uint32_t fId, double fbTx, double lbTx, uint32_t tId, double fbRx, double lbRx, std::string metaInfo="")
Write XMLP function.
uint32_t m_wifiMacTxDropCounterId
wifi MAC transmit drop counter ID
void WriteXmlRp(uint32_t nodeId, std::string destination, Ipv4RoutePathElements rpElements)
Write XMLRP function.
AnimUidPacketInfoMap m_pendingLrWpanPackets
pending LR-WPAN packets
void WifiMacTxTrace(std::string context, Ptr< const Packet > p)
wifi MAC transmit trace function
void ResetAnimWriteCallback()
Reset the write callback function.
void WimaxRxTrace(std::string context, Ptr< const Packet > p, const Mac48Address &m)
WIMax receive trace function.
void LrWpanMacTxDropTrace(std::string context, Ptr< const Packet > p)
LR-WPAN MAC transmit drop trace function.
void LrWpanMacRxTrace(std::string context, Ptr< const Packet > p)
LR-WPAN MAC receive trace function.
std::vector< std::string > m_nodeCounters
node counters
void WriteXmlNode(uint32_t id, uint32_t sysId, double locX, double locY)
Write XML node function.
AnimWriteCallback m_writeCallback
write callback
NodeCounterMap64 m_nodeWifiMacTxDrop
node wifi MAC transmit drop
uint64_t m_currentPktCount
current packet count
std::string GetIpv4RoutingTable(Ptr< Node > n)
Get IPv4 routing table function.
void Ipv4TxTrace(std::string context, Ptr< const Packet > p, Ptr< Ipv4 > ipv4, uint32_t interfaceIndex)
IPv4 transmit trace function.
std::pair< uint32_t, std::string > NodeIdIpv4Pair
NodeIdIpv4Pair typedef.
void EnqueueTrace(std::string context, Ptr< const Packet >)
Enqueue trace function.
uint64_t GetTracePktCount() const
Get trace file packet count (This used only for testing)
void WriteXmlUpdateNodeColor(uint32_t nodeId, uint8_t r, uint8_t g, uint8_t b)
Write XML update node color function.
Vector UpdatePosition(Ptr< Node > n)
Update position function.
std::string m_outputFileName
output file name
void WriteIpv6Addresses()
Write IPv6 Addresses function.
void AddPendingPacket(ProtocolType protocolType, uint64_t animUid, AnimPacketInfo pktInfo)
Add pending packet function.
NodeCounterMap64 m_nodeWifiPhyRxDrop
node wifi Phy receive drop
void WriteXmlIpv4Addresses(uint32_t nodeId, std::vector< std::string > ipv4Addresses)
Write XML Ipv4 addresses function.
Vector GetPosition(Ptr< Node > n)
Get position function.
AnimUidPacketInfoMap m_pendingLtePackets
pending LTE packets
void SetBackgroundImage(std::string fileName, double x, double y, double scaleX, double scaleY, double opacity)
Helper function to set the background image.
void WriteNodes()
Write nodes function.
NodeCounterMap64 m_nodeLrWpanMacRxDrop
node LR-WPAN MAC receive drop
Time m_wifiMacCountersStopTime
wifi MAC counters stop time
void WriteNodeColors()
Write node colors function.
void RecursiveIpv4RoutePathSearch(std::string from, std::string to, Ipv4RoutePathElements &rpElements)
Recursive IPv4 route path search function.
static bool IsInitialized()
Check if AnimationInterface is initialized.
void LrWpanMacTxTrace(std::string context, Ptr< const Packet > p)
LR-WPAN MAC transmit trace function.
void WriteXmlUpdateBackground(std::string fileName, double x, double y, double scaleX, double scaleY, double opacity)
Write XML update background function.
void CsmaPhyTxEndTrace(std::string context, Ptr< const Packet > p)
CSMA Phy transmit end trace function.
void WriteXmlUpdateNodeSize(uint32_t nodeId, double width, double height)
Write XML update node size function.
uint32_t m_remainingEnergyCounterId
remaining energy counter ID
void WriteXmlUpdateNodeImage(uint32_t nodeId, uint32_t resourceId)
Write XML update node image function.
uint32_t m_wifiMacRxDropCounterId
wifi MAC receive drop counter ID
void TrackWifiMacCounters()
Track wifi MAC counters function.
void WriteNodeUpdate(uint32_t nodeId)
Write node update function.
std::string m_originalFileName
original file name
void UpdateNodeDescription(Ptr< Node > n, std::string descr)
Helper function to update the description for a given node.
void UpdateNodeColor(Ptr< Node > n, uint8_t r, uint8_t g, uint8_t b)
Helper function to update the node color.
static void SetConstantPosition(Ptr< Node > n, double x, double y, double z=0)
Helper function to set Constant Position for a given node.
NodeCounterMap64 m_nodeQueueDequeue
node queue dequeue
void WifiPhyTxDropTrace(std::string context, Ptr< const Packet > p)
wifi Phy transmit drop trace function
uint32_t m_wifiPhyRxDropCounterId
wifi Phy receive drop counter ID
void WriteXmlUpdateLink(uint32_t fromId, uint32_t toId, std::string linkDescription)
Write XML update link counter function.
void ConnectLteEnb(Ptr< Node > n, Ptr< LteEnbNetDevice > nd, uint32_t devIndex)
Connect LTE ENB function.
void GenericWirelessRxTrace(std::string context, Ptr< const Packet > p, ProtocolType protocolType)
Generic wireless receive trace function.
std::string GetPacketMetadata(Ptr< const Packet > p)
Get packet metadata function.
uint32_t m_wifiPhyTxDropCounterId
wifi Phy transmit drop counter ID
std::vector< Ipv4RouteTrackElement > m_ipv4RouteTrackElements
IPv route track elements.
std::multimap< uint32_t, std::string > NodeIdIpv4Map
NodeIdIpv4Map typedef.
void EnableQueueCounters(Time startTime, Time stopTime, Time pollInterval=Seconds(1))
Enable tracking of Queue Counters such as Enqueue, Dequeue, Queue Drops.
uint32_t m_ipv4L3ProtocolDropCounterId
IPv4 protocol drop counter ID.
Time m_wifiPhyCountersStopTime
wifi Phy counters stop time
Time m_mobilityPollInterval
mobility poll interval
void OutputWirelessPacketRxInfo(Ptr< const Packet > p, AnimPacketInfo &pktInfo, uint64_t animUid)
Output wireless packet receive info.
std::map< std::string, uint32_t > m_ipv4ToNodeIdMap
IPv4 to node ID map.
AnimUidPacketInfoMap m_pendingCsmaPackets
pending CSMA packets
std::vector< std::string > m_resources
resources
void TrackIpv4L3ProtocolCounters()
Track IPv4 L3 protocol counters function.
void WriteXmlUpdateNodePosition(uint32_t nodeId, double x, double y)
Write XML update node position function.
void StartAnimation(bool restart=false)
Start animation function.
void DevTxTrace(std::string context, Ptr< const Packet > p, Ptr< NetDevice > tx, Ptr< NetDevice > rx, Time txTime, Time rxTime)
Device transmit trace function.
std::string GetIpv4Address(Ptr< NetDevice > nd)
Get IPv4 address.
void WifiMacRxTrace(std::string context, Ptr< const Packet > p)
wifi MAC receive trace function
bool IsStarted() const
Is AnimationInterface started.
void WriteXmlIpv6Addresses(uint32_t nodeId, std::vector< std::string > ipv6Addresses)
Write XML Ipv6 addresses function.
NodeContainer m_routingNc
routing node container
void SetAnimWriteCallback(AnimWriteCallback cb)
Set a callback function to listen to AnimationInterface write events.
void QueueDropTrace(std::string context, Ptr< const Packet >)
Queue trace function.
void WriteXmlLink(uint32_t fromId, uint32_t toLp, uint32_t toId)
Write XML link counter function.
std::map< uint64_t, AnimPacketInfo > AnimUidPacketInfoMap
AnimUidPacketInfoMap typedef.
Packet header for IPv4.
Definition: ipv4-header.h:34
DropReason
Reason why a packet has been dropped.
an EUI-48 address
Definition: mac48-address.h:46
keep track of a set of node pointers.
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:77
a 2d rectangle
Definition: rectangle.h:35
read and write tag data
Definition: tag-buffer.h:52
tag a set of bytes in a packet
Definition: tag.h:39
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:105
a unique identifier for an interface.
Definition: type-id.h:59
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
Time stopTime
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:1326
WifiPhyRxfailureReason
Enumeration of the possible reception failure reasons.
Definition: first.py:1
Every class exported by the ns3 library is enclosed in the ns3 namespace.
std::unordered_map< uint16_t, Ptr< const WifiPsdu > > WifiConstPsduMap
Map of const PSDUs indexed by STA-ID.
std::map< WifiSpectrumBandInfo, double > RxPowerWattPerChannelBand
A map of the received power (Watts) for each band.
Definition: phy-entity.h:77
Definition: second.py:1
uint8_t data[writeSize]
Ipv4RoutePathElement structure IPv4 route path element.
Ipv4RouteTrackElement structure IPv4 route track element.
NodeSize structure node size.
RGB structure RGB structure.