Vtrack is a WiFi signal collection tool for conducting location estimation and activity recognition research.

Download Vtrack here.(So far, the program works only under Windows XP).

We highly appreiciate it If you can kindly help contribute some WiFi data to facilitate this reserach!
To join this project, please send me an email with the following info so that we can trace and provide technical support.

------------------------------------------------------------------------------------------------------------------------------
1. Expected Data Format

WiFi Signal Data are automatically generated by the program, recording the received signal strengths.
Labels are provided by the user, with location and activity as input.

Based on such WiFi data, we can better understand human behaviors by recognizing the user's locations and activities.
Please refer to some of our previous works on WiFi data mining:
(1) Co-Localization from Labeled and Unlabeled Data Using Graph Laplacian. In IJCAI-07.
(2) Transferring Localization Models over Time. In AAAI-08.
(3) High-level Goal Recognition in a Wireless LAN. In AAAI-04.

------------------------------------------------------------------------------------------------------------------------------
2. Installation

Please find the step-by-step installation here.

------------------------------------------------------------------------------------------------------------------------------
3. Data Collection

3.1 Duration
One month.

The users are expected to hand in their collected data at:
(1) the end of Week 1, so that we can check whether the program works smoothly.
(2) the end of Week 4, completing the whole data collection.

3.2 Site
Basically in the HKUST campus area, although places outside the campus area (e.g. home) are also fine.

3.3 How to Collect Data?
Turn on the WiFi and run "Vtrack.exe". (if the user has added Vtrack as an auto-run program, then it will auto-run at system start-up)

Generally, the program runs in background (shown as a green icon in the tray) to collect the WiFi data.
You can left-double-click the icon to restore the program window, or right-double-click it to terminate the program.

The user does not need to take care of the program, until it pops up to ask for user input when:
-- Case 1: it automatically detects possible location change, or
-- Case 2: it fails to detect location change, and the user has to manually left-double-click the program icon in the tray.

Step 1: Picking one of the following 9 pre-defined activities from the list:
Having Class, Having Seminar, Having Meeting, Doing Homework, Doing Research, Having Meal, Having Sports, Having Leisure, Others

Step 2: Composing an identifiable location (e.g. "Room 3501") rather than vague terms (e.g. "Classroom") in the edit bar:
Room 3501, Library, LTE, LG5, Coffee shop, LG1 Indoor Sports Complex, Car park, ARRO, etc.

Step 3: After completing the input, the user can press "enter" or click "Ok" button to save the input.
The program window will automatically minimize to the tray, and run in background.

If you want to terminate the program, please right double-click the program icon in the tray.

3.4 How to Hand in the Collected Data?
Step 1: Copy the generated data logs including "AP.dat", "Data.dat", "Label.dat" and "Location.dat", into a file-folder.
Step 2: Compress the file-folder, and send it to me by email.

3.5 Want to Ask a Question?
Please send me an email.

------------------------------------------------------------------------------------------------------------------------------
4. Privacy

(1) This data collection will not leak any user idenfication information, such as name, etc.
(2) The functions of Vtrack are limited to: collecting WiFi signal data, detecting computer's IP address and recording user inputs.
(3) The final output of Vtrack only contains:
      -- "AP.dat", which saves the detected access points in the environment;
      -- "Data.dat", which saves the received WiFi signal strengths;
      -- "Location.dat", which saves the input location history;
      -- "Label.dat", which saves the user input locations and activities.

------------------------------------------------------------------------------------------------------------------------------
Copyright & Acknowledgement:
Vtrack is © copyrighted by Vincent W. Zheng, Hong Kong University of Science and Technology. Acknowledgement to Junfeng Pan for his great help in developing this code.