A Discrete-Event Network Simulator
API
Loading...
Searching...
No Matches
building-allocator.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2007 INRIA
3 * Copyright (C) 2012 Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)
4 *
5 * SPDX-License-Identifier: GPL-2.0-only
6 *
7 * Author: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
8 * Author: Nicola Baldo <nbaldo@cttc.es> (took position-allocator and turned it into
9 * building-allocator)
10 */
11#ifndef BUILDING_ALLOCATOR_H
12#define BUILDING_ALLOCATOR_H
13
14#include "building-container.h"
15
16#include "ns3/object-factory.h"
17#include "ns3/object.h"
18#include "ns3/position-allocator.h"
19#include "ns3/vector.h"
20
21namespace ns3
22{
23
24class Building;
25
26/**
27 * \ingroup buildings
28 * \brief Allocate buildings on a rectangular 2d grid.
29 *
30 * This class allows to create a set of buildings positioned on a
31 * rectangular 2D grid. Under the hood, this class uses two instances
32 * of GridPositionAllocator.
33 */
35{
36 public:
38 ~GridBuildingAllocator() override;
39
40 /**
41 * \brief Get the type ID.
42 * \return The object TypeId.
43 */
44 static TypeId GetTypeId();
45
46 /**
47 * Set an attribute to be used for each new building to be created
48 *
49 * \param n attribute name
50 * \param v attribute value
51 */
52 void SetBuildingAttribute(std::string n, const AttributeValue& v);
53
54 /**
55 * Create a set of buildings allocated on a grid
56 *
57 * \param n the number of buildings to create
58 *
59 * \return the BuildingContainer that contains the newly created buildings
60 */
62
63 private:
64 /**
65 * Pushes the attributes into the relevant position allocators
66 */
67 void PushAttributes() const;
68
69 mutable uint32_t m_current; //!< Current building number
71 double m_xMin; //!< The x coordinate where the grid starts
72 double m_yMin; //!< The y coordinate where the grid starts
73 uint32_t m_n; //!< The number of objects laid out on a line
74 double m_lengthX; //!< The length of the wall of each building along the X axis.
75 double m_lengthY; //!< The length of the wall of each building along the Y axis.
76 double m_deltaX; //!< The x space between buildings
77 double m_deltaY; //!< The y space between buildings
78 double m_height; //!< The height of the building (roof level)
79
80 mutable ObjectFactory m_buildingFactory; //!< The building factory
81 Ptr<GridPositionAllocator> m_lowerLeftPositionAllocator; //!< The upper left position allocator
83 m_upperRightPositionAllocator; //!< The upper right position allocator
84};
85
86} // namespace ns3
87
88#endif /* BUILDING_ALLOCATOR_H */
Hold a value for an Attribute.
Definition attribute.h:59
keep track of a set of building pointers.
Allocate buildings on a rectangular 2d grid.
void SetBuildingAttribute(std::string n, const AttributeValue &v)
Set an attribute to be used for each new building to be created.
double m_yMin
The y coordinate where the grid starts.
ObjectFactory m_buildingFactory
The building factory.
GridPositionAllocator::LayoutType m_layoutType
Layout type.
static TypeId GetTypeId()
Get the type ID.
double m_xMin
The x coordinate where the grid starts.
uint32_t m_n
The number of objects laid out on a line.
BuildingContainer Create(uint32_t n) const
Create a set of buildings allocated on a grid.
double m_deltaX
The x space between buildings.
Ptr< GridPositionAllocator > m_lowerLeftPositionAllocator
The upper left position allocator.
double m_lengthX
The length of the wall of each building along the X axis.
void PushAttributes() const
Pushes the attributes into the relevant position allocators.
uint32_t m_current
Current building number.
double m_deltaY
The y space between buildings.
double m_height
The height of the building (roof level)
double m_lengthY
The length of the wall of each building along the Y axis.
Ptr< GridPositionAllocator > m_upperRightPositionAllocator
The upper right position allocator.
LayoutType
Determine whether positions are allocated row first or column first.
Instantiate subclasses of ns3::Object.
A base class which provides memory management and object aggregation.
Definition object.h:78
Smart pointer class similar to boost::intrusive_ptr.
a unique identifier for an interface.
Definition type-id.h:48
Every class exported by the ns3 library is enclosed in the ns3 namespace.