fpowerkit 0.3.4

A PDN solver with multiple solutions.

FPowerKit - A power distribution network calculation component

This is a package designed for power distribution network description and solving. Solvers include Newton method, DistFlow and OpenDSS.

This package is affiliated to V2Sim, an open-aource microscopic V2G simulation platform in urban power and transportation network. If you are using the modified DistFlow model in this package, 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}}

Installation options

If you want to use different features, install with different command:

Feature	Command
Only grid description	pip install fpowerkit
Y matrix & Newton	pip install fpowerkit[newton]
OpenDSS	pip install fpowerkit[dss]
DistFlow	pip install fpowerkit[distflow]
All	pip install fpowerkit[full]

Secondary development on this package requires all features.

Introduction

There are 3 modes for this package to work:

• Optimal power flow (OPF): Use cvxpy to solve the optimal power flow and determine the output of the generators.

• Power flow calculation: Use OpenDSS/Newton-Raphson method to solve the power flow.

• Hybrid: Use OPF to determine the initial value, and then use OpenDSS/Newton-Raphson to perform accurate calculation.

Please visit https://gitee.com/fmy_xfk/fpowerkit to read the detailed introduction and the usage.