DSS C-API 0.10.3

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.3 contains some important fixes and has better general performance, new API extensions, new features ported from COM and the OpenDSS version 8 codebase. Although there were lots of changes and extensions, the previous API functions are expected to be valid.

See the changelog for a complete list of changes. Some highlights:

• Important fixes for the line parameter computation on Linux and macOS. The full set of sample files from the OpenDSS distribution were validated on all platforms.
• Extra validation has been added for many functions, avoiding some crashes due to incorrect usage.
• Optimized (small, dense) matrix-vector multiplication, up to 20% time-savings.

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.3rc1

Release candidate for version 0.10.3. Final tests before the proper 0.10.3.

0.10.3a7

Integrates changes up to OpenDSS SVN rev 2585.

0.10.3a6

This pre-release fixes memory corruption issues from 0.10.3a5 and adjusts *_Get_AllNames to match COM results.

As usual, this is for testing purposes, avoid using in production!

0.10.3a5

For testing #54

0.10.3a4

• New Transformers.LossesbyType
• Add ReduceCkt interface

0.10.3a3

For testing downstream projects. Incremental changes:

• Monitors/API: reworked to add more validation
• XYCurves/API: Add XYCurves_Get_AllNames

0.10.3a2

For testing downstream packages. Includes:

• faster *_Set_Name
• many more *_Set_idx/*_Get_idx
• more validation (using the error API)

0.10.3a1

For testing downstream packages

0.10.2

Incremental release with some relevant changes:

• CtrlQueue: Add the missing function CtrlQueue_Push.
• New DSS_Get_AllowEditor and DSS_Set_AllowEditor: AllowEditor controls whether the external editor is used in commands like Show. If you set to 0 (false), the editor is not executed. Note that other side effects, such as the creation of files, are not affected.
• LoadShapes code reworked: more validation, fix potential memory issues after resizing using Npts, and faster reads and writes (up to 3x).
• Introduces pre-built Linux 32-bit binaries.
• The ouput libraries/DLLs have been moved from lib/v7 and lib/v8 to just lib since the libraries already have different names. The previous organization was due to expectations that we would keep only the OpenDSS Version 8 line of code but at the moment the main development of DSS C-API is focused on Version 7.