Pharos Data

IntroductionThis data repository includes the cleaned dataset for the Pharos application 2023-2024 data collection period (May 2023-March 2024). This dataset includes the full recurring network measurement (RNM), landmark (LM) datasets, as well as the county geographies used for the study catchment area. Also included in this dataset are the necessary software files to clean and visualize the collected data replicating the methods used in our published analysis.Setup and Execution Instructions for ReproductionPrerequisitesPython 3.9.16 (likely compatible, but untested with &gt;3.7)pip (Python package installer)Files Included_main.py - Main execution script_clean_df.py - Data cleaning module_make_viz.py - Visualization module_clean_lms.csv - Landmark measurement data_clean_rnms.csv - Recurring network measurement data_Counties_WesternKenya.json - Geographic boundaries for Western Kenya counties_requirements.txt - Python package dependenciesInstallation and Execution1a. Create a virtual environment (using a virtual environment is recommended, but not required)<br><code>python3</code><code> </code><code>-m</code><code> </code><code>venv</code><code> </code><code>venv</code><br><br>1b. Activate the virtual environment (using a virtual environment is recommended, but not required)<br><code>source</code><code> </code><code>venv/bin/activate</code><br><br>2. Install required packages<br><code>pip</code><code> </code><code>install</code><code> </code><code>-r</code><code> </code><code>requirements.txt</code><br><br>3. Run the analysis<br><code>python</code><code> </code><code>_main.py</code><br><br>4. Deactivate virtual environment when done (if used)<br><code>deactivate</code>

引言
本数据集仓库包含Pharos应用程序2023-2024年度数据采集阶段（2023年5月至2024年3月）的清洗后数据集。本数据集涵盖完整的周期性网络测量（Recurring Network Measurement, RNM）数据集、地标（Landmark, LM）数据集，以及用于划定研究覆盖范围的肯尼亚西部郡县地理边界数据。本数据集还包含用于清洗、可视化采集数据的必要软件文件，可复现已发表研究中采用的分析方法。

## 复现实验的设置与执行说明
### 前置依赖
Python 3.9.16（版本兼容范围推测为≥3.7，但未对3.7以上版本进行测试）
pip（Python包安装器）

### 包含文件
`_main.py`：主执行脚本
`_clean_df.py`：数据清洗模块
`_make_viz.py`：可视化模块
`_clean_lms.csv`：地标测量数据
`_clean_rnms.csv`：周期性网络测量数据
`_Counties_WesternKenya.json`：肯尼亚西部郡县地理边界文件
`_requirements.txt`：Python包依赖清单

### 安装与执行步骤
1a. 创建虚拟环境（推荐使用虚拟环境，非强制要求）<br><code>python3 -m venv venv</code>
1b. 激活虚拟环境（推荐使用虚拟环境，非强制要求）<br><code>source venv/bin/activate</code>
2. 安装所需依赖包<br><code>pip install -r requirements.txt</code>
3. 运行分析脚本<br><code>python _main.py</code>
4. 实验结束后退出虚拟环境（若已创建）<br><code>deactivate</code>