v2sim 1.3.0__tar.gz

v2sim-1.3.0/.gitignore

@@ -0,0 +1,39 @@
+# Compiled source
+__pycache__
+.idea
+.vscode
+.venv
+
+# Temporary files
+_sim_temp
+temp
+saved_state
+*.old.*
+buf.csv
+
+# Sensitive files
+amap_key.txt
+v2sim/locale/lang.txt
+*.json
+preference.v2simcfg
+recent_projects.txt
+
+# Logs
+*.log
+*results*
+profiling
+perf*
+
+# Cases
+*.veh.xml*
+*.bat
+*.bak
+deploy
+cases/*
+!cases/std_*
+!cases/pwe_*
+
+# Setup files
+build
+dist
+*.egg-info

v2sim-1.3.0/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2024, fmy-xfk
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+    list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+    this list of conditions and the following disclaimer in the documentation
+    and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+    contributors may be used to endorse or promote products derived from
+    this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

v2sim-1.3.0/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: v2sim
+Version: 1.3.0
+Summary: V2Sim: An Open-Source Microscopic V2G Simulation Platform in Urban Power and Transportation Network
+Project-URL: Homepage, https://github.com/fmy-xfk/v2sim
+Project-URL: Documentation, https://github.com/fmy-xfk/v2sim/wiki
+Project-URL: Repository, https://github.com/fmy-xfk/v2sim.git
+Project-URL: Issues, https://github.com/fmy-xfk/v2sim/issues
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Requires-Python: >=3.8
+Requires-Dist: feasytools>=0.1.4
+Requires-Dist: fpowerkit>=0.3.4
+Requires-Dist: libsumo
+Requires-Dist: matplotlib
+Requires-Dist: numba
+Requires-Dist: numpy
+Requires-Dist: pyproj
+Requires-Dist: requests
+Requires-Dist: scikit-learn
+Provides-Extra: v2g
+Requires-Dist: cvxpy; extra == 'v2g'
+Requires-Dist: ecos; extra == 'v2g'
+Description-Content-Type: text/markdown
+
+# V2Sim Family
+
+> Open-Source V2G Simulation Platform in Urban Power and Transportation Network
+
+**Documents:** http://v2sim.heslab.wiki (Backup links: [HTTPS Link](https://hesl-seu.github.io/v2sim-wiki) | [CN Mirror 中文镜像](https://v2sim.myfrank.cn/#/zh_hans/))
+
+V2Sim family includes several open-source software for coupled urban power and transportation network. They are different in the transportation simulation part.
+
++ **V2Sim**: Use SUMO for **MICROSCOPIC** traffic simulation. It could identify the microscopic motion of a single vehicle, including its lane, speed, accerlation, etc. This version is suitable if your research concerns the implication of delicate motion of EVs on power grid. (Please scroll down to read instructions.)
+
++ **V2Sim-UX**: Use uxsim for **MESOCOPIC** traffic simulation. It runs very fast with free-threading Python (3.14+). This version is suitable if your research need fast iterations and focus on the overall implication of the traffic flow. (Link: [V2Sim-UX](https://github.com/hesl-seu/v2sim/tree/uxsim))
+
+If you are using V2Sim family, please cite the paper:
+```
+@ARTICLE{10970754,
+  author={Qian, Tao and Fang, Mingyu and Hu, Qinran and Shao, Chengcheng and Zheng, Junyi},
+  journal={IEEE Transactions on Smart Grid}, 
+  title={V2Sim: An Open-Source Microscopic V2G Simulation Platform in Urban Power and Transportation Network}, 
+  year={2025},
+  volume={16},
+  number={4},
+  pages={3167-3178},
+  keywords={Vehicle-to-grid;Partial discharges;Microscopy;Batteries;Planning;Discharges (electric);Optimization;Vehicle dynamics;Transportation;Roads;EV charging load simulation;microscopic EV behavior;vehicle-to-grid;charging station fault sensing},
+  doi={10.1109/TSG.2025.3560976}}
+```
+Paper link for the microscopic version: https://ieeexplore.ieee.org/document/10970754
+
+## V2Sim: The Microscopic Version
+
+V2Sim is a microscopic V2G simulation platform in urban power and transportation network. It is open-source under BSD license. 
+
++ **Note**: Current code of V2Sim is ahead of the paper described. The exact older code used in the paper is [here](https://github.com/fmy-xfk/v2sim/commit/940ebd5d988f53fde90f4d83d107f136334952f9). The code used in [arXiv](https://arxiv.org/abs/2412.09808) is the initial commit.
+
++ **Note 2**: Code of PDN part is not included in the repository, it is stored in another repository: [FPowerKit](https://gitee.com/fmy_xfk/fpowerkit).
+
+## Quick start
+This package has been uploaded to PyPI. It can be installed by:
+```
+pip install v2sim
+```
+
+Then, input the following command to open the GUI:
+```
+v2sim-gui
+```
+
+Visit our documents to see the quick start guide!
+Link: https://hesl-seu.github.io/v2sim-wiki/#/v2sim/quick-start (English)

v2sim-1.3.0/README.md

@@ -0,0 +1,48 @@
+# V2Sim Family
+
+> Open-Source V2G Simulation Platform in Urban Power and Transportation Network
+
+**Documents:** http://v2sim.heslab.wiki (Backup links: [HTTPS Link](https://hesl-seu.github.io/v2sim-wiki) | [CN Mirror 中文镜像](https://v2sim.myfrank.cn/#/zh_hans/))
+
+V2Sim family includes several open-source software for coupled urban power and transportation network. They are different in the transportation simulation part.
+
++ **V2Sim**: Use SUMO for **MICROSCOPIC** traffic simulation. It could identify the microscopic motion of a single vehicle, including its lane, speed, accerlation, etc. This version is suitable if your research concerns the implication of delicate motion of EVs on power grid. (Please scroll down to read instructions.)
+
++ **V2Sim-UX**: Use uxsim for **MESOCOPIC** traffic simulation. It runs very fast with free-threading Python (3.14+). This version is suitable if your research need fast iterations and focus on the overall implication of the traffic flow. (Link: [V2Sim-UX](https://github.com/hesl-seu/v2sim/tree/uxsim))
+
+If you are using V2Sim family, please cite the paper:
+```
+@ARTICLE{10970754,
+  author={Qian, Tao and Fang, Mingyu and Hu, Qinran and Shao, Chengcheng and Zheng, Junyi},
+  journal={IEEE Transactions on Smart Grid}, 
+  title={V2Sim: An Open-Source Microscopic V2G Simulation Platform in Urban Power and Transportation Network}, 
+  year={2025},
+  volume={16},
+  number={4},
+  pages={3167-3178},
+  keywords={Vehicle-to-grid;Partial discharges;Microscopy;Batteries;Planning;Discharges (electric);Optimization;Vehicle dynamics;Transportation;Roads;EV charging load simulation;microscopic EV behavior;vehicle-to-grid;charging station fault sensing},
+  doi={10.1109/TSG.2025.3560976}}
+```
+Paper link for the microscopic version: https://ieeexplore.ieee.org/document/10970754
+
+## V2Sim: The Microscopic Version
+
+V2Sim is a microscopic V2G simulation platform in urban power and transportation network. It is open-source under BSD license. 
+
++ **Note**: Current code of V2Sim is ahead of the paper described. The exact older code used in the paper is [here](https://github.com/fmy-xfk/v2sim/commit/940ebd5d988f53fde90f4d83d107f136334952f9). The code used in [arXiv](https://arxiv.org/abs/2412.09808) is the initial commit.
+
++ **Note 2**: Code of PDN part is not included in the repository, it is stored in another repository: [FPowerKit](https://gitee.com/fmy_xfk/fpowerkit).
+
+## Quick start
+This package has been uploaded to PyPI. It can be installed by:
+```
+pip install v2sim
+```
+
+Then, input the following command to open the GUI:
+```
+v2sim-gui
+```
+
+Visit our documents to see the quick start guide!
+Link: https://hesl-seu.github.io/v2sim-wiki/#/v2sim/quick-start (English)

v2sim-1.3.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = [ "hatchling",]
+build-backend = "hatchling.build"
+
+[project]
+name = "v2sim"
+version = "1.3.0"
+dependencies = [ "libsumo", "numpy", "matplotlib", "feasytools>=0.1.4", "fpowerkit>=0.3.4", "pyproj", "requests", "scikit-learn", "numba",]
+requires-python = ">= 3.8"
+license = "BSD-3-Clause"
+description = "V2Sim: An Open-Source Microscopic V2G Simulation Platform in Urban Power and Transportation Network"
+
+[project.readme]
+file = "README.md"
+content-type = "text/markdown"
+
+[project.optional-dependencies]
+v2g = [ "ecos", "cvxpy",]
+
+[project.scripts]
+v2sim-gui = "v2sim.tools.gui_main:main"
+v2sim = "v2sim.tools.sim_single:work"
+v2sim-para = "v2sim.tools.sim_para:main"
+v2sim-advplot = "v2sim.tools.cmd_advplot:main"
+v2sim-convert = "v2sim.tools.cmd_convert:main"
+v2sim-csquery = "v2sim.tools.cmd_csquery:main"
+v2sim-gen-cs = "v2sim.tools.cmd_gen_cs:main"
+v2sim-gen-trip = "v2sim.tools.cmd_gen_trip:main"
+v2sim-plot = "v2sim.tools.cmd_plot:main"
+v2sim-osm = "v2sim.tools.gui_osm:entry"
+
+[project.urls]
+Homepage = "https://github.com/fmy-xfk/v2sim"
+Documentation = "https://github.com/fmy-xfk/v2sim/wiki"
+Repository = "https://github.com/fmy-xfk/v2sim.git"
+Issues = "https://github.com/fmy-xfk/v2sim/issues"
+
+[tool.hatch.build]
+include = [ "v2sim/*",]

v2sim-1.3.0/v2sim/__init__.py

@@ -0,0 +1,21 @@
+from .locale import *
+from .traffic import *
+from .trafficgen import *
+from .plotkit import *
+from .plugins import *
+from .statistics import *
+from .sim_core import (
+    load_external_components,
+    get_sim_params,
+    simulate_multi,
+    simulate_single,
+    V2SimInstance,
+    MsgPack,
+    PLUGINS_FILE,
+    RESULTS_FOLDER,
+    TRIP_EVENT_LOG,
+    SIM_INFO_LOG,
+    PLUGINS_DIR,
+)
+
+__version__ = "1.3.0"

v2sim-1.3.0/v2sim/gui/cmpbox/__init__.py

@@ -0,0 +1,152 @@
+from v2sim.gui.com_no_vx import *
+from v2sim.gui.langhelper import *
+
+import os
+from PIL import Image, ImageTk
+
+
+_ = LangLib.Load(__file__)
+
+
+class CmpBox(Tk):
+    def __init__(self):
+        super().__init__()
+
+        self.title(_("TITLE"))
+        self.geometry("1024x768")
+        self.bind("<Configure>", self.on_resize)
+
+        self.folder1 = None
+        self.folder2 = None
+        self.original_image1 = None
+        self.original_image2 = None
+        self.folder_buf = "./results"
+
+        self.create_widgets()
+
+    def create_widgets(self):
+        self.menu = Menu(self)
+        self.config(menu=self.menu)
+        self.filemenu = Menu(self.menu, tearoff=0)
+        self.filemenu.add_command(label=_("OPEN_FOLDER1"), command=self.open_folder1)
+        self.filemenu.add_command(label=_("OPEN_FOLDER2"), command=self.open_folder2)
+        self.filemenu.add_separator()
+        self.filemenu.add_command(label=_("EXIT"), command=self.destroy)
+        self.menu.add_cascade(label=_("FILE"), menu=self.filemenu)
+        add_lang_menu(self.menu)
+
+        self.sidebar = Frame(self)
+        self.sidebar.pack(side=LEFT, fill=Y)
+
+        self.folder1_button = Button(self.sidebar, text=_("OPEN_FOLDER1"), command=self.open_folder1)
+        self.folder1_button.pack(pady=10)
+
+        self.folder2_button = Button(self.sidebar, text=_("OPEN_FOLDER2"), command=self.open_folder2)
+        self.folder2_button.pack(pady=10)
+
+        self.folder1_label = Label(self.sidebar, text=_("LB_FOLDER1").format(_("TO_BE_SELECTED")))
+        self.folder1_label.pack(pady=10)
+
+        self.folder2_label = Label(self.sidebar, text=_("LB_FOLDER2").format(_("TO_BE_SELECTED")))
+        self.folder2_label.pack(pady=10)
+
+        self.file_listbox = Listbox(self.sidebar)
+        self.file_listbox.pack(fill=BOTH, expand=True, pady=10)
+        self.file_listbox.bind("<<ListboxSelect>>", self.on_file_select)
+
+        self.image_frame = Frame(self)
+        self.image_frame.pack(side=RIGHT, fill=X, expand=True)
+
+        self.image1_label = Label(self.image_frame)
+        self.image1_label.pack(side=TOP, padx=10, pady=10)
+
+        self.image2_label = Label(self.image_frame)
+        self.image2_label.pack(side=TOP, padx=10, pady=10)
+
+    def open_folder1(self):
+        new_folder = filedialog.askdirectory(initialdir=self.folder_buf, title=_("AD_TITLE1"))
+        if new_folder:
+            folder_fig = os.path.join(new_folder, "figures")
+            if os.path.exists(folder_fig):
+                self.folder1 = folder_fig
+                self.folder1_label.config(text=_("LB_FOLDER1").format(os.path.basename(new_folder)))
+                self.update_file_list()
+                self.folder_buf = str(Path(new_folder).parent)
+            else:
+                MB.showerror(_("ERROR"), _("NO_FIG"))
+
+    def open_folder2(self):
+        new_folder = filedialog.askdirectory(initialdir=self.folder_buf, title=_("AD_TITLE2"))
+        if new_folder:
+            folder_fig = os.path.join(new_folder, "figures")
+            if os.path.exists(folder_fig):
+                self.folder2 = folder_fig
+                self.folder2_label.config(text=_("LB_FOLDER2").format(os.path.basename(new_folder)))
+                self.update_file_list()
+                self.folder_buf = str(Path(new_folder).parent)
+            else:
+                MB.showerror(_("ERROR"), _("NO_FIG"))
+
+    def update_file_list(self):
+        self.file_listbox.delete(0, END)
+        if self.folder1 and self.folder2:
+            files1 = set(os.listdir(self.folder1))
+            files2 = set(os.listdir(self.folder2))
+            common_files = files1.union(files2)
+            for file in sorted(common_files):
+                if file.lower().endswith(('png', 'jpg', 'jpeg', 'gif')):  # 只列出图片文件
+                    self.file_listbox.insert(END, file)
+
+    def on_file_select(self, event):
+        selected_index = self.file_listbox.curselection()
+        if selected_index:
+            file_name = self.file_listbox.get(selected_index)
+            self.display_images(file_name)
+
+    def resize(self):
+        sz = (self.winfo_width() - 200, self.winfo_height() // 2 - 20)
+        if self.original_image1 is not None:
+            resized_image1 = self.original_image1.copy()
+            resized_image1.thumbnail(sz)
+            image1 = ImageTk.PhotoImage(resized_image1)
+
+            self.image1_label.config(image=image1,text="")
+            self.image1 = image1
+        else:
+            self.image1_label.config(image='',text=_("NO_IMAGE"))
+            self.image1 = None
+
+        if self.original_image2 is not None:
+            resized_image2 = self.original_image2.copy()
+            resized_image2.thumbnail(sz)
+            image2 = ImageTk.PhotoImage(resized_image2)
+
+            self.image2_label.config(image=image2,text="")
+            self.image2 = image2
+        else:
+            self.image2_label.config(image='',text=_("NO_IMAGE"))
+            self.image2 = None
+
+
+    def on_resize(self, event):
+        self.resize()
+        
+    def display_images(self, file_name:str):
+        if self.folder1 is None: return
+        img1_path = os.path.join(self.folder1, file_name)
+        if self.folder2 is None: return
+        img2_path = os.path.join(self.folder2, file_name)
+        
+        try:
+            if os.path.exists(img1_path):
+                self.original_image1 = Image.open(img1_path)
+            else:
+                self.original_image1 = None
+            if os.path.exists(img2_path):
+                self.original_image2 = Image.open(img2_path)
+            else:
+                self.original_image2 = None
+        except Exception as e:
+            MB.showerror(_("ERROR"), _("LOAD_FAILED").format(str(e)))
+        
+        self.resize()

v2sim-1.3.0/v2sim/gui/cmpbox/_lang/en_US.lang

@@ -0,0 +1,14 @@
+TITLE=Case comparer
+ERROR=Error
+OPEN_FOLDER1=Open folder 1
+OPEN_FOLDER2=Open folder 2
+TO_BE_SELECTED=(To be selected)
+LB_FOLDER1=Folder 1: {}
+LB_FOLDER2=Folder 2: {}
+AD_TITLE1=Select folder 1
+AD_TITLE2=Select folder 2
+NO_FIG=No 'figures' folder in the selected folder! Please plot the data with gui_viewer.py first!
+LOAD_FAILED=Cannot load image: {}
+NO_IMAGE=(No image)
+EXIT=Exit
+FILE=File

v2sim-1.3.0/v2sim/gui/cmpbox/_lang/zh_CN.lang

@@ -0,0 +1,14 @@
+TITLE=案例比较器
+ERROR=错误
+OPEN_FOLDER1=打开文件夹1
+OPEN_FOLDER2=打开文件夹2
+TO_BE_SELECTED=未选择
+LB_FOLDER1=文件夹1: {}
+LB_FOLDER2=文件夹2: {}
+AD_TITLE1=选择文件夹1
+AD_TITLE2=选择文件夹2
+NO_FIG=所选文件夹中没有figures文件夹! 请先使用gui_viewer.py画图!
+LOAD_FAILED=无法加载图片: {}
+NO_IMAGE=无图像
+EXIT=退出
+FILE=文件

v2sim-1.3.0/v2sim/gui/com_no_vx.py

@@ -0,0 +1,33 @@
+# Load Path
+from pathlib import Path
+
+# Load Event Queue
+from .evtq import EventQueue
+
+# Load Language Library
+from feasytools import LangLib, LangConfig
+LangConfig.SetAppName("v2sim")
+ 
+# High DPI awareness for Windows
+import platform
+if platform.system() == "Windows":
+    import ctypes
+    ctypes.windll.shcore.SetProcessDpiAwareness(1)
+
+# Load Tk controls
+from tkinter import (
+    Toplevel, messagebox as MB, BooleanVar, StringVar, IntVar, Canvas, Event, Tk, Menu, filedialog, Text, Listbox, PhotoImage, Widget,
+    NO, YES, NORMAL, DISABLED, END, BOTH, X, Y, LEFT, RIGHT, TOP, BOTTOM, W, E
+)
+from tkinter.ttk import Treeview, Button, LabelFrame, Checkbutton, Combobox, Frame, Label, Entry, Spinbox, Scrollbar, Radiobutton, Notebook, OptionMenu
+
+# Load Type Hints
+from typing import Dict, List, Set, Tuple, Any, Union, Optional, Iterable, Callable, Literal
+
+# Set exports
+__all__ = [
+    "LangLib", "LangConfig", "EventQueue", "Path", "Dict", "List", "Set", "Tuple", "Any", "Union", "Optional", "Iterable", "Callable", "Literal",
+    "Toplevel", "MB", "BooleanVar", "StringVar", "IntVar", "Canvas", "Event", "Tk", "Menu", "filedialog", "Text", "Listbox", "PhotoImage", "Widget",
+    "NO", "YES", "NORMAL", "DISABLED", "END", "X", "Y", "BOTH", "LEFT", "RIGHT", "TOP", "BOTTOM", "W", "E", "platform",
+    "Treeview", "Button", "LabelFrame", "Checkbutton", "Combobox", "Frame", "Label", "Entry", "Spinbox", "Scrollbar", "Radiobutton", "Notebook", "OptionMenu",
+]

v2sim-1.3.0/v2sim/gui/common.py

@@ -0,0 +1,5 @@
+from .com_no_vx import *
+
+# Load V2Sim common items
+from v2sim import ConfigItem, EditMode, ConfigItemDict, ConfigDict, CONFIG_DIR
+CONFIG_DIR.mkdir(parents=True, exist_ok=True)

v2sim-1.3.0/v2sim/gui/evtq.py

@@ -0,0 +1,100 @@
+import threading
+import time
+import traceback
+from collections import deque
+from queue import Queue
+from typing import Callable, Dict, Tuple
+
+class EventQueue:
+    def __init__(self, parent, maxsize:int = 0, interval_ms:int = 100, max_proc_ms:int = 90):
+        self._Q = Queue(maxsize)
+        self._parent = parent
+        self._evt:Dict[str, Callable] = {}
+        self._interval_ms = interval_ms
+        self._max_proc_ns = max_proc_ms * 1e6  # Convert to nanoseconds
+        self._delegates:deque[Tuple[Callable, Tuple, Dict]] = deque()
+        self.do()  # Start processing events immediately
+    
+    def do(self):
+        """Process all events in the queue."""
+        prod_next = True
+        st = time.time_ns()
+
+        cnt = 0
+        while self._delegates:
+            func, args, kwargs = self._delegates.popleft()
+            try:
+                func(*args, **kwargs)
+            except Exception as e:
+                print(f"Error in delegate function '{func.__name__}': {e}")
+        
+        cnt = 0
+        while not self._Q.empty() and (time.time_ns() - st < self._max_proc_ns) and cnt < 100:
+            name, args, kwargs = self._Q.get()
+            if name == "__quit__":
+                self._Q.task_done()
+                prod_next = False
+                break
+            if name in self._evt and self._evt[name] is not None:
+                try:
+                    self._evt[name](*args, **kwargs)
+                except Exception as e:
+                    traceback.print_exc()
+                    print(f"Error processing event '{name}': {e}")
+            else:
+                print(f"Event '{name}' is not registered.")
+            self._Q.task_done()
+            self._parent.update()  # Ensure the GUI updates after processing each event
+            cnt += 1
+        if prod_next:
+            intv = self._interval_ms
+            if cnt >= 100:
+                intv = max(intv // 10, 1)
+            self._parent.after(intv, self.do)
+
+    def register(self, name:str, callback:Callable):
+        """Register an event handler for a specific event name."""
+        if name in self._evt:
+            raise ValueError(f"Event '{name}' is already registered.")
+        self._evt[name] = callback
+    
+    def setcallback(self, name:str, callback:Callable):
+        """Set or update the callback for an event."""
+        if name not in self._evt:
+            raise ValueError(f"Event '{name}' is not registered.")
+        self._evt[name] = callback
+    
+    def trigger(self, name:str, *args, **kwargs):
+        """Trigger an event by its name with optional arguments."""
+        if name not in self._evt:
+            raise ValueError(f"Event '{name}' is not registered.")
+        self._Q.put((name, args, kwargs))
+    
+    def submit(self, name:str, func:Callable, *args, **kwargs):
+        """Run a function asychoronously and submit the results to trigger an event."""
+        def _run_and_trigger(name, func, *args, **kwargs):
+            try:
+                result = func(*args, **kwargs)
+                if result is None:
+                    result = ()
+                elif not isinstance(result, tuple):
+                    result = (result,)
+                self.trigger(name, *result)
+            except Exception as e:
+                traceback.print_exc()
+                print(f"Error in submitting function '{func.__name__}' for event '{name}': {e}")
+        threading.Thread(target=_run_and_trigger, args=(name, func, *args), kwargs=kwargs).start()
+    
+    def asyncrun(self, func:Callable, *args, **kwargs):
+        """Run a no-return function asynchronously"""
+        def _run(func, *args, **kwargs):
+            try:
+                func(*args, **kwargs)
+            except Exception as e:
+                traceback.print_exc()
+                print(f"Error in delegating function '{func.__name__}': {e}")
+        threading.Thread(target=_run, args=(func, *args), kwargs=kwargs).start()
+
+    def delegate(self, func:Callable, *args, **kwargs):
+        """Run a no-return function on the main thread."""
+        self._delegates.append((func, args, kwargs))

v2sim-1.3.0/v2sim/gui/langhelper.py

@@ -0,0 +1,34 @@
+from v2sim.gui.com_no_vx import *
+
+_ = LangLib(["zh_CN", "en_US"])
+_.SetLangLib("zh_CN",
+    MB_INFO = "信息",
+    MENU_LANG = "语言",
+    MENU_LANG_AUTO = "(自动检测)",
+    LANG_RESTART = "语言已更改，请重启程序以应用更改。",
+)
+
+_.SetLangLib("en_US",
+    MB_INFO = "Information",
+    MENU_LANG = "Language",
+    MENU_LANG_AUTO = "(Auto Detect)",
+    LANG_RESTART = "Language has been changed. Please restart the application to apply the changes.",
+)
+
+def setLang(lang_code:str):
+    title = _["MB_INFO"]
+    info = _["LANG_RESTART"]
+    def _f():
+        nonlocal lang_code, title, info
+        LangConfig.SetLangCode(lang_code)
+        MB.showinfo(title, info)
+    return _f
+
+def add_lang_menu(parent: Menu):
+    menuLang = Menu(parent, tearoff=False)
+    parent.add_cascade(label=_["MENU_LANG"], menu=menuLang)
+    menuLang.add_command(label=_["MENU_LANG_AUTO"], command=setLang("<auto>"))
+    menuLang.add_command(label="English (United States)", command=setLang("en_US"))
+    menuLang.add_command(label="中文 (简体)", command=setLang("zh_CN"))
+
+__all__ = ["add_lang_menu"]