CRAWDAD tools/analyze/location/locana

Citation Author(s):
University of Mannheim, Germany
University of Mannheim, Germany
Submitted by:
Last updated:
Wed, 12/05/2007 - 08:00
0 ratings - Please login to submit your rating.


Locana - a visualization tool for 802.11-based positioning systems.

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

Lastmodified :


Dataname :


File :

locana-0.5.1.src.tar.gz, locana-0.5.1.tar.gz

Releasedate :


Change :

the initial version.

References :

The Locana website

Website :

Keyword :


License :

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

Output :

See "usage" for details.

Parameters :

See "usage" for details.

Usage :

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.

Algorithm :

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.
The files in this directory are a CRAWDAD toolset hosted by IEEE DataPort. 

About CRAWDAD: the Community Resource for Archiving Wireless Data At Dartmouth is a data resource for the research community interested in wireless networks and mobile computing. 

CRAWDAD was founded at Dartmouth College in 2004, led by Tristan Henderson, David Kotz, and Chris McDonald. CRAWDAD toolsets are hosted by IEEE DataPort as of November 2022. 

Note: Please use the tools in an ethical and responsible way with the aim of doing no harm to any person or entity for the benefit of society at large. Please respect the privacy of any human subjects whose wireless-network activity is captured by the tools and comply with all applicable laws, including without limitation such applicable laws pertaining to the protection of personal information, security of data, and data breaches. Please do not apply, adapt or develop algorithms for the extraction of the true identity of users and other information of a personal nature, which might constitute personally identifiable information or protected health information under any such applicable laws. Do not publish or otherwise disclose to any other person or entity any information that constitutes personally identifiable information or protected health information under any such applicable laws derived from the tools through manual or automated techniques. 

Please acknowledge the source of the tools in any publications or presentations reporting use of this tools. 

Thomas King, Stephan Kopf, Thomas Butter, Hendrik Lemelson, Thomas Haenselmann, Wolfgang Effelsberg, CRAWDAD toolset tools/analyze/location/locana (v. 2007‑09‑14), Sep 2007.

Dataset Files

Open Access dataset files are accessible to all logged in  users. Don't have a login?  Create a free IEEE account.  IEEE Membership is not required.


These datasets are part of Community Resource for Archiving Wireless Data (CRAWDAD). CRAWDAD began in 2004 at Dartmouth College as a place to share wireless network data with the research community. Its purpose was to enable access to data from real networks and real mobile users at a time when collecting such data was challenging and expensive. The archive has continued to grow since its inception, and starting in summer 2022 is being housed on IEEE DataPort.

Questions about CRAWDAD? See our CRAWDAD FAQ. Interested in submitting your dataset to the CRAWDAD collection? Get started, by submitting an Open Access Dataset.