Pre-release 0.10.7rc4 (for testing)

For testing downstream projects

Pre-release 0.10.7rc1 (for testing)

For testing purposes.

Changelog will come with the proper release.

DSS C-API 0.10.6

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.6 contains several bugfixes, new extensions and new compatibility features. It contains some minor fixes and ports changes from the upstream/official OpenDSS code, based on OpenDSS version 9.0 (up to revision 2909).

See the changelog for a complete list of changes since 0.10.0. Two important new features deserve special attention:

• Like in the official OpenDSS 9.0, several models have been updated. In DSS C-API, a new setting, "Legacy Models", allows the user to continue using the old models if required.
• A new "Extended Errors" mechanism tries to flag improper API usage. This is enabled by default, but the user can disable it for better backwards compatibility even though errors could be hidden by disabling it.

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

• This version should be fully API compatible with 0.10.3+. The behavior of some functions changed with the new extensions. Especially, empty strings are explicitely return as nulls instead of "\0". This conforms to the behavior already seen in arrays of strings.
• The binary releases now use Free Pascal 3.2.0. We observed the solution process is around 6% faster, and results are even closer to the official OpenDSS.
• The releases now include both the optimized/default binary and a non-optimized/debug version. See the Debugging document for more.
• Extended API validation and Extended Errors mechanism:
  • The whole API was reviewed to add basic checks for active circuit and element access.
  • By default, invalid accesses now result in errors reported through the Error interface. This can be disabled to achieve the previous behavior, more compatible with the official COM implementation -- that is, ignore the error, just return a default/invalid value and assume the user has handled it.
  • The mechanism can be toggled by API functions DSS_Set_ExtendedErrors and DSS_Get_ExtendedErrors, or environment variable DSS_CAPI_EXTENDED_ERRORS=0 to disable (defaults to enabled state).
• New Legacy Models mechanism:
  • OpenDSS 9.0+ dropped the old PVsystem, Storage, InvControl, and StorageController models, replacing with the new versions previously known as PVsystem2, Storage2, InvControl2 and StorageController2.
  • The behavior and parameters from the new models are different -- they are better, more complete and versatile models. Check the official OpenDSS docs and examples for further information.
  • The implementation of the new models in DSS C-API was validated successfully with all test cases available. As such, we mirror the decision to make them the default models.
  • As an extension, we implemented the Legacy Models option. By toggling it, a clear command will be issued and the alternative models will be loaded. This should allow users to migrate to the new version but, if something that used to work with the old models stopped working somehow, the user can toggle the old models. The idea is to keep reproducibility of results while we keep updating the engine and the API.
  • Since EPRI dropped/deprecated the old models, we might drop them too, in a future release. Please open an issue on GitHub or send a message if those old models are important to you.
  • The mechanism can be controlled by API functions DSS_Set_LegacyModels and DSS_Get_LegacyModels, or environment variable DSS_CAPI_LEGACY_MODELS=1 to enable (defaults to disabled state).
• WireData API: expose the CapRadius property as a new pair of functions.
• PDElements API: extended with many batch functions exposing equivalents to some CSV reports: AllNames, AllMaxCurrents, AllPctNorm, AllPctEmerg, AllCurrents, AllCurrentsMagAng, AllCplxSeqCurrents, AllSeqCurrents, AllPowers, AllSeqPowers, AllNumPhases, AllNumConductors, AllNumTerminals.
• CktElement_Get_SeqPowers: fix issue for positive sequence circuits (wrong results could corrupt memory).
• Many API functions were optimized to avoid unnecessary allocations and copies.
• Some bugs found in DSS C-API and also reported upstream (already fixed in SVN):
  • CapRadius DSS property: if the radius was initialized using GMRac, CapRadius was left uninitialized, resulting in invalid/NaN values.
  • Sensors API: some functions edited capacitors instead of sensors.
• Updated to the official OpenDSS revision 2903, corresponding to versions 9.0.0+. Changes include:
  • ExportCIMXML: updated.
  • Relay: Fix in GetPropertyValue.
  • Line: In DumpProperties and MakePosSequence, the length is handled differently for lines with LineGeometry or LineSpacing.
  • Bus API: new LineList, LoadList functions.
  • Lines API: SeasonRating now returns NormAmps if there's no SeasonSignal.
  • New command DSS Zsc012: "Returns symmetrical component short circuit impedances Z0, Z1, and Z2 for the ACTIVE 3-PHASE BUS. Determined from Zsc matrix."
  • PVsystem2, Storage2, InvControl2, StorageController2 updated and renamed.

0.10.6rc1

Header: add missing voids

Testing debug builds

Checking if the new debug builds are correctly packaged.

DSS C-API 0.10.5

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.5 is a maintenance release. It contains some minor fixes and ports changes from the upstream/official OpenDSS code.

See the changelog for a complete list of changes since 0.10.0.

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

DSS C-API 0.10.5rc2

For testing. Includes 2 minor fixes since rc1.

DSS C-API 0.10.5rc1

For testing

DSS C-API 0.10.4

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.4 is a maintenance release and contains some minor fixes.

See the changelog for a complete list of changes since 0.10.0. For this release:

• Updated up to revision 2761 of the official OpenDSS code. The changes affect at least the following components: CIMXML export, Capacitor, InvControl, LineGeometry, PVsystem, StorageController, Storage, Vsource, VCCS.
• Fixes issue with long paths on Linux, potentially other platforms too.
• This version should be fully compatible with 0.10.3.

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

0.10.x-path-tests

Tentative fix for #64