TAD Sim

1. 概述

腾讯自动驾驶仿真系统 TAD Sim (Tencent Autonomous Driving Simulation) 单机版 是腾讯自动驾驶以建立更加安全和高效的自动驾驶测试工具为目标, 为自动驾驶系统研发和验证而量身定做的跨平台分布式系统.

它基于腾讯强大的游戏引擎、虚拟现实、云游戏技术, 集成工业级的车辆动力学模型和专业的渲染引擎, 辅以三维重建技术和虚实一体交通流, 可以完成感知、决策、控制算法等实车上全部模块的闭环仿真验证, 极大地降低了研发成本并缩短了研发实际周期.

2. 整体架构

3. 入门指南

3.1 目录结构

--adapter                           消息桥接
--co_simulation                     联合仿真
--common                            通用功能模块
--datas                             数据汇总
--docs                              文档及用户使用操作手册
--simapp                            前端
--simcore                           后端 & 引擎
--tools                             工具脚本集合
--.clang-format                     定义 Clang 格式化工具的代码风格规则, 主要用于 C++ 代码 (排除 simcore/sensors/display)
--.editorconfig                     统一代码风格
--Dockerfile                        定义构建镜像所需指令和配置 - 非 simcore/sensors/display 模块编译
--Dockerfile_display                定义构建镜像所需指令和配置 - simcore/sensors/display 模块编译
--Dockerfile_display_runtime        定义构建镜像所需指令和配置 - simcore/sensors/display 模块运行 (非必须)

3.2 开发环境准备

• 通用要求

• git, git-lfs(simcore/sensors/display 需要), 建议下载 UGit Downloads 软件对于 lfs 有较好的处理.

• 对于 windows 平台下开发, 需手动安装依赖软件, 操作指引如下方链接.

• windows 平台开发指引

• 对于 Ubuntu 平台下开发, 本仓库提供 Dockerfile, 使用该 Dockerfile 构建 Docker 镜像, 并在其中进行相关的开发与编译工作, 操作指引如下方链接. 如需在 Ubuntu 本机进行, 环境安装及版本请参照 Dockerfile 内容自行进行, 此处不做具体展开.

• ubuntu 平台开发指引

3.3 构建编译

• 修改版本号 txt 找到 TAD_Sim/simapp/package.json 文件, 并手动修改第 3 行 ("version" 对应的值). 注意格式需为 "x.x.x"

• 编译指令

```bash # for ubuntu

# 编译 desktop # current build environment is under ubuntu 18.04 (Dockerfile 构建的镜像) cd TAD_Sim ./build.sh

# 编译 display # current build environment is under unreal-engine (Dockerfile_display 构建的镜像) cd simcore/sensors/display ./build.sh ```

```powershell # for windows

# 编译 desktop # current build environment is under windows 11. cd TAD_Sim .\build.bat

# 编译 display # current build environment is under windows 11. cd simcore\sensors\display .\build.bat ```

• 产物查看 ```txt 在 TAD_Sim/build/release 文件夹下, 可查看到如下产物:
  • 可执行程序: (.exe 或 .deb)
  • txSimSDK_xxx.tar.gz (被测算法及功能模块接入 SDK)
  • txSimMapSDK_xxx.tar.gz (高精地图处理 SDK)
  • txSimGradingSDK_xxx.tar.gz (第三方评测指标接入 SDK)

在 TAD_Sim/simcore/sensors/display/build/bin 文件夹下, 可查看到如下产物: - display.tar.gz (高保真及传感器资源) ```

3.4 安装部署

• 产物编译完成后, 可进行安装部署，具体操作如下:
• TAD Sim 单机版安装部署操作指引 - windows & ubuntu

3.5 使用操作

• 用户操作手册可通过如下方式进行编译, 生成本地版 html 静态网站, 可通过浏览器查看.

• 编译指令: bash # for ubuntu cd TAD_Sim/docs/user_guidelines ./build.sh

  ```powershell

  for windows

  cd TAD_Sim\docs\user_guidelines .\build.bat ```

• 产物查看 ```txt

  • 在 TAD_Sim/docs/user_guidelines/build/user_guidelines_desktop_standard 文件夹下:
  • 点击 index.html 跳转到浏览器后查看 ```

4. 贡献

5. 版权

许可证遵循 [Apache v2.0 协议]. 更多细节请访问 LICENSE.