README: reorganise, add office space scenarios

v1.3.1/README.org

@@ -52,51 +52,7 @@ The following mobile terminals can be used:
 When received by a Fonera 2.0, the default packet size is 103 bytes for
 a positioning request, and 116 bytes for an (auto)calibration request.
 
-
+Unless stated otherwise, the Fonera is equipped with a 1.8 dBi antenna.
-* Testing area
-
-** Area description
-
-The deployment area is a room of 5.80 × 10.60 metres. The origin of the
-plan is set to the South-West corner of the room.
-
-The East wall is a weight-bearing wall made of concrete, whereas the
-others are simple partitions, 9.5 cm thick. The West wall has two doors
-and four windows made of Plexiglas. The doors and windows height is 2.5
-m.
-A West-East room divider built from metal, plastic and wood can be
-folded or unfolded to separate the room in two areas of approximately
-the same size.
-
-The room is clear from any obstacle, except for the following elements:
-- Two technical columns (electricity and network cables) whose diameter
-  is 12.5 cm, sitting at the coordinates (1.74;4.72) and (2.46;6.63).
-- Another technical column (which is likely to contain water) of floor
-  dimensions 31 × 51.5 cm. It sits against the East wall, its centre
-  being approximately (2.3;5.65).
-- The room divider. Folded its floor dimensions are 115 × 71 cm, and
-  its centre is around (5.4;5.7); when it is set up, it splits the room
-  at approximately 5.25 m in the Y axis.
-- Four heaters (air conditioners) that measure each 150 × 23 cm,
-  sitting at each end of the East wall and between the two doors of the
-  West wall.
-- Two light metal and wood tables and three plastic and metal chairs.
-
-** Measurement points
-
-To simplify the scenario explanation, the following measurement points
-are predefined:
-1. (5;10)
-2. (1;10)
-3. (5;1)
-4. (1;1)
-5. (2.5;5.5)
-6. (5;5)
-7. (5;2)
-8. (3;2)
-9. (3;0)
-10. (1;5)
-11. (1;3)
 
 
 * Common rules
@@ -114,15 +70,15 @@ and each exception made to these rules or to the scenario description.
 - Aggregation server: Asus EEE-PC 701 4G running Debian GNU/Linux
   squeeze (Linux 2.6.32), with an Atheros AR 500 Wi-Fi interface. It
   runs OwlPS Aggregator v1.3.1-14-ge278aab.
-- Listeners: 4 Fonera 2.0, running OwlPS Listener v1.3.0-11-gc4e0352.
+- Listeners: 4 Fonera 2.0 with 1.8 dBi antennas, running OwlPS Listener
+  v1.3.0-11-gc4e0352.
 
 ** Environmental parameters:
 
-- The temperature is controlled around 22-24°C.
-- The humidity varies from 38% to 55%.
-
 Each test's report file should report the temperature and humidity when
-the test was started.
+the test was started. If the information is missing, one can assume
+that: the temperature is controlled around 22-24°C, and the humidity
+varies from 38% to 55%.
 
 ** Aggregator
 
@@ -154,11 +110,6 @@ exiting, but simply deletes them).
 
 ** Listeners
 
-The capture points are attached to the walls and all have their antennas
-in vertical position, in the direction of the ceiling.
-Their coordinates are given in the OwlPS Positioner's configuration file
-([[./owlps-config/listeners-fonera.csv]]).
-
 The OwlPS Listener program runs continuously, with the autocalibration
 activated. It is launched with the following command:
 : owlps-listenerd -A -v -i 192.168.11.254 -I 192.168.11.254 -r ath1 -w ath0
@@ -211,19 +162,77 @@ The mobile terminal's antenna is vertical.
   60 bpm if the pace is of one metre per second.
 
 
-* Overview of the scenarios
+* One-room scenarios
 
