Opendssdirect.py

[Diff since v0.7.0](https://github.com/dss-extensions/OpenDSSDirect.jl/compare/v0.7.0...v0.7.1)



**Merged pull requests:**
- DSS C-API 0.10.7 (66) (PMeira)

This release upgrades DSS Python and DSS C-API to the latest versions, exposing new modules (Storages, Parallel, ZIP) and several functions, as well as integrating the most changes from the official OpenDSS.

OpenDSSDirect.py can be installed using pip. For more: http://dss-extensions.org/OpenDSSDirect.py/notebooks/Installation.html

As OpenDSSDirect.py accumulates changes from DSS Python, DSS C-API and the official OpenDSS, read below for other important changes including bug-fixes.

**Full Git Changelog**: https://github.com/dss-extensions/OpenDSSDirect.py/compare/v0.6.1...v0.7.0


DSS C-API 0.12 announcement

OpenDSSDirect.py version 0.6.1 upgrades to DSS_Python 0.10.7-1. The only difference from version 0.6.0 is that DSS_Python 0.10.7-1 corrects an issue with energy meter reports. If you don't use the reports, you don't need to upgrade to this version from 0.6.0.

OpenDSSDirect.py can be installed using pip. For more: http://dss-extensions.org/OpenDSSDirect.py/notebooks/Installation.html

We are also testing a conda package. You can use our `dss-extensions` channel, e.g. `conda install -c dss-extensions opendssdirect.py=0.6.1`.

As OpenDSSDirect.py accumulates changes from DSS_Python (all ported to OpenDSSDirect.py), DSS C-API and the official OpenDSS, read below for other important changes including bug-fixes.

Changes from DSS_Python 0.10.7-1

- Correct issue with energy meter reports.

Changes from DSS_Python 0.10.7

DSS_Python is the project that focuses on providing an interface, at Python level, that can be used as a drop-in replacement for the official OpenDSS COM interface. Users can combine both OpenDSSDirect.py and DSS_Python in the same application, sharing the same OpenDSS engine.

- Maintenance release.
- Updated to DSS C-API 0.10.7, which includes most changes up to OpenDSS v9.1.3.4.
- Includes an important bug fix related to the `CapRadius` DSS property. If your DSS scripts included the pattern `GMRac=... rad=...` or `GMRac=... diam=...` (in this order and without specifying `CapRadius`), you should upgrade and re-evaluate the results.
- New API properties ported from the official COM interface: `Bus.AllPCEatBus`, `Bus.AllPDEatBus`, `CktElement.TotalPowers`, `Meters.ZonePCE`

OpenDSSDirect.py version 0.6.0 upgrades to DSS_Python 0.10.7. The version was bumped to v0.6.0 to reflect that support for Python 2.7 was dropped (at the moment, you can still build DSS_Python from source for Python 2.7 if you need it) and Python 3.9 was added.

This release includes bugfixes and new features, among them:
- Bug fix related to the `CapRadius` DSS property. If your DSS scripts included the pattern `GMRac=... rad=...` or `GMRac=... diam=...` (in this order and without specifying `CapRadius`), you should upgrade and re-evaluate the results. The issue also affect the official OpenDSS package.

OpenDSSDirect.py can be installed using pip. For more: http://dss-extensions.org/OpenDSSDirect.py/notebooks/Installation.html

As OpenDSSDirect.py accumulates changes from DSS_Python (all ported to OpenDSSDirect.py), DSS C-API and the official OpenDSS, read below for other important changes including bug-fixes.

Changes from DSS_Python 0.10.7

DSS_Python is the project that focuses on providing an interface, at Python level, that can be used as a drop-in replacement for the official OpenDSS COM interface. Users can combine both OpenDSSDirect.py and DSS_Python in the same application, sharing the same OpenDSS engine.

- Maintenance release.
- Updated to DSS C-API 0.10.7, which includes most changes up to OpenDSS v9.1.3.4.
- Includes an important bug fix related to the `CapRadius` DSS property. If your DSS scripts included the pattern `GMRac=... rad=...` or `GMRac=... diam=...` (in this order and without specifying `CapRadius`), you should upgrade and re-evaluate the results.
- New API properties ported from the official COM interface: `Bus.AllPCEatBus`, `Bus.AllPDEatBus`, `CktElement.TotalPowers`, `Meters.ZonePCE`

- Add Enum support for all functions
- Minor fixes in Error module
- Add OPENDSSDIRECT_REPL environment variable to disable REPL mode
- Add download examples function

OpenDSSDirect.py version 0.5.0 upgrades to DSS_Python 0.10.6. The version was bumped to v0.5.0 to reflect changes with the default behavior.

With this set of releases from the [DSS Extensions project](https://dss-extensions.org/), most API calls are checked, avoiding surprising/confusing messages when the errors are not handled immediately. In OpenDSSDirect.py, the error messages provided in the OpenDSS Error interface are automatically mapped to Python exceptions and should now provide a better context for the errors.

Two new important compatibility settings are introduced:
- [`opendssdirect.Error.ExtendedErrors`](http://dss-extensions.org/OpenDSSDirect.py/opendssdirect.html#opendssdirect.Error.ExtendedErrors) (defaults to enabled state): this new mechanism provides more error messages from the validation checks at the API level. You can disable the new messages, falling back to the previous behavior, using `opendssdirect.Error.ExtendedErrors(False)`.
- [`opendssdirect.Basic.LegacyModels`](http://dss-extensions.org/OpenDSSDirect.py/opendssdirect.html#opendssdirect.Basic.LegacyModels) (defaults to disabled state): in OpenDSS v9.0, the old PVSystem, Storage, ... models were deprecated and removed from the official release. In ODD.py, you can toggle the old models using `opendssdirect.Basic.LegacyModels(True)`. The current/new models, previously known as PVSystem2, Storage2, ... have been validated with the official tests and enabled by default.

OpenDSSDirect.py can be installed using pip. For more: http://dss-extensions.org/OpenDSSDirect.py/notebooks/Installation.html

As OpenDSSDirect.py accumulates changes from DSS_Python (all ported to OpenDSSDirect.py), DSS C-API and the official OpenDSS, read below for other important changes including bug-fixes.

Changes from DSS_Python 0.10.6

DSS_Python is the project that focuses on providing an interface, at Python level, that can be used as a drop-in replacement for the official OpenDSS COM interface. Users can combine both OpenDSSDirect.py and DSS_Python in the same application, sharing the same OpenDSS engine.

- Updated to DSS C-API 0.10.6, which includes most changes up to OpenDSS v9.0.0.3.
- Debug builds of DSS C-API are now included. See the [Debugging](https://github.com/dss-extensions/dss_capi/blob/0.10.x/docs/debug.md) document.
- New `DSS.LegacyModels`: allow using the legacy/deprecated models for `PVsystem`, `Storage`, `InvControl`, and `StorageController`.
- New `DSS.Error.ExtendedErrors`: controls if the new extended error messages are used.
- Many new properties and functions in `DSS.ActiveCircuit.PDElements`.
- Now most of the low-level API calls are checked, mapping the errors from the `DSS.Error` interface to Python exceptions more frequently.