pyEarth项目教程

1. 项目目录结构及介绍

pyEarth项目是一个轻量级的地球3D可视化项目，其目录结构如下：

pyEarth/
├── shapefiles/                # 存放示例shapefiles文件
├── CREDITS.md                # 项目贡献者信息
├── LICENSE                   # 项目许可证信息
├── README.md                 # 项目说明文件
├── extended_pyEarth.py       # 扩展版本的主程序文件
├── pyEarth.py                # 标准版本的主程序文件
└── requirements.txt          # 项目依赖的Python库列表

详细介绍：

• shapefiles/：该文件夹包含了一些用于测试的示例shapefiles文件，这些文件包含了世界国家和美国的地理信息数据。
• CREDITS.md：记录了为项目做出贡献的开发者名单。
• LICENSE：包含了项目的开源许可证，本项目使用MIT许可证。
• README.md：详细介绍了项目的信息、功能和使用方法。
• extended_pyEarth.py：扩展版本的主程序文件，实现了导入shapefiles和Excel文件，并导出项目到Google Earth的功能。
• pyEarth.py：标准版本的主程序文件，仅实现了基本的shapefiles导入和3D地球旋转、缩放等操作。
• requirements.txt：列出了项目运行所依赖的Python库，如pyQt5、pyshp、shapely和pyproj。

2. 项目的启动文件介绍

根据项目的版本，有两种启动文件：pyEarth.py（标准版）和extended_pyEarth.py（扩展版）。

• pyEarth.py：标准版的启动文件，用户可以通过以下命令运行该文件启动项目：

  python pyEarth.py
  

  运行后，用户将看到一个3D地球，可以通过鼠标操作进行旋转和缩放。

• extended_pyEarth.py：扩展版的启动文件，提供了更多的功能，用户可以通过以下命令运行该文件启动项目：

  python extended_pyEarth.py
  

  在扩展版本中，用户不仅可以看到3D地球，还可以导入Excel文件中的节点和链接，并将项目导出为Google Earth的KML文件。

3. 项目的配置文件介绍

pyEarth项目使用requirements.txt作为配置文件，该文件列出了项目运行所需的所有Python库。用户需要确保在运行项目之前安装了这些库。可以通过以下命令安装所有的依赖库：

pip install -r requirements.txt

确保所有依赖库安装完成后，用户即可正常运行pyEarth项目，并根据需要修改pyEarth.py或extended_pyEarth.py中的配置，以适应不同的使用场景。