-** Scenario 1
+This series of scenarios is schematised in the figure
+[[./figures/room.svg]].
+
+** Testing area
+
+*** Area description
+
+The deployment area is a room of 5.80 × 10.60 metres. The origin of the
+plan is set to the South-West corner of the room.
+
+This simple topology is described in the OwlPS Positioner's
+configuration file [[./owlps-config/room/topology.csv]].
+
+The East wall is a weight-bearing wall made of concrete, whereas the
+others are simple partitions, 9.5 cm thick. The West wall has two doors
+and four windows made of Plexiglas. The doors and windows height is 2.5
+m.
+A West-East room divider built from metal, plastic and wood can be
+folded or unfolded to separate the room in two areas of approximately
+the same size.
+
+The room is clear from any obstacle, except for the following elements:
+- Two technical columns (electricity and network cables) whose diameter
+  is 12.5 cm, sitting at the coordinates (1.74;4.72) and (2.46;6.63).
+- Another technical column (which is likely to contain water) of floor
+  dimensions 31 × 51.5 cm. It sits against the East wall, its centre
+  being approximately (2.3;5.65).
+- The room divider. Folded its floor dimensions are 115 × 71 cm, and
+  its centre is around (5.4;5.7); when it is set up, it splits the room
+  at approximately 5.25 m in the Y axis.
+- Four heaters (air conditioners) that measure each 150 × 23 cm,
+  sitting at each end of the East wall and between the two doors of the
+  West wall.
+- Two light metal and wood tables and three plastic and metal chairs.
+
+*** Listeners
+
+The capture points are attached to the walls and all have their antennas
+in vertical position, in the direction of the ceiling.
+Their coordinates are given in the OwlPS Positioner's configuration file
+[[./owlps-config/room/listeners-fonera.csv]].
+
+*** Measurement points
+
+To simplify the scenario explanation, the following measurement points
+are predefined:
+1. (5;10)
+2. (1;10)
+3. (5;1)
+4. (1;1)
+5. (2.5;5.5)
+6. (5;5)
+7. (5;2)
+8. (3;2)
+9. (3;0)
+10. (1;5)
+11. (1;3)
+
+** Scenario 1 (static, hip)
 
 The mobile terminal is still, without human operator, at hip altitude.
 Measurements are taken at each corner and the centre of the room
 (measurement points 1 to 5), during 1 minute at each position.
 
-** Scenario 2
+** Scenario 2 (static, floor)
 
 Repeat the scenario 1, but the mobile terminal is on the floor.
 
-** Scenario 3
+** Scenario 3 (antenna angle & direction)
 
 This scenario tests the antenna angle and measurement direction, with a
 human operator. The measurement points 2 and 5 are tested.
@@ -245,7 +254,7 @@ For each direction, three antenna orientations are measured:
 Therefore, we have 6 measurements per point. Each measurement lasts one
 minute.
 
-** Scenario 4
+** Scenario 4 (mobility)
 
 Test with a human operator carrying the mobile terminal. The operator
 moves along a path following the measurement points 1 to 5, and stands
@@ -253,8 +262,11 @@ at each point for 10 seconds. The pace of the operator is 1 m/s (one
 second per step, with one-metre steps).
 
 Timing:
-- t-10 :: stand at MP#1 in the direction of MP#2, start the aggregation
+- Before to start the timer, start the aggregation server (with
-          server (with autocalibration activated).
+  autocalibration activated) and wait for all the listeners to send a
+  Hello message.
+- t-10 :: stand at MP#1 in the direction of MP#2, while the listeners
+          send autocalibration requests.
 - t0 :: start the client, stay at MP#1 until t10.
 - t10 :: start walking to MP#2 (4 m distance).
 - t14 :: arrived at MP#2, start rotating in the direction of MP#3.
@@ -273,7 +285,7 @@ Timing:
 - t65 :: rotation achieved, stay at MP#5 until t75.
 - t75 :: stop the client.
 
-** Scenario 5
+** Scenario 5 (inter-packet delay)
 
 This scenario aims to evaluate the impact of the delay between the
 packets sent by the mobile terminal. The delay between two requests
@@ -305,7 +317,7 @@ Please keep in mind that for requests as long as one second, the
 aggregation timeout must be extended in the Aggregator's configuration
 (cf. Common rules for details).
 
-** Scenario 6
+** Scenario 6 (altitude)
 
 This scenario uses measurement points 1 and 5-10. For each measurement
 point, three altitudes of the terminal are tested: floor, hip and ear.
@@ -318,18 +330,18 @@ following order:
 2. hip,
 3. ear.
 
-** Scenario 7
+** Scenario 7 (altitude & human presence)
 
 Repeat the scenario 6, but with a human operator standing 0.5 m at the
 West of the terminal.
 Only the hip altitude is studied.
 
-** Scenario 8
+** Scenario 8 (altitude & fixed human presence)
 
 Repeat the scenario 7, but the human operator is always standing at the
 measurement point 11.
 
