v0.12.0b6

Binaries for testing downstream packages.

See #109 for a (WIP) list of changes.

ARM binaries (for Linux) will be added manually later (no CI yet) if no major issues are found, in the final testing steps.

Highlight of changes since b5:

• Generators/API: expose a few properties to the classic API, mirroring the classic Loads API.

v0.12.0b5

Binaries for testing downstream packages.

See #109 for a (WIP) list of changes.

ARM binaries (for Linux) will be added manually later (no CI yet) if no major issues are found.

Changes from b4:

• add toggle for DOScmd
• API/Capacitors: fix string formatting in error message
• Spectrum: fix backwards compatibility issue when using CSV files
• catch up ExportCIMXML changes and a few other SVN commits
• check for infinite values on the convergence calcs

v0.12.0b4

Binaries for testing downstream packages.

See #109 for a (WIP) list of changes.

ARM binaries (for Linux) will be added manually later (no CI yet) if no major issues are found.

Changes from b3:

• add COMHelp command, which actually just throws an error with links for the documentation.
• fix hybrid enums (e.g. RegControl PTPhase) in some scenarios
• adjust some API functions
• a few microoptimizations (ZIPV Loads)

v0.12.0b3

Binaries for testing downstream packages.

See #109 for a (WIP) list of changes.

ARM binaries (for Linux) will be added manually later (no CI yet) if no major issues are found.

Relevant changes from b2:

• macOS ARM binaries added (untested)
• user-model headers and code updated

v0.12.0b2

Binaries for testing downstream packages.

See #109 for a (WIP) list of changes.

ARM binaries will be added manually later (no CI yet) if no major issues are found.

Relevant changes from b1:

• Several changes related to property system and Obj/Batch APIs, removing some more of the old code, and adding a few shortcuts.
• Fix some boolean variables (LongBool required in some places)

v0.12.0b1

Binaries for testing downstream packages.

See #109 for a (WIP) list of changes.

ARM binaries will be added manually later (no CI yet) if no major issues are found.

Relevant changes from a3:

• Reorganize enum initialization to address potential accesses to uninitialized memory.
• Tweak some enums for better backwards compatibility
• Fix minor issues (API only) in Fuses (aliased MonitoredElement) and CktElement (DisplayName)
• Adjust EnergyMeter's bytestreams, reapply the fix to FeederSections bug
• Fix some performance regressions related to files
• Add a minor optimization for Loads on Linux

Pre-release v0.12.0a3 for testing

Binaries for testing downstream packages.

See #109 for a (WIP) list of changes.

ARM binaries will be added manually later (no CI yet) if no major issues are found.

Pre-release 0.12.0a1

A pre-release to test and adjust downstream packages.
More changes incoming soon, including fixes.

Packages available here for macOS (Intel x64 only), Linux (x86_64, x86/i686, ARM32, ARM64/aarch64), and Windows (x86_64, x86/i686).
With the exception of the ARM builds, all successful builds are also available as build artifacts through GitHub Actions, e.g. bottom of https://github.com/dss-extensions/dss_capi/actions/runs/1641141278

DSS C-API 0.10.7-1

Very minor release including a fix to some of the energy meter (textual) reports. This doesn't affect simulation results.

---

DSS C-API is a library that exposes an unofficial C API for OpenDSS, the Distribution System Simulator from EPRI (the Electric Power Research Institute), aiming for full COM compatibility and beyond. It allows using OpenDSS on Windows, Linux and macOS with compatible behavior. It is the lower level API used by the other projects in DSS Extensions: DSS Python, OpenDSSDirect.py, OpenDSSDirect.jl (Julia language), DSS# (.NET/C# bindings) and DSS MATLAB.

See the changelog for a complete list of changes since 0.10.0. One important change deserves special attention:

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

See also the updated "Known Differences" document, which lists the main differences between the DSS C-API codebase and the main/official OpenDSS.

Changes since 0.10.7

• Fix issue with energy meter reports.

Changes since 0.10.6

• 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)."

DSS C-API 0.10.7

DSS C-API is a library that exposes an unofficial C API for OpenDSS, the Distribution System Simulator from EPRI (the Electric Power Research Institute), aiming for full COM compatibility and beyond. It allows using OpenDSS on Windows, Linux and macOS with compatible behavior. It is the lower level API used by the other projects in DSS Extensions: DSS Python, OpenDSSDirect.py, OpenDSSDirect.jl (Julia language), DSS# (.NET/C# bindings) and DSS MATLAB.

Version 0.10.7 contains mostly bugfixes and ported changes from the upstream/official OpenDSS code, based on OpenDSS version 9.x (up to revision 2963).

See the changelog for a complete list of changes since 0.10.0. One important change deserves special attention:

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

See also the updated "Known Differences" document, which lists the main differences between the DSS C-API codebase and the main/official OpenDSS.

Changes since 0.10.6

• 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)."