tessng 0.0.1__tar.gz

tessng-0.0.1/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) Jida Transportation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tessng-0.0.1/MANIFEST.in

@@ -0,0 +1,3 @@
+include LICENSE
+recursive-include tessng *
+exclude */__pycache__

tessng-0.0.1/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.1
+Name: tessng
+Version: 0.0.1
+Summary: TESS NG V4.0 Secondary Development (Python version)
+Home-page: http://jidatraffic.com:82/
+Author: Jida Transportation
+Author-email: 17315487709@163.com
+License: MIT
+Platform: UNKNOWN
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.8
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6, !=3.7.*, <3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+## 功能 Function
+TessNg使用户可以通过编写 Python 代码来与微观交通仿真软件TESS NG 进行交互，从而实现仿真软件的能力扩张与功能定制。
+
+TessNg enables users to interact with the micro traffic simulation software TESS NG by writing Python code, thereby expanding the capabilities and customizing the functions of the simulation software.
+
+## 版本 Version
+Python的版本要求为**3.6或3.8**，运行环境为Windows，TESS NG 的版本为**V4**。
+
+The version requirement for Python is **3.6 or 3.8**, the running environment is Windows, and the version for TESS NG is **V4**.
+
+## 安装 Install
+请使用以下命令安装 tessng 包：
+
+You can use the following command to install the tessng package
+
+```bash
+pip install tessng
+```
+
+## 使用 Usage
+可以使用以下代码生成TESS NG 基础案例的代码文件：
+
+You can generate a code file for a TESS NG basic case using the following code:
+
+```python
+import tessng
+tessng.get_demo_files(path=None)
+```
+其中，参数path为保存代码文件的路径，默认为当前目录。
+
+Among them, the parameter path is the path to save the code file, which defaults to the current directory.
+
+执行该代码将生成4个文件：main.py、MyPlugin.py、MyNet.py 和 MySimulator.py，运行main.py，并使用 key 激活软件，即可启动TESS NG。
+
+Executing this code will generate four files: main.exe, MyPlugin. py, MyNet. py, and MySimulator. py. Run main. py and activate the software with the key to start TESS NG.
+
+更多使用说明请参考济达交通官方网站：http://jidatraffic.com:82/
+
+For more usage instructions, please refer to the official website of Jida Transportation: http://jidatraffic.com:82/
+
+

tessng-0.0.1/README.md

@@ -0,0 +1,39 @@
+## 功能 Function
+TessNg使用户可以通过编写 Python 代码来与微观交通仿真软件TESS NG 进行交互，从而实现仿真软件的能力扩张与功能定制。
+
+TessNg enables users to interact with the micro traffic simulation software TESS NG by writing Python code, thereby expanding the capabilities and customizing the functions of the simulation software.
+
+## 版本 Version
+Python的版本要求为**3.6或3.8**，运行环境为Windows，TESS NG 的版本为**V4**。
+
+The version requirement for Python is **3.6 or 3.8**, the running environment is Windows, and the version for TESS NG is **V4**.
+
+## 安装 Install
+请使用以下命令安装 tessng 包：
+
+You can use the following command to install the tessng package
+
+```bash
+pip install tessng
+```
+
+## 使用 Usage
+可以使用以下代码生成TESS NG 基础案例的代码文件：
+
+You can generate a code file for a TESS NG basic case using the following code:
+
+```python
+import tessng
+tessng.get_demo_files(path=None)
+```
+其中，参数path为保存代码文件的路径，默认为当前目录。
+
+Among them, the parameter path is the path to save the code file, which defaults to the current directory.
+
+执行该代码将生成4个文件：main.py、MyPlugin.py、MyNet.py 和 MySimulator.py，运行main.py，并使用 key 激活软件，即可启动TESS NG。
+
+Executing this code will generate four files: main.exe, MyPlugin. py, MyNet. py, and MySimulator. py. Run main. py and activate the software with the key to start TESS NG.
+
+更多使用说明请参考济达交通官方网站：http://jidatraffic.com:82/
+
+For more usage instructions, please refer to the official website of Jida Transportation: http://jidatraffic.com:82/

tessng-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tessng-0.0.1/setup.py

