PESLite

Documentation · PyPI · Releases

PESLite is an open-source, lightweight, multirate, and extensible power electronics simulator in Python. It is designed for time-domain studies of power-electronic converters and converter-based systems, combining switching and averaged models, digital control timing, event-driven operation, and flexible numerical integration across multiple time scales in readable YAML simulation files and a Python API.

Features

• Converter networks with buses, branches, grid sources, R-L loads and multiple independently named converter units.
• Grid-following and grid-forming controllers assembled from typed control loops.
• Per-converter switching, PWM-period-averaged and ideal continuously averaged bridge models.
• ADC sampling windows, controller interrupts, computation time, PWM shadow/active registers, startup sequencing and unit-owned protection.
• Fixed-step, adaptive and multirate integration with exact event boundaries.
• Connect, disconnect and validated parameter-change events, plus continuation from saved states.
• Streamed CSV output, energy accounting, port-Hamiltonian structure reporting and a lazy Python result API.
• Optional IEEE/LaTeX-style vector PDF plots from completed CSV results.
• Optional project-local extensibility through a PESaddons/ directory beside a simulation file, plus registration APIs for custom control loops, circuit elements, events and solvers.
• Export as a parameter-specialized, standalone C++17 simulator with no third-party C++ runtime dependencies.

Plant quantities use SI units. Controller quantities ending in _pu use each converter's own per-unit base.

Install

pip install peslite

Use pip install "peslite[all]" to include every optional runtime add-on.

PESLite requires Python 3.10 or newer.

Quick start

Run a bundled case:

peslite gfl-example

Run a simulation file and override any parameter by dotted path:

peslite case.pes --set simulation.t_end=1.0 --out output/test

Results are written to output/<name>/. Bridge/solver presets are available through --switching, --pwm-averaging and --averaging; use peslite --help for the full interface.

The same workflow is available from Python:

import peslite

params = peslite.load("case.pes")
result = peslite.Simulation(params).run()

print(result.summary)
print(result.final_states())

C++ export

Select the parameters that should remain variable in the compiled simulator, or use all:

peslite-convert case.pes all
c++ -O3 -DNDEBUG -std=c++17 export/case/peslite.cpp -o export/case/peslite

The generated executable uses the same parameter-override and output conventions as PESLite and writes the same result structure. See the C++ Export guide for compilation, runtime configuration and current backend limits.

Documentation

• Getting Started
• Simulation Files
• Converter and Bridge Models
• Control and PWM Timing
• Solvers
• Multirate Simulation
• Events and Restart
• Output and Results
• Extending PESLite
• Architecture
• CLI Reference

The Wiki documents the current main branch. Releases and the changelog record versioned changes.

Development

python -m pytest

License

GNU Affero General Public License v3.0 only (AGPL-3.0-only). See LICENSE.