========
Overview
========
The py-dss-interface is a Python package that provides a Python interface to the OFFICIAL version of OpenDSS (Open-source Distribution System Simulator) software. OpenDSS is a free, open-source software for simulating and analyzing power distribution systems.
* Free software: MIT license
* Documentation: https://py-dss-interface.readthedocs.io/en/latest/
The current py-dss-interface works only with Windows. The reason is that EPRI provides only Windows versions of OpenDSS. The package will work for Linux when EPRI releases the Linux version of OpenDSS.
The py-dss-interface package allows users to interact with OpenDSS using Python code, which can be particularly useful for automating tasks, performing simulations, and analyzing results. The package provides a range of functionality, including:
* Creating and modifying OpenDSS circuit models
* Running simulations and analyzing results
* Accessing and manipulating data within the circuit model
* Plotting results
The package is available on the Python Package Index (PyPI) and can be installed using pip, the Python package installer. OpenDSS does not have to be installed on the user's system to use the package, as the py-dss-interface provides an OpenDSS version.
Overall, the py-dss-interface is a powerful tool for anyone working with power distribution systems who wants to use Python for simulation and analysis.
Disclaimer
============
This Python Package is purely responsibility of Paulo Radatz and not his employer. Use this package at your own risk.
Installation
============
::
pip install py-dss-interface
Examples
============
You can find several examples of Python scripts at this link: https://github.com/PauloRadatz/py-dss-interface-examples
Thanks
=============
I want to thank Ênio Viana and Rodolfo Pilar Londero for all their contribution to the new version of the tool.
Changelog
=========
2.0.2 (2023-06-04)
------------------
* Tom updated OpenDSS to DDLL built as v9.6.1.2
* Moving away from variant. Capacitor is done. Need other elements
* Tom worked on direct dll with progress bar wired in for daily solution mode
2.0.1 (2023-05-24)
------------------
* Description corrected
2.0.0 (2023-05-24)
------------------
* py-dss-interface version 2 or above does not have backward compatibility with version 1
* Methods replaced by Python property and setter. For example, instead of using dss.lines_read_r1() and dss.lines_write_r1() to read and write, respectively, we can use dss.lines.r1 to either read (variable = dss.lines.r1) or write (dss.lines.r1 = value) in the current version.
* Update OpenDSS version to: OpenDSS Version 9.6.1.1; License Status: Open
1.0.2 (2021-10-10)
------------------
* Code refactored
* PEP 8 in some methods
1.0.1
------------------
* Working only on Windows due EPRI offical OpenDSS is available only on Windows
1.0.0 (2021-01-21)
------------------
* Code refactored
* Works on Linux version of OpenDSS provided in the package. This version is from 2020.
* Tests included
* Methods renamed to satisfy PEP 8 -- Style Guide for Python Code
0.1.0 (2021-01-21)
------------------
* Update OpenDSS version to: OpenDSS Version 9.2.0.1; License Status: Open
0.0.9 (2021-01-21)
------------------
* text method returns string values (Jouni request)
* OpenDSS exe 64bits included
0.0.8 (2020-12-10)
------------------
* Allowing run multiple instances of DDLL without problems with memory - Gustavo asked it
* Allowing run multiple OpenDSS' DLLs
* Update OpenDSS version to: OpenDSS Version 9.1.3.3 (64-bit build); License Status: Open
0.0.7 (2020-10-22)
------------------
* PVsystems updated.
* Update OpenDSS version to: OpenDSS Version 9.1.0.1 (64-bit build); License Status: Open.
* Allowing to write values into Variant methods.
0.0.4 (2020-08-17)
------------------
* DSS class can receive OpenDSS folder in order to use the user own OpenDSS.
0.0.1 (2020-06-12)
------------------
* Integrating CI.
0.0.0 (2020-06-12)
------------------
* First release on PyPI.
Raw data
{
"_id": null,
"home_page": "https://github.com/PauloRadatz/py_dss_interface",
"name": "py-dss-interface",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "",
"author": "Paulo Radatz, \u00canio Viana, Rodolfo Londero",
"author_email": "paulo.radatz@gmail.com, eniocc@gmail.com, rodolfopl@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/97/71/430b152d8b4c68e35c3fa5531faf93c436ae866a25127e352d7c493d9ffa/py-dss-interface-2.0.2.tar.gz",
"platform": null,
"description": "========\nOverview\n========\n\nThe py-dss-interface is a Python package that provides a Python interface to the OFFICIAL version of OpenDSS (Open-source Distribution System Simulator) software. OpenDSS is a free, open-source software for simulating and analyzing power distribution systems.\n\n\n\n* Free software: MIT license\n* Documentation: https://py-dss-interface.readthedocs.io/en/latest/\n\nThe current py-dss-interface works only with Windows. The reason is that EPRI provides only Windows versions of OpenDSS. The package will work for Linux when EPRI releases the Linux version of OpenDSS.\n\nThe py-dss-interface package allows users to interact with OpenDSS using Python code, which can be particularly useful for automating tasks, performing simulations, and analyzing results. The package provides a range of functionality, including:\n\n* Creating and modifying OpenDSS circuit models\n\n* Running simulations and analyzing results\n\n* Accessing and manipulating data within the circuit model\n\n* Plotting results\n\nThe package is available on the Python Package Index (PyPI) and can be installed using pip, the Python package installer. OpenDSS does not have to be installed on the user's system to use the package, as the py-dss-interface provides an OpenDSS version.\n\nOverall, the py-dss-interface is a powerful tool for anyone working with power distribution systems who wants to use Python for simulation and analysis.\n\n\nDisclaimer\n============\nThis Python Package is purely responsibility of Paulo Radatz and not his employer. Use this package at your own risk.\n\nInstallation\n============\n\n::\n\n pip install py-dss-interface\n\nExamples\n============\nYou can find several examples of Python scripts at this link: https://github.com/PauloRadatz/py-dss-interface-examples\n\nThanks\n=============\nI want to thank \u00canio Viana and Rodolfo Pilar Londero for all their contribution to the new version of the tool.\n\n\n\n\nChangelog\n=========\n2.0.2 (2023-06-04)\n------------------\n* Tom updated OpenDSS to DDLL built as v9.6.1.2\n* Moving away from variant. Capacitor is done. Need other elements\n* Tom worked on direct dll with progress bar wired in for daily solution mode\n\n2.0.1 (2023-05-24)\n------------------\n* Description corrected\n\n2.0.0 (2023-05-24)\n------------------\n* py-dss-interface version 2 or above does not have backward compatibility with version 1\n* Methods replaced by Python property and setter. For example, instead of using dss.lines_read_r1() and dss.lines_write_r1() to read and write, respectively, we can use dss.lines.r1 to either read (variable = dss.lines.r1) or write (dss.lines.r1 = value) in the current version.\n* Update OpenDSS version to: OpenDSS Version 9.6.1.1; License Status: Open\n\n1.0.2 (2021-10-10)\n------------------\n* Code refactored\n* PEP 8 in some methods\n\n1.0.1\n------------------\n* Working only on Windows due EPRI offical OpenDSS is available only on Windows\n\n1.0.0 (2021-01-21)\n------------------\n\n* Code refactored\n* Works on Linux version of OpenDSS provided in the package. This version is from 2020.\n* Tests included\n* Methods renamed to satisfy PEP 8 -- Style Guide for Python Code\n\n0.1.0 (2021-01-21)\n------------------\n\n* Update OpenDSS version to: OpenDSS Version 9.2.0.1; License Status: Open\n\n0.0.9 (2021-01-21)\n------------------\n\n* text method returns string values (Jouni request)\n* OpenDSS exe 64bits included\n\n0.0.8 (2020-12-10)\n------------------\n\n* Allowing run multiple instances of DDLL without problems with memory - Gustavo asked it\n* Allowing run multiple OpenDSS' DLLs\n* Update OpenDSS version to: OpenDSS Version 9.1.3.3 (64-bit build); License Status: Open\n\n\n0.0.7 (2020-10-22)\n------------------\n\n* PVsystems updated.\n* Update OpenDSS version to: OpenDSS Version 9.1.0.1 (64-bit build); License Status: Open.\n* Allowing to write values into Variant methods.\n\n\n0.0.4 (2020-08-17)\n------------------\n\n* DSS class can receive OpenDSS folder in order to use the user own OpenDSS.\n\n0.0.1 (2020-06-12)\n------------------\n\n* Integrating CI.\n\n\n0.0.0 (2020-06-12)\n------------------\n\n* First release on PyPI.\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "The py-dss-interface is a Python package that provides a Python interface to the OFFICIAL version of OpenDSS (Open-source Distribution System Simulator) software. OpenDSS is a free, open-source software for simulating and analyzing power distribution systems.",
"version": "2.0.2",
"project_urls": {
"Changelog": "https://py_dss_interface.readthedocs.io/en/latest/changelog.html",
"Documentation": "https://py_dss_interface.readthedocs.io/",
"Homepage": "https://github.com/PauloRadatz/py_dss_interface",
"Issue Tracker": "https://github.com/PauloRadatz/py_dss_interface/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d945999913e590ad5937604fc13b85bf40ff2d6c15e2b2649a34020e2b166956",
"md5": "712f5a97a45487c0fa82a415071cbdd7",
"sha256": "523f0beeef7b4fd3337c312f786e9497878d69d7b6a4698a2a56543a27149b46"
},
"downloads": -1,
"filename": "py_dss_interface-2.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "712f5a97a45487c0fa82a415071cbdd7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 63160488,
"upload_time": "2023-06-05T13:47:09",
"upload_time_iso_8601": "2023-06-05T13:47:09.202549Z",
"url": "https://files.pythonhosted.org/packages/d9/45/999913e590ad5937604fc13b85bf40ff2d6c15e2b2649a34020e2b166956/py_dss_interface-2.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9771430b152d8b4c68e35c3fa5531faf93c436ae866a25127e352d7c493d9ffa",
"md5": "9378850a9c831d316e72843dbae10f80",
"sha256": "569eace754847907c1e9f50c24758f9830154b493bdcccc51e56a559496231d1"
},
"downloads": -1,
"filename": "py-dss-interface-2.0.2.tar.gz",
"has_sig": false,
"md5_digest": "9378850a9c831d316e72843dbae10f80",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 64068968,
"upload_time": "2023-06-05T13:47:17",
"upload_time_iso_8601": "2023-06-05T13:47:17.559417Z",
"url": "https://files.pythonhosted.org/packages/97/71/430b152d8b4c68e35c3fa5531faf93c436ae866a25127e352d7c493d9ffa/py-dss-interface-2.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-05 13:47:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "PauloRadatz",
"github_project": "py_dss_interface",
"travis_ci": true,
"coveralls": true,
"github_actions": false,
"appveyor": true,
"requirements": [],
"tox": true,
"lcname": "py-dss-interface"
}
JSON