@@ -0,0 +1,63 @@
+import sys
+import setuptools
+from wheel.bdist_wheel import bdist_wheel as bdist_wheel_orig
+
+
+# 获取当前Python版本
+current_python_version: str = ".".join(map(str, [sys.version_info.major, sys.version_info.minor]))
+print(f"当前Python版本为：{current_python_version}")
+
+# 如果Python版本是3.6
+if current_python_version == "3.6":
+    python_tag = "cp36"
+    abi_tag = "cp36m"
+# 如果Python版本是3.8
+elif current_python_version == "3.8":
+    python_tag = "cp38"
+    abi_tag = "cp38"
+# 如果Python版本是其他
+else:
+    raise RuntimeError("Unsupported Python version")
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+class bdist_wheel(bdist_wheel_orig):
+    def get_tag(self):
+        # 返回 python tag, abi tag, platform tag
+        return python_tag, abi_tag, "win_amd64"
+
+
+setuptools.setup(
+    name="tessng",
+    version="0.0.1",
+    author="Jida Transportation",
+    author_email="17315487709@163.com",
+    description="TESS NG V4.0 Secondary Development (Python version)",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="http://jidatraffic.com:82/",
+    python_requires=">=3.6, !=3.7.*, <3.9",
+    packages=setuptools.find_packages(),
+    package_data={
+        "tessng": ["*.dll", "*.pyd", "*.pyi", "*.exe", "TESS_PythonAPI_EXAMPLE"]
+    },
+    install_requires=[
+        "PySide2",
+        "shiboken2",
+    ],
+    license='MIT',
+    license_files=('LICENSE',),
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.6",
+        "Programming Language :: Python :: 3.8",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    cmdclass={
+        "bdist_wheel": bdist_wheel
+    },
+    zip_safe=False,
+    include_package_data=True,
+)

tessng-0.0.1/tessng/TESS_PythonAPI_EXAMPLE/MyNet.py

