An indoor positioning system using weighted mean and trilateration methods for use in the University of Tartu Delta Centre.
VideoPreview.mp4
This application was developed as part of a Bachelor's thesis at University of Tartu, which can be viewed here.
/
├── data
│ └── routers.csv # Main routers database
├── map
│ ├── korrus-1-c.png # Cleaned up and original versions
│ ├── korrus-1.png # of maps for every floor in Delta
│ ├── korrus-1-overlay.png # Overlays for floor maps
│ └── ...
├── ui
│ ├── app_main.ui # Main app window UI file for PySide
│ └── components.py # Classes for various UI components
├── app.py # Main app script file
├── config.json # Configuration file
├── install.sh # Easy install and setup bash script
├── locator.py # All methods required for positioning
├── requirements.txt # List of Python packages to install
├── scanner.py # Methods for envoking and parsing network scans
└── start.sh # Start bash script
$ git clone https://github.com/tonysln/delta-wifi-pos.git
$ cd delta-wifi-pos
$ pip install -r requirements.txt
Alternatively, the install.sh
script file can be downloaded and launched to complete the installation automatically.
If you're using Windows as your operating system:
$ python3 app.py
In case of macOS and Linux you will need sudo privileges:
$ sudo python3 app.py
In case of Linux you will also need to specify the name of your Wi-Fi adapter inside the config.json
file, on line 2:
"ADAPTER": "add_name_here",
On some Linux builds, the following error might be displayed, due to a bug in PySide 6:
ImportError: libOpenGL.so.0: cannot open shared object file: No such file or directory
You might need to install the libopengl0
library to fix this.
All constant variables used throughout the app are saved in config.json
and can be changed to possibly improve the accuracy.
Some useful variables to configure:
DIST_THRESHOLD
- expressed in pixels. All nearby routers above this value are ignored.RAD_THRESHOLD
- expressed in meters. Precision will be clamped by this value (max).PX_SCALE
- the amount of pixels to cover one meter of real distance.RSSI_MIN
- expressed in dBm. All nearby routers below this value are excluded.PATH_LOSS
exponent. Influences the conversion algorithm between RSSI and distance.POWER
value. Influences the conversion between RSSI and distance.AUTO_SEC
- expressed in seconds. Number of seconds between auto-scan activations.MIN_FLOOR
andMAX_FLOOR
- the lowest and highest floor numbers used in the application.