DSS Properties |
[This is preliminary documentation and is subject to change.]
The DSS type exposes the following members.
Name | Description | |
---|---|---|
AllowChangeDir |
If disabled, the engine will not change the active working directory during execution. E.g. a "compile"
command will not "chdir" to the file path.
If you have issues with long paths, enabling this might help in some scenarios.
Defaults to True (allow changes, backwards compatible) in the 0.10.x versions of DSS C-API.
This might change to False in future versions.
This can also be set through the environment variable DSS_CAPI_ALLOW_CHANGE_DIR. Set it to 0 to
disallow changing the active working directory.
(API Extension)
| |
AllowDOScmd |
If enabled, the `DOScmd` command is allowed. Otherwise, an error is reported if the user tries to use it.
Defaults to False/0 (disabled state). Users should consider DOScmd deprecated on DSS Extensions.
This can also be set through the environment variable DSS_CAPI_ALLOW_DOSCMD. Setting it to 1 enables
the command.
(API Extension)
| |
AllowEditor |
Gets/sets whether running the external editor for "Show" is allowed
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.
(API Extension)
| |
AllowForms |
Gets/sets whether text output is allowed
| |
Classes |
List of DSS intrinsic classes (names of the classes)
| |
COMErrorResults |
If enabled, in case of errors or empty arrays, the API returns arrays with values compatible with the
official OpenDSS COM interface.
For example, consider the function `Loads_Get_ZIPV`. If there is no active circuit or active load element:
- In the disabled state (COMErrorResults=False), the function will return "[]", an array with 0 elements.
- In the enabled state (COMErrorResults=True), the function will return "[0.0]" instead. This should
be compatible with the return value of the official COM interface.
Defaults to True/1 (enabled state) in the v0.12.x series. This will change to false in future series.
This can also be set through the environment variable DSS_CAPI_COM_DEFAULTS. Setting it to 0 disables
the legacy/COM behavior. The value can be toggled through the API at any time.
(API Extension)
| |
DataPath |
DSS Data File Path. Default path for reports, etc. from DSS
| |
DefaultEditor |
Returns the path name for the default text editor.
| |
LegacyModels |
If enabled, the legacy/deprecated models for PVSystem, InvControl, Storage and StorageControl are used.
In the official OpenDSS version 9.0, the old models where removed. They are temporarily present here
but may be removed in the near future. If they are important to you, please open an issue on GitHub
or contact the authors from DSS Extensions: https://github.com/dss-extensions/
After toggling LegacyModels, run a "clear" command and the models will be loaded accordingly.
Defaults to False.
This can also be enabled by setting the environment variable DSS_CAPI_LEGACY_MODELS to 1.
NOTE: this option will be removed in a future release.
(API Extension)
| |
NumCircuits |
Number of Circuits currently defined
| |
NumClasses |
Number of DSS intrinsic classes
| |
NumUserClasses |
Number of user-defined classes
| |
UserClasses |
List of user-defined classes
| |
Version |
Get version string for the DSS.
|