DSS Python 0.10.7-1
On 2021-03-09, version 0.10.7-1 has been released on the official Python package repository (PyPI) for Windows, macOS and Linux. For Anaconda cloud (channel dss-extensions), packages are available for macOS and Linux.
Note: Although the majority of features are ported frequently from the official OpenDSS and validated with a large suite of tests, this is not an official EPRI project.
The main differences in behavior compared to the official OpenDSS are listed in https://github.com/dss-extensions/dss_capi/blob/0.10.x/docs/known_differences.md
This release includes a correction to an issue with energy meter reports.
Installation
Using pip (Python versions: 3.5 to 3.9):
pip install dss_python==0.10.7-1
Or install it with conda (available for Python versions 3.5 to 3.9 for macOS and Linux, and 3.6 to 3.9 on Windows x64):
conda install -c dss-extensions dss_python=0.10.7.post1
Recent changes
Changes in 0.10.7-1
- Correct issue with energy meter reports.
Changes in 0.10.7, since 0.10.6
Check the changelog document for a detailed list for all releases.
- 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 patternGMRac=... rad=...
orGMRac=... diam=...
(in this order and without specifyingCapRadius
), 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
DSS C-API 0.10.7 changes:
- Simple maintenance release, which includes most changes up to OpenDSS v9.1.3.4 (revision 2963).
- Includes an important bug fix related to the
CapRadius
DSS property. If your DSS scripts included the patternGMRac=... rad=...
orGMRac=... diam=...
(in this order and without specifyingCapRadius
), you should upgrade and re-evaluate the results. - This version should be fully API compatible with 0.10.3+.
- A reference document listing the DSS commands and properties for all DSS elements is now available at https://github.com/dss-extensions/dss_capi/blob/0.10.x/docs/dss_properties.md
- New functions API ported from the official OpenDSS include:
Bus_Get_AllPCEatBus
,Bus_Get_AllPDEatBus
,CktElement_Get_TotalPowers
,Meters_Get_ZonePCE
. - The changes ported from the official OpenDSS include the following (check the repository for more details):
- "Adds LineType property to LineCode and LineGeometry objects."
- "Correcting bug found in storage device when operating in idling mode. It was preventing the solution of other test feeders (IEEE 9500)"
- "Enabling fuel option for generator, fixing bug found in TotalPower command."
- "Adding kvar compensation calculation for normalizing reactive power at feeder head. v 9.1.2.4"
- "Adding: - Line type variable to line definition. - AllPCEatBus and AllPDEatBus commands to the executive command set. - AllPCEatBus and AllPDEatBus commands to bus interface in COM/DLL. (...)"
- "Adding capability to energy meter for getting the list of all PCE (shunt) within a zone. Interface "AllPCEatZone" for COM/DLL created."
- "Fixing bug found when calculating voltage bases with large amount of numbers (large array)."
Reminder: mixed-case handling
If you were using use_com_compat
to allow mixed-cased attributes, it should work better than before. You may now use use_com_compat(warn=True)
to warn when you use an attribute that wouldn't exist without calling use_com_compat
. The intention is that the user should run their code to get a list of warnings, fix it, and then remove use_com_compat
since it does have a small performance impact.