From b022ef11336e1de355f565222caa5211f162ebda Mon Sep 17 00:00:00 2001 From: Marco Miozzo Date: Thu, 8 Sep 2011 12:09:27 +0200 Subject: [PATCH] Address Nicola's comments in LENA-137, lte-pathloss-model.rst moved to lte-pathloss.design.rst --- src/lte/doc/source/conf.py | 2 +- ...loss-model.rst => lte-pathloss-design.rst} | 56 ++++++++++++++----- 2 files changed, 42 insertions(+), 16 deletions(-) rename src/lte/doc/source/{lte-pathloss-model.rst => lte-pathloss-design.rst} (82%) diff --git a/src/lte/doc/source/conf.py b/src/lte/doc/source/conf.py index 70cdcf8a3..24ca8fe45 100644 --- a/src/lte/doc/source/conf.py +++ b/src/lte/doc/source/conf.py @@ -182,7 +182,7 @@ latex_documents = [ # ('lte-design', 'lte-doc-design.tex', u'LTE Simulator Design Documentation', u'Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)', 'manual'), # ('lte-user', 'lte-doc-user.tex', u'LTE Simulator User Documentation', u'Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)', 'manual'), #('lte', 'lte-sim-doc.tex', u'LTE Simulator Documentation', u'Centre Tecnològic de Telecomunicacions de Catalunya (CTTC)', 'manual'), - ('lte-pathloss-model', 'lte-pathloss-model.tex', u'LTE Simulator Pathloss Model Documentation', u'Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)', 'manual'), + ('lte-pathloss-design', 'lte-pathloss-design.tex', u'LTE Simulator Pathloss Desing Documentation', u'Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)', 'manual'), ('lte-pathloss-testing', 'lte-pathloss-testing.tex', u'LTE Simulator Pathloss Testing Documentation', u'Centre Tecnologic de Telecomunicacions de Catalunya (CTTC)', 'manual'), ] diff --git a/src/lte/doc/source/lte-pathloss-model.rst b/src/lte/doc/source/lte-pathloss-design.rst similarity index 82% rename from src/lte/doc/source/lte-pathloss-model.rst rename to src/lte/doc/source/lte-pathloss-design.rst index 8bb29c8e4..677f4cdfa 100644 --- a/src/lte/doc/source/lte-pathloss-model.rst +++ b/src/lte/doc/source/lte-pathloss-design.rst @@ -1,18 +1,18 @@ .. include:: replace.txt -+++++++++++++++++++++++++++ - Pathloss Model Documentation -+++++++++++++++++++++++++++ +++++++++++++++++++++++++++++++++++++++ + Building Pathloss Model Documentation +++++++++++++++++++++++++++++++++++++++ Overview -******** +++++++++ The pathloss model included in the lte module is obtained through a combination of several well known pathloss models in order to mimic heterogeneous scenarios. In fact, we are interested in modeling different environmental scenarios such as urban, suburban and open areas. Moreover, indoor and outdoor communication has to be included since HeNB might be installed either within building and either outside. In case of indoor communication, the model has to consider also the type of building in outdoor <-> indoor communication according to some general criteria such as the wall penetration losses of the common materials; moreover it includes some general configuration for the internal walls in indoor communications. Finally, the frequency also represent an important parameter since it spans from 600 MHz up to 2600 MHz according to [TS36.101]_. -Description of the Model -****************************** +Description of the Included Models +++++++++++++++++++++++++++++++++++ The naming used in the following will be: @@ -20,7 +20,31 @@ The naming used in the following will be: * small cell BS (e.g., pico, femto): SC * BS -> eNB -Both UEs and SC might be either indoor and outdoor. +Both UEs and SC might be either indoor and outdoor. The model does not care about the typology of the nodes in the link pathloss computation rather then in their relative position (i.e., indoor vs. outdoor and z-axis respect to the rooftop level). + +For discriminate indoor and outdoor users, the model includes a specific class called ``Building`` which contains a ns3 ``Box`` class for defining the dimension of the building. In order to implements the characteristics of the pathloss models included, the ``Building`` class provides support for: + + * building type: + + * Residential (default value) + * Office + * Commercial + * external walls type + + * Wood + * ConcreteWithWindows (default value) + * ConcreteWithoutWindows + * StoneBlocks + + * number of floors (default value 1, which means only grondfloor) + * number of rooms in x-axis (default value 1) + * number of rooms in x-axis (default value 1) + +By means of the number of rooms in x and y axis it is possible the definition of buildings where rooms are organized in grids, typical reference scenario for femto-cells in 3GPP called dual-strip. + +The ``Building`` class is included in ``BuildingsMobilityModel`` class, which inherits from the ns3 class ``MobilityModel`` and it is in charge of managing the standard mobility functionalities plus the building ones (e.g., floor and room of the node). + +The class ``BuildingsMobilityModel`` is used by ``BuildingsPropagationLossModel`` class, which inherits from the ns3 class ``PropagationLossModel`` and manages the pathloss computation of the single components and their composition according to the nodes' positions. Moreover, it implements also the shadowing, that is the loss due to obstacoles in the main path (i.e., vegetation, buildings, etc.). The model provides the following pathloss link computations: @@ -318,7 +342,7 @@ The pathloss model characterizes the hybrid cases (i.e., when an outdoor node tr Pathloss Logic Model --------------------- +++++++++++++++++++++ In the following the pseudo-code of the model is presented:: @@ -370,19 +394,21 @@ We note that for SC nodes in case that the distance is greater then 1 km, we sti Shadowing Model ---------------- ++++++++++++++++ -The shadowing is modeled according to a log-normal distribution with variable standard deviation as function of the connection characteristics. In the implementation we considered three main possible scenarios for the standard deviation, in detail: +The shadowing is modeled according to a log-normal distribution with variable standard deviation as function of the connection characteristics. In the implementation we considered three main possible scenarios which correspond to three standard deviations (i.e., the mean is always 0), in detail: - * outdoor (defaul value of 7 dB). - * indoor (defaul value of 10 dB). - * external walls penetration (default value 5 dB). + * outdoor (defaul value of 7 dB) :math:`\rightarrow X_\mathrm{O} \sim N(\mu_\mathrm{O}, \sigma_\mathrm{O}^2)`. + * indoor (defaul value of 10 dB) :math:`\rightarrow X_\mathrm{I} \sim N(\mu_\mathrm{I}, \sigma_\mathrm{I}^2)`. + * external walls penetration (default value 5 dB) :math:`\rightarrow X_\mathrm{W} \sim N(\mu_\mathrm{W}, \sigma_\mathrm{W}^2)` -The simulator generates a shadowing value per each active link according to nodes'position the first time the link is used for transmitting. In case of transmissions from outdoor nodes to indoor ones, and viceversa, the standard deviation has to be calculated as the square root of the sum of the quadratic values of the standard deviatio in case of outdoor nodes and the one for the external walls penetration. This is due to the fact that, the variance of a distribution resulting from the sum of two normal is the sum of the variances. +The simulator generates a shadowing value per each active link according to nodes'position the first time the link is used for transmitting. In case of transmissions from outdoor nodes to indoor ones, and viceversa, the standard deviation (:math:`\sigma_\mathrm{IO}`) has to be calculated as the square root of the sum of the quadratic values of the standard deviatio in case of outdoor nodes and the one for the external walls penetration. This is due to the fact that that the components producing the shadowing are independent of ewach other; therefore, the variance of a distribution resulting from the sum of two independent normal ones is the sum of the variances. .. math:: X \sim N(\mu,\sigma^2) \mbox{ and } Y \sim N(\nu,\tau^2) - Z = X + Y \sim Z (\mu + \nu, \sigma^2 + \tau^2) \Rightarrow \sigma_Z = \sqrt{\sigma^2 + \tau^2} + Z = X + Y \sim Z (\mu + \nu, \sigma^2 + \tau^2) + + \Rightarrow \sigma_\mathrm{IO} = \sqrt{\sigma_\mathrm{O}^2 + \sigma_\mathrm{W}^2}