v2sim 1.3.1

V2Sim: An Open-Source Microscopic V2G Simulation Platform in Urban Power and Transportation Network

V2Sim Family

Open-Source V2G Simulation Platform in Urban Power and Transportation Network

Documents: http://v2sim.heslab.wiki (Backup links: HTTPS Link | CN Mirror 中文镜像)

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)

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. The code used in arXiv is the initial commit.

• Note 2: Code of PDN part is not included in the repository, it is stored in another repository: 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)