@@ -0,0 +1,206 @@
+from PySide2.QtCore import QPointF
+from tessng import PyCustomerNet, tessngIFace, m2p, p2m, NetItemType, GraphicsItemPropName
+
+
+# 用户插件子类，代表用户自定义与路网相关的实现逻辑，继承自MyCustomerNet
+class MyNet(PyCustomerNet):
+    def __init__(self):
+        super().__init__()
+        # 代表TESS NG的接口
+        self.iface = tessngIFace()
+        # 代表TESS NG的路网子接口
+        self.netiface = self.iface.netInterface()
+        # 代表TESS NG仿真子接口
+        self.simuiface = self.iface.simuInterface()
+
+    # 自定义方法：创建路网上的路段和连接段
+    def create_network(self) -> None:
+        # 创建第一条路段
+        start_point = QPointF(m2p(-300), 0)
+        end_point = QPointF(m2p(300), 0)
+        link_points = [start_point, end_point]
+        link1 = self.netiface.createLink(link_points, 7, "曹安公路")
+        if link1 is not None:
+            # 车道列表
+            lanes = link1.lanes()
+            # 打印该路段所有车道ID列表
+            print("曹安公路车道ID列表：", [lane.id() for lane in lanes])
+            # 在当前路段创建发车点
+            dp = self.netiface.createDispatchPoint(link1)
+            if dp is not None:
+                # 设置发车间隔，含车型组成、时间间隔、发车数
+                dp.addDispatchInterval(1, 2, 28)
+
+        # 创建第二条路段
+        start_point = QPointF(m2p(-300), m2p(-25))
+        end_point = QPointF(m2p(300), m2p(-25))
+        link_points = [start_point, end_point]
+        link2 = self.netiface.createLink(link_points, 7, "次干道")
+        if link2 is not None:
+            # 在当前路段创建发车点
+            dp = self.netiface.createDispatchPoint(link2)
+            if dp is not None:
+                # 设置发车间隔，含车型组成、时间间隔、发车数
+                dp.addDispatchInterval(1, 3600, 3600)
+            # 将外侧车道设为公交专用道
+            lanes = link2.lanes()
+            lane = lanes[0]
+            lane.setLaneType("公交专用道")
+
+        # 创建第三条路段
+        start_point = QPointF(m2p(-300), m2p(25))
+        end_point = QPointF(m2p(-150), m2p(25))
+        link_points = [start_point, end_point]
+        link3 = self.netiface.createLink(link_points, 3)
+        if link3 is not None:
+            # 在当前路段创建发车点
+            dp = self.netiface.createDispatchPoint(link3)
+            if dp is not None:
+                # 设置发车间隔，含车型组成、时间间隔、发车数
+                dp.addDispatchInterval(1, 3600, 3600)
+
+        # 创建第四条路段
+        start_point = QPointF(m2p(-50), m2p(25))
+        end_point = QPointF(m2p(50), m2p(25))
+        link_points = [start_point, end_point]
+        link4 = self.netiface.createLink(link_points, 3)
+
+        # 创建第五条路段
+        start_point = QPointF(m2p(150), m2p(25))
+        end_point = QPointF(m2p(300), m2p(25))
+        link_points = [start_point, end_point]
+        link5 = self.netiface.createLink(link_points, 3, "自定义限速路段")
+        if link5 is not None:
+            # 设置路段限速 km/h
+            link5.setLimitSpeed(30)
+
+        # 创建第六条路段
+        start_point = QPointF(m2p(-300), m2p(50))
+        end_point = QPointF(m2p(300), m2p(50))
+        link_points = [start_point, end_point]
+        link6 = self.netiface.createLink(link_points, 3, "动态发车路段")
+        if link6 is not None:
+            # 设置路段限速 km/h
+            link6.setLimitSpeed(80)
+
+        # 创建第七条路段
+        start_point = QPointF(m2p(-300), m2p(75))
+        end_point = QPointF(m2p(-250), m2p(75))
+        link_points = [start_point, end_point]
+        link7 = self.netiface.createLink(link_points, 3)
+        if link7 is not None:
+            # 设置路段限速 km/h
+            link7.setLimitSpeed(80)
+
+        # 创建第八条路段
+        start_point = QPointF(m2p(-50), m2p(75))
+        end_point = QPointF(m2p(300), m2p(75))
+        link_points = [start_point, end_point]
+        link8 = self.netiface.createLink(link_points, 3)
+        if link8 is not None:
+            # 设置路段限速 km/h
+            link8.setLimitSpeed(80)
+
+        # 创建第一条连接段
+        if link3 is not None and link4 is not None:
+            from_lane_numbers = [1, 2, 3]
+            to_lane_numbers = [1, 2, 3]
+            connector1 = self.netiface.createConnector(link3.id(), link4.id(), from_lane_numbers, to_lane_numbers, "连接段1", True)
+
+        # 创建第二条连接段
+        if link4 is not None and link5 is not None:
+            from_lane_numbers = [1, 2, 3]
+            to_lane_numbers = [1, 2, 3]
+            connector2 = self.netiface.createConnector(link4.id(), link5.id(), from_lane_numbers, to_lane_numbers, "连接段2", True)
+
+        # 创建第三条连接段
+        if link7 is not None and link8 is not None:
+            from_lane_numbers = [1, 2, 3]
+            to_lane_numbers = [1, 2, 3]
+            connector3 = self.netiface.createConnector(link7.id(), link8.id(), from_lane_numbers, to_lane_numbers, "动态发车连接段", True)
+
+    # 重写父类方法：当打开网后TESS NG调用此方法
+    def afterLoadNet(self) -> None:
+        # 获取路段数
+        count = self.netiface.linkCount()
+        # 如果路网上没有路段，则调用自定义的创建路网的方法
+        if count == 0:
+            self.create_network()
+
+        if self.netiface.linkCount() > 0:
+            # 所有路段对象列表
+            links = self.netiface.links()
+            # ID等于1的路段
+            link = self.netiface.findLink(1)
+            if link is not None:
+                # 路段中心线断点集
+                link_points = link.centerBreakPoints()
+                print("一条路段中心线断点：", [(p.x(), p.y()) for p in link_points])
+                # 路段的车道对象列表
+                lanes = link.lanes()
+                if lanes is not None and len(lanes) > 0:
+                    # 第一条车道中心线断点
+                    lane_points = lanes[0].centerBreakPoints()
+                    print("一条车道中心线断点：", [(p.x(), p.y()) for p in lane_points])
+            # 所有连接段对象列表
+            connectors = self.netiface.connectors()
+            if len(connectors) > 0:
+                # 第一条连接段的所有“车道连接”
+                lane_connectors = connectors[0].laneConnectors()
+                # 其中第一条“车道连接”
+                lane_connector = lane_connectors[0]
+                # "车道连接“断点集
+                lane_connector_points = lane_connector.centerBreakPoints()
+                print("一条'车道连接'中心线断点：", [(p.x(), p.y()) for p in lane_connector_points])
+
+    # 重写父类方法：是否允许用户对路网元素的绘制进行干预，如选择路段标签类型、确定绘制颜色等，本方法目的在于减少不必要的对python方法调用频次
+    def isPermitForCustDraw(self) -> bool:
+        """
+        :return: 返回值，True表示允许用户对路网元素的绘制进行干预，False表示不允许用户对路网元素的绘制进行干预
+        """
+        # 获取当前路网文件名
+        net_file_name = self.netiface.netFilePath()
+        if "Temp" in net_file_name:
+            return True
+        else:
+            return False
+
+    # 重写父类方法：在绘制路网元素时被调用，确定用ID或名称，以及字体大小绘制标签，也可确定不绘制标签
+    def ref_labelNameAndFont(self, itemType, itemId, ref_outPropName, ref_outFontSize) -> None:
+        """
+        :param itemType: NetItemType常量，代表不同类型路网元素
+        :param itemId: 路网元素的ID
+        :param ref_outPropName: GraphicsItemPropName枚举类型，None_表示不绘制，ID表示绘制ID，NAME表示绘制名称，影响路段和连接段的标签是否被绘制
+        :param ref_outFontSize: 标签大小，单位：米。假设车道宽度是3.5米，如果ref_outFontSize.value等于7，绘制的标签大小占两个车道宽度
+        """
+        # 如果仿真正在进行，设置ref_outPropName.value等于GraphicsItemPropName.None_，路段和车道都不绘制标签
+        if self.simuiface.isRunning():
+            ref_outPropName.value = GraphicsItemPropName.None_
+            return
+        # 默认绘制ID
+        ref_outPropName.value = GraphicsItemPropName.Id
+        # 标签大小为6米
+        ref_outFontSize.value = 6
+        # 如果是连接段一律绘制名称
+        if itemType == NetItemType.GConnectorType:
+            ref_outPropName.value = GraphicsItemPropName.Name
+        # 如果是路段，则根据ID判断是否绘制名称
+        elif itemType == NetItemType.GLinkType:
+            if itemId == 1 or itemId == 5 or itemId == 6:
+                ref_outPropName.value = GraphicsItemPropName.Name
+
+    # 重写父类方法：是否绘制车道中心线
+    def isDrawLaneCenterLine(self, lane_id: int) -> bool:
+        """
+        :param lane_id: 车道ID
+        :return: 是否绘制车道中心线，True表示绘制，False表示不绘制
+        """
+        return True
+
+    # 重写父类方法：是否绘制路段中心线
+    def isDrawLinkCenterLine(self, link_id: int) -> bool:
+        """
+        :param link_id: 路段ID
+        :return: 是否绘制路段中心线，True表示绘制，False表示不绘制
+        """
+        return link_id != 1

