Skip to main content
License Python 3.9+ Documentation Coverage 98%

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

esapp-0.1.5.tar.gz (1.0 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

esapp-0.1.5-py3-none-any.whl (1.1 MB view details)

Uploaded Python 3

File details

Details for the file esapp-0.1.5.tar.gz.

File metadata

  • Download URL: esapp-0.1.5.tar.gz
  • Upload date:
  • Size: 1.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for esapp-0.1.5.tar.gz
Algorithm Hash digest
SHA256 c306ccfa74d3a3ffff73db9b51e5655b4af759cc373980210f5a7820a4b05620
MD5 f7a5b99a8e094c144818441d04381186
BLAKE2b-256 1acd24a13eabe879e1c11baaf391146550a12ba7b538fdb1ca63071d8c6d5780

See more details on using hashes here.

Provenance

The following attestation bundles were made for esapp-0.1.5.tar.gz:

Publisher: python-publish.yml on lukelowry/ESApp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file esapp-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: esapp-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 1.1 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for esapp-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 34e9807699c660c395e4299e24e50cce3ff7986c1288658be3a192bc5c7de101
MD5 83d926f0dedc0b9eae7b894fa87e3bbe
BLAKE2b-256 cc901d51035262606fc0e13d3c9e7da36e1151c33ab052743bd06fbf9a9fd07a

See more details on using hashes here.

Provenance

The following attestation bundles were made for esapp-0.1.5-py3-none-any.whl:

Publisher: python-publish.yml on lukelowry/ESApp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page