= Project Heatmap =

College student student Dennis Wagenaar has started his 'Wireless Leiden Heat map" project. The aim is to convert measurement data on network coverage in a map, similar to for instance this [http://vort.org/media/data/crashes.html example].

When the web application is available volunteers can enter their data that will be included in the map. Measurement data can be collected by applications like 
Netstumbler, Kismet and possibly an Android application.

The map will offer several features:

 - Show where a good connection is available (e.g. for tourist who want to use the internet)
 - Measure and improve coverage of the network
 - Provide visual insight in trends and developments of the network and its organic growth.


The project is very complex and challenging in several ways:

 - The data sets are very big, measuring information very soon leads to a big bulk of data. Producing an attractive picture is not easy. 
 - The representation in the web applicaiton must be simple and accessible in spite of the technical complexity of the system. 
 - A plurality of equipment and measuring set ups must be accomodated.

Dennis will report on his progress during the course of the project at the volunteer meetings.

= Table of Contents =
 Installation
 - [wiki:instal_config Installation & Configuration]
 - [wiki:model_data Model & Data import]
 - [wiki:running Running the application]

 Information
 - [wiki:structure Folders & Files explained]
 - [wiki:tilegen Tile generation & Data flow]

 Misc
 - [wiki:django_gheat Old install instructions]
 - [http://svn.wirelessleiden.nl/svn/projects/Heatmap/src/gheat/index.html 'Heatmap in progress']

 Examples using the [http://svn.wirelessleiden.nl/svn/data/WifiStumble/maatschappelijke-stage/1/WifiStumble/wleiden.csv wleiden.csv] and the methods described in [http://svn.wirelessleiden.nl/svn/data/WifiStumble/maatschappelijke-stage/1/WifiStumble/wleiden.csv onderzoeksrapport]. Based on these the decision has been made to go with django_gheat.
 - [http://svn.wirelessleiden.nl/svn/projects/Heatmap/src/gheat/index.html Gheat]
 - [http://www.google.com/fusiontables/DataSource?snapid=159718 Google Fusion Tables] (Check ''Display as heat map'')
 - [http://svn.wirelessleiden.nl/svn/projects/Heatmap/src/openlayers_heatmap/index.html OpenLayers HeatMap] (Using the [http://svn.openlayers.org/sandbox/camptocamp/canvas/openlayers/lib/OpenLayers.js OpenLayers sandbox/camptocamp] library for easy testing, the [http://svn.wirelessleiden.nl/svn/projects/Heatmap/src/openlayers_heatmap/index.php php version] uses database data)
 - [http://svn.wirelessleiden.nl/svn/projects/Heatmap/src/olheatmap/index.html OLHeatmap] (Edited version which uses local database, link will not show markers)

== Gathering the Data ==
Data are stored in svn: http://svn.wirelessleiden.nl/svn/data/WifiStumble/ 
Data can be gathered using smartphones with gps or a notebook/netbook with gps dongle.
An example is the use of an EeePC with a Garmin Etrex. Software used: Ubuntu with gpsd and kismet.
Rick wrote some detailed instructions on installing [wiki:kismet].

----

=== Starting Points ===

 * TracGuide --  Built-in Documentation
 * [http://trac.edgewall.org/ The Trac project] -- Trac Open Source Project
 * [http://trac.edgewall.org/wiki/TracFaq Trac FAQ] -- Frequently Asked Questions
 * TracSupport --  Trac Support

For a complete list of local wiki pages, see TitleIndex.