Metadata-Version: 2.1
Name: py-dss-interface
Version: 2.0.1
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.
Home-page: https://github.com/PauloRadatz/py_dss_interface
Author: Paulo Radatz, Ênio Viana, Rodolfo Londero
Author-email: paulo.radatz@gmail.com, eniocc@gmail.com, rodolfopl@gmail.com 
License: MIT
Project-URL: Documentation, https://py_dss_interface.readthedocs.io/
Project-URL: Changelog, https://py_dss_interface.readthedocs.io/en/latest/changelog.html
Project-URL: Issue Tracker, https://github.com/PauloRadatz/py_dss_interface/issues
Description: ========
        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.1 (2022-05-24)
        ------------------
        * Description corrected
        
        2.0.0 (2022-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.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Provides-Extra: dev
