A Discrete-Event Network Simulator
API
mobility-helper.h
Go to the documentation of this file.
1/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2/*
3 * Copyright (c) 2008 INRIA
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License version 2 as
7 * published by the Free Software Foundation;
8 *
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
13 *
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17 *
18 * Author: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
19 */
20
21#ifndef MOBILITY_HELPER_H
22#define MOBILITY_HELPER_H
23
24#include <vector>
25#include "ns3/object-factory.h"
26#include "ns3/attribute.h"
27#include "ns3/output-stream-wrapper.h"
28#include "ns3/position-allocator.h"
29#include "ns3/node-container.h"
30
31namespace ns3 {
32
33class PositionAllocator;
34class MobilityModel;
35
43{
44public:
50
55
63
85 void SetPositionAllocator (std::string type,
86 std::string n1 = "", const AttributeValue &v1 = EmptyAttributeValue (),
87 std::string n2 = "", const AttributeValue &v2 = EmptyAttributeValue (),
88 std::string n3 = "", const AttributeValue &v3 = EmptyAttributeValue (),
89 std::string n4 = "", const AttributeValue &v4 = EmptyAttributeValue (),
90 std::string n5 = "", const AttributeValue &v5 = EmptyAttributeValue (),
91 std::string n6 = "", const AttributeValue &v6 = EmptyAttributeValue (),
92 std::string n7 = "", const AttributeValue &v7 = EmptyAttributeValue (),
93 std::string n8 = "", const AttributeValue &v8 = EmptyAttributeValue (),
94 std::string n9 = "", const AttributeValue &v9 = EmptyAttributeValue ());
95
120 void SetMobilityModel (std::string type,
121 std::string n1 = "", const AttributeValue &v1 = EmptyAttributeValue (),
122 std::string n2 = "", const AttributeValue &v2 = EmptyAttributeValue (),
123 std::string n3 = "", const AttributeValue &v3 = EmptyAttributeValue (),
124 std::string n4 = "", const AttributeValue &v4 = EmptyAttributeValue (),
125 std::string n5 = "", const AttributeValue &v5 = EmptyAttributeValue (),
126 std::string n6 = "", const AttributeValue &v6 = EmptyAttributeValue (),
127 std::string n7 = "", const AttributeValue &v7 = EmptyAttributeValue (),
128 std::string n8 = "", const AttributeValue &v8 = EmptyAttributeValue (),
129 std::string n9 = "", const AttributeValue &v9 = EmptyAttributeValue ());
130
168 void PushReferenceMobilityModel (std::string referenceName);
173 void PopReferenceMobilityModel (void);
174
179 std::string GetMobilityModelType (void) const;
180
191 void Install (Ptr<Node> node) const;
202 void Install (std::string nodeName) const;
203
215 void Install (NodeContainer container) const;
216
221 void InstallAll (void);
222
232 static void EnableAscii (Ptr<OutputStreamWrapper> stream, uint32_t nodeid);
242 static void EnableAscii (Ptr<OutputStreamWrapper> stream, NodeContainer n);
251 static void EnableAsciiAll (Ptr<OutputStreamWrapper> stream);
270 int64_t AssignStreams (NodeContainer c, int64_t stream);
271
277 static double GetDistanceSquaredBetween (Ptr<Node> n1, Ptr<Node> n2);
278
279private:
280
287 std::vector<Ptr<MobilityModel> > m_mobilityStack;
290};
291
292} // namespace ns3
293
294#endif /* MOBILITY_HELPER_H */
Hold a value for an Attribute.
Definition: attribute.h:69
A class for an empty attribute value.
Definition: attribute.h:233
Helper class used to assign positions and mobility models to nodes.
void SetMobilityModel(std::string type, std::string n1="", const AttributeValue &v1=EmptyAttributeValue(), std::string n2="", const AttributeValue &v2=EmptyAttributeValue(), std::string n3="", const AttributeValue &v3=EmptyAttributeValue(), std::string n4="", const AttributeValue &v4=EmptyAttributeValue(), std::string n5="", const AttributeValue &v5=EmptyAttributeValue(), std::string n6="", const AttributeValue &v6=EmptyAttributeValue(), std::string n7="", const AttributeValue &v7=EmptyAttributeValue(), std::string n8="", const AttributeValue &v8=EmptyAttributeValue(), std::string n9="", const AttributeValue &v9=EmptyAttributeValue())
int64_t AssignStreams(NodeContainer c, int64_t stream)
Assign a fixed random variable stream number to the random variables used by the mobility models on t...
std::string GetMobilityModelType(void) const
static void EnableAsciiAll(Ptr< OutputStreamWrapper > stream)
static double GetDistanceSquaredBetween(Ptr< Node > n1, Ptr< Node > n2)
void Install(Ptr< Node > node) const
"Layout" a single node according to the current position allocator type.
ObjectFactory m_mobility
Object factory to create mobility objects.
static void CourseChanged(Ptr< OutputStreamWrapper > stream, Ptr< const MobilityModel > mobility)
Output course change events from mobility model to output stream.
void InstallAll(void)
Perform the work of MobilityHelper::Install on all nodes which exist in the simulation.
~MobilityHelper()
Destroy a Mobility Helper.
void PopReferenceMobilityModel(void)
Remove the top item from the top of the stack of "reference mobility models".
Ptr< PositionAllocator > m_position
Position allocator for use in hierarchical mobility model.
void PushReferenceMobilityModel(Ptr< Object > reference)
MobilityHelper()
Construct a Mobility Helper which is used to make life easier when working with mobility models.
void SetPositionAllocator(Ptr< PositionAllocator > allocator)
Set the position allocator which will be used to allocate the initial position of every node initiali...
static void EnableAscii(Ptr< OutputStreamWrapper > stream, uint32_t nodeid)
std::vector< Ptr< MobilityModel > > m_mobilityStack
Internal stack of mobility models.
keep track of a set of node pointers.
Instantiate subclasses of ns3::Object.
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:74
Every class exported by the ns3 library is enclosed in the ns3 namespace.
mobility
Definition: third.py:107