BasemapTutorial 项目使用指南

1. 项目目录结构及介绍

BasemapTutorial 项目的目录结构如下：

BasemapTutorial/
├── README.md
├── requirements.txt
├── data/
│   ├── example_data.nc
│   └── ...
├── notebooks/
│   ├── 01_Introduction_to_Basemap.ipynb
│   ├── 02_Advanced_Basemap_Techniques.ipynb
│   └── ...
├── scripts/
│   ├── plot_map.py
│   ├── process_data.py
│   └── ...
├── config/
│   ├── config.yaml
│   └── ...
└── tests/
    ├── test_plot_map.py
    └── ...

目录介绍：

• README.md: 项目的基本介绍和使用说明。
• requirements.txt: 项目依赖的 Python 包列表。
• data/: 存放项目使用的数据文件，如 example_data.nc。
• notebooks/: Jupyter Notebook 文件，包含项目的教程和示例代码。
• scripts/: Python 脚本文件，包含项目的核心功能实现。
• config/: 配置文件目录，包含项目的配置文件 config.yaml。
• tests/: 测试脚本目录，包含项目的单元测试代码。

2. 项目启动文件介绍

项目的启动文件主要位于 notebooks/ 目录下，其中 01_Introduction_to_Basemap.ipynb 是项目的入门教程，适合初学者使用。

启动步骤：

1. 安装项目依赖：

   pip install -r requirements.txt
   

2. 启动 Jupyter Notebook：

   jupyter notebook
   

3. 在 Jupyter Notebook 界面中打开 notebooks/01_Introduction_to_Basemap.ipynb，按照教程逐步运行代码。

3. 项目配置文件介绍

项目的配置文件位于 config/ 目录下，主要配置文件为 config.yaml。

config.yaml 配置文件示例：

# 数据文件路径
data_path: "data/example_data.nc"

# 地图绘制参数
map_params:
  projection: "merc"
  llcrnrlat: -80
  urcrnrlat: 80
  llcrnrlon: -180
  urcrnrlon: 180
  resolution: "c"

# 其他配置项
other_params:
  output_dir: "output"
  log_level: "INFO"

配置文件说明：

• data_path: 指定数据文件的路径。
• map_params: 配置地图绘制的参数，如投影类型、经纬度范围、分辨率等。
• other_params: 其他配置项，如输出目录、日志级别等。

通过修改 config.yaml 文件，可以自定义项目的运行参数和行为。