Easy SimAuto (ESA)
==================
.. image:: https://img.shields.io/pypi/v/esa.svg
:target: https://pypi.org/project/esa/
.. image:: https://img.shields.io/pypi/pyversions/esa.svg
:target: https://pypi.org/project/esa/
.. image:: https://img.shields.io/discord/1114563747651006524
:target: https://discord.gg/V9v8NRCT
.. image:: https://joss.theoj.org/papers/10.21105/joss.02289/status.svg
:target: https://doi.org/10.21105/joss.02289
.. image:: https://img.shields.io/pypi/l/esa.svg
:target: https://github.com/mzy2240/ESA/blob/master/LICENSE
.. image:: https://pepy.tech/badge/esa/month
:target: https://pepy.tech/project/esa
.. image:: https://img.shields.io/badge/coverage-100%25-brightgreen
:target: https://pypi.org/project/esa/
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 <https://github.com/mzy2240/EasySimauto.jl>`__
for a julia wrapper of ESA.
Citation
--------
If you use ESA in any of your work, please use the citation below.
.. code:: latex
@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 <https://mzy2240.github
.io/ESA/html/installation.html>`__ for full, detailed installation
directions. In many cases, ESA can simply be installed by:
.. code:: bat
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
<https://pypi.org/project/coverage/>`__.
.. table:: ESA's testing coverage as of 2023-05-31 (Git commit: 7180cc9)
:widths: auto
:align: left
+-----------------+-------------------+-----------------+-----------------+--------------------+
| 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 <https://www.apache.org/licenses/LICENSE-2.0>`__
Contributing
------------
We welcome contributions! Please read ``contributing.md``.
.. _documentation: https://mzy2240.github.io/ESA/
.. _documented: https://mzy2240.github.io/ESA/
Raw data
{
"_id": null,
"home_page": "https://github.com/mzy2240/ESA",
"name": "esa",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "Python,PowerWorld,PowerWorld Simulator,Simulator,PowerWorld Simulation Automation Server,SimAuto,Automation,Power Systems,Electric Power,Power,Easy SimAuto,ESA,Smart Grid,Numpy,Pandas",
"author": "Zeyu Mao, Brandon Thayer, Yijing Liu",
"author_email": "zeyumao2@tamu.edu, blthayer@tamu.edu, yiji21@tamu.edu",
"download_url": "https://files.pythonhosted.org/packages/21/75/97af5f9a0f20ecc4d5f8b781b21b510089fd5d18df0d513ffdb27b934b53/esa-1.3.5.tar.gz",
"platform": null,
"description": "Easy SimAuto (ESA)\r\n==================\r\n.. image:: https://img.shields.io/pypi/v/esa.svg\r\n :target: https://pypi.org/project/esa/\r\n.. image:: https://img.shields.io/pypi/pyversions/esa.svg\r\n :target: https://pypi.org/project/esa/\r\n.. image:: https://img.shields.io/discord/1114563747651006524\r\n :target: https://discord.gg/V9v8NRCT\r\n.. image:: https://joss.theoj.org/papers/10.21105/joss.02289/status.svg\r\n :target: https://doi.org/10.21105/joss.02289\r\n.. image:: https://img.shields.io/pypi/l/esa.svg\r\n :target: https://github.com/mzy2240/ESA/blob/master/LICENSE\r\n.. image:: https://pepy.tech/badge/esa/month\r\n :target: https://pepy.tech/project/esa\r\n.. image:: https://img.shields.io/badge/coverage-100%25-brightgreen\r\n :target: https://pypi.org/project/esa/\r\n\r\n\r\nEasy SimAuto (ESA) is an easy-to-use Power System Analysis Automation\r\nPlatform atop PowerWorld's Simulator Automation Server (SimAuto).\r\nESA wraps all PowerWorld SimAuto functions, supports Auxiliary scripts,\r\nprovides helper functions to further simplify working with SimAuto and\r\nalso turbocharges with native implementation of SOTA algorithms. Wherever\r\npossible, data is returned as Pandas DataFrames, making analysis a breeze.\r\nESA is well tested and fully `documented`_.\r\n\r\n`Documentation`_\r\n----------------\r\n\r\nFor quick-start directions, installation instructions, API reference,\r\nexamples, and more, please check out ESA's `documentation`_.\r\n\r\nIf you have your own copy of the ESA repository, you can also view the\r\ndocumentation locally by navigating to the directory ``docs/html`` and\r\nopening ``index.html`` with your web browser.\r\n\r\nIf you want to use ESA or SimAuto from julia, definitely check `EasySimauto.jl <https://github.com/mzy2240/EasySimauto.jl>`__\r\nfor a julia wrapper of ESA.\r\n\r\nCitation\r\n--------\r\n\r\nIf you use ESA in any of your work, please use the citation below.\r\n\r\n.. code:: latex\r\n\r\n @article{ESA,\r\n doi = {10.21105/joss.02289},\r\n url = {https://doi.org/10.21105/joss.02289},\r\n year = {2020},\r\n publisher = {The Open Journal},\r\n volume = {5},\r\n number = {50},\r\n pages = {2289},\r\n author = {Brandon L. Thayer and Zeyu Mao and Yijing Liu and Katherine Davis and Thomas J. Overbye},\r\n title = {Easy SimAuto (ESA): A Python Package that Simplifies Interacting with PowerWorld Simulator},\r\n journal = {Journal of Open Source Software}\r\n }\r\n\r\nInstallation\r\n------------\r\n\r\nPlease refer to ESA's `documentation <https://mzy2240.github\r\n.io/ESA/html/installation.html>`__ for full, detailed installation\r\ndirections. In many cases, ESA can simply be installed by:\r\n\r\n.. code:: bat\r\n\r\n python -m pip install esa\r\n \r\nSimulator Compatibility\r\n-----------------------\r\n\r\nCurrently ESA supports PW Simulator V17, V18, V19, V20, V21, V22 and V23.\r\n\r\n\r\nTesting Coverage\r\n----------------\r\n\r\nThe ESA team works hard to ensure ESA is well tested, and we strive for\r\n100% testing coverage (sometimes we cannot due to lack of specific add-ons). The table below shows the most up-to-date\r\ntesting coverage data for ESA, using `coverage\r\n<https://pypi.org/project/coverage/>`__.\r\n\r\n.. table:: ESA's testing coverage as of 2023-05-31 (Git commit: 7180cc9)\r\n :widths: auto\r\n :align: left\r\n\r\n +-----------------+-------------------+-----------------+-----------------+--------------------+\r\n | Name | Num. Statements | Missing Lines | Covered Lines | Percent Coverage |\r\n +=================+===================+=================+=================+====================+\r\n | esa/__init__.py | 2 | 0 | 2 | 100 |\r\n +-----------------+-------------------+-----------------+-----------------+--------------------+\r\n | esa/saw.py | 1206 | 2 | 1204 | 99.8342 |\r\n +-----------------+-------------------+-----------------+-----------------+--------------------+\r\n\r\nLicense\r\n-------\r\n\r\n`Apache License 2.0 <https://www.apache.org/licenses/LICENSE-2.0>`__\r\n\r\nContributing\r\n------------\r\n\r\nWe welcome contributions! Please read ``contributing.md``.\r\n\r\n.. _documentation: https://mzy2240.github.io/ESA/\r\n.. _documented: https://mzy2240.github.io/ESA/\r\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Easy SimAuto (ESA): An easy-to-use Python connector to PowerWorld Simulator Automation Server (SimAuto).",
"version": "1.3.5",
"project_urls": {
"Homepage": "https://github.com/mzy2240/ESA"
},
"split_keywords": [
"python",
"powerworld",
"powerworld simulator",
"simulator",
"powerworld simulation automation server",
"simauto",
"automation",
"power systems",
"electric power",
"power",
"easy simauto",
"esa",
"smart grid",
"numpy",
"pandas"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6a6809fc467a1a52d974c0b4b4b7e09ce0285c0263c8a135d859666df3c58f09",
"md5": "ba7b04cb0d0d63029ab2a9edb6a69b58",
"sha256": "09a18d5fcbe6a6e046539c3d8bcf13e5117cb7b8a2cc5e562eeb7e6c889d01c0"
},
"downloads": -1,
"filename": "esa-1.3.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ba7b04cb0d0d63029ab2a9edb6a69b58",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 305319,
"upload_time": "2023-06-05T21:18:04",
"upload_time_iso_8601": "2023-06-05T21:18:04.562177Z",
"url": "https://files.pythonhosted.org/packages/6a/68/09fc467a1a52d974c0b4b4b7e09ce0285c0263c8a135d859666df3c58f09/esa-1.3.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "217597af5f9a0f20ecc4d5f8b781b21b510089fd5d18df0d513ffdb27b934b53",
"md5": "c2172571426aa81d53561cfa0b60deeb",
"sha256": "82d8c0c91a22e53d01419fea40c555d8a74fb2faeea647026991fa25aa89b2d6"
},
"downloads": -1,
"filename": "esa-1.3.5.tar.gz",
"has_sig": false,
"md5_digest": "c2172571426aa81d53561cfa0b60deeb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 307973,
"upload_time": "2023-06-05T21:18:07",
"upload_time_iso_8601": "2023-06-05T21:18:07.340600Z",
"url": "https://files.pythonhosted.org/packages/21/75/97af5f9a0f20ecc4d5f8b781b21b510089fd5d18df0d513ffdb27b934b53/esa-1.3.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-05 21:18:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mzy2240",
"github_project": "ESA",
"travis_ci": false,
"coveralls": true,
"github_actions": false,
"lcname": "esa"
}
JSON
