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.0

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.0
File	Size	Uploaded
esapp-0.2.0.tar.gz	975.1 kB	Aug 31, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for esapp 0.2.0
File	Interpreter	ABI	Platform	Reset
esapp-0.2.0-py3-none-any.whl 970.3 kB Aug 31, 2026	Python 3	none	any	Details

Total release size: 1.9 MB

Release files / esapp-0.2.0.tar.gz

Download URL	esapp-0.2.0.tar.gz
Size	975.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`38315a11838e3417723fd5ecf5157b22c80f791786545f70397ec996d8a0d28b`
BLAKE2b-256 checksum How to use checksums	`7230f8b3f0cc57b8183f465bdd8741e5a9e4c5ea5e8c1564f4520e045671c4ac`
Upload date	Aug 31, 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/3f8de06f3fbac862f51b71fa808e6150e179e5be

Workflow

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

Artifact

Subject: esapp-0.2.0.tar.gz
SHA-256 checksum: 38315a11838e3417723fd5ecf5157b22c80f791786545f70397ec996d8a0d28b Verifying attestations

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

Download URL	esapp-0.2.0-py3-none-any.whl
Size	970.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`799270de94116b2cbcfe61644b5183ef5c0a0071dad07fdfa2e79d018adf7cd9`
BLAKE2b-256 checksum How to use checksums	`fbca945caca50f31ecbef8165f2e2fd61e40283c142f8a71a91eb5b1bb61dcfe`
Upload date	Aug 31, 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/3f8de06f3fbac862f51b71fa808e6150e179e5be

Workflow

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

Artifact

Subject: esapp-0.2.0-py3-none-any.whl
SHA-256 checksum: 799270de94116b2cbcfe61644b5183ef5c0a0071dad07fdfa2e79d018adf7cd9 Verifying attestations