SUMO-Web3D 项目使用教程

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

SUMO-Web3D 项目的目录结构如下：

sumo-web3d/
├── sumo_web3d/
│   ├── __init__.py
│   ├── server.py
│   ├── client/
│   │   ├── src/
│   │   │   ├── index.tsx
│   │   │   ├── App.tsx
│   │   │   ├── components/
│   │   │   │   ├── Visualization.tsx
│   │   │   │   ├── Controls.tsx
│   │   │   ├── styles/
│   │   ├── public/
│   │   │   ├── index.html
│   ├── config/
│   │   ├── default_config.yaml
├── tests/
├── requirements.txt
├── README.md
├── setup.py

目录结构介绍

• sumo_web3d/: 主项目目录，包含服务器端和客户端代码。
  • server.py: 服务器端主文件，负责与 SUMO 进行通信。
  • client/: 客户端代码目录，使用 TypeScript、React 和 three.js 编写。
    • src/: 客户端源代码目录。
      • index.tsx: 客户端入口文件。
      • App.tsx: 主应用组件。
      • components/: 其他组件目录。
    • public/: 公共资源目录，包含 index.html。
  • config/: 配置文件目录。
    • default_config.yaml: 默认配置文件。
• tests/: 测试代码目录。
• requirements.txt: Python 依赖文件。
• README.md: 项目说明文档。
• setup.py: 项目安装脚本。

2. 项目的启动文件介绍

服务器端启动文件

服务器端的启动文件是 sumo_web3d/server.py。该文件负责启动 SUMO-Web3D 服务器，并与 SUMO 进行通信。

客户端启动文件

客户端的启动文件是 sumo_web3d/client/src/index.tsx。该文件是客户端的入口文件，负责渲染主应用组件。

3. 项目的配置文件介绍

项目的配置文件是 sumo_web3d/config/default_config.yaml。该文件包含了项目的默认配置选项，例如 SUMO 的启动参数、缩放因子等。

配置文件示例

sumo:
  args: "--scale 10 --step-length 0.1"
  scale: 10
  step_length: 0.1

配置文件说明

• sumo.args: 传递给 SUMO 的参数。
• sumo.scale: 车辆数量的缩放因子。
• sumo.step_length: 每帧的时间步长。

通过以上配置文件，可以灵活地调整 SUMO-Web3D 的运行参数，以适应不同的模拟需求。