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. <strong>Scripts:</strong> 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>dataset.ipynb for dataset visualization. Please check the notebook viewer for a preview. <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. <em>metadata_processing.py</em> The script for pre-processing metadata into CSV files. <em>dataset.ipynb </em> Jupiter notebook with dataset visualization and metadata pre-processing examples. <em>dataset_metadata.zip</em> Metadata of the dataset in TXT and JSON formats. <em>topology_map.png</em> A map of node deployment for creating topology maps. <strong>How to use dataset:</strong> Download <strong>all</strong> files in this repository Unzip the dataset_metadata.zip to the <em>dataset_metadata </em>folder Run the <em>Jupiter notebook -- </em>dataset.ipynb and check the results <strong>Dependencies:</strong> Python 3: networkx seaborn plotly One can use pip to install the package dependencies: <pre><code class="language-python">pip3 install networkx pip3 install seaborn pip3 install plotly pip3 install ipykernel pip3 install --upgrade nbformat pip3 install -U kaleido</code></pre>本仓库包含2021年5月至9月（共计4个月）在中国上海市基于ChirpBox采集的长期连通性与链路质量数据集。 **脚本说明：** 除数据集本身外，我们还提供用于数据分析与可视化的评估脚本，以助力数据集的探索与复用。为清晰说明脚本的使用方法，我们提供了用于数据集可视化的*Jupyter笔记本（Jupyter notebook）——dataset.ipynb*，可通过笔记本查看器预览其内容。 **文件清单：** *dataset_03052021_15092021.csv*：该数据集涵盖2021年5月3日至9月15日期间采集的LoRa连通性、链路质量以及环境信息。 *data_analysis.py*：用于数据集分析与可视化的脚本。 *metadata_processing.py*：用于将元数据预处理为CSV格式文件的脚本。 *dataset.ipynb*：包含数据集可视化与元数据预处理示例的Jupyter笔记本。 *dataset_metadata.zip*：以TXT与JSON格式存储的数据集元数据。 *topology_map.png*：用于绘制拓扑图的节点部署地图。 **数据集使用流程：** 下载本仓库内**全部**文件，将*dataset_metadata.zip*解压至*dataset_metadata*文件夹，随后运行Jupyter笔记本dataset.ipynb并查看执行结果。 **依赖环境：** Python 3，所需依赖包包括networkx、seaborn、plotly。可通过pip安装所需依赖包，执行命令如下： python pip3 install networkx pip3 install seaborn pip3 install plotly pip3 install ipykernel pip3 install --upgrade nbformat pip3 install -U kaleido