Python functions for extracting, executing routines, etc. from projects modeled in OpenDSS
Project description
OpenPy-fx-tools-DSS
Python functions for extracting, executing routines, etc. from projects modeled in OpenDSS
Install
With pip
pip install openpy-fx-tools-dss
How to use
First, in the IDE (Integrated Development Environment) of preference, we import the library:
import openpy_fx_tools_dss as fx_dss
Examples
The library has IEEE example circuits (Table 1), which can be found in the OpenDSS installation files.
For the example files the class examples_lib()
is called:
Table 1. Sample tests
Name | Option | DSS files | xlsx file |
---|---|---|---|
13BusIEEE | 1 | x | x |
37BusIEEE | 2 | x | x |
123BusIEEE | 3 | x | x |
test = fx_dss.examples_lib()
To use the .DSS files:
DSS_path = test.load_examples_DSS()
To use .xlsx file:
xlsx_path = test.load_examples_xlsx()
OpenDSS to xlsx and vice versa
The functions that generate OpenDSS scripts to a .xlsx file and vice versa are inside the xlsx_DSS_xlsx()
class and are called in the following way:
xlsx = fx_dss.xlsx_DSS_xlsx()
Template xlsx
An .xlsx template with the OpenDSS elements is created by calling the create_template_xlsx
function as follows:
xlsx.create_template_xlsx(
path_save: str = None,
prj_name: str = 'default',
elem_list: list = [],
all_elem: bool = True
)
xlsx to OpenDSS
The circuit data is entered in the .xlsx template. Each sheet of the template corresponds to the elements that are modeled in OpenDSS. When generating the OpenDSS scripts, only the cells that are not empty are considered.
For this purpose, the xlsx_to_OpenDSS
function is called as follows:
xlsx.xlsx_to_OpenDSS(
xlsx_path=xlsx_path['xlsx_path'],
path_save=xlsx_path['path_save'],
prj_name=DSS_path['prj_name']
)
Important:
- Do not alter the names of the sheets, and columns, since the element will not be taken into account.
- The form of data entry must coincide with the OpenDSS specifications.
OpenDSS to xlsx
From an OpenDSS file, the xlsx template can be generated. For this purpose, the OpenDSS_to_xlsx
function is used as follows:
xlsx.OpenDSS_to_xlsx(
DSS_path=DSS_path['DSS_path'],
path_save=DSS_path['path_save'],
prj_name=DSS_path['prj_name']
)
License
License: CC BY-NC-SA 4.0
This work has a license Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for openpy_fx_tools_dss-0.1.6.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 72f8d5a0bfaa131db28b52f8a9374e7fde06164f595167a79cdf01c202061562 |
|
MD5 | cb7cbe6efbf7c5c03b07067c9c267b5e |
|
BLAKE2b-256 | d774dbdd191292d6930c78bbb91b733955b91c12cced2d719c8df319879e98c7 |
Hashes for openpy_fx_tools_dss-0.1.6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cb601536623b590913951f72877006f81e6d7231f8c694ae00c1e72eeae1d880 |
|
MD5 | 565721cfce13b1a30eed4ee44a4886ff |
|
BLAKE2b-256 | 79eb6dc1f6342c8e76a06cac40ebeeae6d15123e9b172d29dde073766f550062 |