First, Draw_cml_map
is a folium.Map
object, and therefore all regular folium
features can be added to.
Visualize CML locations and raw-data on a map.
The script reads a csv metadata file and creates and html file of all the links on a 2D map.
Generally, the metadata file must include the following column names:
link id, rx site latitude, tx site latitude, rx site longitude, tx site longitude
.
The names carrier
and hop_id
are optional and will be assigned with unknown carrier
and not provided
if they do not exist, respectively.
Availability of rawdata timeseries can also be visualized in the popups.
In the Class Draw_cml_map
you can can also:
- Determine domain boundaries
- Color specific links in different colors
- Drop specific links
- Add grid-lines
- Create distortion to the locations of the base stations to avoid geographic overlaps
All aforementions options are well documented in the description of the Class.
If raw data files are given, the CMLs drawn on the map will be ones for which raw data is available, and the popup of each link will consist of the timeseries available for it.
Note that the variable interval
is set to 15 (minutes) by default. Change it according to the resolution you possess.
If raw-data is not provided, the metadata will be drawn on the map.
If you choose to visualize data downloaded from the Omnisol system follow these steps. After the filtering of the desired raw-data is done, download both the metadata and the raw-data (optional) by clicking on the blue icons on the top right as shown here:
Another way of obtaining the metadata of your links is by checking all the boxes of the filtered data --> right click --> export --> export to csv. Metadata files can also be directly downloaded from the database. Specifically for the E-band frequancy links of SMBIT, it is even recommended since the metadata on the Omnisol system does not include all the links due to bugs in the system (the SMBIT rawdata file from the database can be fed to the Class "as-is" without changing the column names in the csv file).
Place both the metadata file and the raw-data folder in the same directory.
Play around by running the file run_example.py
, after changing the following lines to your own needs:
name_map = 'my_map'
dir_out = '/directory/of/out/'
dir_data = '/directory/of/metadata/'
md_filename_1 = 'metadata_file_name_1.csv'
md_filename_2 = 'metadata_file_name_2.csv'
raw_data_folder_name = 'rawdata'
An .html file will be generated and when opening it youshould be able to see something like this:
When only metadata is loaded, clicking on a link should start a pop-up containing the link id, hop id and carrier. Clicking on a gridline should show its value. When raw-data is also incorporated, clicking on a link should show you the timeseries of the raw-data you have downloaded, e.g.: