WiFi Location Tracking Files

 
Portions Copyright 2007.  Theodeore Enns, Steven Russell, Theatro Labs Inc.
Theatro Labs User Agreement:
THEATRO LABS, INC. HEREBY MAKES AVAILABLE CERTAIN SOFTWARE, DOCUMENTATION, INFORMATION AND/OR OTHER MATERIALS FOR OPEN SOURCE PROJECTS (COLLECTIVELY "CONTENT"). USE OF THE CONTENT IS GOVERNED BY THE TERMS OF THIS AGREEMENT AND/OR THE TERMS AND CONDITIONS OF LICENSE AGREEMENTS OR NOTICES INDICATED OR REFERENCED BELOW. BY USING THE CONTENT, YOU AGREE THAT YOUR USE OF THE CONTENT IS GOVERNED BY THIS AGREEMENT AND/OR THE TERMS AND CONDITIONS OF ANY APPLICABLE LICENSE AGREEMENTS OR NOTICES INDICATED OR REFERENCED BELOW. IF YOU DO NOT AGREE TO THE TERMS AND CONDITIONS OF THIS AGREEMENT AND THE TERMS AND CONDITIONS OF ANY APPLICABLE LICENSE AGREEMENTS OR NOTICES INDICATED OR REFERENCED BELOW, THEN YOU MAY NOT USE THE CONTENT.
License: CDDL v 1.0
Except as contained in this notice, the name Theatro Labs, Inc. shall not be used in advertising or otherwise to promote the sale, use or other dealings in this content without prior written authorization of the Theatro Labs, Inc.

Contents:
   - Location tracking module named Tracker.py. This module can be plugged 		into any project to track 2D location based on WiFi signals.
   - An example location tracking server called LocationTrackingServer.py. 		This server allows a cleint object to send observed Wifi data and receive 	back a grid location and a qualified region classifier.
   - A Location building (learning) server called LocationBuildingServer.py,  	which can be used in combination with the Android tool to memorize the 	statistics of the wifi environment.  
   - An example Android tool called Wifi Locator, which can be used to both train 	the server and track location using the server.
Installation: 
	-Install Python 2.6 or 2.7 from http://www.python.org/getit/
	-Download and unzip LocationTrackingServer.zip to your workspace
Building Location Data:
   - Modify FloorPlan.py to reflect your environment's obstacles and size
   - Modify Settings.py with the following:
	- ssidlist should contian a list of SSIDs you wish to allow the system to 		track location from
	- Create the folder listed in mydatafilepath. this is where your training 	data will be stored
	- Start the python server by importing LocationBuildingServer.py in the 	IDLE 	console
	-Open the example Android tool or similar training unit to collect data 	(See more below about the Android Tool)
Using Tracker.py:
   - OPTIONAL: Change Settings.py to best reflect travel speeds for your usage
   - Import Tracker.py
   - Create a Tracker object
   - Call input_observation() to your Tracker with a dictionary parameter 	containing SSID names as keys and SSID strength as values.
   - Get fine location with get_most_likely_loc()
   - Get regional classifier (coarse) location with get_most_likely_region()
Using Android Tool (AKA Wifi locator):
        - To train the server, click the Build Training Data button. Enter in your server IP address. 	At each grid location, enter in your X/Y coordinates and press the ON/OFF button. The 	button will turn off when enough data has been collected.
         - To track location from the example LocationTrackingServer.py, import 	LocationTrackingServer.py on your host machine. Start the Android tool and 	select the Track Location button. Enter your host machine IP address and 	press the ON/OFF button.