Updates for v0.13.3

PMeira · PMeira · commit 9309ffe635dd · 2023-06-12T23:47:21.000-03:00
- Use DSS C-API 0.13.3
- Add DSSCompatFlags.SaveCalcVoltageBases
- Port the comment about WdgCurrents/Voltages and open terminals
diff --git a/dss_sharp.csproj b/dss_sharp.csproj
@@ -9,7 +9,7 @@
     <NoWarn>1591</NoWarn>
     <PlatformTarget>x64</PlatformTarget>
     <Authors>Paulo Meira, DSS-Extensions contributors</Authors>
-    <PackageVersion>0.13.2</PackageVersion>
+    <PackageVersion>0.13.3</PackageVersion>
     <Title>DSS Sharp</Title>
     <Description>
         DSS Sharp is a C# wrapper to the native DSS C-API library, a multiplatform multiarchitecture implementation of EPRI's OpenDSS engine. 
@@ -22,8 +22,8 @@
     </Description>
     <PackageId>dss_sharp</PackageId>
     <license>BSD-3-Clause AND LGPL</license>
-    <AssemblyVersion>0.13.2.0</AssemblyVersion>
-    <FileVersion>0.13.2.0</FileVersion>
+    <AssemblyVersion>0.13.3.0</AssemblyVersion>
+    <FileVersion>0.13.3.0</FileVersion>
     <PackageProjectUrl>https://github.com/dss-extensions/dss_sharp/</PackageProjectUrl>
     <PackageTags>dss;opendss;linux;windows;macos;dss-extensions;powerflow;distribution;electric;simulator</PackageTags>
     <PackageIcon>docs/images/dss_sharp.png</PackageIcon>
diff --git a/examples/WinFormsAppSample/WinFormsAppSample.csproj b/examples/WinFormsAppSample/WinFormsAppSample.csproj
@@ -9,7 +9,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="dss_sharp" Version="0.13.2" />
+    <PackageReference Include="dss_sharp" Version="0.13.3" />
     <PackageReference Include="ScottPlot.WinForms" Version="4.1.61" />
   </ItemGroup>
 
diff --git a/scripts/download_native_libs.sh b/scripts/download_native_libs.sh
@@ -1,5 +1,5 @@
 if [ -z ${DSS_CAPI_TAG+x} ]; then
-    DSS_CAPI_TAG=0.13.2
+    DSS_CAPI_TAG=0.13.3
 fi
 
 rm -rf runtimes messages
diff --git a/src/dss_sharp.cs b/src/dss_sharp.cs
@@ -295,9 +295,17 @@ public enum DSSCompatFlags {
 
         /// <summary>
         /// Toggle some InvControl behavior introduced in OpenDSS 9.6.1.1. It could be a regression 
-        /// but needs further investigation, so we added this flag in the time being.        
+        /// but needs further investigation, so we added this flag in the time being.
         /// </summary>
-        InvControl9611 = 0x00000004
+        InvControl9611 = 0x00000004,
+
+        /// <summary>
+        /// When using "save circuit", the official OpenDSS always includes the "CalcVoltageBases" command in the
+        /// saved script. We found that it is not always a good idea, so we removed the command (leaving it commented).
+        /// Use this flag to enable the command in the saved script.
+        /// </summary>
+        SaveCalcVoltageBases = 0x00000008
+
     };
 
     public class Bus : ContextState
@@ -20604,6 +20612,9 @@ public double kVA
 
         /// <summary>
         /// Complex array of voltages for active winding
+        ///
+        /// WARNING: If the transformer has open terminal(s), results may be wrong, i.e. avoid using this
+        /// in those situations. For more information, see https://github.com/dss-extensions/dss-extensions/issues/24
         /// </summary>
         public double[] WdgVoltages
         {
@@ -20623,6 +20634,9 @@ public double[] WdgVoltages
 
         /// <summary>
         /// All Winding currents (ph1, wdg1, wdg2,... ph2, wdg1, wdg2 ...)
+        ///
+        /// WARNING: If the transformer has open terminal(s), results may be wrong, i.e. avoid using this
+        /// in those situations. For more information, see https://github.com/dss-extensions/dss-extensions/issues/24
         /// </summary>
         public double[] WdgCurrents
         {
@@ -20642,6 +20656,9 @@ public double[] WdgCurrents
 
         /// <summary>
         /// All winding currents in CSV string form like the WdgCurrents property
+        ///
+        /// WARNING: If the transformer has open terminal(s), results may be wrong, i.e. avoid using this
+        /// in those situations. For more information, see https://github.com/dss-extensions/dss-extensions/issues/24
         /// </summary>
         public string strWdgCurrents
         {
