Docs and minor changes for 0.10.5

Author: PMeira

.travis.yml

@@ -7,7 +7,7 @@ matrix:
       sudo: required
       env: 
         - DOCKER_IMAGE=pmeira/manylinux_wheel_cmake_fpc
-        - DSS_CAPI_TAG=0.10.5rc2
+        - DSS_CAPI_TAG=0.10.5
         - LINUX_X64=1
         - CONDA_SUBDIR=linux-64
       services:
@@ -32,7 +32,7 @@ matrix:
       sudo: required
       env: 
         - DOCKER_IMAGE=pmeira/manylinux_wheel_cmake_fpc_i686
-        - DSS_CAPI_TAG=0.10.5rc2
+        - DSS_CAPI_TAG=0.10.5
         - CONDA_SUBDIR=linux-32
       services:
         - docker
@@ -52,7 +52,7 @@ matrix:
     - name: "osx_x64"
       os: osx
       env: 
-        - DSS_CAPI_TAG=0.10.5rc2
+        - DSS_CAPI_TAG=0.10.5
       script: 
         - export TRAVIS_TAG_DSS_PYTHON=$TRAVIS_TAG
         - export TRAVIS_TAG=

README.md

@@ -1,5 +1,5 @@
-[![Travis-CI: Linux and macOS build status](https://travis-ci.com/dss-extensions/dss_python.svg?branch=master)](https://travis-ci.com/dss-extensions/dss_python) 
-[![AppVeyor: Windows build status](https://ci.appveyor.com/api/projects/status/bvcbel63n5uf4yjk/branch/master?svg=true)](https://ci.appveyor.com/project/PMeira/dss-python-yyx2r/branch/master)
+[![Travis-CI: Linux and macOS build status](https://travis-ci.com/dss-extensions/dss_python.svg?branch=0.10.x)](https://travis-ci.com/dss-extensions/dss_python) 
+[![AppVeyor: Windows build status](https://ci.appveyor.com/api/projects/status/bvcbel63n5uf4yjk/branch/0.10.x?svg=true)](https://ci.appveyor.com/project/PMeira/dss-python-yyx2r/branch/0.10.x)
 
 # DSS Python: Unofficial bindings for EPRI's OpenDSS
 
@@ -13,7 +13,7 @@ See also the other projects from [DSS-Extensions.org](https://dss-extensions.org
 - [DSS Sharp](http://github.com/dss-extensions/dss_sharp/): available for .NET/C#, also mimics the COM classes, but Windows-only at the moment. Soon it will be possible to use it via COM too.
 - [DSS MATLAB](http://github.com/dss-extensions/dss_matlab/): presents multi-platform integration (Windows, Linux, MacOS) with DSS C-API and is also very compatible with the COM classes.
 
-Version 0.10.3, based on OpenDSS revision 2609 (which is slightly newer than OpenDSS v8.5.9.1 and v7.6.5.86). While we plan to add a lot more funcionality into DSS Python, the main goal of creating a COM-compatible API has been reached. If you find an unexpected missing feature, please report it!
+Version 0.10.5, based on OpenDSS revision 2837 (which is slightly newer than OpenDSS v8.6.7.1). While we plan to add a lot more funcionality into DSS Python, the main goal of creating a COM-compatible API has been reached. If you find an unexpected missing feature, please report it!
 
 This module mimics the COM structure (as exposed via `win32com` or `comtypes`), effectively enabling multi-platform compatibility at Python level.
 Most of the COM documentation can be used as-is, but instead of returning tuples or lists, this modules returns/accepts NumPy arrays for numeric data exchange. 
@@ -22,9 +22,11 @@ The module depends on CFFI, NumPy and, optionally, SciPy.Sparse for reading the
 
 ## Recent changes
 
-Check the [changelog](docs/changelog.md#0103) document for a detailed list.
+Check the [changelog](docs/changelog.md#0105) document for a detailed list.
 
-- **2019-05-22 / version 0.10.3: Some important fixes, better general performance, new API extensions, new features ported from COM and the OpenDSS version 8 codebase.**
+- *2020-03-03 / version 0.10.5: Maintenance release to match DSS C-API 0.10.5, basedon on OpenDSS revision 2837. Temporarily drops the v8 parallel-machine functions, as well as conda packages on Windows.*
+- 2019-11-16 / version 0.10.4: Maintenance release to match DSS C-API 0.10.4.
+- 2019-05-22 / version 0.10.3: Some important fixes, better general performance, new API extensions, new features ported from COM and the OpenDSS version 8 codebase.
 - 2019-02-28 / version 0.10.2: Some small fixes, adds the missing `CtrlQueue.Push`, faster LoadShapes and new property `DSS.AllowEditor` to toggle editor calls.
 - 2019-02-17 / version 0.10.1: Integrate DSS C-API changes/fix, some small fixes, and more error-checking. 
 - 2018-11-17 / version 0.10.0: Lots of changes, fixes and new features. Check the new [changelog](docs/changelog.md#0100) document for a list.
@@ -136,16 +138,16 @@ for i in range(len(voltages) // 2):
 ```
 
 
-If you want to play with the experimental OpenDSS-PM interface (from OpenDSS v8), it is installed side-by-side and you can import it as:
+~~If you want to play with the experimental OpenDSS-PM interface (from OpenDSS v8), it is installed side-by-side and you can import it as:~~ -- temporarily disabled in DSS Python 0.10.5. Check back in a few months.
 
 ```python
 import dss.v8
 dss_engine = dss.v8.DSS
 ```
 
-Although it is experimental, most of its funcionality is working. Depending on your use-case, the parallel interface can be an easy way of better using your machine resources. Otherwise, you can always use general distributed computing resources via Python.
+~~Although it is experimental, most of its funcionality is working. Depending on your use-case, the parallel interface can be an easy way of better using your machine resources. Otherwise, you can always use general distributed computing resources via Python.~~
 
-Beware the v8 alternative can present issues and it should be removed as soon as all OpenDSS 8+ features are integrated into the default version.
+~~Beware the v8 alternative can present issues and it should be removed as soon as all OpenDSS 8+ features are integrated into the default version.~~
 
 Testing
 =======
@@ -162,6 +164,7 @@ Besides bug fixes, the main funcionality of this library is mostly done. Notable
 
 - More and better documentation
 - Plotting and reports integrated in Python.
+- Parallel-machine properties (disabled in DSS Python 0.10.5, to be reworked).
 
 Expect news about these items by version 0.11.
 

appveyor.yml

@@ -5,7 +5,7 @@ clone_folder: c:\projects\dss_python
 cache:
   - c:\projects\VCForPython27.msi
 environment:
-  DSS_CAPI_TAG: 0.10.5rc2
+  DSS_CAPI_TAG: 0.10.5
   DSS_CAPI_PATH: c:\projects\dss_capi
   ANACONDA_API_TOKEN: 
     secure: Pcm5IXFi4ZUsi1ue5QvPNASDo1Ns1REYbAwDJXRd3FRn2CfKbNPgnPda6fxoN6wG

docs/changelog.md

@@ -1,3 +1,27 @@
+# 0.10.5
+
+Released on 2020-03-03. 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)
+
 # 0.10.4
 
 Released on 2019-11-16. This is a maintenance release.

dss/__init__.py

@@ -6,4 +6,4 @@
 from .v7 import *
 from .patch_dss_com import patch_dss_com
 
-__version__ = '0.10.5rc2'
+__version__ = '0.10.5'

dss/v8.py

@@ -3,6 +3,7 @@
 '''
 from __future__ import absolute_import
 from .v7 import *
+import warnings
 
 warnings.warn('This module (dss.v8) is deprecated. Most parallel-machine functions are planned to be integrated in a future version.')