DSS Python 0.10.5
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
andCktElement
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 changesExpControl
: newTresponse
propertyConductorData
,LineConstants
,LineGeometry
: newCapradius
propertyXfmrCode
,Transformer
: new Seasons and Ratings propertiesBus_Get_puVLL
andBus_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.