You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+17-3
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,6 @@
1
1
# DSS MATLAB: an unofficial MATLAB package for EPRI's OpenDSS
2
2
3
-
**Currently in pre-release status!**
4
-
5
-
This is work-in-progress version of a set of MATLAB classes that expose the DSS C-API library with the same structure as the COM object. At the moment, this is the equivalent of DSS Python and DSS Sharp for MATLAB usage.
3
+
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 as extensions as DSS Python. This is the equivalent of DSS Python and DSS Sharp for MATLAB usage.
6
4
7
5
Related projects:
8
6
-[`OpenDSS`](https://sourceforge.net/projects/electricdss/): The main OpenDSS project, maintained by EPRI.
@@ -11,6 +9,8 @@ Related projects:
11
9
-[`OpenDSSDirect.py`](http://github.com/dss-extensions/OpenDSSDirect.py): More pythonic bindings and useful tools.
12
10
-[`DSS Sharp`](http://github.com/dss-extensions/dss_sharp/): .NET assembly to use the native DLL, mimics the COM object as used in .NET.
13
11
12
+
The first non-preview version, 0.10.3, is expected to cover most of the COM functions and classes. 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.
13
+
14
14
## Usage
15
15
16
16
1. Download a package from the [releases page](https://github.com/dss-extensions/dss_matlab/releases).
@@ -45,6 +45,20 @@ function [Start,Obj,Text] = DSSStartup
45
45
46
46
If you want some code to play with, you can use the MATLAB examples from the official OpenDSS distribution, from a local installation (e.g. `C:\OpenDSS\Examples\Matlab`) or from the [official SVN repository](https://sourceforge.net/p/electricdss/code/HEAD/tree/trunk/Distrib/Examples/Matlab/).
47
47
48
+
[Sandia's GridPV toolbox](https://pvpmc.sandia.gov/applications/gridpv-toolbox/) has been confirmed to work with very minor changes. Note that the toolbox seems to be out-of-date for some features, so don't expect everything to work even with COM (e.g. Google Maps integration seem broken).
49
+
50
+
**As a general advice (valid for COM and DSS_MATLAB), avoid using the `get` function without parameters on OpenDSS classes. Some properties like `First` and `Next` used for iteration of elements change the current active element and can lead to misleading data!**
51
+
52
+
## Known differences and more
53
+
54
+
We maintain a list of important differences between the official COM implementation and DSS C-API at:
The [list of important changes](https://github.com/dss-extensions/dss_capi/blob/master/docs/changelog.md#version-0103) through development is also useful.
61
+
48
62
## Credits / Acknowlegement
49
63
50
64
This project is derived from EPRI's OpenDSS and the same style of license (BSD style) is used. As OpenDSS, the project also depends on KLUSolve and SuiteSparse, licensed under the LGPL.
0 commit comments