|
8 | 8 |
|
9 | 9 | ---
|
10 | 10 |
|
11 |
| -This is version of a set of MATLAB classes that expose the DSS C-API library with the same structure as the COM object, with the same extensions as DSS Python. This is the equivalent of DSS Python and DSS Sharp for MATLAB usage. |
| 11 | +This is version of a set of MATLAB classes that expose the DSS C-API library with the same structure as the COM object, with the same extensions as DSS Python. This is the equivalent of DSS-Python and DSS-Sharp for MATLAB usage. |
12 | 12 |
|
13 | 13 | Please see [https://dss-extensions.org/](https://dss-extensions.org/) for a general introduction and useful links for all projects under DSS Extensions.
|
14 | 14 |
|
15 | 15 | A new repository to coordinate documentation and other shared features across all DSS Extensions is now available at [https://github.com/dss-extensions/dss-extensions](https://github.com/dss-extensions/dss-extensions)
|
16 | 16 |
|
17 | 17 | Related projects:
|
18 |
| -- [`OpenDSS`](https://sourceforge.net/projects/electricdss/): The main OpenDSS project, maintained by EPRI. |
| 18 | +- [`OpenDSS`](https://sourceforge.net/projects/electricdss/): The main OpenDSS project, maintained by EPRI. We track the changes there and port accordingly, with a few exceptions. |
19 | 19 | - [`DSS C-API`](http://github.com/dss-extensions/dss_capi): Custom OpenDSS C-API library, which also includes some patches.
|
20 |
| -- [`DSS Python`](http://github.com/dss-extensions/dss_python): Python bindings that mimics the official COM interface (property-style access to items). |
| 20 | +- [dss.hpp](https://dss-extensions.org/dss_capi/): header-only library for C++, hosted within DSS C-API (`include/` directory). Allows using DSS C-API more comfortably from C++, abstract memory management and low-level details such as API conventions of the DSS C-API library. |
| 21 | +- [`DSS-Python`](http://github.com/dss-extensions/dss_python): Python bindings that mimics the official COM interface (property-style access to items). Very similar to DSS_MATLAB, but for Python. Some new and experimental features are tested there first (for example, plotting integration). |
21 | 22 | - [`OpenDSSDirect.py`](http://github.com/dss-extensions/OpenDSSDirect.py): Function-style bindings and useful tools (originally based on the DCSL/OpenDSSDirect.DLL).
|
22 | 23 | - [`OpenDSSDirect.jl`](http://github.com/dss-extensions/OpenDSSDirect.jl): Julia bindings to DSS C-API (originally based on the DCSL/OpenDSSDirect.DLL).
|
23 | 24 | - [`DSS Sharp`](http://github.com/dss-extensions/dss_sharp/): .NET assembly to use the native DLL, mimics the COM object as used in .NET.
|
24 | 25 |
|
25 |
| -Version 0.12.2, released on 2022-08-29, covers most of the COM functions and classes, besides some extensions from DSS C-API. If you find a missing function or unexpected behavior, please open an issue on GitHub to both help us track and hopefully fix it, and also inform other users. This project uses the [DSS C-API library version 0.12.1](https://github.com/dss-extensions/dss_capi/blob/master/docs/changelog.md#version-0121), based on OpenDSS revision 3460 (few commits after OpenDSS v9.4.1.2). |
| 26 | +Version 0.13.0, released on 2023-03, covers most of the COM functions and classes, besides some extensions from DSS C-API. If you find a missing function or unexpected behavior, please open an issue on GitHub to both help us track and hopefully fix it, and also inform other users. This project currently uses the [DSS C-API library version 0.13.0](https://github.com/dss-extensions/dss_capi/blob/master/docs/changelog.md#version-0130), based on OpenDSS revision 3595 (few commits after OpenDSS v9.6.1.1). |
26 | 27 |
|
27 | 28 |
|
| 29 | +## Highlights from 0.13.0 |
| 30 | + |
| 31 | +Port updates from DSS-Python 0.13, integrating our base library, DSS C-API 0.13. Specific to DSS_MATLAB: |
| 32 | + |
| 33 | +- Add missing file |
| 34 | +- `DSS.AdvancedTypes` mode: when enabled, the package can return complex numbers and matrices! |
| 35 | +- `DSS.CompatFlags`: some toggles for compatibility with the official OpenDSS on some specific points. |
| 36 | +- `DSS.AllowDOScmd`: toggle running system commands from DSS scripts |
| 37 | +- Fix many docstring typos |
| 38 | +- Fix some arrays of strings: some functions were broken during the DSSContext migration. |
| 39 | +- Use enums for some properties: easier to read, more maintainable. |
| 40 | +- Introduce a few new functions added in the official COM API. |
| 41 | +- Updated our simple example script. |
| 42 | + |
| 43 | +[See also the DSS C-API 0.13.0 notes.](https://github.com/dss-extensions/dss_capi/releases/tag/0.13.0) |
| 44 | + |
28 | 45 | ## Highlights from 0.12.2
|
29 | 46 |
|
30 | 47 | - Migrate to the DSSContext (`ctx_*`) API. This fixes some results when using multiple actors (PM).
|
@@ -97,7 +114,7 @@ https://github.com/dss-extensions/dss_capi/blob/master/docs/known_differences.md
|
97 | 114 |
|
98 | 115 | Most of these apply indirectly to DSS_MATLAB.
|
99 | 116 |
|
100 |
| -The [list of important changes](https://github.com/dss-extensions/dss_capi/blob/master/docs/changelog.md#version-0120) through development is also useful. |
| 117 | +The [list of important changes](https://github.com/dss-extensions/dss_capi/blob/master/docs/changelog.md#version-0130) through development is also useful. |
101 | 118 |
|
102 | 119 | ## Credits / Acknowlegement
|
103 | 120 |
|
|
0 commit comments