TESSNG Secondary Dev Skills

---

name: tessng-secondary-dev description: TESS NG V4.1 二次开发技能 - 支持 Python/Java/C++ 三种语言的交通仿真二次开发 doc_version: V4.1

TESS NG 二次开发技能

技能概述

本技能提供微观交通仿真软件 **TESS NG V4.1** 的二次开发能力，支持 **Python**、**Java**、**C++** 三种编程语言。TESS NG 是由上海集达交通科技有限公司自主研发的微观交通仿真软件，具有完全独立的知识产权。

核心能力

• 仿真流程控制：启动、暂停、恢复、关闭仿真，单步仿真执行
• 路网管理：路网文件的加载、编辑、CRUD 操作
• 信号控制：交通信号灯、信号组、多周期信号控制方案
• 车辆管理：车辆行为控制、速度引导、路径诱导、编队控制
• 特殊区域：事故区域、施工区域、限速区域、收费站、停车场
• 行人仿真：行人区域、行人路径、人行横道信号
• 数据输出：检测器、采集器、车辆轨迹、结构化路网数据

支持的编程语言

语言	版本要求	开发环境
Python	3.6 / 3.8	PyCharm
Java	JDK 8+	IntelliJ IDEA
C++	MSVC 2017+	Visual Studio / Qt Creator

---

快速开始

Python 开发环境配置

1. **安装 Python 3.6 或 3.8**

   # 下载地址：https://www.python.org/ftp/python/
   # 安装时勾选"Add Python to PATH"

2. **安装 tessng 包**

   pip install tessng
   # 或使用阿里云镜像加速
   pip install tessng -i https://mirrors.aliyun.com/pypi/simple/

3. **安装依赖库**

   pip install PySide2

4. **运行示例**

   from tessng import TessngFactory
   from MyPlugin import MyPlugin
   
   my_plugin = MyPlugin()
   config = {
       "__netfilepath": "path/to/netfile",
       "__workspace": "D:/TESSNG/V4.1",
       "__simuafterload": True,
   }
   factory = TessngFactory()
   factory.build(my_plugin, config)

Java 开发环境配置

1. **安装 JDK 8 或更高版本**

   # 下载地址：https://www.oracle.com/java/technologies/downloads/

2. **配置项目结构**

   TESS_JavaAPI_EXAMPLE/
   ├── lib/           # TESSNG.jar 等依赖库
   ├── src/main/java/ # 源代码
   │   ├── Main.java
   │   ├── MyPlugin.java
   │   ├── MyNet.java
   │   └── MySimulator.java
   └── pom.xml        # Maven 配置

3. **加载本地库**

   static {
       try {
           System.loadLibrary("TESS_WIN_Java");
       } catch (UnsatisfiedLinkError e) {
           System.err.println("Native code library failed to load");
           System.exit(1);
       }
   }