CoverageMapper is an open-source tool to visualize cellular radio network coverage measurements along with a network operator's claimed coverage.
Currently, the following network operators are supported:
- Deutsche Telekom
- Vodafone
The following command line options can be used to customize the rendered maps.
--id is used to create a subfolder where rendered images are stored
(./out/this-is-my-id).
python main.py --help
usage: main.py [OPTIONS]
Generate coverage maps for measurement data.
optional arguments:
-h, --help show this help message and exit
-i ID, --id ID
-t {None,NR,LTE,GSM}, --type {None,NR,LTE,GSM}
-p PADDING_DEGREES, --padding-degrees PADDING_DEGREES
--aspect-ratio ASPECT_RATIO
--dpi DPI
-l LOCATION_UPDATES, --location-updates LOCATION_UPDATES
-s SIGNAL_STRENGTHS, --signal-strengths SIGNAL_STRENGTHS
-d DISPLAY_INFO, --display-info DISPLAY_INFO
-o {None,Telekom,Vodafone}, --operator {None,Telekom,Vodafone}
--hide-title
--title TITLE
--file-type FILE_TYPE
--vmin VMIN
--vmax VMAX
--rsrqUse a virtual Python environment to install the required dependencies. Python 3.8 should work fine, while Python 3.9 does not work at the moment.
python -m venv venv
source venv/bin/activate
pip install -r requirements.txtAdditionally, you have to install PROJ. For details, have a look at their installation instructions. For macOS, simply install PROJ with:
brew install projpython main.py \
--id stuttgart \
--type NR \
--operator Telekom \
--aspect-ratio 1.78 \
--padding-degrees 0.025 \
--file-type png \
--location-updates ./data/LOCATION_UPDATE.csv \
--signal-strengths ./data/SIGNAL_STRENGTH.csv
python main.py \
--id stuttgart \
--rsrq \
--type NR \
--operator Telekom \
--aspect-ratio 1.78 \
--padding-degrees 0.025 \
--file-type png \
--location-updates ./data/LOCATION_UPDATE.csv \
--signal-strengths ./data/SIGNAL_STRENGTH.csv
python main.py \
--id stuttgart \
--type NR \
--operator Telekom \
--aspect-ratio 1.78 \
--padding-degrees 0.025 \
--file-type png \
--location-updates ./data/LOCATION_UPDATE.csv \
--display-info ./data/DISPLAY_INFO.csv
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent