owlps/owlps-positioning/TODO


- Multithread algorithm calls.

- Write a class for Request::type?
   CalibrationRequest::direction uses a dedicated class Direction, why
   not Request::type? That would simplify writing of the type to
   streams (no need to cast each time anymore).

- User interface
   ° Case-insensitive string comparison (for algorithm names, etc.).
   ° Use a prefix for configuration files (search for config files set
   with relative path in owlps-positioning.cfg in the same directory).

- Unit tests
   ° Update tests (currently unmaintained).
   ° Unfinished tests:
   .   InputDataReader
   .   Input
   .   Output
   .   Positioning
   ° Test InterlinkNetworks::compute() ?

- Revoir le diagramme UML
   ° Associations : devraient êtres représentées par des attributs
   pointeurs.
   ° Compositions : devraient être représentées par des attributs
   normaux.

- Building
   Dans le destructeur, vérifier qu'il faut bien supprimer les Area et
   les Waypoint. Si oui, faut-il aussi les enlever des listes dans
   Stock ? (Pour l'instant ils ne sont pas dans Stock.)

- ReferencePoint
   ° La liste des requêtes devrait être un unordered_set (et pas un
   vector), pour garantir l'unicité des entrées.

- MinMax
   ° Différencier le pas pour X, Y et Z ?

- Renommages de membres
   ° InputMedium :
   °° current_line_nb et get_current_line_nb()
   °° get_next_request() −> read_next_request()
   ° Input : get_next_request() −> read_next_request()
   ° Area : p_min et p_max −> coord_min et coord_max

- « C++ en action »
   ° Espaces de noms ? 109
   ° Réserver l'espace mémoire des vector avec reserve(). 217
   ° Copie de conteneur vers un flux (cas de certains operator<<). 275

- « Coder proprement »
   ° Revoir toutes les classes pour respecter si possible les
   principes exposés dans le chapitre 6 (p. 103) : implanter
   systématiquement des accesseurs pour tous les attributs d'une
   classe expose l'implantation de la classe et rend ses attributs
   publics. La classe Direction (et maintenant Timestamp) tend à
   respecter ce principe en utilisant mieux les opérateurs et en ne
   proposant pas d'accesseur direct.

- Divers
   ° Passage de pointeurs en argument : const * const <type>

- Timestamp
   Dans les tests, il y a une probabilité de 1/1000000 que la valeur
   en ns et la valeur arrondie en ms soient identiques. Dans ce cas,
   certains tests peuvent échouer.
-												[Positioning] Several fixes

- Makefile: fix waypoint.o.
- UTF-8 calibrationmeasurement.{hh,cc}, measurement.cc.
- CalibrationMeasurement: fix destructor.
- Measurement: fix const functions, add operator bool().
- Update TODO.

											
										
										
											2010-01-07 16:26:13 +01:00
-												Update TODOs

											
										
										
											2011-05-03 13:53:33 +02:00
+								- Multithread algorithm calls.
-												Update TODOs

											
										
										
											2011-03-31 14:39:29 +02:00
+								- Write a class for Request::type?
 								   CalibrationRequest::direction uses a dedicated class Direction, why
 								   not Request::type? That would simplify writing of the type to
 								   streams (no need to cast each time anymore).
-												Update TODOs

											
										
										
											2011-05-03 13:53:33 +02:00
+								- User interface
 								   ° Case-insensitive string comparison (for algorithm names, etc.).
 								   ° Use a prefix for configuration files (search for config files set
 								   with relative path in owlps-positioning.cfg in the same directory).
-												[Positioning] Del MultilaterationAlgorithm::mobile

Makefile: Use colorgcc.
Update TODO.

											
										
										
											2010-05-04 10:44:19 +02:00
-												Update TODOs

											
										
										
											2011-05-03 13:53:33 +02:00
+								- Unit tests
-												[Positioning] Warn about the non-maintained tests

											
										
										
											2011-03-16 12:45:16 +01:00
+								   ° Update tests (currently unmaintained).
-												Update TODOs

											
										
										
											2011-05-03 13:53:33 +02:00
+								   ° Unfinished tests:
 								   .   InputDataReader
 								   .   Input
 								   .   Output
 								   .   Positioning
 								   ° Test InterlinkNetworks::compute() ?
-												[Positioning] Add Input & posexcept.{hh,cc}

- Add files posexcept.{hh,cc} that contains exception classes.
- Add class Input, that handles InputMedium (and InputLogMedium, in the
  future). Note that for the moment, the unit test is *very* minimal.
- UserInterface: Add options for the input medium and the CSV file.

											
										
										
											2010-02-11 17:24:21 +01:00
-												[Positioning] Add Request, complete InputCSV

== code/owlps-positioning ==

- Add new class Request (split of Measurement).
- Update Measurement and CalibrationMeasurement (suppress the 'mobile'
  attribute).
- Update InputCSV (and InputMedium) to use Request instead of
  Measurement. Complete the file reading (mobile & ap pointers remain to
  be implemented).
- PosUtil: Add timespec_to_ms(), timespec_to_ns(), ms_to_timespec(), and
  ns_to_timespec().
- Makefile: Update to use stlport, fix all deps and add new classes.
- Minor fixes.
- TODO: Add UML-related things, updates Measurement & Request.

== code ==

- libowlps: Add ms_to_timeval() (commented), may be useful later.
- Add TODO.

											
										
										
											2010-01-11 19:40:45 +01:00
+								- Revoir le diagramme UML
 								   ° Associations : devraient êtres représentées par des attributs
 								   pointeurs.
 								   ° Compositions : devraient être représentées par des attributs
 								   normaux.
-												[Positioning] Positioning & UserInterface: add Interlink

											
										
										
											2010-04-16 09:32:12 +02:00
-												[Positioning] Doxygen comments + fixes

- Add/update comments to be Doxygen compliant. Translate existing
  comments in English.
- Various fixes (more or less importants):
	- NULL pointer verification when adding an element to a vector of
	  pointers.
	- Add some missing accessors.
	- Add some more error handling with exceptions. Class Stock: correct
	  accessors (pure read accessors do not create a missing element any
		more, but throw an exception).
- Makefile: Add 'doc' target.
- Update TODO (some things noticed when reviewing the code for
  comments).

											
										
										
											2010-01-16 12:23:07 +01:00
+								- Building
 								   Dans le destructeur, vérifier qu'il faut bien supprimer les Area et
 								   les Waypoint. Si oui, faut-il aussi les enlever des listes dans
 								   Stock ? (Pour l'instant ils ne sont pas dans Stock.)
-												[Positioning] Update TODO

											
										
										
											2010-02-18 12:23:46 +01:00
+								- ReferencePoint
 								   ° La liste des requêtes devrait être un unordered_set (et pas un
 								   vector), pour garantir l'unicité des entrées.
-												[Positioning] Add InterlinkNetworks, MinMax & associates

Add classes:
- MultilaterationMethod
- MinMax (extends MultilaterationMethod)
- MultilaterationAlgorithm (extends PositioningAlgorithm)
- InterlinkNetworks (extends MultilaterationAlgorithm)

											
										
										
											2010-03-22 13:47:19 +01:00
+								- MinMax
 								   ° Différencier le pas pour X, Y et Z ?
-												[Positioning] Code and comments clean-up

- Where possible, use initialisation lists in class definition instead
  of explicit variable initialisations in source file.
- Rename some variables (use of "source" in copy constructors and
  operators…).
- Suppress useless Doxygen comments, allow non-documented members in
  Doxyfile.

											
										
										
											2010-03-05 17:24:18 +01:00
+								- Renommages de membres
 								   ° InputMedium :
 								   °° current_line_nb et get_current_line_nb()
 								   °° get_next_request() −> read_next_request()
 								   ° Input : get_next_request() −> read_next_request()
-												[Positioning] Request: timestamp -> time_sent

											
										
										
											2010-03-05 18:14:33 +01:00
+								   ° Area : p_min et p_max −> coord_min et coord_max
-												[Positioning] Code and comments clean-up

- Where possible, use initialisation lists in class definition instead
  of explicit variable initialisations in source file.
- Rename some variables (use of "source" in copy constructors and
  operators…).
- Suppress useless Doxygen comments, allow non-documented members in
  Doxyfile.

											
										
										
											2010-03-05 17:24:18 +01:00
-												[Positioning] Update TODO

											
										
										
											2010-02-18 12:23:46 +01:00
+								- « C++ en action »
 								   ° Espaces de noms ? 109
 								   ° Réserver l'espace mémoire des vector avec reserve(). 217
 								   ° Copie de conteneur vers un flux (cas de certains operator<<). 275
 								- « Coder proprement »
 								   ° Revoir toutes les classes pour respecter si possible les
 								   principes exposés dans le chapitre 6 (p. 103) : implanter
 								   systématiquement des accesseurs pour tous les attributs d'une
 								   classe expose l'implantation de la classe et rend ses attributs
-												[Positioning] Redesign Timestamp

Use almost only operators for the public interface.

											
										
										
											2010-03-01 16:52:37 +01:00
+								   publics. La classe Direction (et maintenant Timestamp) tend à
 								   respecter ce principe en utilisant mieux les opérateurs et en ne
 								   proposant pas d'accesseur direct.
-												[Positioning] Update TODO

											
										
										
											2010-02-18 12:23:46 +01:00
 								- Divers
 								   ° Passage de pointeurs en argument : const * const <type>
-												[Positioning] Add class Timestamp

Add a class Timestamp that boxes the structure timespec from <ctime>.
timespec manipulation functions are removed from PosUtil.

											
										
										
											2010-02-03 17:03:31 +01:00
 								- Timestamp
 								   Dans les tests, il y a une probabilité de 1/1000000 que la valeur
 								   en ns et la valeur arrondie en ms soient identiques. Dans ce cas,
 								   certains tests peuvent échouer.