Source code for py_dss_interface.models.Transformers.TransformersS
# -*- encoding: utf-8 -*-
"""
Created by eniocc at 11/10/2020
"""
import ctypes
from py_dss_interface.models.Base import Base
[docs]class TransformersS(Base):
"""
This interface can be used to read/modify the properties of the Transformers Class where the values are Strings.
The structure of the interface is as follows:
CStr TransformersS(int32_t Parameter, CStr argument) ;
This interface returns a string, the variable “parameter” is used to specify the property of the class to be used
and the variable “argument” can be used to modify the value of the property when necessary. Reading and writing
properties are separated and require a different parameter number to be executed.
The properties (parameter) are integer numbers and are described as follows.
"""
[docs] def transformers_read_xfmr_code(self):
"""Gets the name of an XfrmCode that supplies electrical parameters for this transformer."""
result = ctypes.c_char_p(self.dss_obj.TransformersS(ctypes.c_int32(0), ctypes.c_int32(0)))
return result.value.decode('ascii')
[docs] def transformers_write_xfmr_code(self, argument):
"""Sets the name of an XfrmCode that supplies electrical parameters for this transformer."""
argument = Base.check_string_param(argument)
result = ctypes.c_char_p(self.dss_obj.TransformersS(ctypes.c_int32(1), argument.encode('ascii')))
return result.value.decode('ascii')
[docs] def transformers_read_name(self):
"""Gets the active transformer name."""
result = ctypes.c_char_p(self.dss_obj.TransformersS(ctypes.c_int32(2), ctypes.c_int32(0)))
return result.value.decode('ascii')
[docs] def transformers_write_name(self, argument):
"""Sets the active transformer by name."""
argument = Base.check_string_param(argument)
result = ctypes.c_char_p(self.dss_obj.TransformersS(ctypes.c_int32(3), argument.encode('ascii')))
return result.value.decode('ascii')
[docs] def transformers_str_wdg_voltages(self):
"""Gets the voltages at the active winding of the active transformer in string format."""
result = ctypes.c_char_p(self.dss_obj.TransformersS(ctypes.c_int32(4), ctypes.c_int32(0)))
return result.value.decode('ascii')