From 38c3402a15eb7662ecc4e9225e7612cdfb577b08 Mon Sep 17 00:00:00 2001
From: Matteo Cypriani <matteo.cypriani@univ-fcomte.fr>
Date: Wed, 27 Apr 2011 16:36:36 +0200
Subject: [PATCH] [Positioning] Update/clean configuration files

---
 owlps-positioning/cfg/listerers.csv         |  10 ++
 owlps-positioning/cfg/minipc.csv            |  20 ---
 owlps-positioning/cfg/owlps-positioning.cfg |  22 ++-
 owlps-positioning/cfg/topo.csv              |  48 -------
 owlps-positioning/cfg/topology.csv          |  31 +++++
 owlps-positioning/cfg/waypoints.csv         | 141 +++-----------------
 6 files changed, 76 insertions(+), 196 deletions(-)
 create mode 100644 owlps-positioning/cfg/listerers.csv
 delete mode 100644 owlps-positioning/cfg/minipc.csv
 delete mode 100644 owlps-positioning/cfg/topo.csv
 create mode 100644 owlps-positioning/cfg/topology.csv

diff --git a/owlps-positioning/cfg/listerers.csv b/owlps-positioning/cfg/listerers.csv
new file mode 100644
index 0000000..f773f5d
--- /dev/null
+++ b/owlps-positioning/cfg/listerers.csv
@@ -0,0 +1,10 @@
+# Listeners' physical description file.
+#
+# Each line follows this format:
+#   MAC address;X;Y;Z;Channel (Hz);Antenna gain (dBi);Trx power (dBm)
+#
+# Blank lines are ignored. Commented lines must have a sharp (#) as
+# their FIRST character.
+
+# Example listener:
+#00:11:22:33:44:55;4;0.5;7.95;2417000000;5.0;20.0
diff --git a/owlps-positioning/cfg/minipc.csv b/owlps-positioning/cfg/minipc.csv
deleted file mode 100644
index 0422be5..0000000
--- a/owlps-positioning/cfg/minipc.csv
+++ /dev/null
@@ -1,20 +0,0 @@
-# Fichier de configuration pour les AP.
-# Chaque ligne est de la forme :
-#   MAC;X;Y;Z;Fréquence d'émission (Hz);Gain d'antenne (dBi);Puissance d'émission (dBm)
-# Les lignes vides ou commençant par un # sont ignorées. Les
-# commentaires doivent obligatoirement être en début de ligne.
-
-# mini5 (Laseldi) 
-00:13:CE:95:E1:6F;4.93;25.81;3.55;2417000000;5.0;20.0
-
-# mini6 (Laurent / Wassim)
-00:13:CE:95:DE:7E;4.83;10.88;3.78;2417000000;5.0;20.0
-
-# mini4 (Incubateur)
-00:13:CE:97:78:79;20.05;28.31;3.74;2417000000;5.0;20.0
-
-# mini3 (Dominique)
-00:13:CE:8F:77:43;4.13;7.085;0.80;2417000000;5.0;20.0
-
-# mini1 (Adrien)
-00:13:CE:8F:78:D9;5.74;30.35;2.04;2417000000;5.0;20.0
diff --git a/owlps-positioning/cfg/owlps-positioning.cfg b/owlps-positioning/cfg/owlps-positioning.cfg
index 02f555e..3ee1204 100644
--- a/owlps-positioning/cfg/owlps-positioning.cfg
+++ b/owlps-positioning/cfg/owlps-positioning.cfg
@@ -1,15 +1,21 @@
 # Sample configuration file for OWLPS Positioning
 
-# Miscellaneous options
+# [Miscellaneous options]
+
 #flush-output-files = true
 
 [data-input]
 
-#ap-medium = CSV
-ap-csv-file = cfg/access_points.csv
+# Description of the machines running the listeners.
+ap-medium = CSV
+ap-csv-file = cfg/listeners.csv
 
-topology-medium = CSV
-areas-csv-file = cfg/topo.csv
+# Description of deployment area topology.
+# You probably don't need a full description of the topology, see the
+# topology example file for details.
+# Uncomment the following line to activate the topology reading.
+#topology-medium = CSV
+areas-csv-file = cfg/topology.csv
 waypoints-csv-file = cfg/waypoints.csv
 
 #reference-points-medium = CSV
@@ -32,10 +38,16 @@ csv-file = /tmp/owlps-positioning.log
 
 [positioning]
 
+# Uncomment lines to activate one or more algorithm.
+#algorithm = Real
+#algorithm = InterlinkNetworks
+#algorithm = FBCM
+#algorithm = RADAR
 #algorithm = FRBHMBasic
 
 [output]
 
+# This is the default output if none is specified.
 #medium = Terminal
 
 #medium = CSV
