Skip to content

DSS Python 0.10.5

Compare
Choose a tag to compare
@PMeira PMeira released this 03 Mar 18:30
· 24 commits to 0.10.x since this release

On 2020-03-03, version 0.10.5 has been released on the official Python package repository (PyPI) for Windows, macOS and Linux. For Anaconda cloud (channel PMeira), packages are available for macOS and Linux.

Note: back on 2019-11-16, version 0.10.4 was not announced on GitHub but it was properly released on PyPI

Installation

Using pip (Python versions: 2.7, 3.5 to 3.8):

pip install dss_python

Or install it with conda (available for Python versions 3.5, 3.6, 3.7 for macOS and Linux):

conda install -c pmeira dss_python

Relevant changes

This is a maintenance release.

  • Updated to DSS C-API 0.10.5, which includes most changes up to OpenDSS v8.6.7.1. Includes new properties and new experimental components (under testing).
  • New properties exposed: ActiveClass.ActiveClassParent, PVSystems.Pmpp, PVSystems.IrradianceNow.
  • For the time being, dss.v8 doesn't use the parallel-machine version anymore. This will be addressed in a future release, most likely in the 0.11.x series coming in the following months.

DSS C-API 0.10.5 changes:

  • Disable builds and distribution of v8-only variation -- the extra/missing parallel-machine will be completely merged in a mixed (v7+v8) codebase in the coming months.
  • This version should be fully API compatible with 0.10.3+.
  • Bus and CktElement API functions reworked with some more checks.
  • Updated up to revision 2837 of the official OpenDSS code:
    • Ported changes from SVN (v7 and v8) into DSS C-API v7 variation (v8 was left untouched).
    • 4 new API level functions (ActiveClass_Get_ActiveClassParent, PVSystems_Get_Pmpp, PVSystems_Set_Pmpp, PVSystems_Get_IrradianceNow)
    • 4 new components: PVsystem2, Storage2, InvControl2, StorageController2 -- added for early testing, no dedicated API functions yet. At the moment, please consider them experimental features subject to change.
    • CIM100: several changes
    • ExpControl: new Tresponse property
    • ConductorData, LineConstants, LineGeometry: new Capradius property
    • XfmrCode, Transformer: new Seasons and Ratings properties
    • Bus_Get_puVLL and Bus_Get_VLL -- see revision 2836 (official SVN). Included an extra fix in DSS C-API to avoid some corner cases.
    • Other small bug fixes like the Full Carson fix -- see https://sourceforge.net/p/electricdss/discussion/861976/thread/2de01d0cdb/ and revision 2805 (official SVN)

Check the full changelog for DSS C-API at https://github.com/dss-extensions/dss_capi/blob/master/docs/changelog.md#version-0105

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

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.