Skip to main content
https://img.shields.io/pypi/v/esa.svg https://img.shields.io/pypi/pyversions/esa.svg https://img.shields.io/discord/1114563747651006524 https://joss.theoj.org/papers/10.21105/joss.02289/status.svg https://img.shields.io/pypi/l/esa.svg https://pepy.tech/badge/esa/month https://img.shields.io/badge/coverage-100%25-brightgreen

Easy SimAuto (ESA) is an easy-to-use Power System Analysis Automation Platform atop PowerWorld’s Simulator Automation Server (SimAuto). ESA wraps all PowerWorld SimAuto functions, supports Auxiliary scripts, provides helper functions to further simplify working with SimAuto and also turbocharges with native implementation of SOTA algorithms. Wherever possible, data is returned as Pandas DataFrames, making analysis a breeze. ESA is well tested and fully documented.

Documentation

For quick-start directions, installation instructions, API reference, examples, and more, please check out ESA’s documentation.

If you have your own copy of the ESA repository, you can also view the documentation locally by navigating to the directory docs/html and opening index.html with your web browser.

If you want to use ESA or SimAuto from julia, definitely check EasySimauto.jl for a julia wrapper of ESA.

Citation

If you use ESA in any of your work, please use the citation below.

@article{ESA,
  doi = {10.21105/joss.02289},
  url = {https://doi.org/10.21105/joss.02289},
  year = {2020},
  publisher = {The Open Journal},
  volume = {5},
  number = {50},
  pages = {2289},
  author = {Brandon L. Thayer and Zeyu Mao and Yijing Liu and Katherine Davis and Thomas J. Overbye},
  title = {Easy SimAuto (ESA): A Python Package that Simplifies Interacting with PowerWorld Simulator},
  journal = {Journal of Open Source Software}
}

Installation

Please refer to ESA’s documentation for full, detailed installation directions. In many cases, ESA can simply be installed by:

python -m pip install esa

Simulator Compatibility

Currently ESA supports PW Simulator V17, V18, V19, V20, V21, V22 and V23.

Testing Coverage

The ESA team works hard to ensure ESA is well tested, and we strive for 100% testing coverage (sometimes we cannot due to lack of specific add-ons). The table below shows the most up-to-date testing coverage data for ESA, using coverage.

ESA’s testing coverage as of 2023-05-31 (Git commit: 7180cc9)

Name

Num. Statements

Missing Lines

Covered Lines

Percent Coverage

esa/__init__.py

2

0

2

100

esa/saw.py

1206

2

1204

99.8342

License

Apache License 2.0

Contributing

We welcome contributions! Please read contributing.md.

Release files for esa 1.3.5

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

Source distribution (sdist)

Source distribution for esa 1.3.5
File Size Uploaded
esa-1.3.5.tar.gz 308.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for esa 1.3.5
File Interpreter ABI Platform
esa-1.3.5-py3-none-any.whl Python 3 none any Details

Total release size: 613.3 kB

Release files / esa-1.3.5.tar.gz

Download URL esa-1.3.5.tar.gz
Size 308.0 kB
Tags Source
SHA-256 checksum
How to use checksums
82d8c0c91a22e53d01419fea40c555d8a74fb2faeea647026991fa25aa89b2d6
BLAKE2b-256 checksum
How to use checksums
217597af5f9a0f20ecc4d5f8b781b21b510089fd5d18df0d513ffdb27b934b53
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.6

Release files / esa-1.3.5-py3-none-any.whl

Download URL esa-1.3.5-py3-none-any.whl
Size 305.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
09a18d5fcbe6a6e046539c3d8bcf13e5117cb7b8a2cc5e562eeb7e6c889d01c0
BLAKE2b-256 checksum
How to use checksums
6a6809fc467a1a52d974c0b4b4b7e09ce0285c0263c8a135d859666df3c58f09
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.6

Release history Release notifications | RSS feed

This release

1.3.5 This release

2 release files

1.3.4

2 release files

1.3.3

2 release files

1.3.2

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.9

2 release files

1.2.8

2 release files

1.2.7

2 release files

1.2.6

2 release files

1.2.5

2 release files

1.2.4

2 release files

1.2.3

2 release files

1.2.2

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.9

2 release files

1.0.8

2 release files

1.0.7

2 release files

1.0.6

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.6.4

2 release files

0.6.3

2 release files

0.6.2

2 release files

0.6.1

2 release files

0.5.3

2 release files

0.5.2

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page