diff --git a/owlps-positioning/cfg/topo.csv b/owlps-positioning/cfg/topo.csv
deleted file mode 100644
index 2c606d2..0000000
--- a/owlps-positioning/cfg/topo.csv
+++ /dev/null
@@ -1,48 +0,0 @@
-# Liste des bâtiments et de leurs zones homogènes (pièces).
-# Chaque ligne définit une zone, de la forme :
-#   Nom du bâtiment;Nom de la pièce;X1;Y1;X2;Y2;Z1;Z2
-
-
-### Rez-de-chaussée ###
-#
-Numerica;0140;1.00;7.28;6.05;3.70;0.00;2.99
-Numerica;0130;1.00;10.88;6.05;7.28;0.00;2.99
-Numerica;0120;1.00;14.48;6.05;10.88;0.00;2.99
-Numerica;0110;1.00;18.12;6.05;14.48;0.00;2.99
-Numerica;0100;1.00;21.66;6.05;18.12;0.00;2.99
-Numerica;0090;1.00;25.32;6.05;21.66;0.00;2.99
-Numerica;0080;1.00;29.00;6.05;25.32;0.00;2.99
-Numerica;0070;1.00;32.00;6.05;29.00;0.00;2.99
-Numerica;WC N0;8.20;5.30;10.00;0.50;0.00;2.99
-Numerica;0085;8.20;9.00;10.00;5.30;0.00;2.99
-Numerica;0075;8.20;10.88;10.00;9.00;0.00;2.99
-Numerica;Palier N0;5.00;3.70;8.20;0.50;0.00;2.99
-Numerica;Couloir N0 A;6.05;30.00;8.20;3.70;0.00;2.99
-Numerica;Couloir N0 B;8.20;16.50;10.00;10.88;0.00;2.99
-Numerica;Couloir N0 C;8.20;24.80;10.00;22.60;0.00;2.99
-
-
-### Escaliers N0 / N1 ###
-#
-# TODO : affiner la hauteur, etc.
-Numerica;Escalier N0-N1 A;8.20;22.60;10.00;16.50;0.00;6.00
-Numerica;Escalier N0-N1 B1;2.50;2.00;5.00;0.50;0.00;6.00
-Numerica;Escalier N0-N1 B palier;1.00;3.70;2.50;0.50;1.50;6.00
-Numerica;Escalier N0-N1 B2;2.50;3.70;5.00;2.00;1.50;6.00
-
-
-### Premier étage ###
-#
-Numerica;1100;1.00;7.28;6.05;3.70;3.00;6.00
-Numerica;0190;1.00;10.88;6.05;7.28;3.00;6.00
-Numerica;0180;1.00;14.48;6.05;10.88;3.00;6.00
-Numerica;1070;1.00;18.12;6.05;14.48;3.00;6.00
-Numerica;1060;1.00;25.32;6.05;18.12;3.00;6.00
-Numerica;1050;1.00;31.40;6.05;25.32;3.00;6.00
-Numerica;WC N1;8.20;9.00;10.00;0.50;3.00;6.00
-Numerica;1105;8.20;10.88;10.00;9.00;3.00;6.00
-Numerica;1095;8.20;29.30;10.00;24.80;3.00;6.00
-Numerica;Palier N1;5.00;3.70;8.20;0.50;3.00;6.00
-Numerica;Couloir N1 A;6.05;29.50;8.20;3.70;3.00;6.00
-Numerica;Couloir N1 B;8.20;16.50;10.00;10.88;3.00;6.00
-Numerica;Couloir N1 C;8.20;24.80;10.00;22.60;3.00;6.00
diff --git a/owlps-positioning/cfg/topology.csv b/owlps-positioning/cfg/topology.csv
new file mode 100644
index 0000000..6c5d32c
--- /dev/null
+++ b/owlps-positioning/cfg/topology.csv
@@ -0,0 +1,31 @@
+# Description of deployment area topology (rooms).
+#
+# IMPORTANT:
+#   You need a precise topology description if you use algorithms that
+#   handle it. Since none of them are currenty implemented, you probably
+#   can save a lot of time by only providing a pseudo-area containing
+#   the whole deployment area in this file (in this case you will not
+#   declare any waypoint in the waypoints' definition file).
+#
+# This file lists the buildings and their "homogeneous areas" (rooms).
+#
+# Each line defines an area, using the following format:
+#   Building name;Room name;X1;Y1;Z1;X2;Y2;Z2
+
+
+### First floor ###
+#
+#My Building;Entrance;1.00;7.28;6.05;3.70;0.00;2.99
+#My Building;Corridor A;6.05;30.00;8.20;3.70;0.00;2.99
+
+
+### 1st/2nd floor staircase ###
+#
+#My Building;Staircase;2.50;2.00;0.00;5.00;0.50;6.00
+#My Building;Staircase landing;1.00;3.70;1.50;2.50;0.50;6.00
+#My Building;Staircase;2.50;3.70;1.50;5.00;2.00;6.00
+
+
+### Second floor ###
+#
+#My Building;My desk;1.00;7.28;6.05;3.70;3.00;6.00
diff --git a/owlps-positioning/cfg/waypoints.csv b/owlps-positioning/cfg/waypoints.csv
index a53bc24..42f8a09 100644
--- a/owlps-positioning/cfg/waypoints.csv
+++ b/owlps-positioning/cfg/waypoints.csv
@@ -1,124 +1,19 @@
-# Liste des points de passage.
-# Chaque ligne définit les trois coordonnées d'un point, de la forme :
-#   X;Y;Z;Nom du bâtiment 1;…;Nom du bâtiment n
-# Chaque point doit appartenir au moins à un bâtiment.
+# Description of deployment area topology (waypoints).
+#
+# IMPORTANT:
+#   Maybe you don't want to define any waypoint. Please read the
+#   topology example file before losing time.
+#
+# This file lists the waypoints linking the areas defined in the
+# topology file (doors, etc.).
+#
+# Each line defines a waypoint, using the following format:
+#   X;Y;Z;Building1 name;…;BuildingN name
+# Each point must belong to at least one building.
+#
+# Note: for the non-convex rooms (which are defined by several areas in
+# the topology file), and for wide gates, you should define one waypoint
+# each 1m or 1.5m.
 
