PulsimGUI

# PulsimGui **Professional GUI for power electronics simulation with Pulsim.** [](https://github.com/lgili/PulsimGUI/releases/latest) [](https://pypi.org/project/pulsimgui/) [](https://lgili.github.io/PulsimGUI/) [](LICENSE) [](https://www.python.org/) [**Download latest release**](https://github.com/lgili/PulsimGUI/releases/latest) · [**Install from PyPI**](https://pypi.org/project/pulsimgui/) · [**Documentation**](https://lgili.github.io/PulsimGUI/) · [**Report a bug**](https://github.com/lgili/PulsimGUI/issues)

---

PulsimGui is a cross-platform desktop interface for Pulsim, focused on modeling and validating power converter topologies.

Key Features

• Schematic editor with drag-and-drop workflow.
• Component library focused on power electronics.
• Transient simulation with advanced solver controls.
• Advanced backend telemetry for convergence, fallback, and loss/thermal diagnostics.
• Integrated waveform viewer with signal measurements.
• Ready-to-run examples (RC, buck, boost, and more).

Official Documentation

Full documentation is available at:

• https://lgili.github.io/PulsimGUI/

Main content includes:

• Installation and execution
• GUI guides and workflow
• Simulation and backend configuration
• Practical tutorials
• Technical reference for contributors

Installation

1. Release (Recommended)

Use installers from Releases.

2. Install via pip

python3 -m pip install --upgrade pip
python3 -m pip install pulsimgui

Run:

pulsimgui

The pulsimgui package is published to PyPI by the release pipeline (.github/workflows/release.yml) whenever a new tag v* is released.

3. Development setup (source code)

git clone https://github.com/lgili/PulsimGUI.git
cd PulsimGui
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install --upgrade pip
python3 -m pip install -e ".[dev]"
python3 -m pulsimgui

Recommended Backend

For reproducible behavior, use pulsim v0.7.9.

This is required for full advanced electrothermal support in GUI runtime:

• staged thermal networks (single_rc, foster, cauer)
• shared-sink coupling (shared_sink_id, shared_sink_rth, shared_sink_cth)
• datasheet switching-loss surfaces (loss.model=datasheet)

Quick check:

python3 -c "import pulsim; print(pulsim.__version__)"

In the app: Preferences → Simulation → Backend Runtime.

Runtime Telemetry

With modern Pulsim backends, transient runs expose structured diagnostics in SimulationResult.statistics, including solver/backend telemetry and electrothermal summaries:

• linear_solver_telemetry
• backend_telemetry
• fallback_trace
• loss_summary
• thermal_summary
• component_electrothermal

Development

Tests

pytest

Template Smoke Test (Pre-release)

PYTHONPATH=src python3 scripts/smoke_templates.py

Lint

ruff check src tests

Local docs build

python3 -m pip install -r docs/requirements.txt
mkdocs build --strict
mkdocs serve

GitHub Pages (Docs)

Documentation is published through:

• .github/workflows/docs-pages.yml

Automatic deploy runs on main and workflow_dispatch.

Repository setting required: Settings → Pages → Source: GitHub Actions.

Contributing

• Open issues for bug reports and feature requests.
• For PRs, include context, validation steps, and evidence (logs/screenshots).
• Update docs whenever a user workflow or feature changes.

License

MIT — see LICENSE.