[Tool] tools/analyze/location/locana (v. 2007-09-14)

top

the initial version.

@MISC{tools-analyze-location-locana-2007-09-14,
  author = {Thomas King and Stephan Kopf and Thomas Butter and Hendrik Lemelson and Thomas Haenselmann and Wolfgang Effelsberg},
  title = {{CRAWDAD} tool tools/analyze/location/locana (v. 2007-09-14)}, 
  howpublished = {Downloaded from http://crawdad.cs.dartmouth.edu/tools/analyze/location/locana},
  month = sep,  
  year = 2007
}
					

Locana is a research tool for 802.11-based positioning systems. Locana 
visualizes the results computed by Loctrace and Loceva.

This tool is released under the GNU General Public License.
Please respect our work and abide the license.

See "usage" for details.

See "usage" for details.

1. Overview

Locana visualizes the results computed by Loctrace and Loceva. This helps 
verifying that the data traced by Loctrace is complete and sound. Intermediate 
results of Loceva can also be visualized. This is a great means to verify 
that these algorithms are working as they are supposed to do.

A whole bunch of tools are grouped together in the Locana package. 
Locana contains many small tools that are supposed to perform special jobs. 
Most of these tools verify the output of Loctrace and Loceva, or list a certain 
object of a trace file. For instance, a tool called AccessPointLister prints out 
all the access points and how often they have been heard for a given trace file.

2. RadioMap

However, Locana contains also a powerful tool named RadioMap. RadioMap offers 
two modes of operation: loctrace and loceva. The former mode visualizes trace files 
generated by Loctrace. This feature is mainly used to visually investigate a fingerprint 
database. For each reference point and access point the number of readings, 
the average signal strength and its standard deviation can be displayed. 
The same can be displayed for online points as well. Furthermore, the grid dimension 
and starting point of the grid of reference points can be varied.

As previously mentioned, Loceva is able to optionally generate a file that logs 
intermediate results of positioning algorithms. Such a log file can be displayed 
in loceva mode of RadioMap. This helps to better understand how the selected positioning 
algorithm works, and to verify that the implementation works as it is supposed to.

After downloading and unpacking the jar archive the RadioMap tool can be run with the following command:

java -Xmx512M -cp batik-awt-util.jar:batik-bridge.jar:batik-css.jar:batik-dom.jar:batik-extension.jar:batik-ext.jar:batik-gui-util.jar:batik-gvt.jar:batik-parser.jar:batik-script.jar:batik-svg-dom.jar:batik-svggen.jar:batik-swing.jar:batik-transcoder.jar:batik-util.jar:batik-xml.jar:locana-0.5.1.jar:locutil1-0.5.1.jar:locutil2-0.5.2.jar:xerces_2_5_0.jar:xml-apis.jar org.pi4.locana.radiomap.RadioMap [-offline FILENAME] [-online FILENAME] [-maxgrid DOUBLE]

FILENAME can be a loctrace file (.trace) or a loceva file (.ptrace) to switch 
between loctrace and loceva mode, respectively. One of the parameters 
-offline and -online is required, both are valid. 
The -maxgrid parameter can be used optionally to set the maximum grid spacing. 
The default value is 5.0.

[Author] Thomas King

top

[Author] Stephan Kopf

top

[Author] Thomas Butter

top

[Author] Hendrik Lemelson

top

[Author] Thomas Haenselmann

top

[Author] Wolfgang Effelsberg

top

[Paper] king-tools

top

802.11-based positioning systems are a hot topic in research. However, no 
standardized set of tools has been established to facilitate the research 
process. In this paper, we contribute our research tools to the community. The 
benefit for the community is considerable: (1) Standardized tools reduce the 
amount of work each researcher has to spend to build software to collect signal 
strength samples and process this data. (2) The confidence in the correctness 
of the tools increases because everybody is encouraged to submit bugfixes. (3) 
A unified evaluation process makes results mutually comparable. (4) We hope 
other researchers contribute to our tools.