Strava-local-heatmap 项目使用教程

1. 项目的目录结构及介绍

Strava-local-heatmap/
├── README.md
├── requirements.txt
├── config.yaml
├── main.py
├── data/
│   └── activities.csv
└── utils/
    ├── heatmap.py
    └── data_processor.py

• README.md: 项目说明文件，包含项目的基本信息和使用指南。
• requirements.txt: 项目依赖文件，列出了运行该项目所需的所有Python包。
• config.yaml: 项目的配置文件，包含各种配置参数。
• main.py: 项目的启动文件，负责初始化和运行整个项目。
• data/: 数据目录，用于存放项目所需的数据文件，如 activities.csv。
• utils/: 工具目录，包含项目中使用的各种工具和辅助函数，如 heatmap.py 和 data_processor.py。

2. 项目的启动文件介绍

main.py

main.py 是项目的启动文件，负责初始化和运行整个项目。以下是其主要功能：

import yaml
from utils.data_processor import DataProcessor
from utils.heatmap import HeatmapGenerator

def main():
    # 读取配置文件
    with open('config.yaml', 'r') as f:
        config = yaml.safe_load(f)

    # 初始化数据处理器
    data_processor = DataProcessor(config['data_path'])
    activities = data_processor.load_data()

    # 初始化热力图生成器
    heatmap_generator = HeatmapGenerator(config)
    heatmap_generator.generate(activities)

if __name__ == '__main__':
    main()

• 读取配置文件: 使用 yaml 库读取 config.yaml 文件中的配置参数。
• 初始化数据处理器: 使用 DataProcessor 类加载数据文件。
• 初始化热力图生成器: 使用 HeatmapGenerator 类生成热力图。

3. 项目的配置文件介绍

config.yaml

config.yaml 是项目的配置文件，包含各种配置参数。以下是其主要内容：

data_path: 'data/activities.csv'
heatmap_output: 'output/heatmap.html'
heatmap_colors: ['orange', 'blue']
heatmap_zoom: 13

• data_path: 数据文件的路径。
• heatmap_output: 生成的热力图文件的输出路径。
• heatmap_colors: 热力图的颜色配置。
• heatmap_zoom: 热力图的缩放级别。

以上是 Strava-local-heatmap 项目的基本使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望对您有所帮助！