A Discrete-Event Network Simulator
API
oh-buildings-propagation-loss-model.cc
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2011 Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License version 2 as
6  * published by the Free Software Foundation;
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11  * GNU General Public License for more details.
12  *
13  * You should have received a copy of the GNU General Public License
14  * along with this program; if not, write to the Free Software
15  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16  *
17  * Author: Marco Miozzo <marco.miozzo@cttc.es>
18  *
19  */
20 
22 
23 #include "ns3/double.h"
24 #include "ns3/enum.h"
25 #include "ns3/log.h"
26 #include "ns3/mobility-model.h"
27 #include "ns3/okumura-hata-propagation-loss-model.h"
28 #include "ns3/pointer.h"
29 #include "ns3/propagation-loss-model.h"
30 #include <ns3/mobility-building-info.h>
31 
32 #include <cmath>
33 
34 namespace ns3
35 {
36 
37 NS_LOG_COMPONENT_DEFINE("OhBuildingsPropagationLossModel");
38 
39 NS_OBJECT_ENSURE_REGISTERED(OhBuildingsPropagationLossModel);
40 
42 {
43  m_okumuraHata = CreateObject<OkumuraHataPropagationLossModel>();
44 }
45 
47 {
48 }
49 
50 TypeId
52 {
53  static TypeId tid = TypeId("ns3::OhBuildingsPropagationLossModel")
54 
56  .SetGroupName("Buildings")
57 
58  .AddConstructor<OhBuildingsPropagationLossModel>();
59 
60  return tid;
61 }
62 
63 double
65 {
66  NS_LOG_FUNCTION(this << a << b);
67 
68  // get the MobilityBuildingInfo pointers
71  NS_ASSERT_MSG(a1 && b1, "OhBuildingsPropagationLossModel only works with MobilityBuildingInfo");
72 
73  double loss = 0.0;
74 
75  bool isAIndoor = a1->IsIndoor();
76  bool isBIndoor = b1->IsIndoor();
77 
78  if (!isAIndoor) // a is outdoor
79  {
80  if (!isBIndoor) // b is outdoor
81  {
82  loss = m_okumuraHata->GetLoss(a, b);
83  NS_LOG_INFO(this << " O-O : " << loss);
84  }
85  else
86  {
87  // b indoor
88  loss = m_okumuraHata->GetLoss(a, b) + ExternalWallLoss(b1);
89  NS_LOG_INFO(this << " O-I : " << loss);
90  } // end b1->isIndoor ()
91  }
92  else
93  {
94  // a is indoor
95  if (isBIndoor) // b is indoor
96  {
97  if (a1->GetBuilding() == b1->GetBuilding())
98  {
99  // nodes are in same building -> indoor communication ITU-R P.1238
100  loss = m_okumuraHata->GetLoss(a, b) + InternalWallsLoss(a1, b1);
101  NS_LOG_INFO(this << " I-I (same building)" << loss);
102  }
103  else
104  {
105  // nodes are in different buildings
106  loss = m_okumuraHata->GetLoss(a, b) + ExternalWallLoss(a1) + ExternalWallLoss(b1);
107  NS_LOG_INFO(this << " I-O-I (different buildings): " << loss);
108  }
109  }
110  else
111  {
112  loss = m_okumuraHata->GetLoss(a, b) + ExternalWallLoss(a1);
113  NS_LOG_INFO(this << " I-O : " << loss);
114  } // end if (isBIndoor)
115  } // end if (!isAIndoor)
116 
117  loss = std::max(0.0, loss);
118  return loss;
119 }
120 
121 } // namespace ns3
#define max(a, b)
Definition: 80211b.c:43
This model provides means for simulating the following propagation phenomena in the presence of build...
double ExternalWallLoss(Ptr< MobilityBuildingInfo > a) const
Calculate the external wall loss.
double InternalWallsLoss(Ptr< MobilityBuildingInfo > a, Ptr< MobilityBuildingInfo > b) const
Calculate the internal wall loss.
mobility buildings information (to be used by mobility models)
Ptr< T > GetObject() const
Get a pointer to the requested aggregated Object.
Definition: object.h:471
this model combines the OkumuraHata model with the BuildingsPropagationLossModel
Ptr< OkumuraHataPropagationLossModel > m_okumuraHata
OkumuraHata Propagation Loss Model.
double GetLoss(Ptr< MobilityModel > a, Ptr< MobilityModel > b) const override
a unique identifier for an interface.
Definition: type-id.h:60
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Definition: type-id.cc:935
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
Definition: assert.h:86
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:202
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by ",...
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Definition: log.h:275
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Definition: object-base.h:46
Every class exported by the ns3 library is enclosed in the ns3 namespace.