savesumocluster/sumo

SUMO-Python容器镜像文档

镜像概述

本镜像旨在提供一个预配置的环境，用于在容器中使用Python运行SUMO（Simulation of Urban MObility）——一款开源的城市交通模拟软件。镜像集成了SUMO核心组件与Python运行环境，简化了交通仿真相关开发、测试和部署流程，避免了本地环境配置的复杂性。

核心功能与特性

• 完整SUMO环境：包含SUMO主程序（sumo、sumo-gui、netconvert等）及相关依赖库
• Python支持：预装Python及SUMO Python API（traci），支持通过Python脚本控制和扩展仿真
• 环境隔离：容器化运行，避免与本地系统环境冲突，确保仿真环境一致性
• 轻量级设计：基于精简基础镜像，平衡功能完整性与资源占用

使用场景

• 城市交通流仿真与分析
• 智能交通系统（ITS）算法开发与测试
• 交通信号控制策略验证
• 自动驾驶路径规划仿真
• 交通相关教学与科研实验

使用方法

基本运行方式

1. 直接运行SUMO命令

bash
docker run --rm -v $(pwd):/app sumo-python sumo -c /app/your_simulation_config.sumocfg

2. 运行Python仿真脚本

bash
docker run --rm -v $(pwd):/app sumo-python python /app/your_simulation_script.py

3. 交互式使用（进入容器终端）

bash
docker run -it --rm -v $(pwd):/app sumo-python /bin/bash

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  sumo-simulation:
    image: sumo-python
    volumes:
      - ./simulation_data:/app  # 挂载本地仿真数据目录
    command: python /app/main.py  # 运行Python仿真脚本
    environment:
      - SUMO_HOME=/usr/share/sumo  # SUMO安装路径（默认已配置）

启动服务：

bash
docker-compose up

关键配置说明

数据挂载

• 建议将本地仿真配置文件（.sumocfg）、网络文件（.net.xml）、需求文件（.rou.xml）等挂载到容器内/app目录，便于修改和管理
• 示例：-v /path/to/your/simulation/files:/app

图形界面支持（可选）

如需运行sumo-gui图形界面，需配置X11转发（Linux/macOS环境）：

bash
docker run -it --rm -v $(pwd):/app -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix sumo-python sumo-gui -c /app/your_config.sumocfg

环境变量

• SUMO_HOME：SUMO安装路径，默认值为/usr/share/sumo，通常无需修改
• PYTHONPATH：Python模块搜索路径，默认已包含SUMO Python API路径

扩展说明

• 如需额外Python依赖，可基于本镜像创建自定义Dockerfile：

  dockerfile
  FROM sumo-python
  RUN pip install numpy pandas  # 安装额外Python库
  

• 更多SUMO使用细节请参考SUMO官方文档