-# Note : pour les zones appartenant à la même pièce non-convexe (ex :
-# Couloir N0 A et Couloir N0 B), on définit un point tous les 1,50 m.
-# Idem pour les portes très larges.
-
-### Rez-de-chaussée ###
-
-# 0140
-6.05;6.50;0.00;Numerica
-
-# 0130
-6.05;7.50;0.00;Numerica
-
-# 0120
-6.05;13.50;0.00;Numerica
-
-# 0130 / 0120
-3.00;10.88;0.00;Numerica
-
-# 0110
-6.05;14.50;0.00;Numerica
-
-# 0100
-6.05;21.00;0.00;Numerica
-
-# 0090
-6.05;22.25;0.00;Numerica
-
-# 0080
-6.05;28.50;0.00;Numerica
-
-# 0070
-6.05;29.50;0.00;Numerica
-
-# WC N0
-8.20;5.00;0.00;Numerica
-
-# 0085
-8.20;8.50;0.00;Numerica
-
-# 0075
-8.20;9.50;0.00;Numerica
-
-# Couloir N0 A / B
-8.20;11.50;0.00;Numerica
-8.20;13.00;0.00;Numerica
-8.20;14.50;0.00;Numerica
-8.20;16.00;0.00;Numerica
-
-# Couloir N0 A / C
-8.20;23.70;0.00;Numerica
-
-# Palier N0
-7.50;3.70;0.00;Numerica
-
-
-### Escaliers N0 / N1 ###
-
-# Couloir N0 C / Escalier NO-N1 A
-8.95;22.60;0.00;Numerica
-
-# Escalier NO-N1 A / Couloir N1 B
-8.95;16.50;3.00;Numerica
-
-# Palier NO / Escalier N0-N1 B1
-5.00;1.25;0.00;Numerica
-
-# Escalier N0-N1 B1 / Escalier N0-N1 B palier
-2.50;1.25;1.50;Numerica
-
-# Escalier N0-N1 B palier / Escalier N0-N1 B2
-2.50;2.75;1.50;Numerica
-
-# Escalier N0-N1 B2 / Palier N1
-5.00;2.75;3.00;Numerica
-
-
-### Premier étage ###
-
-# 1100
-6.05;6.50;3.00;Numerica
-
-# 0190
-6.05;7.50;3.00;Numerica
-
-# 0180
-6.05;13.50;3.00;Numerica
-
-# 0190 / 0180
-3.00;10.88;3.00;Numerica
-
-# 1070
-6.05;14.50;3.00;Numerica
-
-# 1060
-6.05;21.00;3.00;Numerica
-
-# 1050
-6.05;27.75;3.00;Numerica
-
-# WC N1
-8.20;5.00;3.00;Numerica
-
-# 1105
-8.20;9.50;3.00;Numerica
-
-# 1095
-8.20;26.00;3.00;Numerica
-
-# Couloir N1 A / B
-8.20;11.50;3.00;Numerica
-8.20;13.00;3.00;Numerica
-8.20;14.50;3.00;Numerica
-8.20;16.00;3.00;Numerica
-
-# Couloir N1 A / C
-8.20;23.70;3.00;Numerica
-
-# Palier N1
-7.50;3.70;3.00;Numerica
+# Example waypoint:
+#1.5;4;0;My Building