tessng-0.0.1/tessng/TESS_PythonAPI_EXAMPLE/MyPlugin.py

@@ -0,0 +1,51 @@
+import os
+import sys
+from PySide2.QtWidgets import QApplication
+from PySide2.QtGui import Qt
+from tessng import TessPlugin, TessngFactory, tessngIFace
+from MyNet import MyNet
+from MySimulator import MySimulator
+
+
+# 用户插件，继承自TessPlugin
+class MyPlugin(TessPlugin):
+    def __init__(self):
+        super().__init__()
+        self.my_net = None
+        self.my_simulator = None
+
+    def start(self, config: dict) -> None:
+        # 工作空间目录路径
+        workspace = os.path.join(os.getcwd(), "WorkSpace")
+        config["__workspace"] = workspace
+        # 创建文件夹
+        os.makedirs(workspace, exist_ok=True)
+
+        # 创建TESS NG对象
+        app = QApplication()
+        factory = TessngFactory()
+        tessng = factory.build(self, config)
+        if tessng is None:
+            sys.exit(0)
+        else:
+            sys.exit(app.exec_())
+
+    # 过载父类方法：在 TESS NG工厂类创建TESS NG对象时调用
+    def init(self) -> None:
+        self.my_net = MyNet()
+        self.my_simulator = MySimulator()
+        # 关联信号和槽函数
+        iface = tessngIFace()
+        win = iface.guiInterface().mainWindow()
+        # 将信号mSimuInf.forReStopSimu关联到主窗体的槽函数doStopSimu，可以安全地停止仿真
+        self.my_simulator.forStopSimu.connect(win.doStopSimu, Qt.QueuedConnection)
+        # 将信号mSimuInf.forReStartSimu关联到主窗体的槽函数doStartSimu，可以安全地启动仿真
+        self.my_simulator.forReStartSimu.connect(win.doStartSimu, Qt.QueuedConnection)
+
+    # 过载父类方法：返回插件路网子接口，此方法由TESS NG调用
+    def customerNet(self):
+        return self.my_net
+
+    # 过载父类方法：返回插件仿真子接口，此方法由TESS NG调用
+    def customerSimulator(self):
+        return self.my_simulator