Skip to content

DSS Python 0.10.7-1

Compare
Choose a tag to compare
@PMeira PMeira released this 10 Mar 19:25
· 5 commits to 0.10.x since this release

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 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

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 pattern GMRac=... rad=... or GMRac=... diam=... (in this order and without specifying CapRadius), 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.