From 6af79bf7dfa944dfe8819c3c8d0e90ee35bf619d Mon Sep 17 00:00:00 2001
From: Budiarto Herman <budiarto.herman@magister.fi>
Date: Wed, 11 Sep 2013 14:38:13 +0300
Subject: [PATCH] Updated lte-handover-target testing documentation

---
 doc/models/Makefile                           |   2 ++
 src/lte/doc/Makefile                          |   3 ++-
 .../figures/lte-handover-target-scenario.dia  | Bin 0 -> 2323 bytes
 src/lte/doc/source/lte-testing.rst            |  21 +++++++++++++-----
 4 files changed, 19 insertions(+), 7 deletions(-)
 create mode 100644 src/lte/doc/source/figures/lte-handover-target-scenario.dia

diff --git a/doc/models/Makefile b/doc/models/Makefile
index 61a94cd55..a25dc919e 100644
--- a/doc/models/Makefile
+++ b/doc/models/Makefile
@@ -119,6 +119,7 @@ SOURCEFIGS = \
 	$(SRC)/lte/doc/source/figures/lte-cell-selection.dia \
 	$(SRC)/lte/doc/source/figures/lte-cell-selection-open-access.dia \
 	$(SRC)/lte/doc/source/figures/lte-cell-selection-closed-access.dia \
+	$(SRC)/lte/doc/source/figures/lte-handover-target-scenario.dia \
 	$(SRC)/lte/doc/source/figures/lena-dual-stripe.eps \
 	$(SRC)/lte/doc/source/figures/lte-mcs-index.eps \
 	$(SRC)/lte/doc/source/figures/lenaThrTestCase1.eps \
@@ -260,6 +261,7 @@ IMAGES_EPS = \
 	$(FIGURES)/lte-cell-selection.eps \
 	$(FIGURES)/lte-cell-selection-open-access.eps \
 	$(FIGURES)/lte-cell-selection-closed-access.eps \
+	$(FIGURES)/lte-handover-target-scenario.eps \
 	$(FIGURES)/lena-dual-stripe.eps \
 	$(FIGURES)/lte-mcs-index.eps \
 	$(FIGURES)/lenaThrTestCase1.eps \
diff --git a/src/lte/doc/Makefile b/src/lte/doc/Makefile
index 475711b84..894819d9a 100644
--- a/src/lte/doc/Makefile
+++ b/src/lte/doc/Makefile
@@ -39,7 +39,8 @@ IMAGES_DIA = \
 	$(FIGURES)/ue-meas-piecewise-a1-hys.dia \
 	$(FIGURES)/lte-cell-selection.dia \
 	$(FIGURES)/lte-cell-selection-open-access.dia \
-	$(FIGURES)/lte-cell-selection-closed-access.dia
+	$(FIGURES)/lte-cell-selection-closed-access.dia \
+	$(FIGURES)/lte-handover-target-scenario.dia
 
 
 # specify eps figures from which .png and .pdf figures need to be built
diff --git a/src/lte/doc/source/figures/lte-handover-target-scenario.dia b/src/lte/doc/source/figures/lte-handover-target-scenario.dia
new file mode 100644
index 0000000000000000000000000000000000000000..95c04e62affcf297075d19cc945fbc624faa92ac
GIT binary patch
literal 2323
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

literal 0
HcmV?d00001

diff --git a/src/lte/doc/source/lte-testing.rst b/src/lte/doc/source/lte-testing.rst
index 6d23fc40c..aa0ac6e3b 100644
--- a/src/lte/doc/source/lte-testing.rst
+++ b/src/lte/doc/source/lte-testing.rst
@@ -1312,8 +1312,8 @@ do the handover and the target cell where the UE should perform handover to.
 
 The test suite ``lte-handover-target`` verifies that the handover algorithm is
 making the right decision, in particular, in choosing the right target cell. It
-consists of several short test cases for different network topology (2x2 grid
-and 3x2 grid) and types of handover algorithm (the A2-A4-RSRQ handover algorithm
+consists of several short test cases for different network topology (2×2 grid
+and 3×2 grid) and types of handover algorithm (the A2-A4-RSRQ handover algorithm
 and the strongest cell handover algorithm).
 
 Each test case is a simulation of a micro-cell environment with the following
@@ -1330,10 +1330,19 @@ parameter:
  - 1s simulation duration
 
 To trigger a handover, the test case "shutdowns" the source cell at +0.5s
-simulation time. This is done by setting the source cell's Tx power to a very
-low value. As a result, the handover algorithm notices that the UE deserves a
-handover and several neighbouring cells become candidates of target cell at the
-same time.
+simulation time. Figure :ref:`fig-lte-handover-target-scenario` below
+illustrates the process. This is done by setting the source cell's Tx power to
+a very low value. As a result, the handover algorithm notices that the UE
+deserves a handover and several neighbouring cells become candidates of target
+cell at the same time.
+
+.. _fig-lte-handover-target-scenario:
+
+.. figure:: figures/lte-handover-target-scenario.*
+   :scale: 80 %
+   :align: center
+
+   ``lte-handover-target`` test scenario in a 2×2 grid
 
 The test case then verifies that the handover algorithm, when faced with more
 than one options of target cells, is able to choose the right one.