esapp

An open-source Python toolkit for power system automation, providing a high-performance wrapper for PowerWorld’s Simulator Automation Server (SimAuto). Transforms complex COM calls into intuitive, Pythonic operations.

Intuitive Indexing – Access grid data with pw[Bus, "BusPUVolt"] syntax
Full SimAuto Coverage – All PowerWorld API functions through modular mixins
Pandas Integration – Every query returns a DataFrame
Pythonic Settings – Solver and GIC options as descriptor attributes (pw.max_iterations = 250)
Convenience Methods – Flows, overloads, PTDF/LODF, snapshot context manager, case summary
Transient Stability – Fluent API with TS field intellisense
Analysis Utilities – Built-in GIC, network topology, and contingency tools

Installation

Requires Windows with PowerWorld Simulator (SimAuto enabled) and Python 3.9+.

pip install esapp

Quick Example

from esapp import PowerWorld
from esapp.components import *

pw = PowerWorld("path/to/case.pwb")

# Read data
bus_data = pw[Bus, ["BusName", "BusPUVolt"]]

# Solve power flow
V = pw.pflow()

# Inspect and modify
violations = pw.violations(v_min=0.95)
pw[Gen, "GenMW"] = 100.0

Documentation

Full tutorials, API reference, and examples at esapp.readthedocs.io.

Testing

pip install .[test]
pytest tests/

Citation

@article{esa2020,
  title={Easy SimAuto (ESA): A Python Package for PowerWorld Simulator Automation},
  author={Mao, Zeyu and Thayer, Brandon and Liu, Yijing and Birchfield, Adam},
  year={2020}
}

Authors

Developed by Luke Lowery and Adam Birchfield at Texas A&M University (Birchfield Research Group). See my personal (research website).

License

Distributed under the Apache License 2.0.

Metadata

Release files for esapp 0.2.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for esapp 0.2.1
File	Size	Uploaded
esapp-0.2.1.tar.gz	977.4 kB	Sep 1, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for esapp 0.2.1
File	Interpreter	ABI	Platform	Reset
esapp-0.2.1-py3-none-any.whl 971.5 kB Sep 1, 2026	Python 3	none	any	Details

Total release size: 1.9 MB

Release files / esapp-0.2.1.tar.gz

Download URL	esapp-0.2.1.tar.gz
Size	977.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`4e4a600263423b469a61f5f5e2bae0043c56d983fea32a2c328eb8dc577f41bc`
BLAKE2b-256 checksum How to use checksums	`52f98484b0af1623a1d7877d9218185bf50462b2ca940337d84d42b53c37d9a7`
Upload date	Sep 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/lukelowry/ESApp
Publishing commit: github.com/lukelowry/ESApp/tree/cf7d7672dbe8f178c777807de78a03c7e4210203

Workflow

Publishing configuration: github.com/lukelowry/ESApp/blob/cf7d7672dbe8f178c777807de78a03c7e4210203/.github/workflows/python-publish.yml
Publishing logs: github.com/lukelowry/ESApp/actions/runs/33479459116/attempts/1

Artifact

Subject: esapp-0.2.1.tar.gz
SHA-256 checksum: 4e4a600263423b469a61f5f5e2bae0043c56d983fea32a2c328eb8dc577f41bc Verifying attestations

Release files / esapp-0.2.1-py3-none-any.whl

Download URL	esapp-0.2.1-py3-none-any.whl
Size	971.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7602f529754a63da67322f3cbbd43dda4cbc039460fc2cbbedffd697767f5f60`
BLAKE2b-256 checksum How to use checksums	`f0a9491ea7d1787e7e0b55c76596193469d1748341b539b4f6041e6bab1e3054`
Upload date	Sep 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/lukelowry/ESApp
Publishing commit: github.com/lukelowry/ESApp/tree/cf7d7672dbe8f178c777807de78a03c7e4210203

Workflow

Publishing configuration: github.com/lukelowry/ESApp/blob/cf7d7672dbe8f178c777807de78a03c7e4210203/.github/workflows/python-publish.yml
Publishing logs: github.com/lukelowry/ESApp/actions/runs/33479459116/attempts/1

Artifact

Subject: esapp-0.2.1-py3-none-any.whl
SHA-256 checksum: 7602f529754a63da67322f3cbbd43dda4cbc039460fc2cbbedffd697767f5f60 Verifying attestations