cityscapesScripts

环境要求

• Python 环境（可通过 python -m pip 安装包）
• pip 包管理工具
• 已按官网流程获取 Cityscapes 数据集
• 使用 csViewer / csLabelTool 需 Qt5 相关依赖

安装与启动步骤

1. 1安装主包

   通过 pip 安装 cityscapesscripts，安装后会提供 csDownload、csViewer、评估与转换等命令行工具。

   python -m pip install cityscapesscripts

   复制

2. 2安装图形工具

   可选。csViewer 和 csLabelTool 基于 Qt5，需要安装 gui 附加依赖后才能使用。

   python -m pip install cityscapesscripts[gui]

   复制

3. 3设置数据根目录

   将 CITYSCAPES_DATASET 指向数据集根文件夹，多数脚本会把它作为默认数据路径。

   export CITYSCAPES_DATASET=/your/path/cityscapes

   复制

4. 4下载数据集

   安装后可用 csDownload 命令行下载 Cityscapes 数据包；README 未列出具体参数，请按工具提示操作。

5. 5转换训练标签

   运行 csCreateTrainIdLabelImgs，将多边形标注转为像素编码 train ID 的 png；train ID 可在 labels.py 中定义。

6. 6生成实例与全景标注

   分别运行 csCreateTrainIdInstanceImgs 生成实例 ID 图，运行 csCreatePanopticImgs 生成 COCO 全景格式。

7. 7运行评估脚本

   使用 csEvalPixelLevelSemanticLabeling、csEvalInstanceLevelSemanticLabeling 等脚本评估验证集结果。

8. 8可视化检查

   运行 csViewer 查看图像并叠加标注，也可使用 csLabelTool 进行标注检查。

关键配置

如何确认成功

运行 csViewer 能正常打开图像并叠加标注，说明安装与 CITYSCAPES_DATASET 路径设置生效。

常见问题

注意事项

• README 未给出 csDownload、转换和评估工具的完整参数，执行前先确认工具用法。
• 数据集目录中并非所有 split/type 组合都存在，出现空文件夹属正常现象。
• 仅需命令行转换与评估时，不必安装 gui 附加依赖。