-** Scenario 9
+** Scenario 9 (packet size)
 
 This scenario is similar to the scenario 5, but the parameter evaluated
 is the size of the packets:
@@ -345,7 +357,7 @@ listeners must be written, as it can vary.
 
 Please refer to the scenario 5 for details and measurement procedure.
 
-** Scenario 10
+** Scenario 10 (autocalibration inter-packet delay)
 
 Repeat the scenario 1 several times, varying the delay between two
 packets of the autocalibration requests (option -t of owlps-listenerd):
@@ -355,7 +367,7 @@ packets of the autocalibration requests (option -t of owlps-listenerd):
 - 20 ms,
 - 25 ms.
 
-** Scenario 11
+** Scenario 11 (autocalibration frequency, mobility)
 
 Repeat the scenario 4 several time with different autocalibration
 frequencies on the Aggregator (delay between two autocalibration
@@ -371,7 +383,7 @@ The following frequencies are tested:
 - 1000 ms (Listeners: -n39 -t25 = 975 ms).
 *** TODO coord
 
-** Scenario 12
+** Scenario 12 (horizontal antennas)
 
 This scenario aims to evaluate the impact of horizontal capture points'
 antennas. The scenario 1 is repeated partially (for the measurement
@@ -425,28 +437,28 @@ points 3, 4 and 5 only) two times:
  +---+ +---+
 #+end_src
 
-** Scenario 13
+** Scenario 13 (temperature)
 
 This scenario aims to evaluate the impact of the temperature. The
 terminal is on the floor, at the measurement point 1. The temperature
 starts from a maximum, and lowers to a minimum during the experiment.
 
-** TODO Scenario 14
+** TODO Scenario 14 (humidity)
 
 Repeat the scenario 13, but evaluate the impact of the humidity.
 
-** Scenario 15
+** Scenario 15 (autocalibration alone, static)
 
 Repeat the scenario 1, but without client. The terminal is instead
 replaced by a human operator. This scenario aims to evaluate the
 influence of the human body on the autocalibration requests.
 
-** Scenario 16
+** Scenario 16 (autocalibration alone, mobility)
 
 This scenario follows the same principles as the scenario 15, but this
 time the scenario 4 is played instead of the scenario 1.
 
-** Scenario 17
+** Scenario 17 (autocalibration alone, mobility, two humans)
 
 Repeat the scenario 16 (scenario 4 without mobile terminal), but with
 two human operators, each starting from two opposite corners of the
@@ -455,17 +467,17 @@ measurement points:
 - Operator 1: 1, 2, 3, 4, 5 (same as scenario 16).
 - Operator 2: 4, 3, 2, 1, 5.
 
-** Scenario 18
+** Scenario 18 (autocalibration alone, empty room)
 
 The autocalibration is performed for 5 minutes, without mobile terminal
 and without human operator.
 
-** TODO Scenario 19
+** TODO Scenario 19 (mobility, two humans)
 
 Repeat the scenario 17, but one of the operators carries the mobile
 terminal.
 
-** Scenario 20
+** Scenario 20 (manual calibration)
 
 Manual calibration, without autocalibration running. The mobile device
 is carried by a human operator.
@@ -473,10 +485,143 @@ is carried by a human operator.
 Please keep in mind that the default aggregation time is not sufficient
 to aggregate correctly manual calibration requests (cf. Common rules).
 
-** Scenario 21
+** Scenario 21 (obstacle)
 
 This scenario aims to evaluate the impact of an obstacle on the
 propagation. Only two equipments are used, one on each side of the
 obstacle. To evaluate the attenuation in both directions, the easiest
 way is to activate the autocalibration, but one can also use normal
 positioning requests.
+
+
+* Office space scenarios
+
+** Common rules exceptions & additions
+
+*** Device used
+
+The Fonera use 5 dBi antennas.
+
+*** Measurement-related rules
+
+Due to the fact that the antenna used on the client terminal in not
+bendable, to have it vertical in a fixed position, a little stand was
+used, which increases the terminal altitude by 13 cm. Therefore, the
+standard altitudes become:
+- floor (0.13 m),
+- hip (0.95 m),
+- ear (1.70 m).
+
+** Testing area
+
+*** TODO Area description
+
+This space's topology is described in the OwlPS Positioner's
+configuration files [[./owlps-config/offices/topology.csv]] and
+[[./owlps-config/offices/waypoints.csv]].
+
+*** Listeners
+
+The capture points are put on pieces of furniture, at an altitude of
+approximately one metre; for this experiment, it is considered that the
+altitude is exactly one metre. All the capture points have their
+antennas in vertical position, in the direction of the ceiling.
+Their coordinates, as well as their real altitudes, are given in the
+OwlPS Positioner's configuration file
+[[./owlps-config/offices/listeners-fonera.csv]].
+
+*** Calibration points
+
+1. (3;5.48)
+2. (3;9.09)
+3. (3;12.67)
+4. (3;16.30)
+5. (3;19)
+6. (3;24)
+7. (7.50;5.48)
+8. (7.50;9.09)
+9. (7.50;12.67)
+10. (7.50;16.30)
+11. (7.50;19)
+12. (7.50;24)
+
+*** Measurement points
+
+1. (3;5.48)
+2. (6.85;7)
+3. (1.66;8.49)
+4. (2.95;11.79)
+5. (6.31;13.80)
+6. (4.90;15.10)
+7. (2.75;16.63)
+8. (8.41;13.15)
+9. (9.59;16.20)
+10. (7.50;18)
+11. (5.15;21.07)
+12. (3;19)
+13. (1.77;23.30)
+14. (3.55;23.80)
+
+** Scenario 50 (manual calibration)
+
+This scenario is similar to the scenario 20. The calibration points are
+listed in the upper section “Calibration points”.
+
+** Scenario 51 (static, hip)
+
+This scenario is similar to the scenario 1. The measurement points used
+are 1, 2, 5, 7, 10 and 11, and the terminal is at hip altitude, without
+human operator carrying it.
+
+** Scenario 52 (static, floor)
+
+This scenario is similar to the scenario 2, i.e. a static measurement
+with the terminal on the floor, but with the following differences:
+- only the measurement point 8 is used;
+- the test lasts for at least 30 minutes.
+
+** Scenario 54 (mobility)
+
+This scenario is similar to the scenario 4: a path is defined, going
+through all the 14 measurement points.
+
+Timing:
+- Before to start the timer, start the aggregation server (with
+  autocalibration activated) and wait for all the listeners to send a
+  Hello message.
+- t-10 :: stand at MP#1, facing the North, while the listeners send
+          autocalibration requests.
+- t1 :: start the client, stay at MP#1 until t10.
+- t11 :: start walking to MP#2 (6 steps).
+- t16 :: arrived at MP#2, face the North and wait until t26.
+- t27 :: start walking to MP#3 (7 steps).
+- t33 :: arrived at MP#3, rotate clockwise in two steps (until t35), to
+         face the right side of the frame of the door between the two
+         offices; wait until t44.
+- t45 :: start walking to MP#4 (5 steps).
+- t49 :: arrived at MP#4, rotating clockwise in one step (until t50) to
+         face the office door (MP#5); wait until t60.
+- t61 :: start walking to MP#5 (4 steps).
+- t64 :: arrived at MP#5, face the stairway and wait until t74.
+- t75 :: start walking to MP#6 (4 steps).
+- t78 :: arrived at MP#6, face the West and wait until t88.
+- t89 :: start walking to MP#7 (5 steps).
+- t93 :: arrived at MP#7, rotate counter-clockwise in two steps (until
+         t95) to face the middle of the office wall; wait until t104.
+- t105 :: start walking to MP#8 (6 steps).
+- t112 :: arrived at MP#8, rotate counter-clockwise in one step (until
+          t113) to face MP#9; wait until t122.
+- t123 :: start walking to MP#9 (4 steps).
+- t126 :: arrived at MP#9, rotate counter-clockwise in one step (until
+          t127) to face the West; wait until t136.
+- t137 :: start walking to MP#10 (4 steps).
+- t140 :: arrived at MP#10, face the North and wait until t150.
+- t151 :: start walking to MP#11 (6 steps).
+- t156 :: arrived at MP#11, face the West and wait until t166.
+- t167 :: start walking to MP#12 (4 steps).
+- t170 :: arrived at MP#12, face the West and wait until t180.
+- t181 :: start walking to MP#13 (6 steps).
+- t186 :: arrived at MP#13, face the North and wait until t196.
+- t197 :: start walking to MP#14 (4 steps).
+- t200 :: arrived at MP#14, face the room door and wait until t210.
+- t210 and a few milliseconds :: stop the client.