Dataset: Environmental Impact on the Long-Term Connectivity and Link Quality of an Outdoor LoRa Network

This repository contains the long-term connectivity and link quality dataset collected on ChirpBox over 4 months (May -- September 2021) in the city of Shanghai, China. In addition to the dataset itself, we provide evaluation scripts for data analysis and visualization, in order to facilitate data exploration and re-use. To make it clear how to use the scripts, we provide a <em>Jupyter notebook -- </em> <strong>dataset.ipynb</strong> for dataset visualization. <strong>List of files:</strong> <em>dataset_03052021_15092021.csv</em> The dataset includes LoRa connectivity and link quality, as well as environmental information, collected from May 3 to September 15, 2021. <em>data_analysis.py</em> The script for dataset analysis and visualization. One can use the functions in this script to derive network-level statistics (e.g., in terms of average number of correctly-exchanged packets), link-level statistics (e.g., in terms of SNR, RSS, and PRR), and node-level statistics(e.g., in terms of number of neighbours and temperature evolution over time). <em>metadata_processing.py</em> The script for pre-processing metadata into CSV files. One can use the functions in this script to convert metadata for each measurement saved in TXT and JSON formats to CSV files that include attributes such as link quality, connectivity, and environmental information, an example of which is <strong>dataset_03052021_15092021.csv</strong>. <em>dataset.ipynb </em> The Jupiter notebook contains examples of visualization and metadata pre-processing of datasets with functions in <strong>data_analysis.py</strong> and <strong>metadata_processing.py</strong>. <em>topology_map.png</em> The node deployment map used to create topology figures. A usage example is <strong>Figure 1</strong> shown in the notebook <strong>dataset.ipynb</strong>. <em>dataset_metadata.zip</em> The dataset metadata is stored in TXT and JSON formats. Among them, link quality, connectivity and on-board sensor data are stored in TXT files and weather information are stored in JOSN files. <em>README.md</em> The README.md explains all the files in this repository and gives some examples of how to use the provided scripts to analyze the dataset.