diff --git a/cimpy/cgmes_v3_0_0/ACDCConverter.py b/cimpy/cgmes_v3_0_0/ACDCConverter.py new file mode 100644 index 00000000..6e514784 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ACDCConverter.py @@ -0,0 +1,91 @@ +from .ConductingEquipment import ConductingEquipment + + +class ACDCConverter(ConductingEquipment): + ''' + A unit with valves for three phases, together with unit control equipment, essential protective and switching devices, DC storage capacitors, phase reactors and auxiliaries, if any, used for conversion. + + :p: Active power at the point of common coupling. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution in the case a simplified power flow model is used. Default: 0.0 + :q: Reactive power at the point of common coupling. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution in the case a simplified power flow model is used. Default: 0.0 + :targetPpcc: Real power injection target in AC grid, at point of common coupling. Load sign convention is used, i.e. positive sign means flow out from a node. Default: 0.0 + :targetUdc: Target value for DC voltage magnitude. The attribute shall be a positive value. Default: 0.0 + :baseS: Base apparent power of the converter pole. The attribute shall be a positive value. Default: 0.0 + :idleLoss: Active power loss in pole at no power transfer. It is converter`s configuration data used in power flow. The attribute shall be a positive value. Default: 0.0 + :maxUdc: The maximum voltage on the DC side at which the converter should operate. It is converter`s configuration data used in power flow. The attribute shall be a positive value. Default: 0.0 + :minUdc: The minimum voltage on the DC side at which the converter should operate. It is converter`s configuration data used in power flow. The attribute shall be a positive value. Default: 0.0 + :numberOfValves: Number of valves in the converter. Used in loss calculations. Default: 0 + :ratedUdc: Rated converter DC voltage, also called UdN. The attribute shall be a positive value. It is converter`s configuration data used in power flow. For instance a bipolar HVDC link with value 200 kV has a 400kV difference between the dc lines. Default: 0.0 + :resistiveLoss: It is converter`s configuration data used in power flow. Refer to poleLossP. The attribute shall be a positive value. Default: 0.0 + :switchingLoss: Switching losses, relative to the base apparent power `baseS`. Refer to poleLossP. The attribute shall be a positive value. Default: 0.0 + :valveU0: Valve threshold voltage, also called Uvalve. Forward voltage drop when the valve is conducting. Used in loss calculations, i.e. the switchLoss depend on numberOfValves * valveU0. Default: 0.0 + :maxP: Maximum active power limit. The value is overwritten by values of VsCapabilityCurve, if present. Default: 0.0 + :minP: Minimum active power limit. The value is overwritten by values of VsCapabilityCurve, if present. Default: 0.0 + :PccTerminal: Point of common coupling terminal for this converter DC side. It is typically the terminal on the power transformer (or switch) closest to the AC network. Default: None + :DCTerminals: A DC converter have DC converter terminals. A converter has two DC converter terminals. Default: "list" + :idc: Converter DC current, also called Id. It is converter`s state variable, result from power flow. Default: 0.0 + :poleLossP: The active power loss at a DC Pole = idleLoss + switchingLoss*|Idc| + resitiveLoss*Idc^2. For lossless operation Pdc=Pac. For rectifier operation with losses Pdc=Pac-lossP. For inverter operation with losses Pdc=Pac+lossP. It is converter`s state variable used in power flow. The attribute shall be a positive value. Default: 0.0 + :uc: Line-to-line converter voltage, the voltage at the AC side of the valve. It is converter`s state variable, result from power flow. The attribute shall be a positive value. Default: 0.0 + :udc: Converter voltage at the DC side, also called Ud. It is converter`s state variable, result from power flow. The attribute shall be a positive value. Default: 0.0 + ''' + + cgmesProfile = ConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SV.value, ], + 'p': [cgmesProfile.SSH.value, ], + 'q': [cgmesProfile.SSH.value, ], + 'targetPpcc': [cgmesProfile.SSH.value, ], + 'targetUdc': [cgmesProfile.SSH.value, ], + 'baseS': [cgmesProfile.EQ.value, ], + 'idleLoss': [cgmesProfile.EQ.value, ], + 'maxUdc': [cgmesProfile.EQ.value, ], + 'minUdc': [cgmesProfile.EQ.value, ], + 'numberOfValves': [cgmesProfile.EQ.value, ], + 'ratedUdc': [cgmesProfile.EQ.value, ], + 'resistiveLoss': [cgmesProfile.EQ.value, ], + 'switchingLoss': [cgmesProfile.EQ.value, ], + 'valveU0': [cgmesProfile.EQ.value, ], + 'maxP': [cgmesProfile.EQ.value, ], + 'minP': [cgmesProfile.EQ.value, ], + 'PccTerminal': [cgmesProfile.EQ.value, ], + 'DCTerminals': [cgmesProfile.EQ.value, ], + 'idc': [cgmesProfile.SV.value, ], + 'poleLossP': [cgmesProfile.SV.value, ], + 'uc': [cgmesProfile.SV.value, ], + 'udc': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ConductingEquipment: \n' + ConductingEquipment.__doc__ + + def __init__(self, p = 0.0, q = 0.0, targetPpcc = 0.0, targetUdc = 0.0, baseS = 0.0, idleLoss = 0.0, maxUdc = 0.0, minUdc = 0.0, numberOfValves = 0, ratedUdc = 0.0, resistiveLoss = 0.0, switchingLoss = 0.0, valveU0 = 0.0, maxP = 0.0, minP = 0.0, PccTerminal = None, DCTerminals = "list", idc = 0.0, poleLossP = 0.0, uc = 0.0, udc = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.p = p + self.q = q + self.targetPpcc = targetPpcc + self.targetUdc = targetUdc + self.baseS = baseS + self.idleLoss = idleLoss + self.maxUdc = maxUdc + self.minUdc = minUdc + self.numberOfValves = numberOfValves + self.ratedUdc = ratedUdc + self.resistiveLoss = resistiveLoss + self.switchingLoss = switchingLoss + self.valveU0 = valveU0 + self.maxP = maxP + self.minP = minP + self.PccTerminal = PccTerminal + self.DCTerminals = DCTerminals + self.idc = idc + self.poleLossP = poleLossP + self.uc = uc + self.udc = udc + + def __str__(self): + str = 'class=ACDCConverter\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ACDCConverterDCTerminal.py b/cimpy/cgmes_v3_0_0/ACDCConverterDCTerminal.py new file mode 100644 index 00000000..ce7373e8 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ACDCConverterDCTerminal.py @@ -0,0 +1,34 @@ +from .DCBaseTerminal import DCBaseTerminal + + +class ACDCConverterDCTerminal(DCBaseTerminal): + ''' + A DC electrical connection point at the AC/DC converter. The AC/DC converter is electrically connected also to the AC side. The AC connection is inherited from the AC conducting equipment in the same way as any other AC equipment. The AC/DC converter DC terminal is separate from generic DC terminal to restrict the connection with the AC side to AC/DC converter and so that no other DC conducting equipment can be connected to the AC side. + + :DCConductingEquipment: A DC converter terminal belong to an DC converter. Default: None + :polarity: Represents the normal network polarity condition. Depending on the converter configuration the value shall be set as follows: - For a monopole with two converter terminals use DCPolarityKind `positive` and `negative`. - For a bi-pole or symmetric monopole with three converter terminals use DCPolarityKind `positive`, `middle` and `negative`. Default: None + ''' + + cgmesProfile = DCBaseTerminal.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.TP.value, cgmesProfile.EQ.value, ], + 'DCConductingEquipment': [cgmesProfile.EQ.value, ], + 'polarity': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DCBaseTerminal: \n' + DCBaseTerminal.__doc__ + + def __init__(self, DCConductingEquipment = None, polarity = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.DCConductingEquipment = DCConductingEquipment + self.polarity = polarity + + def __str__(self): + str = 'class=ACDCConverterDCTerminal\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ACDCTerminal.py b/cimpy/cgmes_v3_0_0/ACDCTerminal.py new file mode 100644 index 00000000..e94d2723 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ACDCTerminal.py @@ -0,0 +1,43 @@ +from .IdentifiedObject import IdentifiedObject + + +class ACDCTerminal(IdentifiedObject): + ''' + An electrical connection point (AC or DC) to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes. + + :connected: The connected status is related to a bus-branch model and the topological node to terminal relation. True implies the terminal is connected to the related topological node and false implies it is not. In a bus-branch model, the connected status is used to tell if equipment is disconnected without having to change the connectivity described by the topological node to terminal relation. A valid case is that conducting equipment can be connected in one end and open in the other. In particular for an AC line segment, where the reactive line charging can be significant, this is a relevant case. Default: False + :Measurements: Measurements associated with this terminal defining where the measurement is placed in the network topology. It may be used, for instance, to capture the sensor position, such as a voltage transformer (PT) at a busbar or a current transformer (CT) at the bar between a breaker and an isolator. Default: "list" + :sequenceNumber: The orientation of the terminal connections for a multiple terminal conducting equipment. The sequence numbering starts with 1 and additional terminals should follow in increasing order. The first terminal is the `starting point` for a two terminal branch. Default: 0 + :OperationalLimitSet: The operational limit sets at the terminal. Default: "list" + :BusNameMarker: The bus name marker used to name the bus (topological node). Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.TP.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'connected': [cgmesProfile.SSH.value, ], + 'Measurements': [cgmesProfile.OP.value, ], + 'sequenceNumber': [cgmesProfile.EQ.value, ], + 'OperationalLimitSet': [cgmesProfile.EQ.value, ], + 'BusNameMarker': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, connected = False, Measurements = "list", sequenceNumber = 0, OperationalLimitSet = "list", BusNameMarker = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.connected = connected + self.Measurements = Measurements + self.sequenceNumber = sequenceNumber + self.OperationalLimitSet = OperationalLimitSet + self.BusNameMarker = BusNameMarker + + def __str__(self): + str = 'class=ACDCTerminal\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ACLineSegment.py b/cimpy/cgmes_v3_0_0/ACLineSegment.py new file mode 100644 index 00000000..13ed17c9 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ACLineSegment.py @@ -0,0 +1,61 @@ +from .Conductor import Conductor + + +class ACLineSegment(Conductor): + ''' + A wire or combination of wires, with consistent electrical characteristics, building a single electrical system, used to carry alternating current between points in the power system. For symmetrical, transposed three phase lines, it is sufficient to use attributes of the line segment, which describe impedances and admittances for the entire length of the segment. Additionally impedances can be computed by using length and associated per length impedances. The BaseVoltage at the two ends of ACLineSegments in a Line shall have the same BaseVoltage.nominalVoltage. However, boundary lines may have slightly different BaseVoltage.nominalVoltages and variation is allowed. Larger voltage difference in general requires use of an equivalent branch. + + :bch: Positive sequence shunt (charging) susceptance, uniformly distributed, of the entire line section. This value represents the full charging over the full length of the line. Default: 0.0 + :gch: Positive sequence shunt (charging) conductance, uniformly distributed, of the entire line section. Default: 0.0 + :r: Positive sequence series resistance of the entire line section. Default: 0.0 + :x: Positive sequence series reactance of the entire line section. Default: 0.0 + :Clamp: The clamps connected to the line segment. Default: "list" + :Cut: Cuts applied to the line segment. Default: "list" + :b0ch: Zero sequence shunt (charging) susceptance, uniformly distributed, of the entire line section. Default: 0.0 + :g0ch: Zero sequence shunt (charging) conductance, uniformly distributed, of the entire line section. Default: 0.0 + :r0: Zero sequence series resistance of the entire line section. Default: 0.0 + :shortCircuitEndTemperature: Maximum permitted temperature at the end of SC for the calculation of minimum short-circuit currents. Used for short circuit data exchange according to IEC 60909. Default: 0.0 + :x0: Zero sequence series reactance of the entire line section. Default: 0.0 + ''' + + cgmesProfile = Conductor.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'bch': [cgmesProfile.EQ.value, ], + 'gch': [cgmesProfile.EQ.value, ], + 'r': [cgmesProfile.EQ.value, ], + 'x': [cgmesProfile.EQ.value, ], + 'Clamp': [cgmesProfile.EQ.value, ], + 'Cut': [cgmesProfile.EQ.value, ], + 'b0ch': [cgmesProfile.SC.value, ], + 'g0ch': [cgmesProfile.SC.value, ], + 'r0': [cgmesProfile.SC.value, ], + 'shortCircuitEndTemperature': [cgmesProfile.SC.value, ], + 'x0': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Conductor: \n' + Conductor.__doc__ + + def __init__(self, bch = 0.0, gch = 0.0, r = 0.0, x = 0.0, Clamp = "list", Cut = "list", b0ch = 0.0, g0ch = 0.0, r0 = 0.0, shortCircuitEndTemperature = 0.0, x0 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.bch = bch + self.gch = gch + self.r = r + self.x = x + self.Clamp = Clamp + self.Cut = Cut + self.b0ch = b0ch + self.g0ch = g0ch + self.r0 = r0 + self.shortCircuitEndTemperature = shortCircuitEndTemperature + self.x0 = x0 + + def __str__(self): + str = 'class=ACLineSegment\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Accumulator.py b/cimpy/cgmes_v3_0_0/Accumulator.py new file mode 100644 index 00000000..b32a9127 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Accumulator.py @@ -0,0 +1,34 @@ +from .Measurement import Measurement + + +class Accumulator(Measurement): + ''' + Accumulator represents an accumulated (counted) Measurement, e.g. an energy value. + + :AccumulatorValues: The values connected to this measurement. Default: "list" + :LimitSets: A measurement may have zero or more limit ranges defined for it. Default: "list" + ''' + + cgmesProfile = Measurement.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'AccumulatorValues': [cgmesProfile.OP.value, ], + 'LimitSets': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Measurement: \n' + Measurement.__doc__ + + def __init__(self, AccumulatorValues = "list", LimitSets = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.AccumulatorValues = AccumulatorValues + self.LimitSets = LimitSets + + def __str__(self): + str = 'class=Accumulator\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/AccumulatorLimit.py b/cimpy/cgmes_v3_0_0/AccumulatorLimit.py new file mode 100644 index 00000000..91e31ad0 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/AccumulatorLimit.py @@ -0,0 +1,34 @@ +from .Limit import Limit + + +class AccumulatorLimit(Limit): + ''' + Limit values for Accumulator measurements. + + :value: The value to supervise against. The value is positive. Default: 0 + :LimitSet: The set of limits. Default: None + ''' + + cgmesProfile = Limit.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'value': [cgmesProfile.OP.value, ], + 'LimitSet': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Limit: \n' + Limit.__doc__ + + def __init__(self, value = 0, LimitSet = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.value = value + self.LimitSet = LimitSet + + def __str__(self): + str = 'class=AccumulatorLimit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/AccumulatorLimitSet.py b/cimpy/cgmes_v3_0_0/AccumulatorLimitSet.py new file mode 100644 index 00000000..e7cc7abf --- /dev/null +++ b/cimpy/cgmes_v3_0_0/AccumulatorLimitSet.py @@ -0,0 +1,34 @@ +from .LimitSet import LimitSet + + +class AccumulatorLimitSet(LimitSet): + ''' + An AccumulatorLimitSet specifies a set of Limits that are associated with an Accumulator measurement. + + :Measurements: The Measurements using the LimitSet. Default: "list" + :Limits: The limit values used for supervision of Measurements. Default: "list" + ''' + + cgmesProfile = LimitSet.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'Measurements': [cgmesProfile.OP.value, ], + 'Limits': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class LimitSet: \n' + LimitSet.__doc__ + + def __init__(self, Measurements = "list", Limits = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Measurements = Measurements + self.Limits = Limits + + def __str__(self): + str = 'class=AccumulatorLimitSet\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/AccumulatorReset.py b/cimpy/cgmes_v3_0_0/AccumulatorReset.py new file mode 100644 index 00000000..3bc61b0e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/AccumulatorReset.py @@ -0,0 +1,31 @@ +from .Control import Control + + +class AccumulatorReset(Control): + ''' + This command resets the counter value to zero. + + :AccumulatorValue: The accumulator value that is reset by the command. Default: None + ''' + + cgmesProfile = Control.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'AccumulatorValue': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Control: \n' + Control.__doc__ + + def __init__(self, AccumulatorValue = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.AccumulatorValue = AccumulatorValue + + def __str__(self): + str = 'class=AccumulatorReset\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/AccumulatorValue.py b/cimpy/cgmes_v3_0_0/AccumulatorValue.py new file mode 100644 index 00000000..846dbeae --- /dev/null +++ b/cimpy/cgmes_v3_0_0/AccumulatorValue.py @@ -0,0 +1,34 @@ +from .MeasurementValue import MeasurementValue + + +class AccumulatorValue(MeasurementValue): + ''' + AccumulatorValue represents an accumulated (counted) MeasurementValue. + + :Accumulator: Measurement to which this value is connected. Default: None + :AccumulatorReset: The command that resets the accumulator value. Default: None + ''' + + cgmesProfile = MeasurementValue.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'Accumulator': [cgmesProfile.OP.value, ], + 'AccumulatorReset': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class MeasurementValue: \n' + MeasurementValue.__doc__ + + def __init__(self, Accumulator = None, AccumulatorReset = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Accumulator = Accumulator + self.AccumulatorReset = AccumulatorReset + + def __str__(self): + str = 'class=AccumulatorValue\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ActivePower.py b/cimpy/cgmes_v3_0_0/ActivePower.py new file mode 100644 index 00000000..41ddd61c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ActivePower.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class ActivePower(Base): + ''' + Product of RMS value of the voltage and the RMS value of the in-phase component of the current. + + :value: Default: 0.0 + :multiplier: Default: None + :unit: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'value': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'multiplier': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'unit': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, multiplier = None, unit = None, ): + + self.value = value + self.multiplier = multiplier + self.unit = unit + + def __str__(self): + str = 'class=ActivePower\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ActivePowerLimit.py b/cimpy/cgmes_v3_0_0/ActivePowerLimit.py new file mode 100644 index 00000000..43bb4a1f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ActivePowerLimit.py @@ -0,0 +1,34 @@ +from .OperationalLimit import OperationalLimit + + +class ActivePowerLimit(OperationalLimit): + ''' + Limit on active power flow. + + :value: Value of active power limit. The attribute shall be a positive value or zero. Default: 0.0 + :normalValue: The normal value of active power limit. The attribute shall be a positive value or zero. Default: 0.0 + ''' + + cgmesProfile = OperationalLimit.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'value': [cgmesProfile.SSH.value, ], + 'normalValue': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class OperationalLimit: \n' + OperationalLimit.__doc__ + + def __init__(self, value = 0.0, normalValue = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.value = value + self.normalValue = normalValue + + def __str__(self): + str = 'class=ActivePowerLimit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ActivePowerPerCurrentFlow.py b/cimpy/cgmes_v3_0_0/ActivePowerPerCurrentFlow.py new file mode 100644 index 00000000..9af07ca5 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ActivePowerPerCurrentFlow.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class ActivePowerPerCurrentFlow(Base): + ''' + Active power variation with current flow. + + :multiplier: Default: None + :unit: Default: None + :value: Default: 0.0 + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'multiplier': [cgmesProfile.EQ.value, ], + 'unit': [cgmesProfile.EQ.value, ], + 'value': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, multiplier = None, unit = None, value = 0.0, ): + + self.multiplier = multiplier + self.unit = unit + self.value = value + + def __str__(self): + str = 'class=ActivePowerPerCurrentFlow\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ActivePowerPerFrequency.py b/cimpy/cgmes_v3_0_0/ActivePowerPerFrequency.py new file mode 100644 index 00000000..d7eab5a8 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ActivePowerPerFrequency.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class ActivePowerPerFrequency(Base): + ''' + Active power variation with frequency. + + :multiplier: Default: None + :unit: Default: None + :value: Default: 0.0 + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'multiplier': [cgmesProfile.EQ.value, ], + 'unit': [cgmesProfile.EQ.value, ], + 'value': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, multiplier = None, unit = None, value = 0.0, ): + + self.multiplier = multiplier + self.unit = unit + self.value = value + + def __str__(self): + str = 'class=ActivePowerPerFrequency\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Analog.py b/cimpy/cgmes_v3_0_0/Analog.py new file mode 100644 index 00000000..b7417afa --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Analog.py @@ -0,0 +1,37 @@ +from .Measurement import Measurement + + +class Analog(Measurement): + ''' + Analog represents an analog Measurement. + + :positiveFlowIn: If true then this measurement is an active power, reactive power or current with the convention that a positive value measured at the Terminal means power is flowing into the related PowerSystemResource. Default: False + :AnalogValues: The values connected to this measurement. Default: "list" + :LimitSets: A measurement may have zero or more limit ranges defined for it. Default: "list" + ''' + + cgmesProfile = Measurement.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'positiveFlowIn': [cgmesProfile.OP.value, ], + 'AnalogValues': [cgmesProfile.OP.value, ], + 'LimitSets': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Measurement: \n' + Measurement.__doc__ + + def __init__(self, positiveFlowIn = False, AnalogValues = "list", LimitSets = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.positiveFlowIn = positiveFlowIn + self.AnalogValues = AnalogValues + self.LimitSets = LimitSets + + def __str__(self): + str = 'class=Analog\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/AnalogControl.py b/cimpy/cgmes_v3_0_0/AnalogControl.py new file mode 100644 index 00000000..2b6505b4 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/AnalogControl.py @@ -0,0 +1,37 @@ +from .Control import Control + + +class AnalogControl(Control): + ''' + An analog control used for supervisory control. + + :maxValue: Normal value range maximum for any of the Control.value. Used for scaling, e.g. in bar graphs. Default: 0.0 + :minValue: Normal value range minimum for any of the Control.value. Used for scaling, e.g. in bar graphs. Default: 0.0 + :AnalogValue: The MeasurementValue that is controlled. Default: None + ''' + + cgmesProfile = Control.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'maxValue': [cgmesProfile.OP.value, ], + 'minValue': [cgmesProfile.OP.value, ], + 'AnalogValue': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Control: \n' + Control.__doc__ + + def __init__(self, maxValue = 0.0, minValue = 0.0, AnalogValue = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.maxValue = maxValue + self.minValue = minValue + self.AnalogValue = AnalogValue + + def __str__(self): + str = 'class=AnalogControl\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/AnalogLimit.py b/cimpy/cgmes_v3_0_0/AnalogLimit.py new file mode 100644 index 00000000..464f83c8 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/AnalogLimit.py @@ -0,0 +1,34 @@ +from .Limit import Limit + + +class AnalogLimit(Limit): + ''' + Limit values for Analog measurements. + + :value: The value to supervise against. Default: 0.0 + :LimitSet: The set of limits. Default: None + ''' + + cgmesProfile = Limit.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'value': [cgmesProfile.OP.value, ], + 'LimitSet': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Limit: \n' + Limit.__doc__ + + def __init__(self, value = 0.0, LimitSet = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.value = value + self.LimitSet = LimitSet + + def __str__(self): + str = 'class=AnalogLimit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/AnalogLimitSet.py b/cimpy/cgmes_v3_0_0/AnalogLimitSet.py new file mode 100644 index 00000000..5afb9a1a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/AnalogLimitSet.py @@ -0,0 +1,34 @@ +from .LimitSet import LimitSet + + +class AnalogLimitSet(LimitSet): + ''' + An AnalogLimitSet specifies a set of Limits that are associated with an Analog measurement. + + :Measurements: The Measurements using the LimitSet. Default: "list" + :Limits: The limit values used for supervision of Measurements. Default: "list" + ''' + + cgmesProfile = LimitSet.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'Measurements': [cgmesProfile.OP.value, ], + 'Limits': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class LimitSet: \n' + LimitSet.__doc__ + + def __init__(self, Measurements = "list", Limits = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Measurements = Measurements + self.Limits = Limits + + def __str__(self): + str = 'class=AnalogLimitSet\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/AnalogValue.py b/cimpy/cgmes_v3_0_0/AnalogValue.py new file mode 100644 index 00000000..6dffd7f9 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/AnalogValue.py @@ -0,0 +1,34 @@ +from .MeasurementValue import MeasurementValue + + +class AnalogValue(MeasurementValue): + ''' + AnalogValue represents an analog MeasurementValue. + + :Analog: Measurement to which this value is connected. Default: None + :AnalogControl: The Control variable associated with the MeasurementValue. Default: None + ''' + + cgmesProfile = MeasurementValue.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'Analog': [cgmesProfile.OP.value, ], + 'AnalogControl': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class MeasurementValue: \n' + MeasurementValue.__doc__ + + def __init__(self, Analog = None, AnalogControl = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Analog = Analog + self.AnalogControl = AnalogControl + + def __str__(self): + str = 'class=AnalogValue\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/AngleDegrees.py b/cimpy/cgmes_v3_0_0/AngleDegrees.py new file mode 100644 index 00000000..f04bdd95 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/AngleDegrees.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class AngleDegrees(Base): + ''' + Measurement of angle in degrees. + + :value: Default: 0.0 + :unit: Default: None + :multiplier: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.DL.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'value': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.DL.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'unit': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.DL.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'multiplier': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.DL.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, unit = None, multiplier = None, ): + + self.value = value + self.unit = unit + self.multiplier = multiplier + + def __str__(self): + str = 'class=AngleDegrees\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/AngleRadians.py b/cimpy/cgmes_v3_0_0/AngleRadians.py new file mode 100644 index 00000000..9191739c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/AngleRadians.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class AngleRadians(Base): + ''' + Phase angle in radians. + + :value: Default: 0.0 + :unit: Default: None + :multiplier: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, ], + 'value': [cgmesProfile.SSH.value, ], + 'unit': [cgmesProfile.SSH.value, ], + 'multiplier': [cgmesProfile.SSH.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, unit = None, multiplier = None, ): + + self.value = value + self.unit = unit + self.multiplier = multiplier + + def __str__(self): + str = 'class=AngleRadians\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ApparentPower.py b/cimpy/cgmes_v3_0_0/ApparentPower.py new file mode 100644 index 00000000..0d5b6a33 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ApparentPower.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class ApparentPower(Base): + ''' + Product of the RMS value of the voltage and the RMS value of the current. + + :value: Default: 0.0 + :multiplier: Default: None + :unit: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'value': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'multiplier': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'unit': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, multiplier = None, unit = None, ): + + self.value = value + self.multiplier = multiplier + self.unit = unit + + def __str__(self): + str = 'class=ApparentPower\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ApparentPowerLimit.py b/cimpy/cgmes_v3_0_0/ApparentPowerLimit.py new file mode 100644 index 00000000..2559d18c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ApparentPowerLimit.py @@ -0,0 +1,34 @@ +from .OperationalLimit import OperationalLimit + + +class ApparentPowerLimit(OperationalLimit): + ''' + Apparent power limit. + + :value: The apparent power limit. The attribute shall be a positive value or zero. Default: 0.0 + :normalValue: The normal apparent power limit. The attribute shall be a positive value or zero. Default: 0.0 + ''' + + cgmesProfile = OperationalLimit.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'value': [cgmesProfile.SSH.value, ], + 'normalValue': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class OperationalLimit: \n' + OperationalLimit.__doc__ + + def __init__(self, value = 0.0, normalValue = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.value = value + self.normalValue = normalValue + + def __str__(self): + str = 'class=ApparentPowerLimit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Area.py b/cimpy/cgmes_v3_0_0/Area.py new file mode 100644 index 00000000..98325450 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Area.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class Area(Base): + ''' + Area. + + :value: Default: 0.0 + :unit: Default: None + :multiplier: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'value': [cgmesProfile.DY.value, ], + 'unit': [cgmesProfile.DY.value, ], + 'multiplier': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, unit = None, multiplier = None, ): + + self.value = value + self.unit = unit + self.multiplier = multiplier + + def __str__(self): + str = 'class=Area\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/AsynchronousMachine.py b/cimpy/cgmes_v3_0_0/AsynchronousMachine.py new file mode 100644 index 00000000..cee6efb5 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/AsynchronousMachine.py @@ -0,0 +1,61 @@ +from .RotatingMachine import RotatingMachine + + +class AsynchronousMachine(RotatingMachine): + ''' + A rotating machine whose shaft rotates asynchronously with the electrical field. Also known as an induction machine with no external connection to the rotor windings, e.g. squirrel-cage induction machine. + + :AsynchronousMachineDynamics: Asynchronous machine dynamics model used to describe dynamic behaviour of this asynchronous machine. Default: None + :asynchronousMachineType: Indicates the type of Asynchronous Machine (motor or generator). Default: None + :nominalFrequency: Nameplate data indicates if the machine is 50 Hz or 60 Hz. Default: 0.0 + :nominalSpeed: Nameplate data. Depends on the slip and number of pole pairs. Default: 0.0 + :converterFedDrive: Indicates whether the machine is a converter fed drive. Used for short circuit data exchange according to IEC 60909. Default: False + :efficiency: Efficiency of the asynchronous machine at nominal operation as a percentage. Indicator for converter drive motors. Used for short circuit data exchange according to IEC 60909. Default: 0.0 + :iaIrRatio: Ratio of locked-rotor current to the rated current of the motor (Ia/Ir). Used for short circuit data exchange according to IEC 60909. Default: 0.0 + :polePairNumber: Number of pole pairs of stator. Used for short circuit data exchange according to IEC 60909. Default: 0 + :ratedMechanicalPower: Rated mechanical power (Pr in IEC 60909-0). Used for short circuit data exchange according to IEC 60909. Default: 0.0 + :reversible: Indicates for converter drive motors if the power can be reversible. Used for short circuit data exchange according to IEC 60909. Default: False + :rxLockedRotorRatio: Locked rotor ratio (R/X). Used for short circuit data exchange according to IEC 60909. Default: 0.0 + ''' + + cgmesProfile = RotatingMachine.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'AsynchronousMachineDynamics': [cgmesProfile.DY.value, ], + 'asynchronousMachineType': [cgmesProfile.SSH.value, ], + 'nominalFrequency': [cgmesProfile.EQ.value, ], + 'nominalSpeed': [cgmesProfile.EQ.value, ], + 'converterFedDrive': [cgmesProfile.SC.value, ], + 'efficiency': [cgmesProfile.SC.value, ], + 'iaIrRatio': [cgmesProfile.SC.value, ], + 'polePairNumber': [cgmesProfile.SC.value, ], + 'ratedMechanicalPower': [cgmesProfile.SC.value, ], + 'reversible': [cgmesProfile.SC.value, ], + 'rxLockedRotorRatio': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class RotatingMachine: \n' + RotatingMachine.__doc__ + + def __init__(self, AsynchronousMachineDynamics = None, asynchronousMachineType = None, nominalFrequency = 0.0, nominalSpeed = 0.0, converterFedDrive = False, efficiency = 0.0, iaIrRatio = 0.0, polePairNumber = 0, ratedMechanicalPower = 0.0, reversible = False, rxLockedRotorRatio = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.AsynchronousMachineDynamics = AsynchronousMachineDynamics + self.asynchronousMachineType = asynchronousMachineType + self.nominalFrequency = nominalFrequency + self.nominalSpeed = nominalSpeed + self.converterFedDrive = converterFedDrive + self.efficiency = efficiency + self.iaIrRatio = iaIrRatio + self.polePairNumber = polePairNumber + self.ratedMechanicalPower = ratedMechanicalPower + self.reversible = reversible + self.rxLockedRotorRatio = rxLockedRotorRatio + + def __str__(self): + str = 'class=AsynchronousMachine\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/AsynchronousMachineDynamics.py b/cimpy/cgmes_v3_0_0/AsynchronousMachineDynamics.py new file mode 100644 index 00000000..cce15c27 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/AsynchronousMachineDynamics.py @@ -0,0 +1,40 @@ +from .RotatingMachineDynamics import RotatingMachineDynamics + + +class AsynchronousMachineDynamics(RotatingMachineDynamics): + ''' + Asynchronous machine whose behaviour is described by reference to a standard model expressed in either time constant reactance form or equivalent circuit form or by definition of a user-defined model. Parameter details:
  1. Asynchronous machine parameters such as Xl, Xs, etc. are actually used as inductances in the model, but are commonly referred to as reactances since, at nominal frequency, the PU values are the same. However, some references use the symbol L instead of X.
+ + :AsynchronousMachine: Asynchronous machine to which this asynchronous machine dynamics model applies. Default: None + :TurbineGovernorDynamics: Turbine-governor model associated with this asynchronous machine model. Default: None + :MechanicalLoadDynamics: Mechanical load model associated with this asynchronous machine model. Default: None + :WindTurbineType1or2Dynamics: Wind generator type 1 or type 2 model associated with this asynchronous machine model. Default: None + ''' + + cgmesProfile = RotatingMachineDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'AsynchronousMachine': [cgmesProfile.DY.value, ], + 'TurbineGovernorDynamics': [cgmesProfile.DY.value, ], + 'MechanicalLoadDynamics': [cgmesProfile.DY.value, ], + 'WindTurbineType1or2Dynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class RotatingMachineDynamics: \n' + RotatingMachineDynamics.__doc__ + + def __init__(self, AsynchronousMachine = None, TurbineGovernorDynamics = None, MechanicalLoadDynamics = None, WindTurbineType1or2Dynamics = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.AsynchronousMachine = AsynchronousMachine + self.TurbineGovernorDynamics = TurbineGovernorDynamics + self.MechanicalLoadDynamics = MechanicalLoadDynamics + self.WindTurbineType1or2Dynamics = WindTurbineType1or2Dynamics + + def __str__(self): + str = 'class=AsynchronousMachineDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/AsynchronousMachineEquivalentCircuit.py b/cimpy/cgmes_v3_0_0/AsynchronousMachineEquivalentCircuit.py new file mode 100644 index 00000000..b63d0e80 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/AsynchronousMachineEquivalentCircuit.py @@ -0,0 +1,43 @@ +from .AsynchronousMachineDynamics import AsynchronousMachineDynamics + + +class AsynchronousMachineEquivalentCircuit(AsynchronousMachineDynamics): + ''' + The electrical equations of all variations of the asynchronous model are based on the AsynchronousEquivalentCircuit diagram for the direct- and quadrature- axes, with two equivalent rotor windings in each axis. Equations for conversion between equivalent circuit and time constant reactance forms: Xs = Xm + Xl X' = Xl + Xm x Xlr1 / (Xm + Xlr1) X'' = Xl + Xm x Xlr1 x Xlr2 / (Xm x Xlr1 + Xm x Xlr2 + Xlr1 x Xlr2) T'o = (Xm + Xlr1) / (omega0 x Rr1) T''o = (Xm x Xlr1 + Xm x Xlr2 + Xlr1 x Xlr2) / (omega0 x Rr2 x (Xm + Xlr1) Same equations using CIM attributes from AsynchronousMachineTimeConstantReactance class on left of "=" and AsynchronousMachineEquivalentCircuit class on right (except as noted): xs = xm + RotatingMachineDynamics.statorLeakageReactance xp = RotatingMachineDynamics.statorLeakageReactance + xm x xlr1 / (xm + xlr1) xpp = RotatingMachineDynamics.statorLeakageReactance + xm x xlr1 x xlr2 / (xm x xlr1 + xm x xlr2 + xlr1 x xlr2) tpo = (xm + xlr1) / (2 x pi x nominal frequency x rr1) tppo = (xm x xlr1 + xm x xlr2 + xlr1 x xlr2) / (2 x pi x nominal frequency x rr2 x (xm + xlr1). + + :xm: Magnetizing reactance. Default: 0.0 + :rr1: Damper 1 winding resistance. Default: 0.0 + :xlr1: Damper 1 winding leakage reactance. Default: 0.0 + :rr2: Damper 2 winding resistance. Default: 0.0 + :xlr2: Damper 2 winding leakage reactance. Default: 0.0 + ''' + + cgmesProfile = AsynchronousMachineDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'xm': [cgmesProfile.DY.value, ], + 'rr1': [cgmesProfile.DY.value, ], + 'xlr1': [cgmesProfile.DY.value, ], + 'rr2': [cgmesProfile.DY.value, ], + 'xlr2': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class AsynchronousMachineDynamics: \n' + AsynchronousMachineDynamics.__doc__ + + def __init__(self, xm = 0.0, rr1 = 0.0, xlr1 = 0.0, rr2 = 0.0, xlr2 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.xm = xm + self.rr1 = rr1 + self.xlr1 = xlr1 + self.rr2 = rr2 + self.xlr2 = xlr2 + + def __str__(self): + str = 'class=AsynchronousMachineEquivalentCircuit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/AsynchronousMachineKind.py b/cimpy/cgmes_v3_0_0/AsynchronousMachineKind.py new file mode 100644 index 00000000..68e19be3 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/AsynchronousMachineKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class AsynchronousMachineKind(Base): + ''' + Kind of Asynchronous Machine. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=AsynchronousMachineKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/AsynchronousMachineTimeConstantReactance.py b/cimpy/cgmes_v3_0_0/AsynchronousMachineTimeConstantReactance.py new file mode 100644 index 00000000..d33768cd --- /dev/null +++ b/cimpy/cgmes_v3_0_0/AsynchronousMachineTimeConstantReactance.py @@ -0,0 +1,43 @@ +from .AsynchronousMachineDynamics import AsynchronousMachineDynamics + + +class AsynchronousMachineTimeConstantReactance(AsynchronousMachineDynamics): + ''' + Parameter details:
  1. If X'' = X', a single cage (one equivalent rotor winding per axis) is modelled.
  2. The "p" in the attribute names is a substitution for a "prime" in the usual parameter notation, e.g. tpo refers to T'o.
The parameters used for models expressed in time constant reactance form include: - RotatingMachine.ratedS (MVAbase); - RotatingMachineDynamics.damping (D); - RotatingMachineDynamics.inertia (H); - RotatingMachineDynamics.saturationFactor (S1); - RotatingMachineDynamics.saturationFactor120 (S12); - RotatingMachineDynamics.statorLeakageReactance (Xl); - RotatingMachineDynamics.statorResistance (Rs); - .xs (Xs); - .xp (X'); - .xpp (X''); - .tpo (T'o); - .tppo (T''o). + + :xs: Synchronous reactance (Xs) (>= AsynchronousMachineTimeConstantReactance.xp). Typical value = 1,8. Default: 0.0 + :xp: Transient reactance (unsaturated) (X`) (>= AsynchronousMachineTimeConstantReactance.xpp). Typical value = 0,5. Default: 0.0 + :xpp: Subtransient reactance (unsaturated) (X``) (> RotatingMachineDynamics.statorLeakageReactance). Typical value = 0,2. Default: 0.0 + :tpo: Transient rotor time constant (T`o) (> AsynchronousMachineTimeConstantReactance.tppo). Typical value = 5. Default: 0 + :tppo: Subtransient rotor time constant (T``o) (> 0). Typical value = 0,03. Default: 0 + ''' + + cgmesProfile = AsynchronousMachineDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'xs': [cgmesProfile.DY.value, ], + 'xp': [cgmesProfile.DY.value, ], + 'xpp': [cgmesProfile.DY.value, ], + 'tpo': [cgmesProfile.DY.value, ], + 'tppo': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class AsynchronousMachineDynamics: \n' + AsynchronousMachineDynamics.__doc__ + + def __init__(self, xs = 0.0, xp = 0.0, xpp = 0.0, tpo = 0, tppo = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.xs = xs + self.xp = xp + self.xpp = xpp + self.tpo = tpo + self.tppo = tppo + + def __str__(self): + str = 'class=AsynchronousMachineTimeConstantReactance\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/AsynchronousMachineUserDefined.py b/cimpy/cgmes_v3_0_0/AsynchronousMachineUserDefined.py new file mode 100644 index 00000000..8e2c6a22 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/AsynchronousMachineUserDefined.py @@ -0,0 +1,34 @@ +from .AsynchronousMachineDynamics import AsynchronousMachineDynamics + + +class AsynchronousMachineUserDefined(AsynchronousMachineDynamics): + ''' + Asynchronous machine whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = AsynchronousMachineDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class AsynchronousMachineDynamics: \n' + AsynchronousMachineDynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=AsynchronousMachineUserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/AuxiliaryEquipment.py b/cimpy/cgmes_v3_0_0/AuxiliaryEquipment.py new file mode 100644 index 00000000..a46bbe47 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/AuxiliaryEquipment.py @@ -0,0 +1,31 @@ +from .Equipment import Equipment + + +class AuxiliaryEquipment(Equipment): + ''' + AuxiliaryEquipment describe equipment that is not performing any primary functions but support for the equipment performing the primary function. AuxiliaryEquipment is attached to primary equipment via an association with Terminal. + + :Terminal: The Terminal at the equipment where the AuxiliaryEquipment is attached. Default: None + ''' + + cgmesProfile = Equipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'Terminal': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Equipment: \n' + Equipment.__doc__ + + def __init__(self, Terminal = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Terminal = Terminal + + def __str__(self): + str = 'class=AuxiliaryEquipment\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Base.py b/cimpy/cgmes_v3_0_0/Base.py new file mode 100644 index 00000000..f7da68c9 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Base.py @@ -0,0 +1,65 @@ +from enum import Enum + +short_profile_name = { + "Equipment": "EQ", + "SteadyStateHypothesis": "SSH", + "Topology": "TP", + "StateVariables": "SV", + "Dynamics": "DY", + "GeographicalLocation": "GL", + "DiagramLayout": 'DL', + "Operation": 'OP', + "ShortCircuit": 'SC', + "EquipmentBoundary": 'EQBD' +} + +long_profile_name = { + "EQ": "Equipment", + "SSH": "SteadyStateHypothesis", + "TP": "Topology", + "SV": "StateVariables", + "DY": "Dynamics", + "GL": "GeographicalLocation", + "DL": "DiagramLayout", + "OP": "Operation", + "SC": "ShortCircuit", + "EQBD": "EquipmentBoundary" +} + + +class Profile (Enum): + """ Enum containing all CGMES profiles and their export priority. + """ + EQ = 0 + SSH = 1 + TP = 2 + SV = 3 + DY = 4 + GL = 5 + DL = 6 + OP = 7 + SC = 8 + EQBD = 9 + + def long_name(self): + """Testdocumentation + """ + return long_profile_name[self.name] + + @classmethod + def from_long_name(cls, long_name): + return cls[short_profile_name[long_name]] + + +class Base(): + """ + Base Class for CIM + """ + + cgmesProfile = Enum("cgmesProfile", {"EQ": 0, "SSH": 1, "TP": 2, "SV": 3, "DY": 4, "GL": 5, "DL": 6, "OP": 7, "SC": 8, "EQBD": 9}) + + def __init__(self, *args, **kw_args): + pass + + def printxml(self, dict={}): + return dict diff --git a/cimpy/cgmes_v3_0_0/BaseVoltage.py b/cimpy/cgmes_v3_0_0/BaseVoltage.py new file mode 100644 index 00000000..135be49b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/BaseVoltage.py @@ -0,0 +1,43 @@ +from .IdentifiedObject import IdentifiedObject + + +class BaseVoltage(IdentifiedObject): + ''' + Defines a system base voltage which is referenced. + + :TopologicalNode: The topological nodes at the base voltage. Default: "list" + :nominalVoltage: The power system resource`s base voltage. Shall be a positive value and not zero. Default: 0.0 + :ConductingEquipment: All conducting equipment with this base voltage. Use only when there is no voltage level container used and only one base voltage applies. For example, not used for transformers. Default: "list" + :VoltageLevel: The voltage levels having this base voltage. Default: "list" + :TransformerEnds: Transformer ends at the base voltage. This is essential for PU calculation. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.TP.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'TopologicalNode': [cgmesProfile.TP.value, ], + 'nominalVoltage': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'ConductingEquipment': [cgmesProfile.EQ.value, ], + 'VoltageLevel': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'TransformerEnds': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, TopologicalNode = "list", nominalVoltage = 0.0, ConductingEquipment = "list", VoltageLevel = "list", TransformerEnds = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.TopologicalNode = TopologicalNode + self.nominalVoltage = nominalVoltage + self.ConductingEquipment = ConductingEquipment + self.VoltageLevel = VoltageLevel + self.TransformerEnds = TransformerEnds + + def __str__(self): + str = 'class=BaseVoltage\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/BasicIntervalSchedule.py b/cimpy/cgmes_v3_0_0/BasicIntervalSchedule.py new file mode 100644 index 00000000..4f0c4817 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/BasicIntervalSchedule.py @@ -0,0 +1,37 @@ +from .IdentifiedObject import IdentifiedObject + + +class BasicIntervalSchedule(IdentifiedObject): + ''' + Schedule of values at points in time. + + :startTime: The time for the first time point. The value can be a time of day, not a specific date. Default: '' + :value1Unit: Value1 units of measure. Default: None + :value2Unit: Value2 units of measure. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'startTime': [cgmesProfile.EQ.value, ], + 'value1Unit': [cgmesProfile.EQ.value, ], + 'value2Unit': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, startTime = '', value1Unit = None, value2Unit = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.startTime = startTime + self.value1Unit = value1Unit + self.value2Unit = value2Unit + + def __str__(self): + str = 'class=BasicIntervalSchedule\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/BatteryStateKind.py b/cimpy/cgmes_v3_0_0/BatteryStateKind.py new file mode 100644 index 00000000..4d7bff78 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/BatteryStateKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class BatteryStateKind(Base): + ''' + The state of the battery unit. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=BatteryStateKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/BatteryUnit.py b/cimpy/cgmes_v3_0_0/BatteryUnit.py new file mode 100644 index 00000000..eff38951 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/BatteryUnit.py @@ -0,0 +1,37 @@ +from .PowerElectronicsUnit import PowerElectronicsUnit + + +class BatteryUnit(PowerElectronicsUnit): + ''' + An electrochemical energy storage device. + + :batteryState: The current state of the battery (charging, full, etc.). Default: None + :storedE: Amount of energy currently stored. The attribute shall be a positive value or zero and lower than BatteryUnit.ratedE. Default: 0.0 + :ratedE: Full energy storage capacity of the battery. The attribute shall be a positive value. Default: 0.0 + ''' + + cgmesProfile = PowerElectronicsUnit.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'batteryState': [cgmesProfile.SSH.value, ], + 'storedE': [cgmesProfile.SSH.value, ], + 'ratedE': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerElectronicsUnit: \n' + PowerElectronicsUnit.__doc__ + + def __init__(self, batteryState = None, storedE = 0.0, ratedE = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.batteryState = batteryState + self.storedE = storedE + self.ratedE = ratedE + + def __str__(self): + str = 'class=BatteryUnit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Bay.py b/cimpy/cgmes_v3_0_0/Bay.py new file mode 100644 index 00000000..bc78e83e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Bay.py @@ -0,0 +1,31 @@ +from .EquipmentContainer import EquipmentContainer + + +class Bay(EquipmentContainer): + ''' + A collection of power system resources (within a given substation) including conducting equipment, protection relays, measurements, and telemetry. A bay typically represents a physical grouping related to modularization of equipment. + + :VoltageLevel: The voltage level containing this bay. Default: None + ''' + + cgmesProfile = EquipmentContainer.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'VoltageLevel': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EquipmentContainer: \n' + EquipmentContainer.__doc__ + + def __init__(self, VoltageLevel = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.VoltageLevel = VoltageLevel + + def __str__(self): + str = 'class=Bay\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Boolean.py b/cimpy/cgmes_v3_0_0/Boolean.py new file mode 100644 index 00000000..d4ddadfa --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Boolean.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class Boolean(Base): + ''' + A type with the value space "true" and "false". + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.GL.value, cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.DL.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=Boolean\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/BoundaryPoint.py b/cimpy/cgmes_v3_0_0/BoundaryPoint.py new file mode 100644 index 00000000..fe369a35 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/BoundaryPoint.py @@ -0,0 +1,55 @@ +from .PowerSystemResource import PowerSystemResource + + +class BoundaryPoint(PowerSystemResource): + ''' + Designates a connection point at which one or more model authority sets shall connect to. The location of the connection point as well as other properties are agreed between organisations responsible for the interconnection, hence all attributes of the class represent this agreement. It is primarily used in a boundary model authority set which can contain one or many BoundaryPoint-s among other Equipment-s and their connections. + + :fromEndIsoCode: The ISO code of the region which the `From` side of the Boundary point belongs to or it is connected to. The ISO code is a two-character country code as defined by ISO 3166 (http://www.iso.org/iso/country_codes). The length of the string is 2 characters maximum. Default: '' + :fromEndName: A human readable name with length of the string 64 characters maximum. It covers the following two cases: -if the Boundary point is placed on a tie-line, it is the name (IdentifiedObject.name) of the substation at which the `From` side of the tie-line is connected to. -if the Boundary point is placed in a substation, it is the name (IdentifiedObject.name) of the element (e.g. PowerTransformer, ACLineSegment, Switch, etc.) at which the `From` side of the Boundary point is connected to. Default: '' + :fromEndNameTso: Identifies the name of the transmission system operator, distribution system operator or other entity at which the `From` side of the interconnection is connected to. The length of the string is 64 characters maximum. Default: '' + :toEndIsoCode: The ISO code of the region which the `To` side of the Boundary point belongs to or is connected to. The ISO code is a two-character country code as defined by ISO 3166 (http://www.iso.org/iso/country_codes). The length of the string is 2 characters maximum. Default: '' + :toEndName: A human readable name with length of the string 64 characters maximum. It covers the following two cases: -if the Boundary point is placed on a tie-line, it is the name (IdentifiedObject.name) of the substation at which the `To` side of the tie-line is connected to. -if the Boundary point is placed in a substation, it is the name (IdentifiedObject.name) of the element (e.g. PowerTransformer, ACLineSegment, Switch, etc.) at which the `To` side of the Boundary point is connected to. Default: '' + :toEndNameTso: Identifies the name of the transmission system operator, distribution system operator or other entity at which the `To` side of the interconnection is connected to. The length of the string is 64 characters maximum. Default: '' + :isDirectCurrent: If true, this boundary point is a point of common coupling (PCC) of a direct current (DC) interconnection, otherwise the interconnection is AC (default). Default: False + :isExcludedFromAreaInterchange: If true, this boundary point is on the interconnection that is excluded from control area interchange calculation and consequently has no related tie flows. Otherwise, the interconnection is included in control area interchange and a TieFlow is required at all sides of the boundary point (default). Default: False + :ConnectivityNode: The connectivity node that is designated as a boundary point. Default: None + ''' + + cgmesProfile = PowerSystemResource.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'fromEndIsoCode': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'fromEndName': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'fromEndNameTso': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'toEndIsoCode': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'toEndName': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'toEndNameTso': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'isDirectCurrent': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'isExcludedFromAreaInterchange': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'ConnectivityNode': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemResource: \n' + PowerSystemResource.__doc__ + + def __init__(self, fromEndIsoCode = '', fromEndName = '', fromEndNameTso = '', toEndIsoCode = '', toEndName = '', toEndNameTso = '', isDirectCurrent = False, isExcludedFromAreaInterchange = False, ConnectivityNode = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.fromEndIsoCode = fromEndIsoCode + self.fromEndName = fromEndName + self.fromEndNameTso = fromEndNameTso + self.toEndIsoCode = toEndIsoCode + self.toEndName = toEndName + self.toEndNameTso = toEndNameTso + self.isDirectCurrent = isDirectCurrent + self.isExcludedFromAreaInterchange = isExcludedFromAreaInterchange + self.ConnectivityNode = ConnectivityNode + + def __str__(self): + str = 'class=BoundaryPoint\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Breaker.py b/cimpy/cgmes_v3_0_0/Breaker.py new file mode 100644 index 00000000..f509acb0 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Breaker.py @@ -0,0 +1,29 @@ +from .ProtectedSwitch import ProtectedSwitch + + +class Breaker(ProtectedSwitch): + ''' + A mechanical switching device capable of making, carrying, and breaking currents under normal circuit conditions and also making, carrying for a specified time, and breaking currents under specified abnormal circuit conditions e.g. those of short circuit. + + ''' + + cgmesProfile = ProtectedSwitch.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ProtectedSwitch: \n' + ProtectedSwitch.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=Breaker\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/BusNameMarker.py b/cimpy/cgmes_v3_0_0/BusNameMarker.py new file mode 100644 index 00000000..b585ece9 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/BusNameMarker.py @@ -0,0 +1,37 @@ +from .IdentifiedObject import IdentifiedObject + + +class BusNameMarker(IdentifiedObject): + ''' + Used to apply user standard names to TopologicalNodes. Associated with one or more terminals that are normally connected with the bus name. The associated terminals are normally connected by non-retained switches. For a ring bus station configuration, all BusbarSection terminals in the ring are typically associated. For a breaker and a half scheme, both BusbarSections would normally be associated. For a ring bus, all BusbarSections would normally be associated. For a "straight" busbar configuration, normally only the main terminal at the BusbarSection would be associated. + + :Terminal: The terminals associated with this bus name marker. Default: "list" + :priority: Priority of bus name marker for use as topology bus name. Use 0 for do not care. Use 1 for highest priority. Use 2 as priority is less than 1 and so on. Default: 0 + :ReportingGroup: The reporting group to which this bus name marker belongs. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'Terminal': [cgmesProfile.EQ.value, ], + 'priority': [cgmesProfile.EQ.value, ], + 'ReportingGroup': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, Terminal = "list", priority = 0, ReportingGroup = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Terminal = Terminal + self.priority = priority + self.ReportingGroup = ReportingGroup + + def __str__(self): + str = 'class=BusNameMarker\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/BusbarSection.py b/cimpy/cgmes_v3_0_0/BusbarSection.py new file mode 100644 index 00000000..a5546277 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/BusbarSection.py @@ -0,0 +1,31 @@ +from .Connector import Connector + + +class BusbarSection(Connector): + ''' + A conductor, or group of conductors, with negligible impedance, that serve to connect other conducting equipment within a single substation. Voltage measurements are typically obtained from voltage transformers that are connected to busbar sections. A bus bar section may have many physical terminals but for analysis is modelled with exactly one logical terminal. + + :ipMax: Maximum allowable peak short-circuit current of busbar (Ipmax in IEC 60909-0). Mechanical limit of the busbar in the substation itself. Used for short circuit data exchange according to IEC 60909. Default: 0.0 + ''' + + cgmesProfile = Connector.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'ipMax': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Connector: \n' + Connector.__doc__ + + def __init__(self, ipMax = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ipMax = ipMax + + def __str__(self): + str = 'class=BusbarSection\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/CAESPlant.py b/cimpy/cgmes_v3_0_0/CAESPlant.py new file mode 100644 index 00000000..3c18e016 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/CAESPlant.py @@ -0,0 +1,31 @@ +from .PowerSystemResource import PowerSystemResource + + +class CAESPlant(PowerSystemResource): + ''' + Compressed air energy storage plant. + + :ThermalGeneratingUnit: A thermal generating unit may be a member of a compressed air energy storage plant. Default: None + ''' + + cgmesProfile = PowerSystemResource.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'ThermalGeneratingUnit': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemResource: \n' + PowerSystemResource.__doc__ + + def __init__(self, ThermalGeneratingUnit = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ThermalGeneratingUnit = ThermalGeneratingUnit + + def __str__(self): + str = 'class=CAESPlant\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/CSCDynamics.py b/cimpy/cgmes_v3_0_0/CSCDynamics.py new file mode 100644 index 00000000..7648be3d --- /dev/null +++ b/cimpy/cgmes_v3_0_0/CSCDynamics.py @@ -0,0 +1,31 @@ +from .HVDCDynamics import HVDCDynamics + + +class CSCDynamics(HVDCDynamics): + ''' + CSC function block whose behaviour is described by reference to a standard model or by definition of a user-defined model. + + :CSConverter: Current source converter to which current source converter dynamics model applies. Default: None + ''' + + cgmesProfile = HVDCDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'CSConverter': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class HVDCDynamics: \n' + HVDCDynamics.__doc__ + + def __init__(self, CSConverter = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.CSConverter = CSConverter + + def __str__(self): + str = 'class=CSCDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/CSCUserDefined.py b/cimpy/cgmes_v3_0_0/CSCUserDefined.py new file mode 100644 index 00000000..59a131f0 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/CSCUserDefined.py @@ -0,0 +1,34 @@ +from .CSCDynamics import CSCDynamics + + +class CSCUserDefined(CSCDynamics): + ''' + Current source converter (CSC) function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = CSCDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class CSCDynamics: \n' + CSCDynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=CSCUserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Capacitance.py b/cimpy/cgmes_v3_0_0/Capacitance.py new file mode 100644 index 00000000..59be872a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Capacitance.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class Capacitance(Base): + ''' + Capacitive part of reactance (imaginary part of impedance), at rated frequency. + + :value: Default: 0.0 + :unit: Default: None + :multiplier: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'value': [cgmesProfile.EQ.value, ], + 'unit': [cgmesProfile.EQ.value, ], + 'multiplier': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, unit = None, multiplier = None, ): + + self.value = value + self.unit = unit + self.multiplier = multiplier + + def __str__(self): + str = 'class=Capacitance\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Clamp.py b/cimpy/cgmes_v3_0_0/Clamp.py new file mode 100644 index 00000000..56e95027 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Clamp.py @@ -0,0 +1,34 @@ +from .ConductingEquipment import ConductingEquipment + + +class Clamp(ConductingEquipment): + ''' + A Clamp is a galvanic connection at a line segment where other equipment is connected. A Clamp does not cut the line segment. A Clamp is ConductingEquipment and has one Terminal with an associated ConnectivityNode. Any other ConductingEquipment can be connected to the Clamp ConnectivityNode. + + :ACLineSegment: The line segment to which the clamp is connected. Default: None + :lengthFromTerminal1: The length to the place where the clamp is located starting from side one of the line segment, i.e. the line segment terminal with sequence number equal to 1. Default: 0.0 + ''' + + cgmesProfile = ConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'ACLineSegment': [cgmesProfile.EQ.value, ], + 'lengthFromTerminal1': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ConductingEquipment: \n' + ConductingEquipment.__doc__ + + def __init__(self, ACLineSegment = None, lengthFromTerminal1 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ACLineSegment = ACLineSegment + self.lengthFromTerminal1 = lengthFromTerminal1 + + def __str__(self): + str = 'class=Clamp\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/CogenerationPlant.py b/cimpy/cgmes_v3_0_0/CogenerationPlant.py new file mode 100644 index 00000000..5b277bb0 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/CogenerationPlant.py @@ -0,0 +1,31 @@ +from .PowerSystemResource import PowerSystemResource + + +class CogenerationPlant(PowerSystemResource): + ''' + A set of thermal generating units for the production of electrical energy and process steam (usually from the output of the steam turbines). The steam sendout is typically used for industrial purposes or for municipal heating and cooling. + + :ThermalGeneratingUnits: A thermal generating unit may be a member of a cogeneration plant. Default: "list" + ''' + + cgmesProfile = PowerSystemResource.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'ThermalGeneratingUnits': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemResource: \n' + PowerSystemResource.__doc__ + + def __init__(self, ThermalGeneratingUnits = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ThermalGeneratingUnits = ThermalGeneratingUnits + + def __str__(self): + str = 'class=CogenerationPlant\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/CombinedCyclePlant.py b/cimpy/cgmes_v3_0_0/CombinedCyclePlant.py new file mode 100644 index 00000000..f50432c5 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/CombinedCyclePlant.py @@ -0,0 +1,31 @@ +from .PowerSystemResource import PowerSystemResource + + +class CombinedCyclePlant(PowerSystemResource): + ''' + A set of combustion turbines and steam turbines where the exhaust heat from the combustion turbines is recovered to make steam for the steam turbines, resulting in greater overall plant efficiency. + + :ThermalGeneratingUnits: A thermal generating unit may be a member of a combined cycle plant. Default: "list" + ''' + + cgmesProfile = PowerSystemResource.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'ThermalGeneratingUnits': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemResource: \n' + PowerSystemResource.__doc__ + + def __init__(self, ThermalGeneratingUnits = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ThermalGeneratingUnits = ThermalGeneratingUnits + + def __str__(self): + str = 'class=CombinedCyclePlant\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Command.py b/cimpy/cgmes_v3_0_0/Command.py new file mode 100644 index 00000000..e35cfb1b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Command.py @@ -0,0 +1,40 @@ +from .Control import Control + + +class Command(Control): + ''' + A Command is a discrete control used for supervisory control. + + :normalValue: Normal value for Control.value e.g. used for percentage scaling. Default: 0 + :value: The value representing the actuator output. Default: 0 + :ValueAliasSet: The ValueAliasSet used for translation of a Control value to a name. Default: None + :DiscreteValue: The MeasurementValue that is controlled. Default: None + ''' + + cgmesProfile = Control.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'normalValue': [cgmesProfile.OP.value, ], + 'value': [cgmesProfile.OP.value, ], + 'ValueAliasSet': [cgmesProfile.OP.value, ], + 'DiscreteValue': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Control: \n' + Control.__doc__ + + def __init__(self, normalValue = 0, value = 0, ValueAliasSet = None, DiscreteValue = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.normalValue = normalValue + self.value = value + self.ValueAliasSet = ValueAliasSet + self.DiscreteValue = DiscreteValue + + def __str__(self): + str = 'class=Command\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Conductance.py b/cimpy/cgmes_v3_0_0/Conductance.py new file mode 100644 index 00000000..a7aa226a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Conductance.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class Conductance(Base): + ''' + Factor by which voltage must be multiplied to give corresponding power lost from a circuit. Real part of admittance. + + :value: Default: 0.0 + :unit: Default: None + :multiplier: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'value': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'unit': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'multiplier': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, unit = None, multiplier = None, ): + + self.value = value + self.unit = unit + self.multiplier = multiplier + + def __str__(self): + str = 'class=Conductance\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ConductingEquipment.py b/cimpy/cgmes_v3_0_0/ConductingEquipment.py new file mode 100644 index 00000000..87d31744 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ConductingEquipment.py @@ -0,0 +1,37 @@ +from .Equipment import Equipment + + +class ConductingEquipment(Equipment): + ''' + The parts of the AC power system that are designed to carry current or that are conductively connected through terminals. + + :Terminals: Conducting equipment have terminals that may be connected to other conducting equipment terminals via connectivity nodes or topological nodes. Default: "list" + :BaseVoltage: Base voltage of this conducting equipment. Use only when there is no voltage level container used and only one base voltage applies. For example, not used for transformers. Default: None + :SvStatus: The status state variable associated with this conducting equipment. Default: None + ''' + + cgmesProfile = Equipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'Terminals': [cgmesProfile.DY.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'BaseVoltage': [cgmesProfile.EQ.value, ], + 'SvStatus': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Equipment: \n' + Equipment.__doc__ + + def __init__(self, Terminals = "list", BaseVoltage = None, SvStatus = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Terminals = Terminals + self.BaseVoltage = BaseVoltage + self.SvStatus = SvStatus + + def __str__(self): + str = 'class=ConductingEquipment\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Conductor.py b/cimpy/cgmes_v3_0_0/Conductor.py new file mode 100644 index 00000000..3955658d --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Conductor.py @@ -0,0 +1,31 @@ +from .ConductingEquipment import ConductingEquipment + + +class Conductor(ConductingEquipment): + ''' + Combination of conducting material with consistent electrical characteristics, building a single electrical system, used to carry current between points in the power system. + + :length: Segment length for calculating line section capabilities. Default: 0.0 + ''' + + cgmesProfile = ConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'length': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ConductingEquipment: \n' + ConductingEquipment.__doc__ + + def __init__(self, length = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.length = length + + def __str__(self): + str = 'class=Conductor\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ConformLoad.py b/cimpy/cgmes_v3_0_0/ConformLoad.py new file mode 100644 index 00000000..8c69834b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ConformLoad.py @@ -0,0 +1,31 @@ +from .EnergyConsumer import EnergyConsumer + + +class ConformLoad(EnergyConsumer): + ''' + ConformLoad represent loads that follow a daily load change pattern where the pattern can be used to scale the load with a system load. + + :LoadGroup: Group of this ConformLoad. Default: None + ''' + + cgmesProfile = EnergyConsumer.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'LoadGroup': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EnergyConsumer: \n' + EnergyConsumer.__doc__ + + def __init__(self, LoadGroup = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.LoadGroup = LoadGroup + + def __str__(self): + str = 'class=ConformLoad\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ConformLoadGroup.py b/cimpy/cgmes_v3_0_0/ConformLoadGroup.py new file mode 100644 index 00000000..74ed34cf --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ConformLoadGroup.py @@ -0,0 +1,34 @@ +from .LoadGroup import LoadGroup + + +class ConformLoadGroup(LoadGroup): + ''' + A group of loads conforming to an allocation pattern. + + :ConformLoadSchedules: The ConformLoadSchedules in the ConformLoadGroup. Default: "list" + :EnergyConsumers: Conform loads assigned to this ConformLoadGroup. Default: "list" + ''' + + cgmesProfile = LoadGroup.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'ConformLoadSchedules': [cgmesProfile.EQ.value, ], + 'EnergyConsumers': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class LoadGroup: \n' + LoadGroup.__doc__ + + def __init__(self, ConformLoadSchedules = "list", EnergyConsumers = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ConformLoadSchedules = ConformLoadSchedules + self.EnergyConsumers = EnergyConsumers + + def __str__(self): + str = 'class=ConformLoadGroup\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ConformLoadSchedule.py b/cimpy/cgmes_v3_0_0/ConformLoadSchedule.py new file mode 100644 index 00000000..a949382a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ConformLoadSchedule.py @@ -0,0 +1,31 @@ +from .SeasonDayTypeSchedule import SeasonDayTypeSchedule + + +class ConformLoadSchedule(SeasonDayTypeSchedule): + ''' + A curve of load versus time (X-axis) showing the active power values (Y1-axis) and reactive power (Y2-axis) for each unit of the period covered. This curve represents a typical pattern of load over the time period for a given day type and season. + + :ConformLoadGroup: The ConformLoadGroup where the ConformLoadSchedule belongs. Default: None + ''' + + cgmesProfile = SeasonDayTypeSchedule.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'ConformLoadGroup': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class SeasonDayTypeSchedule: \n' + SeasonDayTypeSchedule.__doc__ + + def __init__(self, ConformLoadGroup = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ConformLoadGroup = ConformLoadGroup + + def __str__(self): + str = 'class=ConformLoadSchedule\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ConnectivityNode.py b/cimpy/cgmes_v3_0_0/ConnectivityNode.py new file mode 100644 index 00000000..70c45b5f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ConnectivityNode.py @@ -0,0 +1,40 @@ +from .IdentifiedObject import IdentifiedObject + + +class ConnectivityNode(IdentifiedObject): + ''' + Connectivity nodes are points where terminals of AC conducting equipment are connected together with zero impedance. + + :TopologicalNode: The topological node to which this connectivity node is assigned. May depend on the current state of switches in the network. Default: None + :BoundaryPoint: The boundary point associated with the connectivity node. Default: None + :Terminals: Terminals interconnected with zero impedance at a this connectivity node. Default: "list" + :ConnectivityNodeContainer: Container of this connectivity node. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.TP.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'TopologicalNode': [cgmesProfile.TP.value, ], + 'BoundaryPoint': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'Terminals': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'ConnectivityNodeContainer': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, TopologicalNode = None, BoundaryPoint = None, Terminals = "list", ConnectivityNodeContainer = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.TopologicalNode = TopologicalNode + self.BoundaryPoint = BoundaryPoint + self.Terminals = Terminals + self.ConnectivityNodeContainer = ConnectivityNodeContainer + + def __str__(self): + str = 'class=ConnectivityNode\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ConnectivityNodeContainer.py b/cimpy/cgmes_v3_0_0/ConnectivityNodeContainer.py new file mode 100644 index 00000000..7c0b0eb7 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ConnectivityNodeContainer.py @@ -0,0 +1,34 @@ +from .PowerSystemResource import PowerSystemResource + + +class ConnectivityNodeContainer(PowerSystemResource): + ''' + A base class for all objects that may contain connectivity nodes or topological nodes. + + :TopologicalNode: The topological nodes which belong to this connectivity node container. Default: "list" + :ConnectivityNodes: Connectivity nodes which belong to this connectivity node container. Default: "list" + ''' + + cgmesProfile = PowerSystemResource.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.TP.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'TopologicalNode': [cgmesProfile.TP.value, ], + 'ConnectivityNodes': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemResource: \n' + PowerSystemResource.__doc__ + + def __init__(self, TopologicalNode = "list", ConnectivityNodes = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.TopologicalNode = TopologicalNode + self.ConnectivityNodes = ConnectivityNodes + + def __str__(self): + str = 'class=ConnectivityNodeContainer\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Connector.py b/cimpy/cgmes_v3_0_0/Connector.py new file mode 100644 index 00000000..5a6c694d --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Connector.py @@ -0,0 +1,29 @@ +from .ConductingEquipment import ConductingEquipment + + +class Connector(ConductingEquipment): + ''' + A conductor, or group of conductors, with negligible impedance, that serve to connect other conducting equipment within a single substation and are modelled with a single logical terminal. + + ''' + + cgmesProfile = ConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ConductingEquipment: \n' + ConductingEquipment.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=Connector\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Control.py b/cimpy/cgmes_v3_0_0/Control.py new file mode 100644 index 00000000..155736c0 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Control.py @@ -0,0 +1,46 @@ +from .IOPoint import IOPoint + + +class Control(IOPoint): + ''' + Control is used for supervisory/device control. It represents control outputs that are used to change the state in a process, e.g. close or open breaker, a set point value or a raise lower command. + + :controlType: Specifies the type of Control. For example, this specifies if the Control represents BreakerOpen, BreakerClose, GeneratorVoltageSetPoint, GeneratorRaise, GeneratorLower, etc. Default: '' + :operationInProgress: Indicates that a client is currently sending control commands that has not completed. Default: False + :timeStamp: The last time a control output was sent. Default: '' + :unitMultiplier: The unit multiplier of the controlled quantity. Default: None + :unitSymbol: The unit of measure of the controlled quantity. Default: None + :PowerSystemResource: Regulating device governed by this control output. Default: None + ''' + + cgmesProfile = IOPoint.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'controlType': [cgmesProfile.OP.value, ], + 'operationInProgress': [cgmesProfile.OP.value, ], + 'timeStamp': [cgmesProfile.OP.value, ], + 'unitMultiplier': [cgmesProfile.OP.value, ], + 'unitSymbol': [cgmesProfile.OP.value, ], + 'PowerSystemResource': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IOPoint: \n' + IOPoint.__doc__ + + def __init__(self, controlType = '', operationInProgress = False, timeStamp = '', unitMultiplier = None, unitSymbol = None, PowerSystemResource = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.controlType = controlType + self.operationInProgress = operationInProgress + self.timeStamp = timeStamp + self.unitMultiplier = unitMultiplier + self.unitSymbol = unitSymbol + self.PowerSystemResource = PowerSystemResource + + def __str__(self): + str = 'class=Control\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ControlArea.py b/cimpy/cgmes_v3_0_0/ControlArea.py new file mode 100644 index 00000000..4d70bbca --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ControlArea.py @@ -0,0 +1,46 @@ +from .PowerSystemResource import PowerSystemResource + + +class ControlArea(PowerSystemResource): + ''' + A control area is a grouping of generating units and/or loads and a cutset of tie lines (as terminals) which may be used for a variety of purposes including automatic generation control, power flow solution area interchange control specification, and input to load forecasting. All generation and load within the area defined by the terminals on the border are considered in the area interchange control. Note that any number of overlapping control area specifications can be superimposed on the physical model. The following general principles apply to ControlArea: 1. The control area orientation for net interchange is positive for an import, negative for an export. 2. The control area net interchange is determined by summing flows in Terminals. The Terminals are identified by creating a set of TieFlow objects associated with a ControlArea object. Each TieFlow object identifies one Terminal. 3. In a single network model, a tie between two control areas must be modelled in both control area specifications, such that the two representations of the tie flow sum to zero. 4. The normal orientation of Terminal flow is positive for flow into the conducting equipment that owns the Terminal. (i.e. flow from a bus into a device is positive.) However, the orientation of each flow in the control area specification must align with the control area convention, i.e. import is positive. If the orientation of the Terminal flow referenced by a TieFlow is positive into the control area, then this is confirmed by setting TieFlow.positiveFlowIn flag TRUE. If not, the orientation must be reversed by setting the TieFlow.positiveFlowIn flag FALSE. + + :netInterchange: The specified positive net interchange into the control area, i.e. positive sign means flow into the area. Default: 0.0 + :pTolerance: Active power net interchange tolerance. The attribute shall be a positive value or zero. Default: 0.0 + :type: The primary type of control area definition used to determine if this is used for automatic generation control, for planning interchange control, or other purposes. A control area specified with primary type of automatic generation control could still be forecast and used as an interchange area in power flow analysis. Default: None + :TieFlow: The tie flows associated with the control area. Default: "list" + :ControlAreaGeneratingUnit: The generating unit specifications for the control area. Default: "list" + :EnergyArea: The energy area that is forecast from this control area specification. Default: None + ''' + + cgmesProfile = PowerSystemResource.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'netInterchange': [cgmesProfile.SSH.value, ], + 'pTolerance': [cgmesProfile.SSH.value, ], + 'type': [cgmesProfile.EQ.value, ], + 'TieFlow': [cgmesProfile.EQ.value, ], + 'ControlAreaGeneratingUnit': [cgmesProfile.EQ.value, ], + 'EnergyArea': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemResource: \n' + PowerSystemResource.__doc__ + + def __init__(self, netInterchange = 0.0, pTolerance = 0.0, type = None, TieFlow = "list", ControlAreaGeneratingUnit = "list", EnergyArea = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.netInterchange = netInterchange + self.pTolerance = pTolerance + self.type = type + self.TieFlow = TieFlow + self.ControlAreaGeneratingUnit = ControlAreaGeneratingUnit + self.EnergyArea = EnergyArea + + def __str__(self): + str = 'class=ControlArea\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ControlAreaGeneratingUnit.py b/cimpy/cgmes_v3_0_0/ControlAreaGeneratingUnit.py new file mode 100644 index 00000000..c78504bd --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ControlAreaGeneratingUnit.py @@ -0,0 +1,34 @@ +from .IdentifiedObject import IdentifiedObject + + +class ControlAreaGeneratingUnit(IdentifiedObject): + ''' + A control area generating unit. This class is needed so that alternate control area definitions may include the same generating unit. It should be noted that only one instance within a control area should reference a specific generating unit. + + :ControlArea: The parent control area for the generating unit specifications. Default: None + :GeneratingUnit: The generating unit specified for this control area. Note that a control area should include a GeneratingUnit only once. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'ControlArea': [cgmesProfile.EQ.value, ], + 'GeneratingUnit': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, ControlArea = None, GeneratingUnit = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ControlArea = ControlArea + self.GeneratingUnit = GeneratingUnit + + def __str__(self): + str = 'class=ControlAreaGeneratingUnit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ControlAreaTypeKind.py b/cimpy/cgmes_v3_0_0/ControlAreaTypeKind.py new file mode 100644 index 00000000..3962f487 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ControlAreaTypeKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class ControlAreaTypeKind(Base): + ''' + The type of control area. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=ControlAreaTypeKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/CoordinateSystem.py b/cimpy/cgmes_v3_0_0/CoordinateSystem.py new file mode 100644 index 00000000..36958395 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/CoordinateSystem.py @@ -0,0 +1,34 @@ +from .IdentifiedObject import IdentifiedObject + + +class CoordinateSystem(IdentifiedObject): + ''' + Coordinate reference system. + + :crsUrn: A Uniform Resource Name (URN) for the coordinate reference system (crs) used to define `Location.PositionPoints`. An example would be the European Petroleum Survey Group (EPSG) code for a coordinate reference system, defined in URN under the Open Geospatial Consortium (OGC) namespace as: urn:ogc:def:crs:EPSG::XXXX, where XXXX is an EPSG code (a full list of codes can be found at the EPSG Registry web site http://www.epsg-registry.org/). To define the coordinate system as being WGS84 (latitude, longitude) using an EPSG OGC, this attribute would be urn:ogc:def:crs:EPSG::4236. A profile should limit this code to a set of allowed URNs agreed to by all sending and receiving parties. Default: '' + :Locations: All locations described with position points in this coordinate system. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.GL.value, ], + 'crsUrn': [cgmesProfile.GL.value, ], + 'Locations': [cgmesProfile.GL.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, crsUrn = '', Locations = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.crsUrn = crsUrn + self.Locations = Locations + + def __str__(self): + str = 'class=CoordinateSystem\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/CrossCompoundTurbineGovernorDynamics.py b/cimpy/cgmes_v3_0_0/CrossCompoundTurbineGovernorDynamics.py new file mode 100644 index 00000000..e369080b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/CrossCompoundTurbineGovernorDynamics.py @@ -0,0 +1,34 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class CrossCompoundTurbineGovernorDynamics(DynamicsFunctionBlock): + ''' + Turbine-governor cross-compound function block whose behaviour is described by reference to a standard model or by definition of a user-defined model. + + :HighPressureSynchronousMachineDynamics: High-pressure synchronous machine with which this cross-compound turbine governor is associated. Default: None + :LowPressureSynchronousMachineDynamics: Low-pressure synchronous machine with which this cross-compound turbine governor is associated. Default: None + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'HighPressureSynchronousMachineDynamics': [cgmesProfile.DY.value, ], + 'LowPressureSynchronousMachineDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, HighPressureSynchronousMachineDynamics = None, LowPressureSynchronousMachineDynamics = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.HighPressureSynchronousMachineDynamics = HighPressureSynchronousMachineDynamics + self.LowPressureSynchronousMachineDynamics = LowPressureSynchronousMachineDynamics + + def __str__(self): + str = 'class=CrossCompoundTurbineGovernorDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/CsConverter.py b/cimpy/cgmes_v3_0_0/CsConverter.py new file mode 100644 index 00000000..823fac37 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/CsConverter.py @@ -0,0 +1,73 @@ +from .ACDCConverter import ACDCConverter + + +class CsConverter(ACDCConverter): + ''' + DC side of the current source converter (CSC). The firing angle controls the dc voltage at the converter, both for rectifier and inverter. The difference between the dc voltages of the rectifier and inverter determines the dc current. The extinction angle is used to limit the dc voltage at the inverter, if needed, and is not used in active power control. The firing angle, transformer tap position and number of connected filters are the primary means to control a current source dc line. Higher level controls are built on top, e.g. dc voltage, dc current and active power. From a steady state perspective it is sufficient to specify the wanted active power transfer (ACDCConverter.targetPpcc) and the control functions will set the dc voltage, dc current, firing angle, transformer tap position and number of connected filters to meet this. Therefore attributes targetAlpha and targetGamma are not applicable in this case. The reactive power consumed by the converter is a function of the firing angle, transformer tap position and number of connected filter, which can be approximated with half of the active power. The losses is a function of the dc voltage and dc current. The attributes minAlpha and maxAlpha define the range of firing angles for rectifier operation between which no discrete tap changer action takes place. The range is typically 10-18 degrees. The attributes minGamma and maxGamma define the range of extinction angles for inverter operation between which no discrete tap changer action takes place. The range is typically 17-20 degrees. + + :CSCDynamics: Current source converter dynamics model used to describe dynamic behaviour of this converter. Default: None + :operatingMode: Indicates whether the DC pole is operating as an inverter or as a rectifier. It is converter`s control variable used in power flow. Default: None + :pPccControl: Kind of active power control. Default: None + :targetAlpha: Target firing angle. It is converter`s control variable used in power flow. It is only applicable for rectifier if continuous tap changer control is used. Allowed values are within the range minAlpha<=targetAlpha<=maxAlpha. The attribute shall be a positive value. Default: 0.0 + :targetGamma: Target extinction angle. It is converter`s control variable used in power flow. It is only applicable for inverter if continuous tap changer control is used. Allowed values are within the range minGamma<=targetGamma<=maxGamma. The attribute shall be a positive value. Default: 0.0 + :targetIdc: DC current target value. It is converter`s control variable used in power flow. The attribute shall be a positive value. Default: 0.0 + :maxAlpha: Maximum firing angle. It is converter`s configuration data used in power flow. The attribute shall be a positive value. Default: 0.0 + :maxGamma: Maximum extinction angle. It is converter`s configuration data used in power flow. The attribute shall be a positive value. Default: 0.0 + :maxIdc: The maximum direct current (Id) on the DC side at which the converter should operate. It is converter`s configuration data use in power flow. The attribute shall be a positive value. Default: 0.0 + :minAlpha: Minimum firing angle. It is converter`s configuration data used in power flow. The attribute shall be a positive value. Default: 0.0 + :minGamma: Minimum extinction angle. It is converter`s configuration data used in power flow. The attribute shall be a positive value. Default: 0.0 + :minIdc: The minimum direct current (Id) on the DC side at which the converter should operate. It is converter`s configuration data used in power flow. The attribute shall be a positive value. Default: 0.0 + :ratedIdc: Rated converter DC current, also called IdN. The attribute shall be a positive value. It is converter`s configuration data used in power flow. Default: 0.0 + :alpha: Firing angle that determines the dc voltage at the converter dc terminal. Typical value between 10 degrees and 18 degrees for a rectifier. It is converter`s state variable, result from power flow. The attribute shall be a positive value. Default: 0.0 + :gamma: Extinction angle. It is used to limit the dc voltage at the inverter if needed. Typical value between 17 degrees and 20 degrees for an inverter. It is converter`s state variable, result from power flow. The attribute shall be a positive value. Default: 0.0 + ''' + + cgmesProfile = ACDCConverter.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SV.value, ], + 'CSCDynamics': [cgmesProfile.DY.value, ], + 'operatingMode': [cgmesProfile.SSH.value, ], + 'pPccControl': [cgmesProfile.SSH.value, ], + 'targetAlpha': [cgmesProfile.SSH.value, ], + 'targetGamma': [cgmesProfile.SSH.value, ], + 'targetIdc': [cgmesProfile.SSH.value, ], + 'maxAlpha': [cgmesProfile.EQ.value, ], + 'maxGamma': [cgmesProfile.EQ.value, ], + 'maxIdc': [cgmesProfile.EQ.value, ], + 'minAlpha': [cgmesProfile.EQ.value, ], + 'minGamma': [cgmesProfile.EQ.value, ], + 'minIdc': [cgmesProfile.EQ.value, ], + 'ratedIdc': [cgmesProfile.EQ.value, ], + 'alpha': [cgmesProfile.SV.value, ], + 'gamma': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ACDCConverter: \n' + ACDCConverter.__doc__ + + def __init__(self, CSCDynamics = None, operatingMode = None, pPccControl = None, targetAlpha = 0.0, targetGamma = 0.0, targetIdc = 0.0, maxAlpha = 0.0, maxGamma = 0.0, maxIdc = 0.0, minAlpha = 0.0, minGamma = 0.0, minIdc = 0.0, ratedIdc = 0.0, alpha = 0.0, gamma = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.CSCDynamics = CSCDynamics + self.operatingMode = operatingMode + self.pPccControl = pPccControl + self.targetAlpha = targetAlpha + self.targetGamma = targetGamma + self.targetIdc = targetIdc + self.maxAlpha = maxAlpha + self.maxGamma = maxGamma + self.maxIdc = maxIdc + self.minAlpha = minAlpha + self.minGamma = minGamma + self.minIdc = minIdc + self.ratedIdc = ratedIdc + self.alpha = alpha + self.gamma = gamma + + def __str__(self): + str = 'class=CsConverter\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/CsOperatingModeKind.py b/cimpy/cgmes_v3_0_0/CsOperatingModeKind.py new file mode 100644 index 00000000..0ea27a6e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/CsOperatingModeKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class CsOperatingModeKind(Base): + ''' + Operating mode for HVDC line operating as Current Source Converter. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=CsOperatingModeKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/CsPpccControlKind.py b/cimpy/cgmes_v3_0_0/CsPpccControlKind.py new file mode 100644 index 00000000..738a9495 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/CsPpccControlKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class CsPpccControlKind(Base): + ''' + Active power control modes for HVDC line operating as Current Source Converter. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=CsPpccControlKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Currency.py b/cimpy/cgmes_v3_0_0/Currency.py new file mode 100644 index 00000000..1619e642 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Currency.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class Currency(Base): + ''' + Monetary currencies. ISO 4217 standard including 3-character currency code. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=Currency\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/CurrentFlow.py b/cimpy/cgmes_v3_0_0/CurrentFlow.py new file mode 100644 index 00000000..b0902234 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/CurrentFlow.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class CurrentFlow(Base): + ''' + Electrical current with sign convention: positive flow is out of the conducting equipment into the connectivity node. Can be both AC and DC. + + :value: Default: 0.0 + :multiplier: Default: None + :unit: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'value': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'multiplier': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'unit': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, multiplier = None, unit = None, ): + + self.value = value + self.multiplier = multiplier + self.unit = unit + + def __str__(self): + str = 'class=CurrentFlow\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/CurrentLimit.py b/cimpy/cgmes_v3_0_0/CurrentLimit.py new file mode 100644 index 00000000..da85fe48 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/CurrentLimit.py @@ -0,0 +1,34 @@ +from .OperationalLimit import OperationalLimit + + +class CurrentLimit(OperationalLimit): + ''' + Operational limit on current. + + :value: Limit on current flow. The attribute shall be a positive value or zero. Default: 0.0 + :normalValue: The normal value for limit on current flow. The attribute shall be a positive value or zero. Default: 0.0 + ''' + + cgmesProfile = OperationalLimit.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'value': [cgmesProfile.SSH.value, ], + 'normalValue': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class OperationalLimit: \n' + OperationalLimit.__doc__ + + def __init__(self, value = 0.0, normalValue = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.value = value + self.normalValue = normalValue + + def __str__(self): + str = 'class=CurrentLimit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/CurrentTransformer.py b/cimpy/cgmes_v3_0_0/CurrentTransformer.py new file mode 100644 index 00000000..d2fb8a24 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/CurrentTransformer.py @@ -0,0 +1,29 @@ +from .Sensor import Sensor + + +class CurrentTransformer(Sensor): + ''' + Instrument transformer used to measure electrical qualities of the circuit that is being protected and/or monitored. Typically used as current transducer for the purpose of metering or protection. A typical secondary current rating would be 5A. + + ''' + + cgmesProfile = Sensor.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Sensor: \n' + Sensor.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=CurrentTransformer\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Curve.py b/cimpy/cgmes_v3_0_0/Curve.py new file mode 100644 index 00000000..84e1db76 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Curve.py @@ -0,0 +1,43 @@ +from .IdentifiedObject import IdentifiedObject + + +class Curve(IdentifiedObject): + ''' + A multi-purpose curve or functional relationship between an independent variable (X-axis) and dependent (Y-axis) variables. + + :curveStyle: The style or shape of the curve. Default: None + :xUnit: The X-axis units of measure. Default: None + :y1Unit: The Y1-axis units of measure. Default: None + :y2Unit: The Y2-axis units of measure. Default: None + :CurveDatas: The point data values that define this curve. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'curveStyle': [cgmesProfile.EQ.value, ], + 'xUnit': [cgmesProfile.EQ.value, ], + 'y1Unit': [cgmesProfile.EQ.value, ], + 'y2Unit': [cgmesProfile.EQ.value, ], + 'CurveDatas': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, curveStyle = None, xUnit = None, y1Unit = None, y2Unit = None, CurveDatas = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.curveStyle = curveStyle + self.xUnit = xUnit + self.y1Unit = y1Unit + self.y2Unit = y2Unit + self.CurveDatas = CurveDatas + + def __str__(self): + str = 'class=Curve\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/CurveData.py b/cimpy/cgmes_v3_0_0/CurveData.py new file mode 100644 index 00000000..eddf9812 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/CurveData.py @@ -0,0 +1,39 @@ +from .Base import Base + + +class CurveData(Base): + ''' + Multi-purpose data points for defining a curve. The use of this generic class is discouraged if a more specific class can be used to specify the X and Y axis values along with their specific data types. + + :Curve: The curve of this curve data point. Default: None + :xvalue: The data value of the X-axis variable, depending on the X-axis units. Default: 0.0 + :y1value: The data value of the first Y-axis variable, depending on the Y-axis units. Default: 0.0 + :y2value: The data value of the second Y-axis variable (if present), depending on the Y-axis units. Default: 0.0 + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'Curve': [cgmesProfile.EQ.value, ], + 'xvalue': [cgmesProfile.EQ.value, ], + 'y1value': [cgmesProfile.EQ.value, ], + 'y2value': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, Curve = None, xvalue = 0.0, y1value = 0.0, y2value = 0.0, ): + + self.Curve = Curve + self.xvalue = xvalue + self.y1value = y1value + self.y2value = y2value + + def __str__(self): + str = 'class=CurveData\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/CurveStyle.py b/cimpy/cgmes_v3_0_0/CurveStyle.py new file mode 100644 index 00000000..2e3904d2 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/CurveStyle.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class CurveStyle(Base): + ''' + Style or shape of curve. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=CurveStyle\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Cut.py b/cimpy/cgmes_v3_0_0/Cut.py new file mode 100644 index 00000000..29e8a0ff --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Cut.py @@ -0,0 +1,34 @@ +from .Switch import Switch + + +class Cut(Switch): + ''' + A cut separates a line segment into two parts. The cut appears as a switch inserted between these two parts and connects them together. As the cut is normally open there is no galvanic connection between the two line segment parts. But it is possible to close the cut to get galvanic connection. The cut terminals are oriented towards the line segment terminals with the same sequence number. Hence the cut terminal with sequence number equal to 1 is oriented to the line segment's terminal with sequence number equal to 1. The cut terminals also act as connection points for jumpers and other equipment, e.g. a mobile generator. To enable this, connectivity nodes are placed at the cut terminals. Once the connectivity nodes are in place any conducting equipment can be connected at them. + + :ACLineSegment: The line segment to which the cut is applied. Default: None + :lengthFromTerminal1: The length to the place where the cut is located starting from side one of the cut line segment, i.e. the line segment Terminal with sequenceNumber equal to 1. Default: 0.0 + ''' + + cgmesProfile = Switch.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'ACLineSegment': [cgmesProfile.EQ.value, ], + 'lengthFromTerminal1': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Switch: \n' + Switch.__doc__ + + def __init__(self, ACLineSegment = None, lengthFromTerminal1 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ACLineSegment = ACLineSegment + self.lengthFromTerminal1 = lengthFromTerminal1 + + def __str__(self): + str = 'class=Cut\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCBaseTerminal.py b/cimpy/cgmes_v3_0_0/DCBaseTerminal.py new file mode 100644 index 00000000..d340023e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCBaseTerminal.py @@ -0,0 +1,34 @@ +from .ACDCTerminal import ACDCTerminal + + +class DCBaseTerminal(ACDCTerminal): + ''' + An electrical connection point at a piece of DC conducting equipment. DC terminals are connected at one physical DC node that may have multiple DC terminals connected. A DC node is similar to an AC connectivity node. The model requires that DC connections are distinct from AC connections. + + :DCTopologicalNode: See association end Terminal.TopologicalNode. Default: None + :DCNode: The DC connectivity node to which this DC base terminal connects with zero impedance. Default: None + ''' + + cgmesProfile = ACDCTerminal.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.TP.value, cgmesProfile.EQ.value, ], + 'DCTopologicalNode': [cgmesProfile.TP.value, ], + 'DCNode': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ACDCTerminal: \n' + ACDCTerminal.__doc__ + + def __init__(self, DCTopologicalNode = None, DCNode = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.DCTopologicalNode = DCTopologicalNode + self.DCNode = DCNode + + def __str__(self): + str = 'class=DCBaseTerminal\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCBreaker.py b/cimpy/cgmes_v3_0_0/DCBreaker.py new file mode 100644 index 00000000..279b4e96 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCBreaker.py @@ -0,0 +1,29 @@ +from .DCSwitch import DCSwitch + + +class DCBreaker(DCSwitch): + ''' + A breaker within a DC system. + + ''' + + cgmesProfile = DCSwitch.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DCSwitch: \n' + DCSwitch.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=DCBreaker\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCBusbar.py b/cimpy/cgmes_v3_0_0/DCBusbar.py new file mode 100644 index 00000000..71d38948 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCBusbar.py @@ -0,0 +1,29 @@ +from .DCConductingEquipment import DCConductingEquipment + + +class DCBusbar(DCConductingEquipment): + ''' + A busbar within a DC system. + + ''' + + cgmesProfile = DCConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DCConductingEquipment: \n' + DCConductingEquipment.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=DCBusbar\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCChopper.py b/cimpy/cgmes_v3_0_0/DCChopper.py new file mode 100644 index 00000000..fa6ec0c7 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCChopper.py @@ -0,0 +1,29 @@ +from .DCConductingEquipment import DCConductingEquipment + + +class DCChopper(DCConductingEquipment): + ''' + Low resistance equipment used in the internal DC circuit to balance voltages. It has typically positive and negative pole terminals and a ground. + + ''' + + cgmesProfile = DCConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DCConductingEquipment: \n' + DCConductingEquipment.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=DCChopper\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCConductingEquipment.py b/cimpy/cgmes_v3_0_0/DCConductingEquipment.py new file mode 100644 index 00000000..762f9bbf --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCConductingEquipment.py @@ -0,0 +1,34 @@ +from .Equipment import Equipment + + +class DCConductingEquipment(Equipment): + ''' + The parts of the DC power system that are designed to carry current or that are conductively connected through DC terminals. + + :ratedUdc: Rated DC device voltage. The attribute shall be a positive value. It is configuration data used in power flow. Default: 0.0 + :DCTerminals: A DC conducting equipment has DC terminals. Default: "list" + ''' + + cgmesProfile = Equipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'ratedUdc': [cgmesProfile.EQ.value, ], + 'DCTerminals': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Equipment: \n' + Equipment.__doc__ + + def __init__(self, ratedUdc = 0.0, DCTerminals = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ratedUdc = ratedUdc + self.DCTerminals = DCTerminals + + def __str__(self): + str = 'class=DCConductingEquipment\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCConverterOperatingModeKind.py b/cimpy/cgmes_v3_0_0/DCConverterOperatingModeKind.py new file mode 100644 index 00000000..ea01fc06 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCConverterOperatingModeKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class DCConverterOperatingModeKind(Base): + ''' + The operating mode of an HVDC bipole. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=DCConverterOperatingModeKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCConverterUnit.py b/cimpy/cgmes_v3_0_0/DCConverterUnit.py new file mode 100644 index 00000000..fdffa465 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCConverterUnit.py @@ -0,0 +1,34 @@ +from .DCEquipmentContainer import DCEquipmentContainer + + +class DCConverterUnit(DCEquipmentContainer): + ''' + Indivisible operative unit comprising all equipment between the point of common coupling on the AC side and the point of common coupling - DC side, essentially one or more converters, together with one or more converter transformers, converter control equipment, essential protective and switching devices and auxiliaries, if any, used for conversion. + + :operationMode: The operating mode of an HVDC bipole (bipolar, monopolar metallic return, etc). Default: None + :Substation: The containing substation of the DC converter unit. Default: None + ''' + + cgmesProfile = DCEquipmentContainer.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'operationMode': [cgmesProfile.EQ.value, ], + 'Substation': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DCEquipmentContainer: \n' + DCEquipmentContainer.__doc__ + + def __init__(self, operationMode = None, Substation = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.operationMode = operationMode + self.Substation = Substation + + def __str__(self): + str = 'class=DCConverterUnit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCDisconnector.py b/cimpy/cgmes_v3_0_0/DCDisconnector.py new file mode 100644 index 00000000..6be928d0 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCDisconnector.py @@ -0,0 +1,29 @@ +from .DCSwitch import DCSwitch + + +class DCDisconnector(DCSwitch): + ''' + A disconnector within a DC system. + + ''' + + cgmesProfile = DCSwitch.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DCSwitch: \n' + DCSwitch.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=DCDisconnector\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCEquipmentContainer.py b/cimpy/cgmes_v3_0_0/DCEquipmentContainer.py new file mode 100644 index 00000000..f9f2c44e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCEquipmentContainer.py @@ -0,0 +1,34 @@ +from .EquipmentContainer import EquipmentContainer + + +class DCEquipmentContainer(EquipmentContainer): + ''' + A modelling construct to provide a root class for containment of DC as well as AC equipment. The class differ from the EquipmentContaner for AC in that it may also contain DCNode-s. Hence it can contain both AC and DC equipment. + + :DCTopologicalNode: The topological nodes which belong to this connectivity node container. Default: "list" + :DCNodes: The DC nodes contained in the DC equipment container. Default: "list" + ''' + + cgmesProfile = EquipmentContainer.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.TP.value, cgmesProfile.EQ.value, ], + 'DCTopologicalNode': [cgmesProfile.TP.value, ], + 'DCNodes': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EquipmentContainer: \n' + EquipmentContainer.__doc__ + + def __init__(self, DCTopologicalNode = "list", DCNodes = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.DCTopologicalNode = DCTopologicalNode + self.DCNodes = DCNodes + + def __str__(self): + str = 'class=DCEquipmentContainer\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCGround.py b/cimpy/cgmes_v3_0_0/DCGround.py new file mode 100644 index 00000000..8331961c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCGround.py @@ -0,0 +1,34 @@ +from .DCConductingEquipment import DCConductingEquipment + + +class DCGround(DCConductingEquipment): + ''' + A ground within a DC system. + + :inductance: Inductance to ground. Default: 0.0 + :r: Resistance to ground. Default: 0.0 + ''' + + cgmesProfile = DCConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'inductance': [cgmesProfile.EQ.value, ], + 'r': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DCConductingEquipment: \n' + DCConductingEquipment.__doc__ + + def __init__(self, inductance = 0.0, r = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.inductance = inductance + self.r = r + + def __str__(self): + str = 'class=DCGround\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCLine.py b/cimpy/cgmes_v3_0_0/DCLine.py new file mode 100644 index 00000000..d9b4fa85 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCLine.py @@ -0,0 +1,31 @@ +from .DCEquipmentContainer import DCEquipmentContainer + + +class DCLine(DCEquipmentContainer): + ''' + Overhead lines and/or cables connecting two or more HVDC substations. + + :Region: The SubGeographicalRegion containing the DC line. Default: None + ''' + + cgmesProfile = DCEquipmentContainer.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'Region': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DCEquipmentContainer: \n' + DCEquipmentContainer.__doc__ + + def __init__(self, Region = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Region = Region + + def __str__(self): + str = 'class=DCLine\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCLineSegment.py b/cimpy/cgmes_v3_0_0/DCLineSegment.py new file mode 100644 index 00000000..065e8642 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCLineSegment.py @@ -0,0 +1,40 @@ +from .DCConductingEquipment import DCConductingEquipment + + +class DCLineSegment(DCConductingEquipment): + ''' + A wire or combination of wires not insulated from one another, with consistent electrical characteristics, used to carry direct current between points in the DC region of the power system. + + :capacitance: Capacitance of the DC line segment. Significant for cables only. Default: 0.0 + :inductance: Inductance of the DC line segment. Negligible compared with DCSeriesDevice used for smoothing. Default: 0.0 + :resistance: Resistance of the DC line segment. Default: 0.0 + :length: Segment length for calculating line section capabilities. Default: 0.0 + ''' + + cgmesProfile = DCConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'capacitance': [cgmesProfile.EQ.value, ], + 'inductance': [cgmesProfile.EQ.value, ], + 'resistance': [cgmesProfile.EQ.value, ], + 'length': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DCConductingEquipment: \n' + DCConductingEquipment.__doc__ + + def __init__(self, capacitance = 0.0, inductance = 0.0, resistance = 0.0, length = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.capacitance = capacitance + self.inductance = inductance + self.resistance = resistance + self.length = length + + def __str__(self): + str = 'class=DCLineSegment\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCNode.py b/cimpy/cgmes_v3_0_0/DCNode.py new file mode 100644 index 00000000..b0dfe074 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCNode.py @@ -0,0 +1,37 @@ +from .IdentifiedObject import IdentifiedObject + + +class DCNode(IdentifiedObject): + ''' + DC nodes are points where terminals of DC conducting equipment are connected together with zero impedance. + + :DCTopologicalNode: The DC topological node to which this DC connectivity node is assigned. May depend on the current state of switches in the network. Default: None + :DCTerminals: DC base terminals interconnected with zero impedance at a this DC connectivity node. Default: "list" + :DCEquipmentContainer: The DC container for the DC nodes. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.TP.value, cgmesProfile.EQ.value, ], + 'DCTopologicalNode': [cgmesProfile.TP.value, ], + 'DCTerminals': [cgmesProfile.EQ.value, ], + 'DCEquipmentContainer': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, DCTopologicalNode = None, DCTerminals = "list", DCEquipmentContainer = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.DCTopologicalNode = DCTopologicalNode + self.DCTerminals = DCTerminals + self.DCEquipmentContainer = DCEquipmentContainer + + def __str__(self): + str = 'class=DCNode\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCPolarityKind.py b/cimpy/cgmes_v3_0_0/DCPolarityKind.py new file mode 100644 index 00000000..7c60bf15 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCPolarityKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class DCPolarityKind(Base): + ''' + Polarity for DC circuits. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=DCPolarityKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCSeriesDevice.py b/cimpy/cgmes_v3_0_0/DCSeriesDevice.py new file mode 100644 index 00000000..74e7c3a0 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCSeriesDevice.py @@ -0,0 +1,34 @@ +from .DCConductingEquipment import DCConductingEquipment + + +class DCSeriesDevice(DCConductingEquipment): + ''' + A series device within the DC system, typically a reactor used for filtering or smoothing. Needed for transient and short circuit studies. + + :inductance: Inductance of the device. Default: 0.0 + :resistance: Resistance of the DC device. Default: 0.0 + ''' + + cgmesProfile = DCConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'inductance': [cgmesProfile.EQ.value, ], + 'resistance': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DCConductingEquipment: \n' + DCConductingEquipment.__doc__ + + def __init__(self, inductance = 0.0, resistance = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.inductance = inductance + self.resistance = resistance + + def __str__(self): + str = 'class=DCSeriesDevice\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCShunt.py b/cimpy/cgmes_v3_0_0/DCShunt.py new file mode 100644 index 00000000..ffb4a617 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCShunt.py @@ -0,0 +1,34 @@ +from .DCConductingEquipment import DCConductingEquipment + + +class DCShunt(DCConductingEquipment): + ''' + A shunt device within the DC system, typically used for filtering. Needed for transient and short circuit studies. + + :capacitance: Capacitance of the DC shunt. Default: 0.0 + :resistance: Resistance of the DC device. Default: 0.0 + ''' + + cgmesProfile = DCConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'capacitance': [cgmesProfile.EQ.value, ], + 'resistance': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DCConductingEquipment: \n' + DCConductingEquipment.__doc__ + + def __init__(self, capacitance = 0.0, resistance = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.capacitance = capacitance + self.resistance = resistance + + def __str__(self): + str = 'class=DCShunt\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCSwitch.py b/cimpy/cgmes_v3_0_0/DCSwitch.py new file mode 100644 index 00000000..b3efbf57 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCSwitch.py @@ -0,0 +1,29 @@ +from .DCConductingEquipment import DCConductingEquipment + + +class DCSwitch(DCConductingEquipment): + ''' + A switch within the DC system. + + ''' + + cgmesProfile = DCConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DCConductingEquipment: \n' + DCConductingEquipment.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=DCSwitch\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCTerminal.py b/cimpy/cgmes_v3_0_0/DCTerminal.py new file mode 100644 index 00000000..9e99bbdb --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCTerminal.py @@ -0,0 +1,31 @@ +from .DCBaseTerminal import DCBaseTerminal + + +class DCTerminal(DCBaseTerminal): + ''' + An electrical connection point to generic DC conducting equipment. + + :DCConductingEquipment: An DC terminal belong to a DC conducting equipment. Default: None + ''' + + cgmesProfile = DCBaseTerminal.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.TP.value, cgmesProfile.EQ.value, ], + 'DCConductingEquipment': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DCBaseTerminal: \n' + DCBaseTerminal.__doc__ + + def __init__(self, DCConductingEquipment = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.DCConductingEquipment = DCConductingEquipment + + def __str__(self): + str = 'class=DCTerminal\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCTopologicalIsland.py b/cimpy/cgmes_v3_0_0/DCTopologicalIsland.py new file mode 100644 index 00000000..89da0821 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCTopologicalIsland.py @@ -0,0 +1,31 @@ +from .IdentifiedObject import IdentifiedObject + + +class DCTopologicalIsland(IdentifiedObject): + ''' + An electrically connected subset of the network. DC topological islands can change as the current network state changes, e.g. due to: - disconnect switches or breakers changing state in a SCADA/EMS. - manual creation, change or deletion of topological nodes in a planning tool. Only energised TopologicalNode-s shall be part of the topological island. + + :DCTopologicalNodes: The DC topological nodes in a DC topological island. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SV.value, ], + 'DCTopologicalNodes': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, DCTopologicalNodes = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.DCTopologicalNodes = DCTopologicalNodes + + def __str__(self): + str = 'class=DCTopologicalIsland\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DCTopologicalNode.py b/cimpy/cgmes_v3_0_0/DCTopologicalNode.py new file mode 100644 index 00000000..3a824f0b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DCTopologicalNode.py @@ -0,0 +1,40 @@ +from .IdentifiedObject import IdentifiedObject + + +class DCTopologicalNode(IdentifiedObject): + ''' + DC bus. + + :DCTerminals: See association end TopologicalNode.Terminal. Default: "list" + :DCEquipmentContainer: The connectivity node container to which the topological node belongs. Default: None + :DCNodes: The DC connectivity nodes combined together to form this DC topological node. May depend on the current state of switches in the network. Default: "list" + :DCTopologicalIsland: A DC topological node belongs to a DC topological island. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.TP.value, cgmesProfile.SV.value, ], + 'DCTerminals': [cgmesProfile.TP.value, ], + 'DCEquipmentContainer': [cgmesProfile.TP.value, ], + 'DCNodes': [cgmesProfile.TP.value, ], + 'DCTopologicalIsland': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, DCTerminals = "list", DCEquipmentContainer = None, DCNodes = "list", DCTopologicalIsland = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.DCTerminals = DCTerminals + self.DCEquipmentContainer = DCEquipmentContainer + self.DCNodes = DCNodes + self.DCTopologicalIsland = DCTopologicalIsland + + def __str__(self): + str = 'class=DCTopologicalNode\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Date.py b/cimpy/cgmes_v3_0_0/Date.py new file mode 100644 index 00000000..dd5eeb2e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Date.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class Date(Base): + ''' + Date as "yyyy-mm-dd", which conforms with ISO 8601. UTC time zone is specified as "yyyy-mm-ddZ". A local timezone relative UTC is specified as "yyyy-mm-dd(+/-)hh:mm". + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.GL.value, cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.DL.value, cgmesProfile.TP.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=Date\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DateTime.py b/cimpy/cgmes_v3_0_0/DateTime.py new file mode 100644 index 00000000..04bd4139 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DateTime.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class DateTime(Base): + ''' + Date and time as "yyyy-mm-ddThh:mm:ss.sss", which conforms with ISO 8601. UTC time zone is specified as "yyyy-mm-ddThh:mm:ss.sssZ". A local timezone relative UTC is specified as "yyyy-mm-ddThh:mm:ss.sss-hh:mm". The second component (shown here as "ss.sss") could have any number of digits in its fractional part to allow any kind of precision beyond seconds. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.GL.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=DateTime\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DayType.py b/cimpy/cgmes_v3_0_0/DayType.py new file mode 100644 index 00000000..8c75d573 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DayType.py @@ -0,0 +1,31 @@ +from .IdentifiedObject import IdentifiedObject + + +class DayType(IdentifiedObject): + ''' + Group of similar days. For example it could be used to represent weekdays, weekend, or holidays. + + :SeasonDayTypeSchedules: Schedules that use this DayType. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'SeasonDayTypeSchedules': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, SeasonDayTypeSchedules = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.SeasonDayTypeSchedules = SeasonDayTypeSchedules + + def __str__(self): + str = 'class=DayType\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Decimal.py b/cimpy/cgmes_v3_0_0/Decimal.py new file mode 100644 index 00000000..4e205714 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Decimal.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class Decimal(Base): + ''' + Decimal is the base-10 notational system for representing real numbers. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=Decimal\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Diagram.py b/cimpy/cgmes_v3_0_0/Diagram.py new file mode 100644 index 00000000..902ad330 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Diagram.py @@ -0,0 +1,49 @@ +from .IdentifiedObject import IdentifiedObject + + +class Diagram(IdentifiedObject): + ''' + The diagram being exchanged. The coordinate system is a standard Cartesian coordinate system and the orientation attribute defines the orientation. The initial view related attributes can be used to specify an initial view with the x,y coordinates of the diagonal points. + + :orientation: Coordinate system orientation of the diagram. A positive orientation gives standard `right-hand` orientation, with negative orientation indicating a `left-hand` orientation. For 2D diagrams, a positive orientation will result in X values increasing from left to right and Y values increasing from bottom to top. A negative orientation gives the `left-hand` orientation (favoured by computer graphics displays) with X values increasing from left to right and Y values increasing from top to bottom. Default: None + :x1InitialView: X coordinate of the first corner of the initial view. Default: 0.0 + :x2InitialView: X coordinate of the second corner of the initial view. Default: 0.0 + :y1InitialView: Y coordinate of the first corner of the initial view. Default: 0.0 + :y2InitialView: Y coordinate of the second corner of the initial view. Default: 0.0 + :DiagramElements: A diagram is made up of multiple diagram objects. Default: "list" + :DiagramStyle: A Diagram may have a DiagramStyle. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DL.value, ], + 'orientation': [cgmesProfile.DL.value, ], + 'x1InitialView': [cgmesProfile.DL.value, ], + 'x2InitialView': [cgmesProfile.DL.value, ], + 'y1InitialView': [cgmesProfile.DL.value, ], + 'y2InitialView': [cgmesProfile.DL.value, ], + 'DiagramElements': [cgmesProfile.DL.value, ], + 'DiagramStyle': [cgmesProfile.DL.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, orientation = None, x1InitialView = 0.0, x2InitialView = 0.0, y1InitialView = 0.0, y2InitialView = 0.0, DiagramElements = "list", DiagramStyle = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.orientation = orientation + self.x1InitialView = x1InitialView + self.x2InitialView = x2InitialView + self.y1InitialView = y1InitialView + self.y2InitialView = y2InitialView + self.DiagramElements = DiagramElements + self.DiagramStyle = DiagramStyle + + def __str__(self): + str = 'class=Diagram\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DiagramObject.py b/cimpy/cgmes_v3_0_0/DiagramObject.py new file mode 100644 index 00000000..dcd32ea4 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DiagramObject.py @@ -0,0 +1,58 @@ +from .IdentifiedObject import IdentifiedObject + + +class DiagramObject(IdentifiedObject): + ''' + An object that defines one or more points in a given space. This object can be associated with anything that specializes IdentifiedObject. For single line diagrams such objects typically include such items as analog values, breakers, disconnectors, power transformers, and transmission lines. + + :Diagram: A diagram object is part of a diagram. Default: None + :drawingOrder: The drawing order of this element. The higher the number, the later the element is drawn in sequence. This is used to ensure that elements that overlap are rendered in the correct order. Default: 0 + :isPolygon: Defines whether or not the diagram objects points define the boundaries of a polygon or the routing of a polyline. If this value is true then a receiving application should consider the first and last points to be connected. Default: False + :offsetX: The offset in the X direction. This is used for defining the offset from centre for rendering an icon (the default is that a single point specifies the centre of the icon). The offset is in per-unit with 0 indicating there is no offset from the horizontal centre of the icon. -0.5 indicates it is offset by 50% to the left and 0.5 indicates an offset of 50% to the right. Default: 0.0 + :offsetY: The offset in the Y direction. This is used for defining the offset from centre for rendering an icon (the default is that a single point specifies the centre of the icon). The offset is in per-unit with 0 indicating there is no offset from the vertical centre of the icon. The offset direction is dependent on the orientation of the diagram, with -0.5 and 0.5 indicating an offset of +/- 50% on the vertical axis. Default: 0.0 + :rotation: Sets the angle of rotation of the diagram object. Zero degrees is pointing to the top of the diagram. Rotation is clockwise. DiagramObject.rotation=0 has the following meaning: The connection point of an element which has one terminal is pointing to the top side of the diagram. The connection point `From side` of an element which has more than one terminal is pointing to the top side of the diagram. DiagramObject.rotation=90 has the following meaning: The connection point of an element which has one terminal is pointing to the right hand side of the diagram. The connection point `From side` of an element which has more than one terminal is pointing to the right hand side of the diagram. Default: 0.0 + :IdentifiedObject: The domain object to which this diagram object is associated. Default: None + :DiagramObjectPoints: A diagram object can have 0 or more points to reflect its layout position, routing (for polylines) or boundary (for polygons). Default: "list" + :VisibilityLayers: A diagram object can be part of multiple visibility layers. Default: "list" + :DiagramObjectStyle: A diagram object has a style associated that provides a reference for the style used in the originating system. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DL.value, ], + 'Diagram': [cgmesProfile.DL.value, ], + 'drawingOrder': [cgmesProfile.DL.value, ], + 'isPolygon': [cgmesProfile.DL.value, ], + 'offsetX': [cgmesProfile.DL.value, ], + 'offsetY': [cgmesProfile.DL.value, ], + 'rotation': [cgmesProfile.DL.value, ], + 'IdentifiedObject': [cgmesProfile.DL.value, ], + 'DiagramObjectPoints': [cgmesProfile.DL.value, ], + 'VisibilityLayers': [cgmesProfile.DL.value, ], + 'DiagramObjectStyle': [cgmesProfile.DL.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, Diagram = None, drawingOrder = 0, isPolygon = False, offsetX = 0.0, offsetY = 0.0, rotation = 0.0, IdentifiedObject = None, DiagramObjectPoints = "list", VisibilityLayers = "list", DiagramObjectStyle = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Diagram = Diagram + self.drawingOrder = drawingOrder + self.isPolygon = isPolygon + self.offsetX = offsetX + self.offsetY = offsetY + self.rotation = rotation + self.IdentifiedObject = IdentifiedObject + self.DiagramObjectPoints = DiagramObjectPoints + self.VisibilityLayers = VisibilityLayers + self.DiagramObjectStyle = DiagramObjectStyle + + def __str__(self): + str = 'class=DiagramObject\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DiagramObjectGluePoint.py b/cimpy/cgmes_v3_0_0/DiagramObjectGluePoint.py new file mode 100644 index 00000000..12e73d05 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DiagramObjectGluePoint.py @@ -0,0 +1,30 @@ +from .Base import Base + + +class DiagramObjectGluePoint(Base): + ''' + This is used for grouping diagram object points from different diagram objects that are considered to be glued together in a diagram even if they are not at the exact same coordinates. + + :DiagramObjectPoints: A diagram object glue point is associated with 2 or more object points that are considered to be `glued` together. Default: "list" + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DL.value, ], + 'DiagramObjectPoints': [cgmesProfile.DL.value, ], + } + + serializationProfile = {} + + + + def __init__(self, DiagramObjectPoints = "list", ): + + self.DiagramObjectPoints = DiagramObjectPoints + + def __str__(self): + str = 'class=DiagramObjectGluePoint\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DiagramObjectPoint.py b/cimpy/cgmes_v3_0_0/DiagramObjectPoint.py new file mode 100644 index 00000000..6389312e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DiagramObjectPoint.py @@ -0,0 +1,45 @@ +from .Base import Base + + +class DiagramObjectPoint(Base): + ''' + A point in a given space defined by 3 coordinates and associated to a diagram object. The coordinates may be positive or negative as the origin does not have to be in the corner of a diagram. + + :DiagramObject: The diagram object with which the points are associated. Default: None + :DiagramObjectGluePoint: The `glue` point to which this point is associated. Default: None + :sequenceNumber: The sequence position of the point, used for defining the order of points for diagram objects acting as a polyline or polygon with more than one point. The attribute shall be a positive value. Default: 0 + :xPosition: The X coordinate of this point. Default: 0.0 + :yPosition: The Y coordinate of this point. Default: 0.0 + :zPosition: The Z coordinate of this point. Default: 0.0 + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DL.value, ], + 'DiagramObject': [cgmesProfile.DL.value, ], + 'DiagramObjectGluePoint': [cgmesProfile.DL.value, ], + 'sequenceNumber': [cgmesProfile.DL.value, ], + 'xPosition': [cgmesProfile.DL.value, ], + 'yPosition': [cgmesProfile.DL.value, ], + 'zPosition': [cgmesProfile.DL.value, ], + } + + serializationProfile = {} + + + + def __init__(self, DiagramObject = None, DiagramObjectGluePoint = None, sequenceNumber = 0, xPosition = 0.0, yPosition = 0.0, zPosition = 0.0, ): + + self.DiagramObject = DiagramObject + self.DiagramObjectGluePoint = DiagramObjectGluePoint + self.sequenceNumber = sequenceNumber + self.xPosition = xPosition + self.yPosition = yPosition + self.zPosition = zPosition + + def __str__(self): + str = 'class=DiagramObjectPoint\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DiagramObjectStyle.py b/cimpy/cgmes_v3_0_0/DiagramObjectStyle.py new file mode 100644 index 00000000..3aeb482e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DiagramObjectStyle.py @@ -0,0 +1,31 @@ +from .IdentifiedObject import IdentifiedObject + + +class DiagramObjectStyle(IdentifiedObject): + ''' + A reference to a style used by the originating system for a diagram object. A diagram object style describes information such as line thickness, shape such as circle or rectangle etc, and colour. + + :StyledObjects: A style can be assigned to multiple diagram objects. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DL.value, ], + 'StyledObjects': [cgmesProfile.DL.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, StyledObjects = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.StyledObjects = StyledObjects + + def __str__(self): + str = 'class=DiagramObjectStyle\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DiagramStyle.py b/cimpy/cgmes_v3_0_0/DiagramStyle.py new file mode 100644 index 00000000..874ced62 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DiagramStyle.py @@ -0,0 +1,31 @@ +from .IdentifiedObject import IdentifiedObject + + +class DiagramStyle(IdentifiedObject): + ''' + The diagram style refers to a style used by the originating system for a diagram. A diagram style describes information such as schematic, geographic, etc. + + :Diagram: A DiagramStyle can be used by many Diagrams. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DL.value, ], + 'Diagram': [cgmesProfile.DL.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, Diagram = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Diagram = Diagram + + def __str__(self): + str = 'class=DiagramStyle\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DiscExcContIEEEDEC1A.py b/cimpy/cgmes_v3_0_0/DiscExcContIEEEDEC1A.py new file mode 100644 index 00000000..b394bb3f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DiscExcContIEEEDEC1A.py @@ -0,0 +1,82 @@ +from .DiscontinuousExcitationControlDynamics import DiscontinuousExcitationControlDynamics + + +class DiscExcContIEEEDEC1A(DiscontinuousExcitationControlDynamics): + ''' + IEEE type DEC1A discontinuous excitation control model that boosts generator excitation to a level higher than that demanded by the voltage regulator and stabilizer immediately following a system fault. Reference: IEEE 421.5-2005, 12.2. + + :vtlmt: Voltage reference (VTLMT). Typical value = 1,1. Default: 0.0 + :vomax: Limiter (VOMAX) (> DiscExcContIEEEDEC1A.vomin). Typical value = 0,3. Default: 0.0 + :vomin: Limiter (VOMIN) (< DiscExcContIEEEDEC1A.vomax). Typical value = 0,1. Default: 0.0 + :ketl: Terminal voltage limiter gain (KETL). Typical value = 47. Default: 0.0 + :vtc: Terminal voltage level reference (VTC). Typical value = 0,95. Default: 0.0 + :val: Regulator voltage reference (VAL). Typical value = 5,5. Default: 0.0 + :esc: Speed change reference (ESC). Typical value = 0,0015. Default: 0.0 + :kan: Discontinuous controller gain (KAN). Typical value = 400. Default: 0.0 + :tan: Discontinuous controller time constant (TAN) (>= 0). Typical value = 0,08. Default: 0 + :tw5: DEC washout time constant (TW5) (>= 0). Typical value = 5. Default: 0 + :vsmax: Limiter (VSMAX)(> DiscExcContIEEEDEC1A.vsmin). Typical value = 0,2. Default: 0.0 + :vsmin: Limiter (VSMIN) (< DiscExcContIEEEDEC1A.vsmax). Typical value = -0,066. Default: 0.0 + :td: Time constant (TD) (>= 0). Typical value = 0,03. Default: 0 + :tl1: Time constant (TL1) (>= 0). Typical value = 0,025. Default: 0 + :tl2: Time constant (TL2) (>= 0). Typical value = 1,25. Default: 0 + :vtm: Voltage limits (VTM). Typical value = 1,13. Default: 0.0 + :vtn: Voltage limits (VTN). Typical value = 1,12. Default: 0.0 + :vanmax: Limiter for Van (VANMAX). Default: 0.0 + ''' + + cgmesProfile = DiscontinuousExcitationControlDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'vtlmt': [cgmesProfile.DY.value, ], + 'vomax': [cgmesProfile.DY.value, ], + 'vomin': [cgmesProfile.DY.value, ], + 'ketl': [cgmesProfile.DY.value, ], + 'vtc': [cgmesProfile.DY.value, ], + 'val': [cgmesProfile.DY.value, ], + 'esc': [cgmesProfile.DY.value, ], + 'kan': [cgmesProfile.DY.value, ], + 'tan': [cgmesProfile.DY.value, ], + 'tw5': [cgmesProfile.DY.value, ], + 'vsmax': [cgmesProfile.DY.value, ], + 'vsmin': [cgmesProfile.DY.value, ], + 'td': [cgmesProfile.DY.value, ], + 'tl1': [cgmesProfile.DY.value, ], + 'tl2': [cgmesProfile.DY.value, ], + 'vtm': [cgmesProfile.DY.value, ], + 'vtn': [cgmesProfile.DY.value, ], + 'vanmax': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DiscontinuousExcitationControlDynamics: \n' + DiscontinuousExcitationControlDynamics.__doc__ + + def __init__(self, vtlmt = 0.0, vomax = 0.0, vomin = 0.0, ketl = 0.0, vtc = 0.0, val = 0.0, esc = 0.0, kan = 0.0, tan = 0, tw5 = 0, vsmax = 0.0, vsmin = 0.0, td = 0, tl1 = 0, tl2 = 0, vtm = 0.0, vtn = 0.0, vanmax = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.vtlmt = vtlmt + self.vomax = vomax + self.vomin = vomin + self.ketl = ketl + self.vtc = vtc + self.val = val + self.esc = esc + self.kan = kan + self.tan = tan + self.tw5 = tw5 + self.vsmax = vsmax + self.vsmin = vsmin + self.td = td + self.tl1 = tl1 + self.tl2 = tl2 + self.vtm = vtm + self.vtn = vtn + self.vanmax = vanmax + + def __str__(self): + str = 'class=DiscExcContIEEEDEC1A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DiscExcContIEEEDEC2A.py b/cimpy/cgmes_v3_0_0/DiscExcContIEEEDEC2A.py new file mode 100644 index 00000000..36a1437f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DiscExcContIEEEDEC2A.py @@ -0,0 +1,43 @@ +from .DiscontinuousExcitationControlDynamics import DiscontinuousExcitationControlDynamics + + +class DiscExcContIEEEDEC2A(DiscontinuousExcitationControlDynamics): + ''' + IEEE type DEC2A model for discontinuous excitation control. This system provides transient excitation boosting via an open-loop control as initiated by a trigger signal generated remotely. Reference: IEEE 421.5-2005 12.3. + + :vk: Discontinuous controller input reference (VK). Default: 0.0 + :td1: Discontinuous controller time constant (TD1) (>= 0). Default: 0 + :td2: Discontinuous controller washout time constant (TD2) (>= 0). Default: 0 + :vdmin: Limiter (VDMIN) (< DiscExcContIEEEDEC2A.vdmax). Default: 0.0 + :vdmax: Limiter (VDMAX) (> DiscExcContIEEEDEC2A.vdmin). Default: 0.0 + ''' + + cgmesProfile = DiscontinuousExcitationControlDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'vk': [cgmesProfile.DY.value, ], + 'td1': [cgmesProfile.DY.value, ], + 'td2': [cgmesProfile.DY.value, ], + 'vdmin': [cgmesProfile.DY.value, ], + 'vdmax': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DiscontinuousExcitationControlDynamics: \n' + DiscontinuousExcitationControlDynamics.__doc__ + + def __init__(self, vk = 0.0, td1 = 0, td2 = 0, vdmin = 0.0, vdmax = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.vk = vk + self.td1 = td1 + self.td2 = td2 + self.vdmin = vdmin + self.vdmax = vdmax + + def __str__(self): + str = 'class=DiscExcContIEEEDEC2A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DiscExcContIEEEDEC3A.py b/cimpy/cgmes_v3_0_0/DiscExcContIEEEDEC3A.py new file mode 100644 index 00000000..05c58144 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DiscExcContIEEEDEC3A.py @@ -0,0 +1,34 @@ +from .DiscontinuousExcitationControlDynamics import DiscontinuousExcitationControlDynamics + + +class DiscExcContIEEEDEC3A(DiscontinuousExcitationControlDynamics): + ''' + IEEE type DEC3A model. In some systems, the stabilizer output is disconnected from the regulator immediately following a severe fault to prevent the stabilizer from competing with action of voltage regulator during the first swing. Reference: IEEE 421.5-2005 12.4. + + :vtmin: Terminal undervoltage comparison level (VTMIN). Default: 0.0 + :tdr: Reset time delay (TDR) (>= 0). Default: 0 + ''' + + cgmesProfile = DiscontinuousExcitationControlDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'vtmin': [cgmesProfile.DY.value, ], + 'tdr': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DiscontinuousExcitationControlDynamics: \n' + DiscontinuousExcitationControlDynamics.__doc__ + + def __init__(self, vtmin = 0.0, tdr = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.vtmin = vtmin + self.tdr = tdr + + def __str__(self): + str = 'class=DiscExcContIEEEDEC3A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DisconnectingCircuitBreaker.py b/cimpy/cgmes_v3_0_0/DisconnectingCircuitBreaker.py new file mode 100644 index 00000000..dea4bd20 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DisconnectingCircuitBreaker.py @@ -0,0 +1,29 @@ +from .Breaker import Breaker + + +class DisconnectingCircuitBreaker(Breaker): + ''' + A circuit breaking device including disconnecting function, eliminating the need for separate disconnectors. + + ''' + + cgmesProfile = Breaker.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Breaker: \n' + Breaker.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=DisconnectingCircuitBreaker\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Disconnector.py b/cimpy/cgmes_v3_0_0/Disconnector.py new file mode 100644 index 00000000..978a7a12 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Disconnector.py @@ -0,0 +1,29 @@ +from .Switch import Switch + + +class Disconnector(Switch): + ''' + A manually operated or motor operated mechanical switching device used for changing the connections in a circuit, or for isolating a circuit or equipment from a source of power. It is required to open or close circuits when negligible current is broken or made. + + ''' + + cgmesProfile = Switch.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Switch: \n' + Switch.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=Disconnector\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DiscontinuousExcitationControlDynamics.py b/cimpy/cgmes_v3_0_0/DiscontinuousExcitationControlDynamics.py new file mode 100644 index 00000000..a8f39c6e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DiscontinuousExcitationControlDynamics.py @@ -0,0 +1,34 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class DiscontinuousExcitationControlDynamics(DynamicsFunctionBlock): + ''' + Discontinuous excitation control function block whose behaviour is described by reference to a standard model or by definition of a user-defined model. + + :RemoteInputSignal: Remote input signal used by this discontinuous excitation control system model. Default: None + :ExcitationSystemDynamics: Excitation system model with which this discontinuous excitation control model is associated. Default: None + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'RemoteInputSignal': [cgmesProfile.DY.value, ], + 'ExcitationSystemDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, RemoteInputSignal = None, ExcitationSystemDynamics = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.RemoteInputSignal = RemoteInputSignal + self.ExcitationSystemDynamics = ExcitationSystemDynamics + + def __str__(self): + str = 'class=DiscontinuousExcitationControlDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DiscontinuousExcitationControlUserDefined.py b/cimpy/cgmes_v3_0_0/DiscontinuousExcitationControlUserDefined.py new file mode 100644 index 00000000..a5930230 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DiscontinuousExcitationControlUserDefined.py @@ -0,0 +1,34 @@ +from .DiscontinuousExcitationControlDynamics import DiscontinuousExcitationControlDynamics + + +class DiscontinuousExcitationControlUserDefined(DiscontinuousExcitationControlDynamics): + ''' + Discontinuous excitation control function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = DiscontinuousExcitationControlDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DiscontinuousExcitationControlDynamics: \n' + DiscontinuousExcitationControlDynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=DiscontinuousExcitationControlUserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Discrete.py b/cimpy/cgmes_v3_0_0/Discrete.py new file mode 100644 index 00000000..91bfe8cb --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Discrete.py @@ -0,0 +1,34 @@ +from .Measurement import Measurement + + +class Discrete(Measurement): + ''' + Discrete represents a discrete Measurement, i.e. a Measurement representing discrete values, e.g. a Breaker position. + + :DiscreteValues: The values connected to this measurement. Default: "list" + :ValueAliasSet: The ValueAliasSet used for translation of a MeasurementValue.value to a name. Default: None + ''' + + cgmesProfile = Measurement.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'DiscreteValues': [cgmesProfile.OP.value, ], + 'ValueAliasSet': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Measurement: \n' + Measurement.__doc__ + + def __init__(self, DiscreteValues = "list", ValueAliasSet = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.DiscreteValues = DiscreteValues + self.ValueAliasSet = ValueAliasSet + + def __str__(self): + str = 'class=Discrete\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DiscreteValue.py b/cimpy/cgmes_v3_0_0/DiscreteValue.py new file mode 100644 index 00000000..a7030bcf --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DiscreteValue.py @@ -0,0 +1,34 @@ +from .MeasurementValue import MeasurementValue + + +class DiscreteValue(MeasurementValue): + ''' + DiscreteValue represents a discrete MeasurementValue. + + :Command: The Control variable associated with the MeasurementValue. Default: None + :Discrete: Measurement to which this value is connected. Default: None + ''' + + cgmesProfile = MeasurementValue.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'Command': [cgmesProfile.OP.value, ], + 'Discrete': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class MeasurementValue: \n' + MeasurementValue.__doc__ + + def __init__(self, Command = None, Discrete = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Command = Command + self.Discrete = Discrete + + def __str__(self): + str = 'class=DiscreteValue\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DroopSignalFeedbackKind.py b/cimpy/cgmes_v3_0_0/DroopSignalFeedbackKind.py new file mode 100644 index 00000000..9dc1e882 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DroopSignalFeedbackKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class DroopSignalFeedbackKind(Base): + ''' + Governor droop signal feedback source. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=DroopSignalFeedbackKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/DynamicsFunctionBlock.py b/cimpy/cgmes_v3_0_0/DynamicsFunctionBlock.py new file mode 100644 index 00000000..d9585391 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/DynamicsFunctionBlock.py @@ -0,0 +1,31 @@ +from .IdentifiedObject import IdentifiedObject + + +class DynamicsFunctionBlock(IdentifiedObject): + ''' + Abstract parent class for all Dynamics function blocks. + + :enabled: Function block used indicator. true = use of function block is enabled false = use of function block is disabled. Default: False + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'enabled': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, enabled = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.enabled = enabled + + def __str__(self): + str = 'class=DynamicsFunctionBlock\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/EarthFaultCompensator.py b/cimpy/cgmes_v3_0_0/EarthFaultCompensator.py new file mode 100644 index 00000000..07ece86c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/EarthFaultCompensator.py @@ -0,0 +1,31 @@ +from .ConductingEquipment import ConductingEquipment + + +class EarthFaultCompensator(ConductingEquipment): + ''' + A conducting equipment used to represent a connection to ground which is typically used to compensate earth faults. An earth fault compensator device modelled with a single terminal implies a second terminal solidly connected to ground. If two terminals are modelled, the ground is not assumed and normal connection rules apply. + + :r: Nominal resistance of device. Default: 0.0 + ''' + + cgmesProfile = ConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'r': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ConductingEquipment: \n' + ConductingEquipment.__doc__ + + def __init__(self, r = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.r = r + + def __str__(self): + str = 'class=EarthFaultCompensator\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/EnergyArea.py b/cimpy/cgmes_v3_0_0/EnergyArea.py new file mode 100644 index 00000000..18d2c74d --- /dev/null +++ b/cimpy/cgmes_v3_0_0/EnergyArea.py @@ -0,0 +1,31 @@ +from .IdentifiedObject import IdentifiedObject + + +class EnergyArea(IdentifiedObject): + ''' + Describes an area having energy production or consumption. Specializations are intended to support the load allocation function as typically required in energy management systems or planning studies to allocate hypothesized load levels to individual load points for power flow analysis. Often the energy area can be linked to both measured and forecast load levels. + + :ControlArea: The control area specification that is used for the load forecast. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'ControlArea': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, ControlArea = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ControlArea = ControlArea + + def __str__(self): + str = 'class=EnergyArea\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/EnergyConnection.py b/cimpy/cgmes_v3_0_0/EnergyConnection.py new file mode 100644 index 00000000..c4feeef5 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/EnergyConnection.py @@ -0,0 +1,29 @@ +from .ConductingEquipment import ConductingEquipment + + +class EnergyConnection(ConductingEquipment): + ''' + A connection of energy generation or consumption on the power system model. + + ''' + + cgmesProfile = ConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ConductingEquipment: \n' + ConductingEquipment.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=EnergyConnection\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/EnergyConsumer.py b/cimpy/cgmes_v3_0_0/EnergyConsumer.py new file mode 100644 index 00000000..79270c3a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/EnergyConsumer.py @@ -0,0 +1,52 @@ +from .EnergyConnection import EnergyConnection + + +class EnergyConsumer(EnergyConnection): + ''' + Generic user of energy - a point of consumption on the power system model. EnergyConsumer.pfixed, .qfixed, .pfixedPct and .qfixedPct have meaning only if there is no LoadResponseCharacteristic associated with EnergyConsumer or if LoadResponseCharacteristic.exponentModel is set to False. + + :LoadDynamics: Load dynamics model used to describe dynamic behaviour of this energy consumer. Default: None + :p: Active power of the load. Load sign convention is used, i.e. positive sign means flow out from a node. For voltage dependent loads the value is at rated voltage. Starting value for a steady state solution. Default: 0.0 + :q: Reactive power of the load. Load sign convention is used, i.e. positive sign means flow out from a node. For voltage dependent loads the value is at rated voltage. Starting value for a steady state solution. Default: 0.0 + :pfixed: Active power of the load that is a fixed quantity and does not vary as load group value varies. Load sign convention is used, i.e. positive sign means flow out from a node. Default: 0.0 + :pfixedPct: Fixed active power as a percentage of load group fixed active power. Used to represent the time-varying components. Load sign convention is used, i.e. positive sign means flow out from a node. Default: 0.0 + :qfixed: Reactive power of the load that is a fixed quantity and does not vary as load group value varies. Load sign convention is used, i.e. positive sign means flow out from a node. Default: 0.0 + :qfixedPct: Fixed reactive power as a percentage of load group fixed reactive power. Used to represent the time-varying components. Load sign convention is used, i.e. positive sign means flow out from a node. Default: 0.0 + :LoadResponse: The load response characteristic of this load. If missing, this load is assumed to be constant power. Default: None + ''' + + cgmesProfile = EnergyConnection.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'LoadDynamics': [cgmesProfile.DY.value, ], + 'p': [cgmesProfile.SSH.value, ], + 'q': [cgmesProfile.SSH.value, ], + 'pfixed': [cgmesProfile.EQ.value, ], + 'pfixedPct': [cgmesProfile.EQ.value, ], + 'qfixed': [cgmesProfile.EQ.value, ], + 'qfixedPct': [cgmesProfile.EQ.value, ], + 'LoadResponse': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EnergyConnection: \n' + EnergyConnection.__doc__ + + def __init__(self, LoadDynamics = None, p = 0.0, q = 0.0, pfixed = 0.0, pfixedPct = 0.0, qfixed = 0.0, qfixedPct = 0.0, LoadResponse = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.LoadDynamics = LoadDynamics + self.p = p + self.q = q + self.pfixed = pfixed + self.pfixedPct = pfixedPct + self.qfixed = qfixed + self.qfixedPct = qfixedPct + self.LoadResponse = LoadResponse + + def __str__(self): + str = 'class=EnergyConsumer\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/EnergySchedulingType.py b/cimpy/cgmes_v3_0_0/EnergySchedulingType.py new file mode 100644 index 00000000..0098d3a3 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/EnergySchedulingType.py @@ -0,0 +1,31 @@ +from .IdentifiedObject import IdentifiedObject + + +class EnergySchedulingType(IdentifiedObject): + ''' + Used to define the type of generation for scheduling purposes. + + :EnergySource: Energy Source of a particular Energy Scheduling Type. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'EnergySource': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, EnergySource = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.EnergySource = EnergySource + + def __str__(self): + str = 'class=EnergySchedulingType\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/EnergySource.py b/cimpy/cgmes_v3_0_0/EnergySource.py new file mode 100644 index 00000000..df744699 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/EnergySource.py @@ -0,0 +1,70 @@ +from .EnergyConnection import EnergyConnection + + +class EnergySource(EnergyConnection): + ''' + A generic equivalent for an energy supplier on a transmission or distribution voltage level. + + :activePower: High voltage source active injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions. Default: 0.0 + :reactivePower: High voltage source reactive injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions. Default: 0.0 + :voltageAngle: Phase angle of a-phase open circuit used when voltage characteristics need to be imposed at the node associated with the terminal of the energy source, such as when voltages and angles from the transmission level are used as input to the distribution network. The attribute shall be a positive value or zero. Default: 0.0 + :voltageMagnitude: Phase-to-phase open circuit voltage magnitude used when voltage characteristics need to be imposed at the node associated with the terminal of the energy source, such as when voltages and angles from the transmission level are used as input to the distribution network. The attribute shall be a positive value or zero. Default: 0.0 + :EnergySchedulingType: Energy Scheduling Type of an Energy Source. Default: None + :nominalVoltage: Phase-to-phase nominal voltage. Default: 0.0 + :pMin: This is the minimum active power that can be produced by the source. Load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment. Default: 0.0 + :pMax: This is the maximum active power that can be produced by the source. Load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment. Default: 0.0 + :r: Positive sequence Thevenin resistance. Default: 0.0 + :r0: Zero sequence Thevenin resistance. Default: 0.0 + :rn: Negative sequence Thevenin resistance. Default: 0.0 + :x: Positive sequence Thevenin reactance. Default: 0.0 + :x0: Zero sequence Thevenin reactance. Default: 0.0 + :xn: Negative sequence Thevenin reactance. Default: 0.0 + ''' + + cgmesProfile = EnergyConnection.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'activePower': [cgmesProfile.SSH.value, ], + 'reactivePower': [cgmesProfile.SSH.value, ], + 'voltageAngle': [cgmesProfile.SSH.value, ], + 'voltageMagnitude': [cgmesProfile.SSH.value, ], + 'EnergySchedulingType': [cgmesProfile.EQ.value, ], + 'nominalVoltage': [cgmesProfile.EQ.value, ], + 'pMin': [cgmesProfile.EQ.value, ], + 'pMax': [cgmesProfile.EQ.value, ], + 'r': [cgmesProfile.SC.value, ], + 'r0': [cgmesProfile.SC.value, ], + 'rn': [cgmesProfile.SC.value, ], + 'x': [cgmesProfile.SC.value, ], + 'x0': [cgmesProfile.SC.value, ], + 'xn': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EnergyConnection: \n' + EnergyConnection.__doc__ + + def __init__(self, activePower = 0.0, reactivePower = 0.0, voltageAngle = 0.0, voltageMagnitude = 0.0, EnergySchedulingType = None, nominalVoltage = 0.0, pMin = 0.0, pMax = 0.0, r = 0.0, r0 = 0.0, rn = 0.0, x = 0.0, x0 = 0.0, xn = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.activePower = activePower + self.reactivePower = reactivePower + self.voltageAngle = voltageAngle + self.voltageMagnitude = voltageMagnitude + self.EnergySchedulingType = EnergySchedulingType + self.nominalVoltage = nominalVoltage + self.pMin = pMin + self.pMax = pMax + self.r = r + self.r0 = r0 + self.rn = rn + self.x = x + self.x0 = x0 + self.xn = xn + + def __str__(self): + str = 'class=EnergySource\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Equipment.py b/cimpy/cgmes_v3_0_0/Equipment.py new file mode 100644 index 00000000..17a687e2 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Equipment.py @@ -0,0 +1,43 @@ +from .PowerSystemResource import PowerSystemResource + + +class Equipment(PowerSystemResource): + ''' + The parts of a power system that are physical devices, electronic or mechanical. + + :inService: Specifies the availability of the equipment. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model. Default: False + :aggregate: The aggregate flag provides an alternative way of representing an aggregated (equivalent) element. It is applicable in cases when the dedicated classes for equivalent equipment do not have all of the attributes necessary to represent the required level of detail. In case the flag is set to `true` the single instance of equipment represents multiple pieces of equipment that have been modelled together as an aggregate equivalent obtained by a network reduction procedure. Examples would be power transformers or synchronous machines operating in parallel modelled as a single aggregate power transformer or aggregate synchronous machine. The attribute is not used for EquivalentBranch, EquivalentShunt and EquivalentInjection. Default: False + :normallyInService: Specifies the availability of the equipment under normal operating conditions. True means the equipment is available for topology processing, which determines if the equipment is energized or not. False means that the equipment is treated by network applications as if it is not in the model. Default: False + :EquipmentContainer: Container of this equipment. Default: None + :OperationalLimitSet: The operational limit sets associated with this equipment. Default: "list" + ''' + + cgmesProfile = PowerSystemResource.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SC.value, ], + 'inService': [cgmesProfile.SSH.value, ], + 'aggregate': [cgmesProfile.EQ.value, ], + 'normallyInService': [cgmesProfile.EQ.value, ], + 'EquipmentContainer': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], +# 'OperationalLimitSet': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemResource: \n' + PowerSystemResource.__doc__ + + def __init__(self, inService = False, aggregate = False, normallyInService = False, EquipmentContainer = None, OperationalLimitSet = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.inService = inService + self.aggregate = aggregate + self.normallyInService = normallyInService + self.EquipmentContainer = EquipmentContainer + self.OperationalLimitSet = OperationalLimitSet + + def __str__(self): + str = 'class=Equipment\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/EquipmentContainer.py b/cimpy/cgmes_v3_0_0/EquipmentContainer.py new file mode 100644 index 00000000..23b25402 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/EquipmentContainer.py @@ -0,0 +1,31 @@ +from .ConnectivityNodeContainer import ConnectivityNodeContainer + + +class EquipmentContainer(ConnectivityNodeContainer): + ''' + A modelling construct to provide a root class for containing equipment. + + :Equipments: Contained equipment. Default: "list" + ''' + + cgmesProfile = ConnectivityNodeContainer.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'Equipments': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ConnectivityNodeContainer: \n' + ConnectivityNodeContainer.__doc__ + + def __init__(self, Equipments = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Equipments = Equipments + + def __str__(self): + str = 'class=EquipmentContainer\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/EquivalentBranch.py b/cimpy/cgmes_v3_0_0/EquivalentBranch.py new file mode 100644 index 00000000..040908fd --- /dev/null +++ b/cimpy/cgmes_v3_0_0/EquivalentBranch.py @@ -0,0 +1,76 @@ +from .EquivalentEquipment import EquivalentEquipment + + +class EquivalentBranch(EquivalentEquipment): + ''' + The class represents equivalent branches. In cases where a transformer phase shift is modelled and the EquivalentBranch is spanning the same nodes, the impedance quantities for the EquivalentBranch shall consider the needed phase shift. + + :r: Positive sequence series resistance of the reduced branch. Default: 0.0 + :r21: Resistance from terminal sequence 2 to terminal sequence 1 .Used for steady state power flow. This attribute is optional and represent unbalanced network such as off-nominal phase shifter. If only EquivalentBranch.r is given, then EquivalentBranch.r21 is assumed equal to EquivalentBranch.r. Usage rule : EquivalentBranch is a result of network reduction prior to the data exchange. Default: 0.0 + :x: Positive sequence series reactance of the reduced branch. Default: 0.0 + :x21: Reactance from terminal sequence 2 to terminal sequence 1. Used for steady state power flow. This attribute is optional and represents an unbalanced network such as off-nominal phase shifter. If only EquivalentBranch.x is given, then EquivalentBranch.x21 is assumed equal to EquivalentBranch.x. Usage rule: EquivalentBranch is a result of network reduction prior to the data exchange. Default: 0.0 + :negativeR12: Negative sequence series resistance from terminal sequence 1 to terminal sequence 2. Used for short circuit data exchange according to IEC 60909. EquivalentBranch is a result of network reduction prior to the data exchange. Default: 0.0 + :negativeR21: Negative sequence series resistance from terminal sequence 2 to terminal sequence 1. Used for short circuit data exchange according to IEC 60909. EquivalentBranch is a result of network reduction prior to the data exchange. Default: 0.0 + :negativeX12: Negative sequence series reactance from terminal sequence 1 to terminal sequence 2. Used for short circuit data exchange according to IEC 60909. Usage : EquivalentBranch is a result of network reduction prior to the data exchange. Default: 0.0 + :negativeX21: Negative sequence series reactance from terminal sequence 2 to terminal sequence 1. Used for short circuit data exchange according to IEC 60909. Usage: EquivalentBranch is a result of network reduction prior to the data exchange. Default: 0.0 + :positiveR12: Positive sequence series resistance from terminal sequence 1 to terminal sequence 2 . Used for short circuit data exchange according to IEC 60909. EquivalentBranch is a result of network reduction prior to the data exchange. Default: 0.0 + :positiveR21: Positive sequence series resistance from terminal sequence 2 to terminal sequence 1. Used for short circuit data exchange according to IEC 60909. EquivalentBranch is a result of network reduction prior to the data exchange. Default: 0.0 + :positiveX12: Positive sequence series reactance from terminal sequence 1 to terminal sequence 2. Used for short circuit data exchange according to IEC 60909. Usage : EquivalentBranch is a result of network reduction prior to the data exchange. Default: 0.0 + :positiveX21: Positive sequence series reactance from terminal sequence 2 to terminal sequence 1. Used for short circuit data exchange according to IEC 60909. Usage : EquivalentBranch is a result of network reduction prior to the data exchange. Default: 0.0 + :zeroR12: Zero sequence series resistance from terminal sequence 1 to terminal sequence 2. Used for short circuit data exchange according to IEC 60909. EquivalentBranch is a result of network reduction prior to the data exchange. Default: 0.0 + :zeroR21: Zero sequence series resistance from terminal sequence 2 to terminal sequence 1. Used for short circuit data exchange according to IEC 60909. Usage : EquivalentBranch is a result of network reduction prior to the data exchange. Default: 0.0 + :zeroX12: Zero sequence series reactance from terminal sequence 1 to terminal sequence 2. Used for short circuit data exchange according to IEC 60909. Usage : EquivalentBranch is a result of network reduction prior to the data exchange. Default: 0.0 + :zeroX21: Zero sequence series reactance from terminal sequence 2 to terminal sequence 1. Used for short circuit data exchange according to IEC 60909. Usage : EquivalentBranch is a result of network reduction prior to the data exchange. Default: 0.0 + ''' + + cgmesProfile = EquivalentEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'r': [cgmesProfile.EQ.value, ], + 'r21': [cgmesProfile.EQ.value, ], + 'x': [cgmesProfile.EQ.value, ], + 'x21': [cgmesProfile.EQ.value, ], + 'negativeR12': [cgmesProfile.SC.value, ], + 'negativeR21': [cgmesProfile.SC.value, ], + 'negativeX12': [cgmesProfile.SC.value, ], + 'negativeX21': [cgmesProfile.SC.value, ], + 'positiveR12': [cgmesProfile.SC.value, ], + 'positiveR21': [cgmesProfile.SC.value, ], + 'positiveX12': [cgmesProfile.SC.value, ], + 'positiveX21': [cgmesProfile.SC.value, ], + 'zeroR12': [cgmesProfile.SC.value, ], + 'zeroR21': [cgmesProfile.SC.value, ], + 'zeroX12': [cgmesProfile.SC.value, ], + 'zeroX21': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EquivalentEquipment: \n' + EquivalentEquipment.__doc__ + + def __init__(self, r = 0.0, r21 = 0.0, x = 0.0, x21 = 0.0, negativeR12 = 0.0, negativeR21 = 0.0, negativeX12 = 0.0, negativeX21 = 0.0, positiveR12 = 0.0, positiveR21 = 0.0, positiveX12 = 0.0, positiveX21 = 0.0, zeroR12 = 0.0, zeroR21 = 0.0, zeroX12 = 0.0, zeroX21 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.r = r + self.r21 = r21 + self.x = x + self.x21 = x21 + self.negativeR12 = negativeR12 + self.negativeR21 = negativeR21 + self.negativeX12 = negativeX12 + self.negativeX21 = negativeX21 + self.positiveR12 = positiveR12 + self.positiveR21 = positiveR21 + self.positiveX12 = positiveX12 + self.positiveX21 = positiveX21 + self.zeroR12 = zeroR12 + self.zeroR21 = zeroR21 + self.zeroX12 = zeroX12 + self.zeroX21 = zeroX21 + + def __str__(self): + str = 'class=EquivalentBranch\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/EquivalentEquipment.py b/cimpy/cgmes_v3_0_0/EquivalentEquipment.py new file mode 100644 index 00000000..6b1a176a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/EquivalentEquipment.py @@ -0,0 +1,31 @@ +from .ConductingEquipment import ConductingEquipment + + +class EquivalentEquipment(ConductingEquipment): + ''' + The class represents equivalent objects that are the result of a network reduction. The class is the base for equivalent objects of different types. + + :EquivalentNetwork: The equivalent where the reduced model belongs. Default: None + ''' + + cgmesProfile = ConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'EquivalentNetwork': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ConductingEquipment: \n' + ConductingEquipment.__doc__ + + def __init__(self, EquivalentNetwork = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.EquivalentNetwork = EquivalentNetwork + + def __str__(self): + str = 'class=EquivalentEquipment\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/EquivalentInjection.py b/cimpy/cgmes_v3_0_0/EquivalentInjection.py new file mode 100644 index 00000000..4269eb0a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/EquivalentInjection.py @@ -0,0 +1,76 @@ +from .EquivalentEquipment import EquivalentEquipment + + +class EquivalentInjection(EquivalentEquipment): + ''' + This class represents equivalent injections (generation or load). Voltage regulation is allowed only at the point of connection. + + :regulationStatus: Specifies the regulation status of the EquivalentInjection. True is regulating. False is not regulating. Default: False + :regulationTarget: The target voltage for voltage regulation. The attribute shall be a positive value. Default: 0.0 + :p: Equivalent active power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions. Default: 0.0 + :q: Equivalent reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions. Default: 0.0 + :maxP: Maximum active power of the injection. Default: 0.0 + :maxQ: Maximum reactive power of the injection. Used for modelling of infeed for load flow exchange. Not used for short circuit modelling. If maxQ and minQ are not used ReactiveCapabilityCurve can be used. Default: 0.0 + :minP: Minimum active power of the injection. Default: 0.0 + :minQ: Minimum reactive power of the injection. Used for modelling of infeed for load flow exchange. Not used for short circuit modelling. If maxQ and minQ are not used ReactiveCapabilityCurve can be used. Default: 0.0 + :regulationCapability: Specifies whether or not the EquivalentInjection has the capability to regulate the local voltage. If true the EquivalentInjection can regulate. If false the EquivalentInjection cannot regulate. ReactiveCapabilityCurve can only be associated with EquivalentInjection if the flag is true. Default: False + :ReactiveCapabilityCurve: The reactive capability curve used by this equivalent injection. Default: None + :r: Positive sequence resistance. Used to represent Extended-Ward (IEC 60909). Usage : Extended-Ward is a result of network reduction prior to the data exchange. Default: 0.0 + :r0: Zero sequence resistance. Used to represent Extended-Ward (IEC 60909). Usage : Extended-Ward is a result of network reduction prior to the data exchange. Default: 0.0 + :r2: Negative sequence resistance. Used to represent Extended-Ward (IEC 60909). Usage : Extended-Ward is a result of network reduction prior to the data exchange. Default: 0.0 + :x: Positive sequence reactance. Used to represent Extended-Ward (IEC 60909). Usage : Extended-Ward is a result of network reduction prior to the data exchange. Default: 0.0 + :x0: Zero sequence reactance. Used to represent Extended-Ward (IEC 60909). Usage : Extended-Ward is a result of network reduction prior to the data exchange. Default: 0.0 + :x2: Negative sequence reactance. Used to represent Extended-Ward (IEC 60909). Usage : Extended-Ward is a result of network reduction prior to the data exchange. Default: 0.0 + ''' + + cgmesProfile = EquivalentEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'regulationStatus': [cgmesProfile.SSH.value, ], + 'regulationTarget': [cgmesProfile.SSH.value, ], + 'p': [cgmesProfile.SSH.value, ], + 'q': [cgmesProfile.SSH.value, ], + 'maxP': [cgmesProfile.EQ.value, ], + 'maxQ': [cgmesProfile.EQ.value, ], + 'minP': [cgmesProfile.EQ.value, ], + 'minQ': [cgmesProfile.EQ.value, ], + 'regulationCapability': [cgmesProfile.EQ.value, ], + 'ReactiveCapabilityCurve': [cgmesProfile.EQ.value, ], + 'r': [cgmesProfile.SC.value, ], + 'r0': [cgmesProfile.SC.value, ], + 'r2': [cgmesProfile.SC.value, ], + 'x': [cgmesProfile.SC.value, ], + 'x0': [cgmesProfile.SC.value, ], + 'x2': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EquivalentEquipment: \n' + EquivalentEquipment.__doc__ + + def __init__(self, regulationStatus = False, regulationTarget = 0.0, p = 0.0, q = 0.0, maxP = 0.0, maxQ = 0.0, minP = 0.0, minQ = 0.0, regulationCapability = False, ReactiveCapabilityCurve = None, r = 0.0, r0 = 0.0, r2 = 0.0, x = 0.0, x0 = 0.0, x2 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.regulationStatus = regulationStatus + self.regulationTarget = regulationTarget + self.p = p + self.q = q + self.maxP = maxP + self.maxQ = maxQ + self.minP = minP + self.minQ = minQ + self.regulationCapability = regulationCapability + self.ReactiveCapabilityCurve = ReactiveCapabilityCurve + self.r = r + self.r0 = r0 + self.r2 = r2 + self.x = x + self.x0 = x0 + self.x2 = x2 + + def __str__(self): + str = 'class=EquivalentInjection\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/EquivalentNetwork.py b/cimpy/cgmes_v3_0_0/EquivalentNetwork.py new file mode 100644 index 00000000..c8cbc0e2 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/EquivalentNetwork.py @@ -0,0 +1,31 @@ +from .ConnectivityNodeContainer import ConnectivityNodeContainer + + +class EquivalentNetwork(ConnectivityNodeContainer): + ''' + A class that groups electrical equivalents, including internal nodes, of a network that has been reduced. The ConnectivityNodes contained in the equivalent are intended to reflect internal nodes of the equivalent. The boundary Connectivity nodes where the equivalent connects outside itself are not contained by the equivalent. + + :EquivalentEquipments: The associated reduced equivalents. Default: "list" + ''' + + cgmesProfile = ConnectivityNodeContainer.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'EquivalentEquipments': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ConnectivityNodeContainer: \n' + ConnectivityNodeContainer.__doc__ + + def __init__(self, EquivalentEquipments = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.EquivalentEquipments = EquivalentEquipments + + def __str__(self): + str = 'class=EquivalentNetwork\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/EquivalentShunt.py b/cimpy/cgmes_v3_0_0/EquivalentShunt.py new file mode 100644 index 00000000..93a9f74d --- /dev/null +++ b/cimpy/cgmes_v3_0_0/EquivalentShunt.py @@ -0,0 +1,34 @@ +from .EquivalentEquipment import EquivalentEquipment + + +class EquivalentShunt(EquivalentEquipment): + ''' + The class represents equivalent shunts. + + :b: Positive sequence shunt susceptance. Default: 0.0 + :g: Positive sequence shunt conductance. Default: 0.0 + ''' + + cgmesProfile = EquivalentEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'b': [cgmesProfile.EQ.value, ], + 'g': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EquivalentEquipment: \n' + EquivalentEquipment.__doc__ + + def __init__(self, b = 0.0, g = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.b = b + self.g = g + + def __str__(self): + str = 'class=EquivalentShunt\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcAC1A.py b/cimpy/cgmes_v3_0_0/ExcAC1A.py new file mode 100644 index 00000000..ad141fab --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcAC1A.py @@ -0,0 +1,94 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcAC1A(ExcitationSystemDynamics): + ''' + Modified IEEE AC1A alternator-supplied rectifier excitation system with different rate feedback source. + + :tb: Voltage regulator time constant (Tb) (>= 0). Typical value = 0. Default: 0 + :tc: Voltage regulator time constant (Tc) (>= 0). Typical value = 0. Default: 0 + :ka: Voltage regulator gain (Ka) (> 0). Typical value = 400. Default: 0.0 + :ta: Voltage regulator time constant (Ta) (> 0). Typical value = 0,02. Default: 0 + :vamax: Maximum voltage regulator output (Vamax) (> 0). Typical value = 14,5. Default: 0.0 + :vamin: Minimum voltage regulator output (Vamin) (< 0). Typical value = -14,5. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (Te) (> 0). Typical value = 0,8. Default: 0 + :kf: Excitation control system stabilizer gains (Kf) (>= 0). Typical value = 0,03. Default: 0.0 + :kf1: Coefficient to allow different usage of the model (Kf1) (>= 0). Typical value = 0. Default: 0.0 + :kf2: Coefficient to allow different usage of the model (Kf2) (>= 0). Typical value = 1. Default: 0.0 + :ks: Coefficient to allow different usage of the model-speed coefficient (Ks) (>= 0). Typical value = 0. Default: 0.0 + :tf: Excitation control system stabilizer time constant (Tf) (> 0). Typical value = 1. Default: 0 + :kc: Rectifier loading factor proportional to commutating reactance (Kc) (>= 0). Typical value = 0,2. Default: 0.0 + :kd: Demagnetizing factor, a function of exciter alternator reactances (Kd) (>= 0). Typical value = 0,38. Default: 0.0 + :ke: Exciter constant related to self-excited field (Ke). Typical value = 1. Default: 0.0 + :ve1: Exciter alternator output voltages back of commutating reactance at which saturation is defined (Ve1) (> 0). Typical value = 4,18. Default: 0.0 + :seve1: Exciter saturation function value at the corresponding exciter voltage, Ve1, back of commutating reactance (Se[Ve1]) (>= 0). Typical value = 0,1. Default: 0.0 + :ve2: Exciter alternator output voltages back of commutating reactance at which saturation is defined (Ve2) (> 0). Typical value = 3,14. Default: 0.0 + :seve2: Exciter saturation function value at the corresponding exciter voltage, Ve2, back of commutating reactance (Se[Ve2]) (>= 0). Typical value = 0,03. Default: 0.0 + :vrmax: Maximum voltage regulator outputs (Vrmax) (> 0). Typical value = 6,03. Default: 0.0 + :vrmin: Minimum voltage regulator outputs (Vrmin) (< 0). Typical value = -5,43. Default: 0.0 + :hvlvgates: Indicates if both HV gate and LV gate are active (HVLVgates). true = gates are used false = gates are not used. Typical value = true. Default: False + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'vamax': [cgmesProfile.DY.value, ], + 'vamin': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'kf1': [cgmesProfile.DY.value, ], + 'kf2': [cgmesProfile.DY.value, ], + 'ks': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 've1': [cgmesProfile.DY.value, ], + 'seve1': [cgmesProfile.DY.value, ], + 've2': [cgmesProfile.DY.value, ], + 'seve2': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'hvlvgates': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, tb = 0, tc = 0, ka = 0.0, ta = 0, vamax = 0.0, vamin = 0.0, te = 0, kf = 0.0, kf1 = 0.0, kf2 = 0.0, ks = 0.0, tf = 0, kc = 0.0, kd = 0.0, ke = 0.0, ve1 = 0.0, seve1 = 0.0, ve2 = 0.0, seve2 = 0.0, vrmax = 0.0, vrmin = 0.0, hvlvgates = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.tb = tb + self.tc = tc + self.ka = ka + self.ta = ta + self.vamax = vamax + self.vamin = vamin + self.te = te + self.kf = kf + self.kf1 = kf1 + self.kf2 = kf2 + self.ks = ks + self.tf = tf + self.kc = kc + self.kd = kd + self.ke = ke + self.ve1 = ve1 + self.seve1 = seve1 + self.ve2 = ve2 + self.seve2 = seve2 + self.vrmax = vrmax + self.vrmin = vrmin + self.hvlvgates = hvlvgates + + def __str__(self): + str = 'class=ExcAC1A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcAC2A.py b/cimpy/cgmes_v3_0_0/ExcAC2A.py new file mode 100644 index 00000000..cec08d58 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcAC2A.py @@ -0,0 +1,112 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcAC2A(ExcitationSystemDynamics): + ''' + Modified IEEE AC2A alternator-supplied rectifier excitation system with different field current limit. + + :tb: Voltage regulator time constant (Tb) (>= 0). Typical value = 0. Default: 0 + :tc: Voltage regulator time constant (Tc) (>= 0). Typical value = 0. Default: 0 + :ka: Voltage regulator gain (Ka) (> 0). Typical value = 400. Default: 0.0 + :ta: Voltage regulator time constant (Ta) (> 0). Typical value = 0,02. Default: 0 + :vamax: Maximum voltage regulator output (Vamax) (> 0). Typical value = 8. Default: 0.0 + :vamin: Minimum voltage regulator output (Vamin) (< 0). Typical value = -8. Default: 0.0 + :kb: Second stage regulator gain (Kb) (> 0). Exciter field current controller gain. Typical value = 25. Default: 0.0 + :kb1: Second stage regulator gain (Kb1). It is exciter field current controller gain used as alternative to Kb to represent a variant of the ExcAC2A model. Typical value = 25. Default: 0.0 + :vrmax: Maximum voltage regulator outputs (Vrmax) (> 0). Typical value = 105. Default: 0.0 + :vrmin: Minimum voltage regulator outputs (Vrmin) (< 0). Typical value = -95. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (Te) (> 0). Typical value = 0,6. Default: 0 + :vfemax: Exciter field current limit reference (Vfemax) (>= 0). Typical value = 4,4. Default: 0.0 + :kh: Exciter field current feedback gain (Kh) (>= 0). Typical value = 1. Default: 0.0 + :kf: Excitation control system stabilizer gains (Kf) (>= 0). Typical value = 0,03. Default: 0.0 + :kl: Exciter field current limiter gain (Kl). Typical value = 10. Default: 0.0 + :vlr: Maximum exciter field current (Vlr) (> 0). Typical value = 4,4. Default: 0.0 + :kl1: Coefficient to allow different usage of the model (Kl1). Typical value = 1. Default: 0.0 + :ks: Coefficient to allow different usage of the model-speed coefficient (Ks) (>= 0). Typical value = 0. Default: 0.0 + :tf: Excitation control system stabilizer time constant (Tf) (> 0). Typical value = 1. Default: 0 + :kc: Rectifier loading factor proportional to commutating reactance (Kc) (>= 0). Typical value = 0,28. Default: 0.0 + :kd: Demagnetizing factor, a function of exciter alternator reactances (Kd) (>= 0). Typical value = 0,35. Default: 0.0 + :ke: Exciter constant related to self-excited field (Ke). Typical value = 1. Default: 0.0 + :ve1: Exciter alternator output voltages back of commutating reactance at which saturation is defined (Ve1) (> 0). Typical value = 4,4. Default: 0.0 + :seve1: Exciter saturation function value at the corresponding exciter voltage, Ve1, back of commutating reactance (Se[Ve1]) (>= 0). Typical value = 0,037. Default: 0.0 + :ve2: Exciter alternator output voltages back of commutating reactance at which saturation is defined (Ve2) (> 0). Typical value = 3,3. Default: 0.0 + :seve2: Exciter saturation function value at the corresponding exciter voltage, Ve2, back of commutating reactance (Se[Ve2]) (>= 0). Typical value = 0,012. Default: 0.0 + :hvgate: Indicates if HV gate is active (HVgate). true = gate is used false = gate is not used. Typical value = true. Default: False + :lvgate: Indicates if LV gate is active (LVgate). true = gate is used false = gate is not used. Typical value = true. Default: False + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'vamax': [cgmesProfile.DY.value, ], + 'vamin': [cgmesProfile.DY.value, ], + 'kb': [cgmesProfile.DY.value, ], + 'kb1': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'vfemax': [cgmesProfile.DY.value, ], + 'kh': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'kl': [cgmesProfile.DY.value, ], + 'vlr': [cgmesProfile.DY.value, ], + 'kl1': [cgmesProfile.DY.value, ], + 'ks': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 've1': [cgmesProfile.DY.value, ], + 'seve1': [cgmesProfile.DY.value, ], + 've2': [cgmesProfile.DY.value, ], + 'seve2': [cgmesProfile.DY.value, ], + 'hvgate': [cgmesProfile.DY.value, ], + 'lvgate': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, tb = 0, tc = 0, ka = 0.0, ta = 0, vamax = 0.0, vamin = 0.0, kb = 0.0, kb1 = 0.0, vrmax = 0.0, vrmin = 0.0, te = 0, vfemax = 0.0, kh = 0.0, kf = 0.0, kl = 0.0, vlr = 0.0, kl1 = 0.0, ks = 0.0, tf = 0, kc = 0.0, kd = 0.0, ke = 0.0, ve1 = 0.0, seve1 = 0.0, ve2 = 0.0, seve2 = 0.0, hvgate = False, lvgate = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.tb = tb + self.tc = tc + self.ka = ka + self.ta = ta + self.vamax = vamax + self.vamin = vamin + self.kb = kb + self.kb1 = kb1 + self.vrmax = vrmax + self.vrmin = vrmin + self.te = te + self.vfemax = vfemax + self.kh = kh + self.kf = kf + self.kl = kl + self.vlr = vlr + self.kl1 = kl1 + self.ks = ks + self.tf = tf + self.kc = kc + self.kd = kd + self.ke = ke + self.ve1 = ve1 + self.seve1 = seve1 + self.ve2 = ve2 + self.seve2 = seve2 + self.hvgate = hvgate + self.lvgate = lvgate + + def __str__(self): + str = 'class=ExcAC2A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcAC3A.py b/cimpy/cgmes_v3_0_0/ExcAC3A.py new file mode 100644 index 00000000..994f6e85 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcAC3A.py @@ -0,0 +1,106 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcAC3A(ExcitationSystemDynamics): + ''' + Modified IEEE AC3A alternator-supplied rectifier excitation system with different field current limit. + + :tb: Voltage regulator time constant (Tb) (>= 0). Typical value = 0. Default: 0 + :tc: Voltage regulator time constant (Tc) (>= 0). Typical value = 0. Default: 0 + :ka: Voltage regulator gain (Ka) (> 0). Typical value = 45,62. Default: 0 + :ta: Voltage regulator time constant (Ta) (> 0). Typical value = 0,013. Default: 0.0 + :vamax: Maximum voltage regulator output (Vamax) (> 0). Typical value = 1. Default: 0.0 + :vamin: Minimum voltage regulator output (Vamin) (< 0). Typical value = -0,95. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (Te) (> 0). Typical value = 1,17. Default: 0 + :vemin: Minimum exciter voltage output (Vemin) (<= 0). Typical value = 0. Default: 0.0 + :kr: Constant associated with regulator and alternator field power supply (Kr) (> 0). Typical value =3,77. Default: 0.0 + :kf: Excitation control system stabilizer gains (Kf) (>= 0). Typical value = 0,143. Default: 0.0 + :tf: Excitation control system stabilizer time constant (Tf) (> 0). Typical value = 1. Default: 0 + :kn: Excitation control system stabilizer gain (Kn) (>= 0). Typical value =0,05. Default: 0.0 + :efdn: Value of Efd at which feedback gain changes (Efdn) (> 0). Typical value = 2,36. Default: 0.0 + :kc: Rectifier loading factor proportional to commutating reactance (Kc) (>= 0). Typical value = 0,104. Default: 0.0 + :kd: Demagnetizing factor, a function of exciter alternator reactances (Kd) (>= 0). Typical value = 0,499. Default: 0.0 + :ke: Exciter constant related to self-excited field (Ke). Typical value = 1. Default: 0.0 + :klv: Gain used in the minimum field voltage limiter loop (Klv). Typical value = 0,194. Default: 0.0 + :kf1: Coefficient to allow different usage of the model (Kf1). Typical value = 1. Default: 0.0 + :kf2: Coefficient to allow different usage of the model (Kf2). Typical value = 0. Default: 0.0 + :ks: Coefficient to allow different usage of the model-speed coefficient (Ks). Typical value = 0. Default: 0.0 + :vfemax: Exciter field current limit reference (Vfemax) (>= 0). Typical value = 16. Default: 0.0 + :ve1: Exciter alternator output voltages back of commutating reactance at which saturation is defined (Ve1) (> 0). Typical value = 6.24. Default: 0.0 + :seve1: Exciter saturation function value at the corresponding exciter voltage, Ve1, back of commutating reactance (Se[Ve1]) (>= 0). Typical value = 1,143. Default: 0.0 + :ve2: Exciter alternator output voltages back of commutating reactance at which saturation is defined (Ve2) (> 0). Typical value = 4,68. Default: 0.0 + :seve2: Exciter saturation function value at the corresponding exciter voltage, Ve2, back of commutating reactance (Se[Ve2]) (>= 0). Typical value = 0,1. Default: 0.0 + :vlv: Field voltage used in the minimum field voltage limiter loop (Vlv). Typical value = 0,79. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'vamax': [cgmesProfile.DY.value, ], + 'vamin': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'vemin': [cgmesProfile.DY.value, ], + 'kr': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'kn': [cgmesProfile.DY.value, ], + 'efdn': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'klv': [cgmesProfile.DY.value, ], + 'kf1': [cgmesProfile.DY.value, ], + 'kf2': [cgmesProfile.DY.value, ], + 'ks': [cgmesProfile.DY.value, ], + 'vfemax': [cgmesProfile.DY.value, ], + 've1': [cgmesProfile.DY.value, ], + 'seve1': [cgmesProfile.DY.value, ], + 've2': [cgmesProfile.DY.value, ], + 'seve2': [cgmesProfile.DY.value, ], + 'vlv': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, tb = 0, tc = 0, ka = 0, ta = 0.0, vamax = 0.0, vamin = 0.0, te = 0, vemin = 0.0, kr = 0.0, kf = 0.0, tf = 0, kn = 0.0, efdn = 0.0, kc = 0.0, kd = 0.0, ke = 0.0, klv = 0.0, kf1 = 0.0, kf2 = 0.0, ks = 0.0, vfemax = 0.0, ve1 = 0.0, seve1 = 0.0, ve2 = 0.0, seve2 = 0.0, vlv = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.tb = tb + self.tc = tc + self.ka = ka + self.ta = ta + self.vamax = vamax + self.vamin = vamin + self.te = te + self.vemin = vemin + self.kr = kr + self.kf = kf + self.tf = tf + self.kn = kn + self.efdn = efdn + self.kc = kc + self.kd = kd + self.ke = ke + self.klv = klv + self.kf1 = kf1 + self.kf2 = kf2 + self.ks = ks + self.vfemax = vfemax + self.ve1 = ve1 + self.seve1 = seve1 + self.ve2 = ve2 + self.seve2 = seve2 + self.vlv = vlv + + def __str__(self): + str = 'class=ExcAC3A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcAC4A.py b/cimpy/cgmes_v3_0_0/ExcAC4A.py new file mode 100644 index 00000000..e31bfc52 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcAC4A.py @@ -0,0 +1,55 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcAC4A(ExcitationSystemDynamics): + ''' + Modified IEEE AC4A alternator-supplied rectifier excitation system with different minimum controller output. + + :vimax: Maximum voltage regulator input limit (Vimax) (> 0). Typical value = 10. Default: 0.0 + :vimin: Minimum voltage regulator input limit (Vimin) (< 0). Typical value = -10. Default: 0.0 + :tc: Voltage regulator time constant (Tc) (>= 0). Typical value = 1. Default: 0 + :tb: Voltage regulator time constant (Tb) (>= 0). Typical value = 10. Default: 0 + :ka: Voltage regulator gain (Ka) (> 0). Typical value = 200. Default: 0.0 + :ta: Voltage regulator time constant (Ta) (> 0). Typical value = 0,015. Default: 0 + :vrmax: Maximum voltage regulator output (Vrmax) (> 0). Typical value = 5,64. Default: 0.0 + :vrmin: Minimum voltage regulator output (Vrmin) (< 0). Typical value = -4,53. Default: 0.0 + :kc: Rectifier loading factor proportional to commutating reactance (Kc) (>= 0). Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'vimax': [cgmesProfile.DY.value, ], + 'vimin': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, vimax = 0.0, vimin = 0.0, tc = 0, tb = 0, ka = 0.0, ta = 0, vrmax = 0.0, vrmin = 0.0, kc = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.vimax = vimax + self.vimin = vimin + self.tc = tc + self.tb = tb + self.ka = ka + self.ta = ta + self.vrmax = vrmax + self.vrmin = vrmin + self.kc = kc + + def __str__(self): + str = 'class=ExcAC4A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcAC5A.py b/cimpy/cgmes_v3_0_0/ExcAC5A.py new file mode 100644 index 00000000..38c9cf9a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcAC5A.py @@ -0,0 +1,82 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcAC5A(ExcitationSystemDynamics): + ''' + Modified IEEE AC5A alternator-supplied rectifier excitation system with different minimum controller output. + + :ka: Voltage regulator gain (Ka) (> 0). Typical value = 400. Default: 0.0 + :ks: Coefficient to allow different usage of the model-speed coefficient (Ks). Typical value = 0. Default: 0.0 + :tb: Voltage regulator time constant (Tb) (>= 0). Typical value = 0. Default: 0 + :tc: Voltage regulator time constant (Tc) (>= 0). Typical value = 0. Default: 0 + :ta: Voltage regulator time constant (Ta) (> 0). Typical value = 0,02. Default: 0 + :vrmax: Maximum voltage regulator output (Vrmax) (> 0). Typical value = 7,3. Default: 0.0 + :vrmin: Minimum voltage regulator output (Vrmin) (< 0). Typical value =-7,3. Default: 0.0 + :ke: Exciter constant related to self-excited field (Ke). Typical value = 1. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (Te) (> 0). Typical value = 0,8. Default: 0 + :kf: Excitation control system stabilizer gains (Kf) (>= 0). Typical value = 0,03. Default: 0.0 + :tf1: Excitation control system stabilizer time constant (Tf1) (> 0). Typical value = 1. Default: 0 + :tf2: Excitation control system stabilizer time constant (Tf2) (>= 0). Typical value = 0,8. Default: 0 + :tf3: Excitation control system stabilizer time constant (Tf3) (>= 0). Typical value = 0. Default: 0 + :efd1: Exciter voltage at which exciter saturation is defined (Efd1) (> 0). Typical value = 5,6. Default: 0.0 + :seefd1: Exciter saturation function value at the corresponding exciter voltage, Efd1 (Se[Efd1]) (>= 0). Typical value = 0,86. Default: 0.0 + :efd2: Exciter voltage at which exciter saturation is defined (Efd2) (> 0). Typical value = 4,2. Default: 0.0 + :seefd2: Exciter saturation function value at the corresponding exciter voltage, Efd2 (Se[Efd2]) (>= 0). Typical value = 0,5. Default: 0.0 + :a: Coefficient to allow different usage of the model (a). Typical value = 1. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ks': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf1': [cgmesProfile.DY.value, ], + 'tf2': [cgmesProfile.DY.value, ], + 'tf3': [cgmesProfile.DY.value, ], + 'efd1': [cgmesProfile.DY.value, ], + 'seefd1': [cgmesProfile.DY.value, ], + 'efd2': [cgmesProfile.DY.value, ], + 'seefd2': [cgmesProfile.DY.value, ], + 'a': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ka = 0.0, ks = 0.0, tb = 0, tc = 0, ta = 0, vrmax = 0.0, vrmin = 0.0, ke = 0.0, te = 0, kf = 0.0, tf1 = 0, tf2 = 0, tf3 = 0, efd1 = 0.0, seefd1 = 0.0, efd2 = 0.0, seefd2 = 0.0, a = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.ks = ks + self.tb = tb + self.tc = tc + self.ta = ta + self.vrmax = vrmax + self.vrmin = vrmin + self.ke = ke + self.te = te + self.kf = kf + self.tf1 = tf1 + self.tf2 = tf2 + self.tf3 = tf3 + self.efd1 = efd1 + self.seefd1 = seefd1 + self.efd2 = efd2 + self.seefd2 = seefd2 + self.a = a + + def __str__(self): + str = 'class=ExcAC5A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcAC6A.py b/cimpy/cgmes_v3_0_0/ExcAC6A.py new file mode 100644 index 00000000..dbda0435 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcAC6A.py @@ -0,0 +1,97 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcAC6A(ExcitationSystemDynamics): + ''' + Modified IEEE AC6A alternator-supplied rectifier excitation system with speed input. + + :ka: Voltage regulator gain (Ka) (> 0). Typical value = 536. Default: 0.0 + :ks: Coefficient to allow different usage of the model-speed coefficient (Ks). Typical value = 0. Default: 0.0 + :ta: Voltage regulator time constant (Ta) (>= 0). Typical value = 0,086. Default: 0 + :tk: Voltage regulator time constant (Tk) (>= 0). Typical value = 0,18. Default: 0 + :tb: Voltage regulator time constant (Tb) (>= 0). Typical value = 9. Default: 0 + :tc: Voltage regulator time constant (Tc) (>= 0). Typical value = 3. Default: 0 + :vamax: Maximum voltage regulator output (Vamax) (> 0). Typical value = 75. Default: 0.0 + :vamin: Minimum voltage regulator output (Vamin) (< 0). Typical value = -75. Default: 0.0 + :vrmax: Maximum voltage regulator output (Vrmax) (> 0). Typical value = 44. Default: 0.0 + :vrmin: Minimum voltage regulator output (Vrmin) (< 0). Typical value = -36. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (Te) (> 0). Typical value = 1. Default: 0 + :kh: Exciter field current limiter gain (Kh) (>= 0). Typical value = 92. Default: 0.0 + :tj: Exciter field current limiter time constant (Tj) (>= 0). Typical value = 0,02. Default: 0 + :th: Exciter field current limiter time constant (Th) (> 0). Typical value = 0,08. Default: 0 + :vfelim: Exciter field current limit reference (Vfelim) (> 0). Typical value = 19. Default: 0.0 + :vhmax: Maximum field current limiter signal reference (Vhmax) (> 0). Typical value = 75. Default: 0.0 + :kc: Rectifier loading factor proportional to commutating reactance (Kc) (>= 0). Typical value = 0,173. Default: 0.0 + :kd: Demagnetizing factor, a function of exciter alternator reactances (Kd) (>= 0). Typical value = 1,91. Default: 0.0 + :ke: Exciter constant related to self-excited field (Ke). Typical value = 1,6. Default: 0.0 + :ve1: Exciter alternator output voltages back of commutating reactance at which saturation is defined (Ve1) (> 0). Typical value = 7,4. Default: 0.0 + :seve1: Exciter saturation function value at the corresponding exciter voltage, Ve1, back of commutating reactance (Se[Ve1]) (>= 0). Typical value = 0,214. Default: 0.0 + :ve2: Exciter alternator output voltages back of commutating reactance at which saturation is defined (Ve2) (> 0). Typical value = 5,55. Default: 0.0 + :seve2: Exciter saturation function value at the corresponding exciter voltage, Ve2, back of commutating reactance (Se[Ve2]) (>= 0). Typical value = 0,044. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ks': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tk': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'vamax': [cgmesProfile.DY.value, ], + 'vamin': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'kh': [cgmesProfile.DY.value, ], + 'tj': [cgmesProfile.DY.value, ], + 'th': [cgmesProfile.DY.value, ], + 'vfelim': [cgmesProfile.DY.value, ], + 'vhmax': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 've1': [cgmesProfile.DY.value, ], + 'seve1': [cgmesProfile.DY.value, ], + 've2': [cgmesProfile.DY.value, ], + 'seve2': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ka = 0.0, ks = 0.0, ta = 0, tk = 0, tb = 0, tc = 0, vamax = 0.0, vamin = 0.0, vrmax = 0.0, vrmin = 0.0, te = 0, kh = 0.0, tj = 0, th = 0, vfelim = 0.0, vhmax = 0.0, kc = 0.0, kd = 0.0, ke = 0.0, ve1 = 0.0, seve1 = 0.0, ve2 = 0.0, seve2 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.ks = ks + self.ta = ta + self.tk = tk + self.tb = tb + self.tc = tc + self.vamax = vamax + self.vamin = vamin + self.vrmax = vrmax + self.vrmin = vrmin + self.te = te + self.kh = kh + self.tj = tj + self.th = th + self.vfelim = vfelim + self.vhmax = vhmax + self.kc = kc + self.kd = kd + self.ke = ke + self.ve1 = ve1 + self.seve1 = seve1 + self.ve2 = ve2 + self.seve2 = seve2 + + def __str__(self): + str = 'class=ExcAC6A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcAC8B.py b/cimpy/cgmes_v3_0_0/ExcAC8B.py new file mode 100644 index 00000000..858e1511 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcAC8B.py @@ -0,0 +1,109 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcAC8B(ExcitationSystemDynamics): + ''' + Modified IEEE AC8B alternator-supplied rectifier excitation system with speed input and input limiter. + + :inlim: Input limiter indicator. true = input limiter Vimax and Vimin is considered false = input limiter Vimax and Vimin is not considered. Typical value = true. Default: False + :ka: Voltage regulator gain (Ka) (> 0). Typical value = 1. Default: 0.0 + :kc: Rectifier loading factor proportional to commutating reactance (Kc) (>= 0). Typical value = 0,55. Default: 0.0 + :kd: Demagnetizing factor, a function of exciter alternator reactances (Kd) (>= 0). Typical value = 1,1. Default: 0.0 + :kdr: Voltage regulator derivative gain (Kdr) (>= 0). Typical value = 10. Default: 0.0 + :ke: Exciter constant related to self-excited field (Ke). Typical value = 1. Default: 0.0 + :kir: Voltage regulator integral gain (Kir) (>= 0). Typical value = 5. Default: 0.0 + :kpr: Voltage regulator proportional gain (Kpr) (> 0 if ExcAC8B.kir = 0). Typical value = 80. Default: 0.0 + :ks: Coefficient to allow different usage of the model-speed coefficient (Ks). Typical value = 0. Default: 0.0 + :pidlim: PID limiter indicator. true = input limiter Vpidmax and Vpidmin is considered false = input limiter Vpidmax and Vpidmin is not considered. Typical value = true. Default: False + :seve1: Exciter saturation function value at the corresponding exciter voltage, Ve1, back of commutating reactance (Se[Ve1]) (>= 0). Typical value = 0,3. Default: 0.0 + :seve2: Exciter saturation function value at the corresponding exciter voltage, Ve2, back of commutating reactance (Se[Ve2]) (>= 0). Typical value = 3. Default: 0.0 + :ta: Voltage regulator time constant (Ta) (>= 0). Typical value = 0. Default: 0 + :tdr: Lag time constant (Tdr) (> 0 if ExcAC8B.kdr > 0). Typical value = 0,1. Default: 0 + :te: Exciter time constant, integration rate associated with exciter control (Te) (> 0). Typical value = 1,2. Default: 0 + :telim: Selector for the limiter on the block (1/sTe). See diagram for meaning of true and false. Typical value = false. Default: False + :ve1: Exciter alternator output voltages back of commutating reactance at which saturation is defined (Ve1) (> 0). Typical value = 6,5. Default: 0.0 + :ve2: Exciter alternator output voltages back of commutating reactance at which saturation is defined (Ve2) (> 0). Typical value = 9. Default: 0.0 + :vemin: Minimum exciter voltage output (Vemin) (<= 0). Typical value = 0. Default: 0.0 + :vfemax: Exciter field current limit reference (Vfemax). Typical value = 6. Default: 0.0 + :vimax: Input signal maximum (Vimax) (> ExcAC8B.vimin). Typical value = 35. Default: 0.0 + :vimin: Input signal minimum (Vimin) (< ExcAC8B.vimax). Typical value = -10. Default: 0.0 + :vpidmax: PID maximum controller output (Vpidmax) (> ExcAC8B.vpidmin). Typical value = 35. Default: 0.0 + :vpidmin: PID minimum controller output (Vpidmin) (< ExcAC8B.vpidmax). Typical value = -10. Default: 0.0 + :vrmax: Maximum voltage regulator output (Vrmax) (> 0). Typical value = 35. Default: 0.0 + :vrmin: Minimum voltage regulator output (Vrmin) (< 0). Typical value = 0. Default: 0.0 + :vtmult: Multiply by generator`s terminal voltage indicator. true =the limits Vrmax and Vrmin are multiplied by the generator`s terminal voltage to represent a thyristor power stage fed from the generator terminals false = limits are not multiplied by generator`s terminal voltage. Typical value = false. Default: False + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'inlim': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'kdr': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'kir': [cgmesProfile.DY.value, ], + 'kpr': [cgmesProfile.DY.value, ], + 'ks': [cgmesProfile.DY.value, ], + 'pidlim': [cgmesProfile.DY.value, ], + 'seve1': [cgmesProfile.DY.value, ], + 'seve2': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tdr': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'telim': [cgmesProfile.DY.value, ], + 've1': [cgmesProfile.DY.value, ], + 've2': [cgmesProfile.DY.value, ], + 'vemin': [cgmesProfile.DY.value, ], + 'vfemax': [cgmesProfile.DY.value, ], + 'vimax': [cgmesProfile.DY.value, ], + 'vimin': [cgmesProfile.DY.value, ], + 'vpidmax': [cgmesProfile.DY.value, ], + 'vpidmin': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'vtmult': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, inlim = False, ka = 0.0, kc = 0.0, kd = 0.0, kdr = 0.0, ke = 0.0, kir = 0.0, kpr = 0.0, ks = 0.0, pidlim = False, seve1 = 0.0, seve2 = 0.0, ta = 0, tdr = 0, te = 0, telim = False, ve1 = 0.0, ve2 = 0.0, vemin = 0.0, vfemax = 0.0, vimax = 0.0, vimin = 0.0, vpidmax = 0.0, vpidmin = 0.0, vrmax = 0.0, vrmin = 0.0, vtmult = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.inlim = inlim + self.ka = ka + self.kc = kc + self.kd = kd + self.kdr = kdr + self.ke = ke + self.kir = kir + self.kpr = kpr + self.ks = ks + self.pidlim = pidlim + self.seve1 = seve1 + self.seve2 = seve2 + self.ta = ta + self.tdr = tdr + self.te = te + self.telim = telim + self.ve1 = ve1 + self.ve2 = ve2 + self.vemin = vemin + self.vfemax = vfemax + self.vimax = vimax + self.vimin = vimin + self.vpidmax = vpidmax + self.vpidmin = vpidmin + self.vrmax = vrmax + self.vrmin = vrmin + self.vtmult = vtmult + + def __str__(self): + str = 'class=ExcAC8B\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcANS.py b/cimpy/cgmes_v3_0_0/ExcANS.py new file mode 100644 index 00000000..56eef5eb --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcANS.py @@ -0,0 +1,70 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcANS(ExcitationSystemDynamics): + ''' + Italian excitation system. It represents static field voltage or excitation current feedback excitation system. + + :k3: AVR gain (K3). Typical value = 1000. Default: 0.0 + :k2: Exciter gain (K2). Typical value = 20. Default: 0.0 + :kce: Ceiling factor (KCE). Typical value = 1. Default: 0.0 + :t3: Time constant (T3) (>= 0). Typical value = 1,6. Default: 0 + :t2: Time constant (T2) (>= 0). Typical value = 0,05. Default: 0 + :t1: Time constant (T1) (>= 0). Typical value = 20. Default: 0 + :blint: Governor control flag (BLINT). 0 = lead-lag regulator 1 = proportional integral regulator. Typical value = 0. Default: 0 + :kvfif: Rate feedback signal flag (KVFIF). 0 = output voltage of the exciter 1 = exciter field current. Typical value = 0. Default: 0 + :ifmn: Minimum exciter current (IFMN). Typical value = -5,2. Default: 0.0 + :ifmx: Maximum exciter current (IFMX). Typical value = 6,5. Default: 0.0 + :vrmn: Minimum AVR output (VRMN). Typical value = -5,2. Default: 0.0 + :vrmx: Maximum AVR output (VRMX). Typical value = 6,5. Default: 0.0 + :krvecc: Feedback enabling (KRVECC). 0 = open loop control 1 = closed loop control. Typical value = 1. Default: 0 + :tb: Exciter time constant (TB) (>= 0). Typical value = 0,04. Default: 0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'k3': [cgmesProfile.DY.value, ], + 'k2': [cgmesProfile.DY.value, ], + 'kce': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 'blint': [cgmesProfile.DY.value, ], + 'kvfif': [cgmesProfile.DY.value, ], + 'ifmn': [cgmesProfile.DY.value, ], + 'ifmx': [cgmesProfile.DY.value, ], + 'vrmn': [cgmesProfile.DY.value, ], + 'vrmx': [cgmesProfile.DY.value, ], + 'krvecc': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, k3 = 0.0, k2 = 0.0, kce = 0.0, t3 = 0, t2 = 0, t1 = 0, blint = 0, kvfif = 0, ifmn = 0.0, ifmx = 0.0, vrmn = 0.0, vrmx = 0.0, krvecc = 0, tb = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.k3 = k3 + self.k2 = k2 + self.kce = kce + self.t3 = t3 + self.t2 = t2 + self.t1 = t1 + self.blint = blint + self.kvfif = kvfif + self.ifmn = ifmn + self.ifmx = ifmx + self.vrmn = vrmn + self.vrmx = vrmx + self.krvecc = krvecc + self.tb = tb + + def __str__(self): + str = 'class=ExcANS\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcAVR1.py b/cimpy/cgmes_v3_0_0/ExcAVR1.py new file mode 100644 index 00000000..20cbbd30 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcAVR1.py @@ -0,0 +1,64 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcAVR1(ExcitationSystemDynamics): + ''' + Italian excitation system corresponding to IEEE (1968) type 1 model. It represents an exciter dynamo and electromechanical regulator. + + :ka: AVR gain (KA). Typical value = 500. Default: 0.0 + :vrmn: Minimum AVR output (VRMN). Typical value = -6. Default: 0.0 + :vrmx: Maximum AVR output (VRMX). Typical value = 7. Default: 0.0 + :ta: AVR time constant (TA) (>= 0). Typical value = 0,2. Default: 0 + :tb: AVR time constant (TB) (>= 0). Typical value = 0. Default: 0 + :te: Exciter time constant (TE) (>= 0). Typical value = 1. Default: 0 + :e1: Field voltage value 1 (E1). Typical value = 4.18. Default: 0.0 + :se1: Saturation factor at E1 (S[E1]). Typical value = 0,1. Default: 0.0 + :e2: Field voltage value 2 (E2). Typical value = 3,14. Default: 0.0 + :se2: Saturation factor at E2 (S[E2]). Typical value = 0,03. Default: 0.0 + :kf: Rate feedback gain (KF). Typical value = 0,12. Default: 0.0 + :tf: Rate feedback time constant (TF) (>= 0). Typical value = 1. Default: 0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'vrmn': [cgmesProfile.DY.value, ], + 'vrmx': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'e1': [cgmesProfile.DY.value, ], + 'se1': [cgmesProfile.DY.value, ], + 'e2': [cgmesProfile.DY.value, ], + 'se2': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ka = 0.0, vrmn = 0.0, vrmx = 0.0, ta = 0, tb = 0, te = 0, e1 = 0.0, se1 = 0.0, e2 = 0.0, se2 = 0.0, kf = 0.0, tf = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.vrmn = vrmn + self.vrmx = vrmx + self.ta = ta + self.tb = tb + self.te = te + self.e1 = e1 + self.se1 = se1 + self.e2 = e2 + self.se2 = se2 + self.kf = kf + self.tf = tf + + def __str__(self): + str = 'class=ExcAVR1\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcAVR2.py b/cimpy/cgmes_v3_0_0/ExcAVR2.py new file mode 100644 index 00000000..417a5df1 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcAVR2.py @@ -0,0 +1,67 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcAVR2(ExcitationSystemDynamics): + ''' + Italian excitation system corresponding to IEEE (1968) type 2 model. It represents an alternator and rotating diodes and electromechanic voltage regulators. + + :ka: AVR gain (KA). Typical value = 500. Default: 0.0 + :vrmn: Minimum AVR output (VRMN). Typical value = -6. Default: 0.0 + :vrmx: Maximum AVR output (VRMX). Typical value = 7. Default: 0.0 + :ta: AVR time constant (TA) (>= 0). Typical value = 0,02. Default: 0 + :tb: AVR time constant (TB) (>= 0). Typical value = 0. Default: 0 + :te: Exciter time constant (TE) (>= 0). Typical value = 1. Default: 0 + :e1: Field voltage value 1 (E1). Typical value = 4,18. Default: 0.0 + :se1: Saturation factor at E1 (S[E1]). Typical value = 0.1. Default: 0.0 + :e2: Field voltage value 2 (E2). Typical value = 3,14. Default: 0.0 + :se2: Saturation factor at E2 (S[E2]). Typical value = 0,03. Default: 0.0 + :kf: Rate feedback gain (KF). Typical value = 0,12. Default: 0.0 + :tf1: Rate feedback time constant (TF1) (>= 0). Typical value = 1. Default: 0 + :tf2: Rate feedback time constant (TF2) (>= 0). Typical value = 1. Default: 0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'vrmn': [cgmesProfile.DY.value, ], + 'vrmx': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'e1': [cgmesProfile.DY.value, ], + 'se1': [cgmesProfile.DY.value, ], + 'e2': [cgmesProfile.DY.value, ], + 'se2': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf1': [cgmesProfile.DY.value, ], + 'tf2': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ka = 0.0, vrmn = 0.0, vrmx = 0.0, ta = 0, tb = 0, te = 0, e1 = 0.0, se1 = 0.0, e2 = 0.0, se2 = 0.0, kf = 0.0, tf1 = 0, tf2 = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.vrmn = vrmn + self.vrmx = vrmx + self.ta = ta + self.tb = tb + self.te = te + self.e1 = e1 + self.se1 = se1 + self.e2 = e2 + self.se2 = se2 + self.kf = kf + self.tf1 = tf1 + self.tf2 = tf2 + + def __str__(self): + str = 'class=ExcAVR2\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcAVR3.py b/cimpy/cgmes_v3_0_0/ExcAVR3.py new file mode 100644 index 00000000..f9562ebf --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcAVR3.py @@ -0,0 +1,64 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcAVR3(ExcitationSystemDynamics): + ''' + Italian excitation system. It represents an exciter dynamo and electric regulator. + + :ka: AVR gain (KA). Typical value = 100. Default: 0.0 + :vrmn: Minimum AVR output (VRMN). Typical value = -7,5. Default: 0.0 + :vrmx: Maximum AVR output (VRMX). Typical value = 7,5. Default: 0.0 + :t1: AVR time constant (T1) (>= 0). Typical value = 20. Default: 0 + :t2: AVR time constant (T2) (>= 0). Typical value = 1,6. Default: 0 + :t3: AVR time constant (T3) (>= 0). Typical value = 0,66. Default: 0 + :t4: AVR time constant (T4) (>= 0). Typical value = 0,07. Default: 0 + :te: Exciter time constant (TE) (>= 0). Typical value = 1. Default: 0 + :e1: Field voltage value 1 (E1). Typical value = 4,18. Default: 0.0 + :se1: Saturation factor at E1 (S[E1]). Typical value = 0,1. Default: 0.0 + :e2: Field voltage value 2 (E2). Typical value = 3,14. Default: 0.0 + :se2: Saturation factor at E2 (S[E2]). Typical value = 0,03. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'vrmn': [cgmesProfile.DY.value, ], + 'vrmx': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'e1': [cgmesProfile.DY.value, ], + 'se1': [cgmesProfile.DY.value, ], + 'e2': [cgmesProfile.DY.value, ], + 'se2': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ka = 0.0, vrmn = 0.0, vrmx = 0.0, t1 = 0, t2 = 0, t3 = 0, t4 = 0, te = 0, e1 = 0.0, se1 = 0.0, e2 = 0.0, se2 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.vrmn = vrmn + self.vrmx = vrmx + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.t4 = t4 + self.te = te + self.e1 = e1 + self.se1 = se1 + self.e2 = e2 + self.se2 = se2 + + def __str__(self): + str = 'class=ExcAVR3\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcAVR4.py b/cimpy/cgmes_v3_0_0/ExcAVR4.py new file mode 100644 index 00000000..2c3b8ff5 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcAVR4.py @@ -0,0 +1,70 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcAVR4(ExcitationSystemDynamics): + ''' + Italian excitation system. It represents a static exciter and electric voltage regulator. + + :ka: AVR gain (KA). Typical value = 300. Default: 0.0 + :vrmn: Minimum AVR output (VRMN). Typical value = 0. Default: 0.0 + :vrmx: Maximum AVR output (VRMX). Typical value = 5. Default: 0.0 + :t1: AVR time constant (T1) (>= 0). Typical value = 4,8. Default: 0 + :t2: AVR time constant (T2) (>= 0). Typical value = 1,5. Default: 0 + :t3: AVR time constant (T3) (>= 0). Typical value = 0. Default: 0 + :t4: AVR time constant (T4) (>= 0). Typical value = 0. Default: 0 + :ke: Exciter gain (KE). Typical value = 1. Default: 0.0 + :vfmx: Maximum exciter output (VFMX). Typical value = 5. Default: 0.0 + :vfmn: Minimum exciter output (VFMN). Typical value = 0. Default: 0.0 + :kif: Exciter internal reactance (KIF). Typical value = 0. Default: 0.0 + :tif: Exciter current feedback time constant (TIF) (>= 0). Typical value = 0. Default: 0 + :t1if: Exciter current feedback time constant (T1IF) (>= 0). Typical value = 60. Default: 0 + :imul: AVR output voltage dependency selector (IMUL). true = selector is connected false = selector is not connected. Typical value = true. Default: False + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'vrmn': [cgmesProfile.DY.value, ], + 'vrmx': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'vfmx': [cgmesProfile.DY.value, ], + 'vfmn': [cgmesProfile.DY.value, ], + 'kif': [cgmesProfile.DY.value, ], + 'tif': [cgmesProfile.DY.value, ], + 't1if': [cgmesProfile.DY.value, ], + 'imul': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ka = 0.0, vrmn = 0.0, vrmx = 0.0, t1 = 0, t2 = 0, t3 = 0, t4 = 0, ke = 0.0, vfmx = 0.0, vfmn = 0.0, kif = 0.0, tif = 0, t1if = 0, imul = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.vrmn = vrmn + self.vrmx = vrmx + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.t4 = t4 + self.ke = ke + self.vfmx = vfmx + self.vfmn = vfmn + self.kif = kif + self.tif = tif + self.t1if = t1if + self.imul = imul + + def __str__(self): + str = 'class=ExcAVR4\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcAVR5.py b/cimpy/cgmes_v3_0_0/ExcAVR5.py new file mode 100644 index 00000000..26bbaa0b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcAVR5.py @@ -0,0 +1,37 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcAVR5(ExcitationSystemDynamics): + ''' + Manual excitation control with field circuit resistance. This model can be used as a very simple representation of manual voltage control. + + :ka: Gain (Ka). Default: 0.0 + :ta: Time constant (Ta) (>= 0). Default: 0 + :rex: Effective output resistance (Rex). Rex represents the effective output resistance seen by the excitation system. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'rex': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ka = 0.0, ta = 0, rex = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.ta = ta + self.rex = rex + + def __str__(self): + str = 'class=ExcAVR5\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcAVR7.py b/cimpy/cgmes_v3_0_0/ExcAVR7.py new file mode 100644 index 00000000..62742314 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcAVR7.py @@ -0,0 +1,91 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcAVR7(ExcitationSystemDynamics): + ''' + IVO excitation system. + + :k1: Gain (K1). Typical value = 1. Default: 0.0 + :a1: Lead coefficient (A1). Typical value = 0,5. Default: 0.0 + :a2: Lag coefficient (A2). Typical value = 0,5. Default: 0.0 + :t1: Lead time constant (T1) (>= 0). Typical value = 0,05. Default: 0 + :t2: Lag time constant (T2) (>= 0). Typical value = 0,1. Default: 0 + :vmax1: Lead-lag maximum limit (Vmax1) (> ExcAVR7.vmin1). Typical value = 5. Default: 0.0 + :vmin1: Lead-lag minimum limit (Vmin1) (< ExcAVR7.vmax1). Typical value = -5. Default: 0.0 + :k3: Gain (K3). Typical value = 3. Default: 0.0 + :a3: Lead coefficient (A3). Typical value = 0,5. Default: 0.0 + :a4: Lag coefficient (A4). Typical value = 0,5. Default: 0.0 + :t3: Lead time constant (T3) (>= 0). Typical value = 0,1. Default: 0 + :t4: Lag time constant (T4) (>= 0). Typical value = 0,1. Default: 0 + :vmax3: Lead-lag maximum limit (Vmax3) (> ExcAVR7.vmin3). Typical value = 5. Default: 0.0 + :vmin3: Lead-lag minimum limit (Vmin3) (< ExcAVR7.vmax3). Typical value = -5. Default: 0.0 + :k5: Gain (K5). Typical value = 1. Default: 0.0 + :a5: Lead coefficient (A5). Typical value = 0,5. Default: 0.0 + :a6: Lag coefficient (A6). Typical value = 0,5. Default: 0.0 + :t5: Lead time constant (T5) (>= 0). Typical value = 0,1. Default: 0 + :t6: Lag time constant (T6) (>= 0). Typical value = 0,1. Default: 0 + :vmax5: Lead-lag maximum limit (Vmax5) (> ExcAVR7.vmin5). Typical value = 5. Default: 0.0 + :vmin5: Lead-lag minimum limit (Vmin5) (< ExcAVR7.vmax5). Typical value = -2. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'k1': [cgmesProfile.DY.value, ], + 'a1': [cgmesProfile.DY.value, ], + 'a2': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 'vmax1': [cgmesProfile.DY.value, ], + 'vmin1': [cgmesProfile.DY.value, ], + 'k3': [cgmesProfile.DY.value, ], + 'a3': [cgmesProfile.DY.value, ], + 'a4': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 'vmax3': [cgmesProfile.DY.value, ], + 'vmin3': [cgmesProfile.DY.value, ], + 'k5': [cgmesProfile.DY.value, ], + 'a5': [cgmesProfile.DY.value, ], + 'a6': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 't6': [cgmesProfile.DY.value, ], + 'vmax5': [cgmesProfile.DY.value, ], + 'vmin5': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, k1 = 0.0, a1 = 0.0, a2 = 0.0, t1 = 0, t2 = 0, vmax1 = 0.0, vmin1 = 0.0, k3 = 0.0, a3 = 0.0, a4 = 0.0, t3 = 0, t4 = 0, vmax3 = 0.0, vmin3 = 0.0, k5 = 0.0, a5 = 0.0, a6 = 0.0, t5 = 0, t6 = 0, vmax5 = 0.0, vmin5 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.k1 = k1 + self.a1 = a1 + self.a2 = a2 + self.t1 = t1 + self.t2 = t2 + self.vmax1 = vmax1 + self.vmin1 = vmin1 + self.k3 = k3 + self.a3 = a3 + self.a4 = a4 + self.t3 = t3 + self.t4 = t4 + self.vmax3 = vmax3 + self.vmin3 = vmin3 + self.k5 = k5 + self.a5 = a5 + self.a6 = a6 + self.t5 = t5 + self.t6 = t6 + self.vmax5 = vmax5 + self.vmin5 = vmin5 + + def __str__(self): + str = 'class=ExcAVR7\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcBBC.py b/cimpy/cgmes_v3_0_0/ExcBBC.py new file mode 100644 index 00000000..8143432f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcBBC.py @@ -0,0 +1,61 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcBBC(ExcitationSystemDynamics): + ''' + Transformer fed static excitation system (static with ABB regulator). This model represents a static excitation system in which a gated thyristor bridge fed by a transformer at the main generator terminals feeds the main generator directly. + + :t1: Controller time constant (T1) (>= 0). Typical value = 6. Default: 0 + :t2: Controller time constant (T2) (>= 0). Typical value = 1. Default: 0 + :t3: Lead/lag time constant (T3) (>= 0). If = 0, block is bypassed. Typical value = 0,05. Default: 0 + :t4: Lead/lag time constant (T4) (>= 0). If = 0, block is bypassed. Typical value = 0,01. Default: 0 + :k: Steady state gain (K) (not = 0). Typical value = 300. Default: 0.0 + :vrmin: Minimum control element output (Vrmin) (< ExcBBC.vrmax). Typical value = -5. Default: 0.0 + :vrmax: Maximum control element output (Vrmax) (> ExcBBC.vrmin). Typical value = 5. Default: 0.0 + :efdmin: Minimum open circuit exciter voltage (Efdmin) (< ExcBBC.efdmax). Typical value = -5. Default: 0.0 + :efdmax: Maximum open circuit exciter voltage (Efdmax) (> ExcBBC.efdmin). Typical value = 5. Default: 0.0 + :xe: Effective excitation transformer reactance (Xe) (>= 0). Xe models the regulation of the transformer/rectifier unit. Typical value = 0,05. Default: 0.0 + :switch: Supplementary signal routing selector (switch). true = Vs connected to 3rd summing point false = Vs connected to 1st summing point (see diagram). Typical value = false. Default: False + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 'k': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'efdmin': [cgmesProfile.DY.value, ], + 'efdmax': [cgmesProfile.DY.value, ], + 'xe': [cgmesProfile.DY.value, ], + 'switch': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, t1 = 0, t2 = 0, t3 = 0, t4 = 0, k = 0.0, vrmin = 0.0, vrmax = 0.0, efdmin = 0.0, efdmax = 0.0, xe = 0.0, switch = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.t4 = t4 + self.k = k + self.vrmin = vrmin + self.vrmax = vrmax + self.efdmin = efdmin + self.efdmax = efdmax + self.xe = xe + self.switch = switch + + def __str__(self): + str = 'class=ExcBBC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcCZ.py b/cimpy/cgmes_v3_0_0/ExcCZ.py new file mode 100644 index 00000000..4e71b502 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcCZ.py @@ -0,0 +1,58 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcCZ(ExcitationSystemDynamics): + ''' + Czech proportion/integral exciter. + + :kp: Regulator proportional gain (Kp). Default: 0.0 + :tc: Regulator integral time constant (Tc) (>= 0). Default: 0 + :vrmax: Voltage regulator maximum limit (Vrmax) (> ExcCZ.vrmin). Default: 0.0 + :vrmin: Voltage regulator minimum limit (Vrmin) (< ExcCZ.vrmax). Default: 0.0 + :ka: Regulator gain (Ka). Default: 0.0 + :ta: Regulator time constant (Ta) (>= 0). Default: 0 + :ke: Exciter constant related to self-excited field (Ke). Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (Te) (>= 0). Default: 0 + :efdmax: Exciter output maximum limit (Efdmax) (> ExcCZ.efdmin). Default: 0.0 + :efdmin: Exciter output minimum limit (Efdmin) (< ExcCZ.efdmax). Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'efdmax': [cgmesProfile.DY.value, ], + 'efdmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, kp = 0.0, tc = 0, vrmax = 0.0, vrmin = 0.0, ka = 0.0, ta = 0, ke = 0.0, te = 0, efdmax = 0.0, efdmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.kp = kp + self.tc = tc + self.vrmax = vrmax + self.vrmin = vrmin + self.ka = ka + self.ta = ta + self.ke = ke + self.te = te + self.efdmax = efdmax + self.efdmin = efdmin + + def __str__(self): + str = 'class=ExcCZ\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcDC1A.py b/cimpy/cgmes_v3_0_0/ExcDC1A.py new file mode 100644 index 00000000..d9111fdb --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcDC1A.py @@ -0,0 +1,82 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcDC1A(ExcitationSystemDynamics): + ''' + Modified IEEE DC1A direct current commutator exciter with speed input and without underexcitation limiters (UEL) inputs. + + :ka: Voltage regulator gain (Ka) (> 0). Typical value = 46. Default: 0.0 + :ks: Coefficient to allow different usage of the model-speed coefficient (Ks). Typical value = 0. Default: 0.0 + :ta: Voltage regulator time constant (Ta) (> 0). Typical value = 0,06. Default: 0 + :tb: Voltage regulator time constant (Tb) (>= 0). Typical value = 0. Default: 0 + :tc: Voltage regulator time constant (Tc) (>= 0). Typical value = 0. Default: 0 + :vrmax: Maximum voltage regulator output (Vrmax) (> ExcDC1A.vrmin). Typical value = 1. Default: 0.0 + :vrmin: Minimum voltage regulator output (Vrmin) (< 0 and < ExcDC1A.vrmax). Typical value = -0,9. Default: 0.0 + :ke: Exciter constant related to self-excited field (Ke). Typical value = 0. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (Te) (> 0). Typical value = 0,46. Default: 0 + :kf: Excitation control system stabilizer gain (Kf) (>= 0). Typical value = 0,1. Default: 0.0 + :tf: Excitation control system stabilizer time constant (Tf) (> 0). Typical value = 1. Default: 0 + :efd1: Exciter voltage at which exciter saturation is defined (Efd1) (> 0). Typical value = 3,1. Default: 0.0 + :seefd1: Exciter saturation function value at the corresponding exciter voltage, Efd1 (Se[Eefd1]) (>= 0). Typical value = 0,33. Default: 0.0 + :efd2: Exciter voltage at which exciter saturation is defined (Efd2) (> 0). Typical value = 2,3. Default: 0.0 + :seefd2: Exciter saturation function value at the corresponding exciter voltage, Efd2 (Se[Eefd2]) (>= 0). Typical value = 0,1. Default: 0.0 + :exclim: (exclim). IEEE standard is ambiguous about lower limit on exciter output. true = a lower limit of zero is applied to integrator output false = a lower limit of zero is not applied to integrator output. Typical value = true. Default: False + :efdmin: Minimum voltage exciter output limiter (Efdmin) (< ExcDC1A.edfmax). Typical value = -99. Default: 0.0 + :efdmax: Maximum voltage exciter output limiter (Efdmax) (> ExcDC1A.efdmin). Typical value = 99. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ks': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'efd1': [cgmesProfile.DY.value, ], + 'seefd1': [cgmesProfile.DY.value, ], + 'efd2': [cgmesProfile.DY.value, ], + 'seefd2': [cgmesProfile.DY.value, ], + 'exclim': [cgmesProfile.DY.value, ], + 'efdmin': [cgmesProfile.DY.value, ], + 'efdmax': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ka = 0.0, ks = 0.0, ta = 0, tb = 0, tc = 0, vrmax = 0.0, vrmin = 0.0, ke = 0.0, te = 0, kf = 0.0, tf = 0, efd1 = 0.0, seefd1 = 0.0, efd2 = 0.0, seefd2 = 0.0, exclim = False, efdmin = 0.0, efdmax = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.ks = ks + self.ta = ta + self.tb = tb + self.tc = tc + self.vrmax = vrmax + self.vrmin = vrmin + self.ke = ke + self.te = te + self.kf = kf + self.tf = tf + self.efd1 = efd1 + self.seefd1 = seefd1 + self.efd2 = efd2 + self.seefd2 = seefd2 + self.exclim = exclim + self.efdmin = efdmin + self.efdmax = efdmax + + def __str__(self): + str = 'class=ExcDC1A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcDC2A.py b/cimpy/cgmes_v3_0_0/ExcDC2A.py new file mode 100644 index 00000000..6fe0f259 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcDC2A.py @@ -0,0 +1,82 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcDC2A(ExcitationSystemDynamics): + ''' + Modified IEEE DC2A direct current commutator exciter with speed input, one more leg block in feedback loop and without underexcitation limiters (UEL) inputs. DC type 2 excitation system model with added speed multiplier, added lead-lag, and voltage-dependent limits. + + :ka: Voltage regulator gain (Ka) (> 0). Typical value = 300. Default: 0.0 + :ks: Coefficient to allow different usage of the model-speed coefficient (Ks). Typical value = 0. Default: 0.0 + :ta: Voltage regulator time constant (Ta) (> 0). Typical value = 0,01. Default: 0 + :tb: Voltage regulator time constant (Tb) (>= 0). Typical value = 0. Default: 0 + :tc: Voltage regulator time constant (Tc) (>= 0). Typical value = 0. Default: 0 + :vrmax: Maximum voltage regulator output (Vrmax) (> ExcDC2A.vrmin). Typical value = 4,95. Default: 0.0 + :vrmin: Minimum voltage regulator output (Vrmin) (< 0 and < ExcDC2A.vrmax). Typical value = -4,9. Default: 0.0 + :ke: Exciter constant related to self-excited field (Ke). If Ke is entered as zero, the model calculates an effective value of Ke such that the initial condition value of Vr is zero. The zero value of Ke is not changed. If Ke is entered as non-zero, its value is used directly, without change. Typical value = 1. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (Te) (> 0). Typical value = 1,33. Default: 0 + :kf: Excitation control system stabilizer gain (Kf) (>= 0). Typical value = 0,1. Default: 0.0 + :tf: Excitation control system stabilizer time constant (Tf) (> 0). Typical value = 0,675. Default: 0 + :tf1: Excitation control system stabilizer time constant (Tf1) (>= 0). Typical value = 0. Default: 0 + :efd1: Exciter voltage at which exciter saturation is defined (Efd1) (> 0). Typical value = 3,05. Default: 0.0 + :seefd1: Exciter saturation function value at the corresponding exciter voltage, Efd1 (Se[Efd1]) (>= 0). Typical value = 0,279. Default: 0.0 + :efd2: Exciter voltage at which exciter saturation is defined (Efd2) (> 0). Typical value = 2,29. Default: 0.0 + :seefd2: Exciter saturation function value at the corresponding exciter voltage, Efd2 (Se[Efd2]) (>= 0). Typical value = 0,117. Default: 0.0 + :exclim: (exclim). IEEE standard is ambiguous about lower limit on exciter output. true = a lower limit of zero is applied to integrator output false = a lower limit of zero is not applied to integrator output. Typical value = true. Default: False + :vtlim: (Vtlim). true = limiter at the block (Ka / [1 + sTa]) is dependent on Vt false = limiter at the block is not dependent on Vt. Typical value = true. Default: False + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ks': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'tf1': [cgmesProfile.DY.value, ], + 'efd1': [cgmesProfile.DY.value, ], + 'seefd1': [cgmesProfile.DY.value, ], + 'efd2': [cgmesProfile.DY.value, ], + 'seefd2': [cgmesProfile.DY.value, ], + 'exclim': [cgmesProfile.DY.value, ], + 'vtlim': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ka = 0.0, ks = 0.0, ta = 0, tb = 0, tc = 0, vrmax = 0.0, vrmin = 0.0, ke = 0.0, te = 0, kf = 0.0, tf = 0, tf1 = 0, efd1 = 0.0, seefd1 = 0.0, efd2 = 0.0, seefd2 = 0.0, exclim = False, vtlim = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.ks = ks + self.ta = ta + self.tb = tb + self.tc = tc + self.vrmax = vrmax + self.vrmin = vrmin + self.ke = ke + self.te = te + self.kf = kf + self.tf = tf + self.tf1 = tf1 + self.efd1 = efd1 + self.seefd1 = seefd1 + self.efd2 = efd2 + self.seefd2 = seefd2 + self.exclim = exclim + self.vtlim = vtlim + + def __str__(self): + str = 'class=ExcDC2A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcDC3A.py b/cimpy/cgmes_v3_0_0/ExcDC3A.py new file mode 100644 index 00000000..6c499048 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcDC3A.py @@ -0,0 +1,76 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcDC3A(ExcitationSystemDynamics): + ''' + Modified IEEE DC3A direct current commutator exciter with speed input, and deadband. DC old type 4. + + :trh: Rheostat travel time (Trh) (> 0). Typical value = 20. Default: 0 + :ks: Coefficient to allow different usage of the model-speed coefficient (Ks). Typical value = 0. Default: 0.0 + :kr: Deadband (Kr). Typical value = 0. Default: 0.0 + :kv: Fast raise/lower contact setting (Kv) (> 0). Typical value = 0,05. Default: 0.0 + :vrmax: Maximum voltage regulator output (Vrmax) (> 0). Typical value = 5. Default: 0.0 + :vrmin: Minimum voltage regulator output (Vrmin) (<= 0). Typical value = 0. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (Te) (> 0). Typical value = 1,83. Default: 0 + :ke: Exciter constant related to self-excited field (Ke). Typical value = 1. Default: 0.0 + :efd1: Exciter voltage at which exciter saturation is defined (Efd1) (> 0). Typical value = 2,6. Default: 0.0 + :seefd1: Exciter saturation function value at the corresponding exciter voltage, Efd1 (Se[Efd1]) (>= 0). Typical value = 0,1. Default: 0.0 + :efd2: Exciter voltage at which exciter saturation is defined (Efd2) (> 0). Typical value = 3,45. Default: 0.0 + :seefd2: Exciter saturation function value at the corresponding exciter voltage, Efd2 (Se[Efd2]) (>= 0). Typical value = 0,35. Default: 0.0 + :exclim: (exclim). IEEE standard is ambiguous about lower limit on exciter output. true = a lower limit of zero is applied to integrator output false = a lower limit of zero not applied to integrator output. Typical value = true. Default: False + :efdmax: Maximum voltage exciter output limiter (Efdmax) (> ExcDC3A.efdmin). Typical value = 99. Default: 0.0 + :efdmin: Minimum voltage exciter output limiter (Efdmin) (< ExcDC3A.efdmax). Typical value = -99. Default: 0.0 + :efdlim: (Efdlim). true = exciter output limiter is active false = exciter output limiter not active. Typical value = true. Default: False + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'trh': [cgmesProfile.DY.value, ], + 'ks': [cgmesProfile.DY.value, ], + 'kr': [cgmesProfile.DY.value, ], + 'kv': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'efd1': [cgmesProfile.DY.value, ], + 'seefd1': [cgmesProfile.DY.value, ], + 'efd2': [cgmesProfile.DY.value, ], + 'seefd2': [cgmesProfile.DY.value, ], + 'exclim': [cgmesProfile.DY.value, ], + 'efdmax': [cgmesProfile.DY.value, ], + 'efdmin': [cgmesProfile.DY.value, ], + 'efdlim': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, trh = 0, ks = 0.0, kr = 0.0, kv = 0.0, vrmax = 0.0, vrmin = 0.0, te = 0, ke = 0.0, efd1 = 0.0, seefd1 = 0.0, efd2 = 0.0, seefd2 = 0.0, exclim = False, efdmax = 0.0, efdmin = 0.0, efdlim = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.trh = trh + self.ks = ks + self.kr = kr + self.kv = kv + self.vrmax = vrmax + self.vrmin = vrmin + self.te = te + self.ke = ke + self.efd1 = efd1 + self.seefd1 = seefd1 + self.efd2 = efd2 + self.seefd2 = seefd2 + self.exclim = exclim + self.efdmax = efdmax + self.efdmin = efdmin + self.efdlim = efdlim + + def __str__(self): + str = 'class=ExcDC3A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcDC3A1.py b/cimpy/cgmes_v3_0_0/ExcDC3A1.py new file mode 100644 index 00000000..a942271c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcDC3A1.py @@ -0,0 +1,70 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcDC3A1(ExcitationSystemDynamics): + ''' + Modified old IEEE type 3 excitation system. + + :ka: Voltage regulator gain (Ka) (> 0). Typical value = 300. Default: 0.0 + :ta: Voltage regulator time constant (Ta) (> 0). Typical value = 0,01. Default: 0 + :vrmax: Maximum voltage regulator output (Vrmax) (> ExcDC3A1.vrmin). Typical value = 5. Default: 0.0 + :vrmin: Minimum voltage regulator output (Vrmin) (< 0 and < ExcDC3A1.vrmax). Typical value = 0. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (Te) (> 0). Typical value = 1,83. Default: 0 + :kf: Excitation control system stabilizer gain (Kf) (>= 0). Typical value = 0,1. Default: 0.0 + :tf: Excitation control system stabilizer time constant (Tf) (>= 0). Typical value = 0,675. Default: 0 + :kp: Potential circuit gain coefficient (Kp) (>= 0). Typical value = 4,37. Default: 0.0 + :ki: Potential circuit gain coefficient (Ki) (>= 0). Typical value = 4,83. Default: 0.0 + :vbmax: Available exciter voltage limiter (Vbmax) (> 0). Typical value = 11,63. Default: 0.0 + :exclim: (exclim). true = lower limit of zero is applied to integrator output false = lower limit of zero not applied to integrator output. Typical value = true. Default: False + :ke: Exciter constant related to self-excited field (Ke). Typical value = 1. Default: 0.0 + :vb1max: Available exciter voltage limiter (Vb1max) (> 0). Typical value = 11,63. Default: 0.0 + :vblim: Vb limiter indicator. true = exciter Vbmax limiter is active false = Vb1max is active. Typical value = true. Default: False + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'vbmax': [cgmesProfile.DY.value, ], + 'exclim': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'vb1max': [cgmesProfile.DY.value, ], + 'vblim': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ka = 0.0, ta = 0, vrmax = 0.0, vrmin = 0.0, te = 0, kf = 0.0, tf = 0, kp = 0.0, ki = 0.0, vbmax = 0.0, exclim = False, ke = 0.0, vb1max = 0.0, vblim = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.ta = ta + self.vrmax = vrmax + self.vrmin = vrmin + self.te = te + self.kf = kf + self.tf = tf + self.kp = kp + self.ki = ki + self.vbmax = vbmax + self.exclim = exclim + self.ke = ke + self.vb1max = vb1max + self.vblim = vblim + + def __str__(self): + str = 'class=ExcDC3A1\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcELIN1.py b/cimpy/cgmes_v3_0_0/ExcELIN1.py new file mode 100644 index 00000000..c3020367 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcELIN1.py @@ -0,0 +1,73 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcELIN1(ExcitationSystemDynamics): + ''' + Static PI transformer fed excitation system ELIN (VATECH) - simplified model. This model represents an all-static excitation system. A PI voltage controller establishes a desired field current set point for a proportional current controller. The integrator of the PI controller has a follow-up input to match its signal to the present field current. A power system stabilizer with power input is included in the model. + + :tfi: Current transducer time constant (Tfi) (>= 0). Typical value = 0. Default: 0 + :tnu: Controller reset time constant (Tnu) (>= 0). Typical value = 2. Default: 0 + :vpu: Voltage controller proportional gain (Vpu). Typical value = 34,5. Default: 0.0 + :vpi: Current controller gain (Vpi). Typical value = 12,45. Default: 0.0 + :vpnf: Controller follow up gain (Vpnf). Typical value = 2. Default: 0.0 + :dpnf: Controller follow up deadband (Dpnf). Typical value = 0. Default: 0.0 + :tsw: Stabilizer parameters (Tsw) (>= 0). Typical value = 3. Default: 0 + :efmin: Minimum open circuit excitation voltage (Efmin) (< ExcELIN1.efmax). Typical value = -5. Default: 0.0 + :efmax: Maximum open circuit excitation voltage (Efmax) (> ExcELIN1.efmin). Typical value = 5. Default: 0.0 + :xe: Excitation transformer effective reactance (Xe) (>= 0). Xe represents the regulation of the transformer/rectifier unit. Typical value = 0,06. Default: 0.0 + :ks1: Stabilizer gain 1 (Ks1). Typical value = 0. Default: 0.0 + :ks2: Stabilizer gain 2 (Ks2). Typical value = 0. Default: 0.0 + :ts1: Stabilizer phase lag time constant (Ts1) (>= 0). Typical value = 1. Default: 0 + :ts2: Stabilizer filter time constant (Ts2) (>= 0). Typical value = 1. Default: 0 + :smax: Stabilizer limit output (smax). Typical value = 0,1. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'tfi': [cgmesProfile.DY.value, ], + 'tnu': [cgmesProfile.DY.value, ], + 'vpu': [cgmesProfile.DY.value, ], + 'vpi': [cgmesProfile.DY.value, ], + 'vpnf': [cgmesProfile.DY.value, ], + 'dpnf': [cgmesProfile.DY.value, ], + 'tsw': [cgmesProfile.DY.value, ], + 'efmin': [cgmesProfile.DY.value, ], + 'efmax': [cgmesProfile.DY.value, ], + 'xe': [cgmesProfile.DY.value, ], + 'ks1': [cgmesProfile.DY.value, ], + 'ks2': [cgmesProfile.DY.value, ], + 'ts1': [cgmesProfile.DY.value, ], + 'ts2': [cgmesProfile.DY.value, ], + 'smax': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, tfi = 0, tnu = 0, vpu = 0.0, vpi = 0.0, vpnf = 0.0, dpnf = 0.0, tsw = 0, efmin = 0.0, efmax = 0.0, xe = 0.0, ks1 = 0.0, ks2 = 0.0, ts1 = 0, ts2 = 0, smax = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.tfi = tfi + self.tnu = tnu + self.vpu = vpu + self.vpi = vpi + self.vpnf = vpnf + self.dpnf = dpnf + self.tsw = tsw + self.efmin = efmin + self.efmax = efmax + self.xe = xe + self.ks1 = ks1 + self.ks2 = ks2 + self.ts1 = ts1 + self.ts2 = ts2 + self.smax = smax + + def __str__(self): + str = 'class=ExcELIN1\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcELIN2.py b/cimpy/cgmes_v3_0_0/ExcELIN2.py new file mode 100644 index 00000000..c066a102 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcELIN2.py @@ -0,0 +1,109 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcELIN2(ExcitationSystemDynamics): + ''' + Detailed excitation system ELIN (VATECH). This model represents an all-static excitation system. A PI voltage controller establishes a desired field current set point for a proportional current controller. The integrator of the PI controller has a follow-up input to match its signal to the present field current. Power system stabilizer models used in conjunction with this excitation system model: PssELIN2, PssIEEE2B, Pss2B. + + :k1: Voltage regulator input gain (K1). Typical value = 0. Default: 0.0 + :k1ec: Voltage regulator input limit (K1ec). Typical value = 2. Default: 0.0 + :kd1: Voltage controller derivative gain (Kd1). Typical value = 34,5. Default: 0.0 + :tb1: Voltage controller derivative washout time constant (Tb1) (>= 0). Typical value = 12,45. Default: 0 + :pid1max: Controller follow up gain (PID1max). Typical value = 2. Default: 0.0 + :ti1: Controller follow up deadband (Ti1). Typical value = 0. Default: 0.0 + :iefmax2: Minimum open circuit excitation voltage (Iefmax2). Typical value = -5. Default: 0.0 + :k2: Gain (K2). Typical value = 5. Default: 0.0 + :ketb: Gain (Ketb). Typical value = 0,06. Default: 0.0 + :upmax: Limiter (Upmax) (> ExcELIN2.upmin). Typical value = 3. Default: 0.0 + :upmin: Limiter (Upmin) (< ExcELIN2.upmax). Typical value = 0. Default: 0.0 + :te: Time constant (Te) (>= 0). Typical value = 0. Default: 0 + :xp: Excitation transformer effective reactance (Xp). Typical value = 1. Default: 0.0 + :te2: Time Constant (Te2) (>= 0). Typical value = 1. Default: 0 + :ke2: Gain (Ke2). Typical value = 0,1. Default: 0.0 + :ve1: Exciter alternator output voltages back of commutating reactance at which saturation is defined (Ve1) (> 0). Typical value = 3. Default: 0.0 + :seve1: Exciter saturation function value at the corresponding exciter voltage, Ve1, back of commutating reactance (Se[Ve1]) (>= 0). Typical value = 0. Default: 0.0 + :ve2: Exciter alternator output voltages back of commutating reactance at which saturation is defined (Ve2) (> 0). Typical value = 0. Default: 0.0 + :seve2: Exciter saturation function value at the corresponding exciter voltage, Ve2, back of commutating reactance (Se[Ve2]) (>= 0). Typical value = 1. Default: 0.0 + :tr4: Time constant (Tr4) (>= 0). Typical value = 1. Default: 0 + :k3: Gain (K3). Typical value = 0,1. Default: 0.0 + :ti3: Time constant (Ti3) (>= 0). Typical value = 3. Default: 0 + :k4: Gain (K4). Typical value = 0. Default: 0.0 + :ti4: Time constant (Ti4) (>= 0). Typical value = 0. Default: 0 + :iefmax: Limiter (Iefmax) (> ExcELIN2.iefmin). Typical value = 1. Default: 0.0 + :iefmin: Limiter (Iefmin) (< ExcELIN2.iefmax). Typical value = 1. Default: 0.0 + :efdbas: Gain (Efdbas). Typical value = 0,1. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'k1': [cgmesProfile.DY.value, ], + 'k1ec': [cgmesProfile.DY.value, ], + 'kd1': [cgmesProfile.DY.value, ], + 'tb1': [cgmesProfile.DY.value, ], + 'pid1max': [cgmesProfile.DY.value, ], + 'ti1': [cgmesProfile.DY.value, ], + 'iefmax2': [cgmesProfile.DY.value, ], + 'k2': [cgmesProfile.DY.value, ], + 'ketb': [cgmesProfile.DY.value, ], + 'upmax': [cgmesProfile.DY.value, ], + 'upmin': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'xp': [cgmesProfile.DY.value, ], + 'te2': [cgmesProfile.DY.value, ], + 'ke2': [cgmesProfile.DY.value, ], + 've1': [cgmesProfile.DY.value, ], + 'seve1': [cgmesProfile.DY.value, ], + 've2': [cgmesProfile.DY.value, ], + 'seve2': [cgmesProfile.DY.value, ], + 'tr4': [cgmesProfile.DY.value, ], + 'k3': [cgmesProfile.DY.value, ], + 'ti3': [cgmesProfile.DY.value, ], + 'k4': [cgmesProfile.DY.value, ], + 'ti4': [cgmesProfile.DY.value, ], + 'iefmax': [cgmesProfile.DY.value, ], + 'iefmin': [cgmesProfile.DY.value, ], + 'efdbas': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, k1 = 0.0, k1ec = 0.0, kd1 = 0.0, tb1 = 0, pid1max = 0.0, ti1 = 0.0, iefmax2 = 0.0, k2 = 0.0, ketb = 0.0, upmax = 0.0, upmin = 0.0, te = 0, xp = 0.0, te2 = 0, ke2 = 0.0, ve1 = 0.0, seve1 = 0.0, ve2 = 0.0, seve2 = 0.0, tr4 = 0, k3 = 0.0, ti3 = 0, k4 = 0.0, ti4 = 0, iefmax = 0.0, iefmin = 0.0, efdbas = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.k1 = k1 + self.k1ec = k1ec + self.kd1 = kd1 + self.tb1 = tb1 + self.pid1max = pid1max + self.ti1 = ti1 + self.iefmax2 = iefmax2 + self.k2 = k2 + self.ketb = ketb + self.upmax = upmax + self.upmin = upmin + self.te = te + self.xp = xp + self.te2 = te2 + self.ke2 = ke2 + self.ve1 = ve1 + self.seve1 = seve1 + self.ve2 = ve2 + self.seve2 = seve2 + self.tr4 = tr4 + self.k3 = k3 + self.ti3 = ti3 + self.k4 = k4 + self.ti4 = ti4 + self.iefmax = iefmax + self.iefmin = iefmin + self.efdbas = efdbas + + def __str__(self): + str = 'class=ExcELIN2\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcHU.py b/cimpy/cgmes_v3_0_0/ExcHU.py new file mode 100644 index 00000000..8441f7c8 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcHU.py @@ -0,0 +1,64 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcHU(ExcitationSystemDynamics): + ''' + Hungarian excitation system, with built-in voltage transducer. + + :tr: Filter time constant (Tr) (>= 0). If a voltage compensator is used in conjunction with this excitation system model, Tr should be set to 0. Typical value = 0,01. Default: 0 + :te: Major loop PI tag integration time constant (Te) (>= 0). Typical value = 0,154. Default: 0 + :imin: Major loop PI tag output signal lower limit (Imin) (< ExcHU.imax). Typical value = 0,1. Default: 0.0 + :imax: Major loop PI tag output signal upper limit (Imax) (> ExcHU.imin). Typical value = 2,19. Default: 0.0 + :ae: Major loop PI tag gain factor (Ae). Typical value = 3. Default: 0.0 + :emin: Field voltage control signal lower limit on AVR base (Emin) (< ExcHU.emax). Typical value = -0,866. Default: 0.0 + :emax: Field voltage control signal upper limit on AVR base (Emax) (> ExcHU.emin). Typical value = 0,996. Default: 0.0 + :ki: Current base conversion constant (Ki). Typical value = 0,21428. Default: 0.0 + :ai: Minor loop PI tag gain factor (Ai). Typical value = 22. Default: 0.0 + :ti: Minor loop PI control tag integration time constant (Ti) (>= 0). Typical value = 0,01333. Default: 0 + :atr: AVR constant (Atr). Typical value = 2,19. Default: 0.0 + :ke: Voltage base conversion constant (Ke). Typical value = 4,666. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'tr': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'imin': [cgmesProfile.DY.value, ], + 'imax': [cgmesProfile.DY.value, ], + 'ae': [cgmesProfile.DY.value, ], + 'emin': [cgmesProfile.DY.value, ], + 'emax': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'ai': [cgmesProfile.DY.value, ], + 'ti': [cgmesProfile.DY.value, ], + 'atr': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, tr = 0, te = 0, imin = 0.0, imax = 0.0, ae = 0.0, emin = 0.0, emax = 0.0, ki = 0.0, ai = 0.0, ti = 0, atr = 0.0, ke = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.tr = tr + self.te = te + self.imin = imin + self.imax = imax + self.ae = ae + self.emin = emin + self.emax = emax + self.ki = ki + self.ai = ai + self.ti = ti + self.atr = atr + self.ke = ke + + def __str__(self): + str = 'class=ExcHU\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEAC1A.py b/cimpy/cgmes_v3_0_0/ExcIEEEAC1A.py new file mode 100644 index 00000000..e72992b1 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEAC1A.py @@ -0,0 +1,82 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEAC1A(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type AC1A model. The model represents the field-controlled alternator-rectifier excitation systems designated type AC1A. These excitation systems consist of an alternator main exciter with non-controlled rectifiers. Reference: IEEE 421.5-2005, 6.1. + + :tb: Voltage regulator time constant (TB) (>= 0). Typical value = 0. Default: 0 + :tc: Voltage regulator time constant (TC) (>= 0). Typical value = 0. Default: 0 + :ka: Voltage regulator gain (KA) (> 0). Typical value = 400. Default: 0.0 + :ta: Voltage regulator time constant (TA) (> 0). Typical value = 0,02. Default: 0 + :vamax: Maximum voltage regulator output (VAMAX) (> 0). Typical value = 14,5. Default: 0.0 + :vamin: Minimum voltage regulator output (VAMIN) (< 0). Typical value = -14,5. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (TE) (> 0). Typical value = 0,8. Default: 0 + :kf: Excitation control system stabilizer gains (KF) (>= 0). Typical value = 0,03. Default: 0.0 + :tf: Excitation control system stabilizer time constant (TF) (> 0). Typical value = 1. Default: 0 + :kc: Rectifier loading factor proportional to commutating reactance (KC) (>= 0). Typical value = 0,2. Default: 0.0 + :kd: Demagnetizing factor, a function of exciter alternator reactances (KD) (>= 0). Typical value = 0,38. Default: 0.0 + :ke: Exciter constant related to self-excited field (KE). Typical value = 1. Default: 0.0 + :ve1: Exciter alternator output voltages back of commutating reactance at which saturation is defined (VE1) (> 0). Typical value = 4,18. Default: 0.0 + :seve1: Exciter saturation function value at the corresponding exciter voltage, VE1, back of commutating reactance (SE[VE1]) (>= 0). Typical value = 0,1. Default: 0.0 + :ve2: Exciter alternator output voltages back of commutating reactance at which saturation is defined (VE2) (> 0). Typical value = 3,14. Default: 0.0 + :seve2: Exciter saturation function value at the corresponding exciter voltage, VE2, back of commutating reactance (SE[VE2]) (>= 0). Typical value = 0,03. Default: 0.0 + :vrmax: Maximum voltage regulator outputs (VRMAX) (> 0). Typical value = 6,03. Default: 0.0 + :vrmin: Minimum voltage regulator outputs (VRMIN) (< 0). Typical value = -5,43. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'vamax': [cgmesProfile.DY.value, ], + 'vamin': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 've1': [cgmesProfile.DY.value, ], + 'seve1': [cgmesProfile.DY.value, ], + 've2': [cgmesProfile.DY.value, ], + 'seve2': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, tb = 0, tc = 0, ka = 0.0, ta = 0, vamax = 0.0, vamin = 0.0, te = 0, kf = 0.0, tf = 0, kc = 0.0, kd = 0.0, ke = 0.0, ve1 = 0.0, seve1 = 0.0, ve2 = 0.0, seve2 = 0.0, vrmax = 0.0, vrmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.tb = tb + self.tc = tc + self.ka = ka + self.ta = ta + self.vamax = vamax + self.vamin = vamin + self.te = te + self.kf = kf + self.tf = tf + self.kc = kc + self.kd = kd + self.ke = ke + self.ve1 = ve1 + self.seve1 = seve1 + self.ve2 = ve2 + self.seve2 = seve2 + self.vrmax = vrmax + self.vrmin = vrmin + + def __str__(self): + str = 'class=ExcIEEEAC1A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEAC2A.py b/cimpy/cgmes_v3_0_0/ExcIEEEAC2A.py new file mode 100644 index 00000000..737a0b67 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEAC2A.py @@ -0,0 +1,91 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEAC2A(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type AC2A model. The model represents a high initial response field-controlled alternator-rectifier excitation system. The alternator main exciter is used with non-controlled rectifiers. The type AC2A model is similar to that of type AC1A except for the inclusion of exciter time constant compensation and exciter field current limiting elements. Reference: IEEE 421.5-2005, 6.2. + + :tb: Voltage regulator time constant (TB) (>= 0). Typical value = 0. Default: 0 + :tc: Voltage regulator time constant (TC) (>= 0). Typical value = 0. Default: 0 + :ka: Voltage regulator gain (KA) (> 0). Typical value = 400. Default: 0.0 + :ta: Voltage regulator time constant (TA) (> 0). Typical value = 0,02. Default: 0 + :vamax: Maximum voltage regulator output (VAMAX) (> 0). Typical value = 8. Default: 0.0 + :vamin: Minimum voltage regulator output (VAMIN) (< 0). Typical value = -8. Default: 0.0 + :kb: Second stage regulator gain (KB) (> 0). Typical value = 25. Default: 0.0 + :vrmax: Maximum voltage regulator outputs (VRMAX) (> 0). Typical value = 105. Default: 0.0 + :vrmin: Minimum voltage regulator outputs (VRMIN) (< 0). Typical value = -95. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (TE) (> 0). Typical value = 0,6. Default: 0 + :vfemax: Exciter field current limit reference (VFEMAX) (> 0). Typical value = 4,4. Default: 0.0 + :kh: Exciter field current feedback gain (KH) (>= 0). Typical value = 1. Default: 0.0 + :kf: Excitation control system stabilizer gains (KF) (>= 0). Typical value = 0,03. Default: 0.0 + :tf: Excitation control system stabilizer time constant (TF) (> 0). Typical value = 1. Default: 0 + :kc: Rectifier loading factor proportional to commutating reactance (KC) (>= 0). Typical value = 0,28. Default: 0.0 + :kd: Demagnetizing factor, a function of exciter alternator reactances (KD) (>= 0). Typical value = 0,35. Default: 0.0 + :ke: Exciter constant related to self-excited field (KE) (>= 0). Typical value = 1. Default: 0.0 + :ve1: Exciter alternator output voltages back of commutating reactance at which saturation is defined (VE1) (> 0). Typical value = 4,4. Default: 0.0 + :seve1: Exciter saturation function value at the corresponding exciter voltage, VE1, back of commutating reactance (SE[VE1]) (>= 0). Typical value = 0,037. Default: 0.0 + :ve2: Exciter alternator output voltages back of commutating reactance at which saturation is defined (VE2) (> 0). Typical value = 3,3. Default: 0.0 + :seve2: Exciter saturation function value at the corresponding exciter voltage, VE2, back of commutating reactance (SE[VE2]) (>= 0). Typical value = 0,012. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'vamax': [cgmesProfile.DY.value, ], + 'vamin': [cgmesProfile.DY.value, ], + 'kb': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'vfemax': [cgmesProfile.DY.value, ], + 'kh': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 've1': [cgmesProfile.DY.value, ], + 'seve1': [cgmesProfile.DY.value, ], + 've2': [cgmesProfile.DY.value, ], + 'seve2': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, tb = 0, tc = 0, ka = 0.0, ta = 0, vamax = 0.0, vamin = 0.0, kb = 0.0, vrmax = 0.0, vrmin = 0.0, te = 0, vfemax = 0.0, kh = 0.0, kf = 0.0, tf = 0, kc = 0.0, kd = 0.0, ke = 0.0, ve1 = 0.0, seve1 = 0.0, ve2 = 0.0, seve2 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.tb = tb + self.tc = tc + self.ka = ka + self.ta = ta + self.vamax = vamax + self.vamin = vamin + self.kb = kb + self.vrmax = vrmax + self.vrmin = vrmin + self.te = te + self.vfemax = vfemax + self.kh = kh + self.kf = kf + self.tf = tf + self.kc = kc + self.kd = kd + self.ke = ke + self.ve1 = ve1 + self.seve1 = seve1 + self.ve2 = ve2 + self.seve2 = seve2 + + def __str__(self): + str = 'class=ExcIEEEAC2A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEAC3A.py b/cimpy/cgmes_v3_0_0/ExcIEEEAC3A.py new file mode 100644 index 00000000..918114ad --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEAC3A.py @@ -0,0 +1,91 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEAC3A(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type AC3A model. The model represents the field-controlled alternator-rectifier excitation systems designated type AC3A. These excitation systems include an alternator main exciter with non-controlled rectifiers. The exciter employs self-excitation, and the voltage regulator power is derived from the exciter output voltage. Therefore, this system has an additional nonlinearity, simulated by the use of a multiplier whose inputs are the voltage regulator command signal, Va, and the exciter output voltage, Efd, times KR. This model is applicable to excitation systems employing static voltage regulators. Reference: IEEE 421.5-2005, 6.3. + + :tb: Voltage regulator time constant (TB) (>= 0). Typical value = 0. Default: 0 + :tc: Voltage regulator time constant (TC) (>= 0). Typical value = 0. Default: 0 + :ka: Voltage regulator gain (KA) (> 0). Typical value = 45,62. Default: 0.0 + :ta: Voltage regulator time constant (TA) (> 0). Typical value = 0,013. Default: 0 + :vamax: Maximum voltage regulator output (VAMAX) (> 0). Typical value = 1. Default: 0.0 + :vamin: Minimum voltage regulator output (VAMIN) (< 0). Typical value = -0,95. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (TE) (> 0). Typical value = 1,17. Default: 0 + :vemin: Minimum exciter voltage output (VEMIN) (<= 0). Typical value = 0. Default: 0.0 + :kr: Constant associated with regulator and alternator field power supply (KR) (> 0). Typical value = 3,77. Default: 0.0 + :kf: Excitation control system stabilizer gains (KF) (>= 0). Typical value = 0,143. Default: 0.0 + :tf: Excitation control system stabilizer time constant (TF) (> 0). Typical value = 1. Default: 0 + :kn: Excitation control system stabilizer gain (KN) (>= 0). Typical value = 0,05. Default: 0.0 + :efdn: Value of Efd at which feedback gain changes (EFDN) (> 0). Typical value = 2,36. Default: 0.0 + :kc: Rectifier loading factor proportional to commutating reactance (KC) (>= 0). Typical value = 0,104. Default: 0.0 + :kd: Demagnetizing factor, a function of exciter alternator reactances (KD) (>= 0). Typical value = 0,499. Default: 0.0 + :ke: Exciter constant related to self-excited field (KE). Typical value = 1. Default: 0.0 + :vfemax: Exciter field current limit reference (VFEMAX) (>= 0). Typical value = 16. Default: 0.0 + :ve1: Exciter alternator output voltages back of commutating reactance at which saturation is defined (VE1) (> 0). Typical value = 6,24. Default: 0.0 + :seve1: Exciter saturation function value at the corresponding exciter voltage, VE1, back of commutating reactance (SE[VE1]) (>= 0). Typical value = 1,143. Default: 0.0 + :ve2: Exciter alternator output voltages back of commutating reactance at which saturation is defined (VE2) (> 0). Typical value = 4,68. Default: 0.0 + :seve2: Exciter saturation function value at the corresponding exciter voltage, VE2, back of commutating reactance (SE[VE2]) (>= 0). Typical value = 0,1. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'vamax': [cgmesProfile.DY.value, ], + 'vamin': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'vemin': [cgmesProfile.DY.value, ], + 'kr': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'kn': [cgmesProfile.DY.value, ], + 'efdn': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'vfemax': [cgmesProfile.DY.value, ], + 've1': [cgmesProfile.DY.value, ], + 'seve1': [cgmesProfile.DY.value, ], + 've2': [cgmesProfile.DY.value, ], + 'seve2': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, tb = 0, tc = 0, ka = 0.0, ta = 0, vamax = 0.0, vamin = 0.0, te = 0, vemin = 0.0, kr = 0.0, kf = 0.0, tf = 0, kn = 0.0, efdn = 0.0, kc = 0.0, kd = 0.0, ke = 0.0, vfemax = 0.0, ve1 = 0.0, seve1 = 0.0, ve2 = 0.0, seve2 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.tb = tb + self.tc = tc + self.ka = ka + self.ta = ta + self.vamax = vamax + self.vamin = vamin + self.te = te + self.vemin = vemin + self.kr = kr + self.kf = kf + self.tf = tf + self.kn = kn + self.efdn = efdn + self.kc = kc + self.kd = kd + self.ke = ke + self.vfemax = vfemax + self.ve1 = ve1 + self.seve1 = seve1 + self.ve2 = ve2 + self.seve2 = seve2 + + def __str__(self): + str = 'class=ExcIEEEAC3A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEAC4A.py b/cimpy/cgmes_v3_0_0/ExcIEEEAC4A.py new file mode 100644 index 00000000..6f17f938 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEAC4A.py @@ -0,0 +1,55 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEAC4A(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type AC4A model. The model represents type AC4A alternator-supplied controlled-rectifier excitation system which is quite different from the other types of AC systems. This high initial response excitation system utilizes a full thyristor bridge in the exciter output circuit. The voltage regulator controls the firing of the thyristor bridges. The exciter alternator uses an independent voltage regulator to control its output voltage to a constant value. These effects are not modelled; however, transient loading effects on the exciter alternator are included. Reference: IEEE 421.5-2005, 6.4. + + :vimax: Maximum voltage regulator input limit (VIMAX) (> 0). Typical value = 10. Default: 0.0 + :vimin: Minimum voltage regulator input limit (VIMIN) (< 0). Typical value = -10. Default: 0.0 + :tc: Voltage regulator time constant (TC) (>= 0). Typical value = 1. Default: 0 + :tb: Voltage regulator time constant (TB) (>= 0). Typical value = 10. Default: 0 + :ka: Voltage regulator gain (KA) (> 0). Typical value = 200. Default: 0.0 + :ta: Voltage regulator time constant (TA) (> 0). Typical value = 0,015. Default: 0 + :vrmax: Maximum voltage regulator output (VRMAX) (> 0). Typical value = 5,64. Default: 0.0 + :vrmin: Minimum voltage regulator output (VRMIN) (< 0). Typical value = -4,53. Default: 0.0 + :kc: Rectifier loading factor proportional to commutating reactance (KC) (>= 0). Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'vimax': [cgmesProfile.DY.value, ], + 'vimin': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, vimax = 0.0, vimin = 0.0, tc = 0, tb = 0, ka = 0.0, ta = 0, vrmax = 0.0, vrmin = 0.0, kc = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.vimax = vimax + self.vimin = vimin + self.tc = tc + self.tb = tb + self.ka = ka + self.ta = ta + self.vrmax = vrmax + self.vrmin = vrmin + self.kc = kc + + def __str__(self): + str = 'class=ExcIEEEAC4A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEAC5A.py b/cimpy/cgmes_v3_0_0/ExcIEEEAC5A.py new file mode 100644 index 00000000..c59ba32e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEAC5A.py @@ -0,0 +1,70 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEAC5A(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type AC5A model. The model represents a simplified model for brushless excitation systems. The regulator is supplied from a source, such as a permanent magnet generator, which is not affected by system disturbances. Unlike other AC models, this model uses loaded rather than open circuit exciter saturation data in the same way as it is used for the DC models. Because the model has been widely implemented by the industry, it is sometimes used to represent other types of systems when either detailed data for them are not available or simplified models are required. Reference: IEEE 421.5-2005, 6.5. + + :ka: Voltage regulator gain (KA) (> 0). Typical value = 400. Default: 0.0 + :ta: Voltage regulator time constant (TA) (> 0). Typical value = 0,02. Default: 0 + :vrmax: Maximum voltage regulator output (VRMAX) (> 0). Typical value = 7,3. Default: 0.0 + :vrmin: Minimum voltage regulator output (VRMIN) (< 0). Typical value = -7,3. Default: 0.0 + :ke: Exciter constant related to self-excited field (KE). Typical value = 1. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (TE) (> 0). Typical value = 0,8. Default: 0 + :kf: Excitation control system stabilizer gains (KF) (>= 0). Typical value = 0,03. Default: 0.0 + :tf1: Excitation control system stabilizer time constant (TF1) (> 0). Typical value = 1. Default: 0 + :tf2: Excitation control system stabilizer time constant (TF2) (>= 0). Typical value = 1. Default: 0 + :tf3: Excitation control system stabilizer time constant (TF3) (>= 0). Typical value = 1. Default: 0 + :efd1: Exciter voltage at which exciter saturation is defined (EFD1) (> 0). Typical value = 5,6. Default: 0.0 + :seefd1: Exciter saturation function value at the corresponding exciter voltage, EFD1 (SE[EFD1]) (>= 0). Typical value = 0,86. Default: 0.0 + :efd2: Exciter voltage at which exciter saturation is defined (EFD2) (> 0). Typical value = 4,2. Default: 0.0 + :seefd2: Exciter saturation function value at the corresponding exciter voltage, EFD2 (SE[EFD2]) (>= 0). Typical value = 0,5. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf1': [cgmesProfile.DY.value, ], + 'tf2': [cgmesProfile.DY.value, ], + 'tf3': [cgmesProfile.DY.value, ], + 'efd1': [cgmesProfile.DY.value, ], + 'seefd1': [cgmesProfile.DY.value, ], + 'efd2': [cgmesProfile.DY.value, ], + 'seefd2': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ka = 0.0, ta = 0, vrmax = 0.0, vrmin = 0.0, ke = 0.0, te = 0, kf = 0.0, tf1 = 0, tf2 = 0, tf3 = 0, efd1 = 0.0, seefd1 = 0.0, efd2 = 0.0, seefd2 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.ta = ta + self.vrmax = vrmax + self.vrmin = vrmin + self.ke = ke + self.te = te + self.kf = kf + self.tf1 = tf1 + self.tf2 = tf2 + self.tf3 = tf3 + self.efd1 = efd1 + self.seefd1 = seefd1 + self.efd2 = efd2 + self.seefd2 = seefd2 + + def __str__(self): + str = 'class=ExcIEEEAC5A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEAC6A.py b/cimpy/cgmes_v3_0_0/ExcIEEEAC6A.py new file mode 100644 index 00000000..fbbc068c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEAC6A.py @@ -0,0 +1,94 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEAC6A(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type AC6A model. The model represents field-controlled alternator-rectifier excitation systems with system-supplied electronic voltage regulators. The maximum output of the regulator, VR, is a function of terminal voltage, VT. The field current limiter included in the original model AC6A remains in the 2005 update. Reference: IEEE 421.5-2005, 6.6. + + :ka: Voltage regulator gain (KA) (> 0). Typical value = 536. Default: 0.0 + :ta: Voltage regulator time constant (TA) (>= 0). Typical value = 0,086. Default: 0 + :tk: Voltage regulator time constant (TK) (>= 0). Typical value = 0,18. Default: 0 + :tb: Voltage regulator time constant (TB) (>= 0). Typical value = 9. Default: 0 + :tc: Voltage regulator time constant (TC) (>= 0). Typical value = 3. Default: 0 + :vamax: Maximum voltage regulator output (VAMAX) (> 0). Typical value = 75. Default: 0.0 + :vamin: Minimum voltage regulator output (VAMIN) (< 0). Typical value = -75. Default: 0.0 + :vrmax: Maximum voltage regulator output (VRMAX) (> 0). Typical value = 44. Default: 0.0 + :vrmin: Minimum voltage regulator output (VRMIN) (< 0). Typical value = -36. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (TE) (> 0). Typical value = 1. Default: 0 + :kh: Exciter field current limiter gain (KH) (>= 0). Typical value = 92. Default: 0.0 + :tj: Exciter field current limiter time constant (TJ) (>= 0). Typical value = 0,02. Default: 0 + :th: Exciter field current limiter time constant (TH) (> 0). Typical value = 0,08. Default: 0 + :vfelim: Exciter field current limit reference (VFELIM) (> 0). Typical value = 19. Default: 0.0 + :vhmax: Maximum field current limiter signal reference (VHMAX) (> 0). Typical value = 75. Default: 0.0 + :kc: Rectifier loading factor proportional to commutating reactance (KC) (>= 0). Typical value = 0,173. Default: 0.0 + :kd: Demagnetizing factor, a function of exciter alternator reactances (KD) (>= 0). Typical value = 1,91. Default: 0.0 + :ke: Exciter constant related to self-excited field (KE). Typical value = 1,6. Default: 0.0 + :ve1: Exciter alternator output voltages back of commutating reactance at which saturation is defined (VE1) (> 0). Typical value = 7,4. Default: 0.0 + :seve1: Exciter saturation function value at the corresponding exciter voltage, VE1, back of commutating reactance (SE[VE1]) (>= 0). Typical value = 0,214. Default: 0.0 + :ve2: Exciter alternator output voltages back of commutating reactance at which saturation is defined (VE2) (> 0). Typical value = 5,55. Default: 0.0 + :seve2: Exciter saturation function value at the corresponding exciter voltage, VE2, back of commutating reactance (SE[VE2]) (>= 0). Typical value = 0,044. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tk': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'vamax': [cgmesProfile.DY.value, ], + 'vamin': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'kh': [cgmesProfile.DY.value, ], + 'tj': [cgmesProfile.DY.value, ], + 'th': [cgmesProfile.DY.value, ], + 'vfelim': [cgmesProfile.DY.value, ], + 'vhmax': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 've1': [cgmesProfile.DY.value, ], + 'seve1': [cgmesProfile.DY.value, ], + 've2': [cgmesProfile.DY.value, ], + 'seve2': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ka = 0.0, ta = 0, tk = 0, tb = 0, tc = 0, vamax = 0.0, vamin = 0.0, vrmax = 0.0, vrmin = 0.0, te = 0, kh = 0.0, tj = 0, th = 0, vfelim = 0.0, vhmax = 0.0, kc = 0.0, kd = 0.0, ke = 0.0, ve1 = 0.0, seve1 = 0.0, ve2 = 0.0, seve2 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.ta = ta + self.tk = tk + self.tb = tb + self.tc = tc + self.vamax = vamax + self.vamin = vamin + self.vrmax = vrmax + self.vrmin = vrmin + self.te = te + self.kh = kh + self.tj = tj + self.th = th + self.vfelim = vfelim + self.vhmax = vhmax + self.kc = kc + self.kd = kd + self.ke = ke + self.ve1 = ve1 + self.seve1 = seve1 + self.ve2 = ve2 + self.seve2 = seve2 + + def __str__(self): + str = 'class=ExcIEEEAC6A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEAC7B.py b/cimpy/cgmes_v3_0_0/ExcIEEEAC7B.py new file mode 100644 index 00000000..cef84755 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEAC7B.py @@ -0,0 +1,106 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEAC7B(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type AC7B model. The model represents excitation systems which consist of an AC alternator with either stationary or rotating rectifiers to produce the DC field requirements. It is an upgrade to earlier AC excitation systems, which replace only the controls but retain the AC alternator and diode rectifier bridge. Reference: IEEE 421.5-2005, 6.7. Note, however, that in IEEE 421.5-2005, the [1 / sTE] block is shown as [1 / (1 + sTE)], which is incorrect. + + :kpr: Voltage regulator proportional gain (KPR) (> 0 if ExcIEEEAC7B.kir = 0). Typical value = 4,24. Default: 0.0 + :kir: Voltage regulator integral gain (KIR) (>= 0). Typical value = 4,24. Default: 0.0 + :kdr: Voltage regulator derivative gain (KDR) (>= 0). Typical value = 0. Default: 0.0 + :tdr: Lag time constant (TDR) (>= 0). Typical value = 0. Default: 0 + :vrmax: Maximum voltage regulator output (VRMAX) (> 0). Typical value = 5,79. Default: 0.0 + :vrmin: Minimum voltage regulator output (VRMIN) (< 0). Typical value = -5,79. Default: 0.0 + :kpa: Voltage regulator proportional gain (KPA) (> 0 if ExcIEEEAC7B.kia = 0). Typical value = 65,36. Default: 0.0 + :kia: Voltage regulator integral gain (KIA) (>= 0). Typical value = 59,69. Default: 0.0 + :vamax: Maximum voltage regulator output (VAMAX) (> 0). Typical value = 1. Default: 0.0 + :vamin: Minimum voltage regulator output (VAMIN) (< 0). Typical value = -0,95. Default: 0.0 + :kp: Potential circuit gain coefficient (KP) (> 0). Typical value = 4,96. Default: 0.0 + :kl: Exciter field voltage lower limit parameter (KL). Typical value = 10. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (TE) (> 0). Typical value = 1,1. Default: 0 + :vfemax: Exciter field current limit reference (VFEMAX). Typical value = 6,9. Default: 0.0 + :vemin: Minimum exciter voltage output (VEMIN) (<= 0). Typical value = 0. Default: 0.0 + :ke: Exciter constant related to self-excited field (KE). Typical value = 1. Default: 0.0 + :kc: Rectifier loading factor proportional to commutating reactance (KC) (>= 0). Typical value = 0,18. Default: 0.0 + :kd: Demagnetizing factor, a function of exciter alternator reactances (KD) (>= 0). Typical value = 0,02. Default: 0.0 + :kf1: Excitation control system stabilizer gain (KF1) (>= 0). Typical value = 0,212. Default: 0.0 + :kf2: Excitation control system stabilizer gain (KF2) (>= 0). Typical value = 0. Default: 0.0 + :kf3: Excitation control system stabilizer gain (KF3) (>= 0). Typical value = 0. Default: 0.0 + :tf: Excitation control system stabilizer time constant (TF) (> 0). Typical value = 1. Default: 0 + :ve1: Exciter alternator output voltages back of commutating reactance at which saturation is defined (VE1) (> 0). Typical value = 6,3. Default: 0.0 + :seve1: Exciter saturation function value at the corresponding exciter voltage, VE1, back of commutating reactance (SE[VE1]) (>= 0). Typical value = 0,44. Default: 0.0 + :ve2: Exciter alternator output voltages back of commutating reactance at which saturation is defined (VE2) (> 0). Typical value = 3,02. Default: 0.0 + :seve2: Exciter saturation function value at the corresponding exciter voltage, VE2, back of commutating reactance (SE[VE2]) (>= 0). Typical value = 0,075. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'kpr': [cgmesProfile.DY.value, ], + 'kir': [cgmesProfile.DY.value, ], + 'kdr': [cgmesProfile.DY.value, ], + 'tdr': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'kpa': [cgmesProfile.DY.value, ], + 'kia': [cgmesProfile.DY.value, ], + 'vamax': [cgmesProfile.DY.value, ], + 'vamin': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'kl': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'vfemax': [cgmesProfile.DY.value, ], + 'vemin': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'kf1': [cgmesProfile.DY.value, ], + 'kf2': [cgmesProfile.DY.value, ], + 'kf3': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 've1': [cgmesProfile.DY.value, ], + 'seve1': [cgmesProfile.DY.value, ], + 've2': [cgmesProfile.DY.value, ], + 'seve2': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, kpr = 0.0, kir = 0.0, kdr = 0.0, tdr = 0, vrmax = 0.0, vrmin = 0.0, kpa = 0.0, kia = 0.0, vamax = 0.0, vamin = 0.0, kp = 0.0, kl = 0.0, te = 0, vfemax = 0.0, vemin = 0.0, ke = 0.0, kc = 0.0, kd = 0.0, kf1 = 0.0, kf2 = 0.0, kf3 = 0.0, tf = 0, ve1 = 0.0, seve1 = 0.0, ve2 = 0.0, seve2 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.kpr = kpr + self.kir = kir + self.kdr = kdr + self.tdr = tdr + self.vrmax = vrmax + self.vrmin = vrmin + self.kpa = kpa + self.kia = kia + self.vamax = vamax + self.vamin = vamin + self.kp = kp + self.kl = kl + self.te = te + self.vfemax = vfemax + self.vemin = vemin + self.ke = ke + self.kc = kc + self.kd = kd + self.kf1 = kf1 + self.kf2 = kf2 + self.kf3 = kf3 + self.tf = tf + self.ve1 = ve1 + self.seve1 = seve1 + self.ve2 = ve2 + self.seve2 = seve2 + + def __str__(self): + str = 'class=ExcIEEEAC7B\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEAC8B.py b/cimpy/cgmes_v3_0_0/ExcIEEEAC8B.py new file mode 100644 index 00000000..b9f40d2a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEAC8B.py @@ -0,0 +1,82 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEAC8B(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type AC8B model. This model represents a PID voltage regulator with either a brushless exciter or DC exciter. The AVR in this model consists of PID control, with separate constants for the proportional (KPR), integral (KIR), and derivative (KDR) gains. The representation of the brushless exciter (TE, KE, SE, KC, KD) is similar to the model type AC2A. The type AC8B model can be used to represent static voltage regulators applied to brushless excitation systems. Digitally based voltage regulators feeding DC rotating main exciters can be represented with the AC type AC8B model with the parameters KC and KD set to 0. For thyristor power stages fed from the generator terminals, the limits VRMAX and VRMIN should be a function of terminal voltage: VT x VRMAX and VT x VRMIN. Reference: IEEE 421.5-2005, 6.8. + + :kpr: Voltage regulator proportional gain (KPR) (> 0 if ExcIEEEAC8B.kir = 0). Typical value = 80. Default: 0.0 + :kir: Voltage regulator integral gain (KIR) (>= 0). Typical value = 5. Default: 0.0 + :kdr: Voltage regulator derivative gain (KDR) (>= 0). Typical value = 10. Default: 0.0 + :tdr: Lag time constant (TDR) (> 0). Typical value = 0,1. Default: 0 + :vrmax: Maximum voltage regulator output (VRMAX) (> 0). Typical value = 35. Default: 0.0 + :vrmin: Minimum voltage regulator output (VRMIN) (<= 0). Typical value = 0. Default: 0.0 + :ka: Voltage regulator gain (KA) (> 0). Typical value = 1. Default: 0.0 + :ta: Voltage regulator time constant (TA) (>= 0). Typical value = 0. Default: 0 + :te: Exciter time constant, integration rate associated with exciter control (TE) (> 0). Typical value = 1,2. Default: 0 + :vfemax: Exciter field current limit reference (VFEMAX). Typical value = 6. Default: 0.0 + :vemin: Minimum exciter voltage output (VEMIN) (<= 0). Typical value = 0. Default: 0.0 + :ke: Exciter constant related to self-excited field (KE). Typical value = 1. Default: 0.0 + :kc: Rectifier loading factor proportional to commutating reactance (KC) (>= 0). Typical value = 0,55. Default: 0.0 + :kd: Demagnetizing factor, a function of exciter alternator reactances (KD) (>= 0). Typical value = 1,1. Default: 0.0 + :ve1: Exciter alternator output voltages back of commutating reactance at which saturation is defined (VE1) (> 0). Typical value = 6,5. Default: 0.0 + :seve1: Exciter saturation function value at the corresponding exciter voltage, VE1, back of commutating reactance (SE[VE1]) (>= 0). Typical value = 0,3. Default: 0.0 + :ve2: Exciter alternator output voltages back of commutating reactance at which saturation is defined (VE2) (> 0). Typical value = 9. Default: 0.0 + :seve2: Exciter saturation function value at the corresponding exciter voltage, VE2, back of commutating reactance (SE[VE2]) (>= 0). Typical value = 3. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'kpr': [cgmesProfile.DY.value, ], + 'kir': [cgmesProfile.DY.value, ], + 'kdr': [cgmesProfile.DY.value, ], + 'tdr': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'vfemax': [cgmesProfile.DY.value, ], + 'vemin': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 've1': [cgmesProfile.DY.value, ], + 'seve1': [cgmesProfile.DY.value, ], + 've2': [cgmesProfile.DY.value, ], + 'seve2': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, kpr = 0.0, kir = 0.0, kdr = 0.0, tdr = 0, vrmax = 0.0, vrmin = 0.0, ka = 0.0, ta = 0, te = 0, vfemax = 0.0, vemin = 0.0, ke = 0.0, kc = 0.0, kd = 0.0, ve1 = 0.0, seve1 = 0.0, ve2 = 0.0, seve2 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.kpr = kpr + self.kir = kir + self.kdr = kdr + self.tdr = tdr + self.vrmax = vrmax + self.vrmin = vrmin + self.ka = ka + self.ta = ta + self.te = te + self.vfemax = vfemax + self.vemin = vemin + self.ke = ke + self.kc = kc + self.kd = kd + self.ve1 = ve1 + self.seve1 = seve1 + self.ve2 = ve2 + self.seve2 = seve2 + + def __str__(self): + str = 'class=ExcIEEEAC8B\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEDC1A.py b/cimpy/cgmes_v3_0_0/ExcIEEEDC1A.py new file mode 100644 index 00000000..07dafbe2 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEDC1A.py @@ -0,0 +1,76 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEDC1A(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type DC1A model. This model represents field-controlled DC commutator exciters with continuously acting voltage regulators (especially the direct-acting rheostatic, rotating amplifier, and magnetic amplifier types). Because this model has been widely implemented by the industry, it is sometimes used to represent other types of systems when detailed data for them are not available or when a simplified model is required. Reference: IEEE 421.5-2005, 5.1. + + :ka: Voltage regulator gain (KA) (> 0). Typical value = 46. Default: 0.0 + :ta: Voltage regulator time constant (TA) (> 0). Typical value = 0,06. Default: 0 + :tb: Voltage regulator time constant (TB) (>= 0). Typical value = 0. Default: 0 + :tc: Voltage regulator time constant (TC) (>= 0). Typical value = 0. Default: 0 + :vrmax: Maximum voltage regulator output (VRMAX) (> ExcIEEEDC1A.vrmin). Typical value = 1. Default: 0.0 + :vrmin: Minimum voltage regulator output (VRMIN) (< 0 and < ExcIEEEDC1A.vrmax). Typical value = -0,9. Default: 0.0 + :ke: Exciter constant related to self-excited field (KE). Typical value = 0. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (TE) (> 0). Typical value = 0,46. Default: 0 + :kf: Excitation control system stabilizer gain (KF) (>= 0). Typical value = 0.1. Default: 0.0 + :tf: Excitation control system stabilizer time constant (TF) (> 0). Typical value = 1. Default: 0 + :efd1: Exciter voltage at which exciter saturation is defined (EFD1) (> 0). Typical value = 3,1. Default: 0.0 + :seefd1: Exciter saturation function value at the corresponding exciter voltage, EFD1 (SE[EFD1]) (>= 0). Typical value = 0.33. Default: 0.0 + :efd2: Exciter voltage at which exciter saturation is defined (EFD2) (> 0). Typical value = 2,3. Default: 0.0 + :seefd2: Exciter saturation function value at the corresponding exciter voltage, EFD2 (SE[EFD2]) (>= 0). Typical value = 0,1. Default: 0.0 + :uelin: UEL input (uelin). true = input is connected to the HV gate false = input connects to the error signal. Typical value = true. Default: False + :exclim: (exclim). IEEE standard is ambiguous about lower limit on exciter output. true = a lower limit of zero is applied to integrator output false = a lower limit of zero is not applied to integrator output. Typical value = true. Default: False + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'efd1': [cgmesProfile.DY.value, ], + 'seefd1': [cgmesProfile.DY.value, ], + 'efd2': [cgmesProfile.DY.value, ], + 'seefd2': [cgmesProfile.DY.value, ], + 'uelin': [cgmesProfile.DY.value, ], + 'exclim': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ka = 0.0, ta = 0, tb = 0, tc = 0, vrmax = 0.0, vrmin = 0.0, ke = 0.0, te = 0, kf = 0.0, tf = 0, efd1 = 0.0, seefd1 = 0.0, efd2 = 0.0, seefd2 = 0.0, uelin = False, exclim = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.ta = ta + self.tb = tb + self.tc = tc + self.vrmax = vrmax + self.vrmin = vrmin + self.ke = ke + self.te = te + self.kf = kf + self.tf = tf + self.efd1 = efd1 + self.seefd1 = seefd1 + self.efd2 = efd2 + self.seefd2 = seefd2 + self.uelin = uelin + self.exclim = exclim + + def __str__(self): + str = 'class=ExcIEEEDC1A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEDC2A.py b/cimpy/cgmes_v3_0_0/ExcIEEEDC2A.py new file mode 100644 index 00000000..2f8e3bcc --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEDC2A.py @@ -0,0 +1,76 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEDC2A(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type DC2A model. This model represents field-controlled DC commutator exciters with continuously acting voltage regulators having supplies obtained from the generator or auxiliary bus. It differs from the type DC1A model only in the voltage regulator output limits, which are now proportional to terminal voltage VT. It is representative of solid-state replacements for various forms of older mechanical and rotating amplifier regulating equipment connected to DC commutator exciters. Reference: IEEE 421.5-2005, 5.2. + + :efd1: Exciter voltage at which exciter saturation is defined (EFD1) (> 0). Typical value = 3,05. Default: 0.0 + :efd2: Exciter voltage at which exciter saturation is defined (EFD2) (> 0). Typical value = 2,29. Default: 0.0 + :exclim: (exclim). IEEE standard is ambiguous about lower limit on exciter output. Typical value = - 999 which means that there is no limit applied. Default: 0.0 + :ka: Voltage regulator gain (KA) (> 0). Typical value = 300. Default: 0.0 + :ke: Exciter constant related to self-excited field (KE). Typical value = 1. Default: 0.0 + :kf: Excitation control system stabilizer gain (KF) (>= 0). Typical value = 0,1. Default: 0.0 + :seefd1: Exciter saturation function value at the corresponding exciter voltage, EFD1 (SE[EFD1]) (>= 0). Typical value = 0,279. Default: 0.0 + :seefd2: Exciter saturation function value at the corresponding exciter voltage, EFD2 (SE[EFD2]) (>= 0). Typical value = 0,117. Default: 0.0 + :ta: Voltage regulator time constant (TA) (> 0). Typical value = 0,01. Default: 0 + :tb: Voltage regulator time constant (TB) (>= 0). Typical value = 0. Default: 0 + :tc: Voltage regulator time constant (TC) (>= 0). Typical value = 0. Default: 0 + :te: Exciter time constant, integration rate associated with exciter control (TE) (> 0). Typical value = 1,33. Default: 0 + :tf: Excitation control system stabilizer time constant (TF) (> 0). Typical value = 0,675. Default: 0 + :uelin: UEL input (uelin). true = input is connected to the HV gate false = input connects to the error signal. Typical value = true. Default: False + :vrmax: Maximum voltage regulator output (VRMAX)(> ExcIEEEDC2A.vrmin). Typical value = 4,95. Default: 0.0 + :vrmin: Minimum voltage regulator output (VRMIN) (< 0 and < ExcIEEEDC2A.vrmax). Typical value = -4,9. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'efd1': [cgmesProfile.DY.value, ], + 'efd2': [cgmesProfile.DY.value, ], + 'exclim': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'seefd1': [cgmesProfile.DY.value, ], + 'seefd2': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'uelin': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, efd1 = 0.0, efd2 = 0.0, exclim = 0.0, ka = 0.0, ke = 0.0, kf = 0.0, seefd1 = 0.0, seefd2 = 0.0, ta = 0, tb = 0, tc = 0, te = 0, tf = 0, uelin = False, vrmax = 0.0, vrmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.efd1 = efd1 + self.efd2 = efd2 + self.exclim = exclim + self.ka = ka + self.ke = ke + self.kf = kf + self.seefd1 = seefd1 + self.seefd2 = seefd2 + self.ta = ta + self.tb = tb + self.tc = tc + self.te = te + self.tf = tf + self.uelin = uelin + self.vrmax = vrmax + self.vrmin = vrmin + + def __str__(self): + str = 'class=ExcIEEEDC2A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEDC3A.py b/cimpy/cgmes_v3_0_0/ExcIEEEDC3A.py new file mode 100644 index 00000000..0582c270 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEDC3A.py @@ -0,0 +1,61 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEDC3A(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type DC3A model. This model represents older systems, in particular those DC commutator exciters with non-continuously acting regulators that were commonly used before the development of the continuously acting varieties. These systems respond at basically two different rates, depending upon the magnitude of voltage error. For small errors, adjustment is made periodically with a signal to a motor-operated rheostat. Larger errors cause resistors to be quickly shorted or inserted and a strong forcing signal applied to the exciter. Continuous motion of the motor-operated rheostat occurs for these larger error signals, even though it is bypassed by contactor action. Reference: IEEE 421.5-2005, 5.3. + + :trh: Rheostat travel time (TRH) (> 0). Typical value = 20. Default: 0 + :kv: Fast raise/lower contact setting (KV) (> 0). Typical value = 0,05. Default: 0.0 + :vrmax: Maximum voltage regulator output (VRMAX) (> 0). Typical value = 1. Default: 0.0 + :vrmin: Minimum voltage regulator output (VRMIN) (<= 0). Typical value = 0. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (TE) (> 0). Typical value = 0,5. Default: 0 + :ke: Exciter constant related to self-excited field (KE). Typical value = 0,05. Default: 0.0 + :efd1: Exciter voltage at which exciter saturation is defined (EFD1) (> 0). Typical value = 3,375. Default: 0.0 + :seefd1: Exciter saturation function value at the corresponding exciter voltage, EFD1 (SE[EFD1]) (>= 0). Typical value = 0,267. Default: 0.0 + :efd2: Exciter voltage at which exciter saturation is defined (EFD2) (> 0). Typical value = 3,15. Default: 0.0 + :seefd2: Exciter saturation function value at the corresponding exciter voltage, EFD2 (SE[EFD2]) (>= 0). Typical value = 0,068. Default: 0.0 + :exclim: (exclim). IEEE standard is ambiguous about lower limit on exciter output. true = a lower limit of zero is applied to integrator output false = a lower limit of zero is not applied to integrator output. Typical value = true. Default: False + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'trh': [cgmesProfile.DY.value, ], + 'kv': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'efd1': [cgmesProfile.DY.value, ], + 'seefd1': [cgmesProfile.DY.value, ], + 'efd2': [cgmesProfile.DY.value, ], + 'seefd2': [cgmesProfile.DY.value, ], + 'exclim': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, trh = 0, kv = 0.0, vrmax = 0.0, vrmin = 0.0, te = 0, ke = 0.0, efd1 = 0.0, seefd1 = 0.0, efd2 = 0.0, seefd2 = 0.0, exclim = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.trh = trh + self.kv = kv + self.vrmax = vrmax + self.vrmin = vrmin + self.te = te + self.ke = ke + self.efd1 = efd1 + self.seefd1 = seefd1 + self.efd2 = efd2 + self.seefd2 = seefd2 + self.exclim = exclim + + def __str__(self): + str = 'class=ExcIEEEDC3A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEDC4B.py b/cimpy/cgmes_v3_0_0/ExcIEEEDC4B.py new file mode 100644 index 00000000..97bdf4e2 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEDC4B.py @@ -0,0 +1,85 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEDC4B(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type DC4B model. These excitation systems utilize a field-controlled DC commutator exciter with a continuously acting voltage regulator having supplies obtained from the generator or auxiliary bus. Reference: IEEE 421.5-2005, 5.4. + + :ka: Voltage regulator gain (KA) (> 0). Typical value = 1. Default: 0.0 + :ta: Voltage regulator time constant (TA) (> 0). Typical value = 0,2. Default: 0 + :kp: Regulator proportional gain (KP) (>= 0). Typical value = 20. Default: 0.0 + :ki: Regulator integral gain (KI) (>= 0). Typical value = 20. Default: 0.0 + :kd: Regulator derivative gain (KD) (>= 0). Typical value = 20. Default: 0.0 + :td: Regulator derivative filter time constant (TD) (> 0 if ExcIEEEDC4B.kd > 0). Typical value = 0,01. Default: 0 + :vrmax: Maximum voltage regulator output (VRMAX) (> ExcIEEEDC4B.vrmin). Typical value = 2,7. Default: 0.0 + :vrmin: Minimum voltage regulator output (VRMIN) (<= 0 and < ExcIEEEDC4B.vrmax). Typical value = -0,9. Default: 0.0 + :ke: Exciter constant related to self-excited field (KE). Typical value = 1. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (TE) (> 0). Typical value = 0,8. Default: 0 + :kf: Excitation control system stabilizer gain (KF) (>= 0). Typical value = 0. Default: 0.0 + :tf: Excitation control system stabilizer time constant (TF) (>= 0). Typical value = 1. Default: 0 + :efd1: Exciter voltage at which exciter saturation is defined (EFD1) (> 0). Typical value = 1,75. Default: 0.0 + :seefd1: Exciter saturation function value at the corresponding exciter voltage, EFD1 (SE[EFD1]) (>= 0). Typical value = 0,08. Default: 0.0 + :efd2: Exciter voltage at which exciter saturation is defined (EFD2) (> 0). Typical value = 2,33. Default: 0.0 + :seefd2: Exciter saturation function value at the corresponding exciter voltage, EFD2 (SE[EFD2]) (>= 0). Typical value = 0,27. Default: 0.0 + :vemin: Minimum exciter voltage output (VEMIN) (<= 0). Typical value = 0. Default: 0.0 + :oelin: OEL input (OELin). true = LV gate false = subtract from error signal. Typical value = true. Default: False + :uelin: UEL input (UELin). true = HV gate false = add to error signal. Typical value = true. Default: False + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'td': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'efd1': [cgmesProfile.DY.value, ], + 'seefd1': [cgmesProfile.DY.value, ], + 'efd2': [cgmesProfile.DY.value, ], + 'seefd2': [cgmesProfile.DY.value, ], + 'vemin': [cgmesProfile.DY.value, ], + 'oelin': [cgmesProfile.DY.value, ], + 'uelin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ka = 0.0, ta = 0, kp = 0.0, ki = 0.0, kd = 0.0, td = 0, vrmax = 0.0, vrmin = 0.0, ke = 0.0, te = 0, kf = 0.0, tf = 0, efd1 = 0.0, seefd1 = 0.0, efd2 = 0.0, seefd2 = 0.0, vemin = 0.0, oelin = False, uelin = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.ta = ta + self.kp = kp + self.ki = ki + self.kd = kd + self.td = td + self.vrmax = vrmax + self.vrmin = vrmin + self.ke = ke + self.te = te + self.kf = kf + self.tf = tf + self.efd1 = efd1 + self.seefd1 = seefd1 + self.efd2 = efd2 + self.seefd2 = seefd2 + self.vemin = vemin + self.oelin = oelin + self.uelin = uelin + + def __str__(self): + str = 'class=ExcIEEEDC4B\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEST1A.py b/cimpy/cgmes_v3_0_0/ExcIEEEST1A.py new file mode 100644 index 00000000..57c27183 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEST1A.py @@ -0,0 +1,85 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEST1A(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type ST1A model. This model represents systems in which excitation power is supplied through a transformer from the generator terminals (or the unit's auxiliary bus) and is regulated by a controlled rectifier. The maximum exciter voltage available from such systems is directly related to the generator terminal voltage. Reference: IEEE 421.5-2005, 7.1. + + :ilr: Exciter output current limit reference (ILR). Typical value = 0. Default: 0.0 + :ka: Voltage regulator gain (KA) (> 0). Typical value = 190. Default: 0.0 + :kc: Rectifier loading factor proportional to commutating reactance (KC) (>= 0). Typical value = 0,08. Default: 0.0 + :kf: Excitation control system stabilizer gains (KF) (>= 0). Typical value = 0. Default: 0.0 + :klr: Exciter output current limiter gain (KLR). Typical value = 0. Default: 0.0 + :pssin: Selector of the Power System Stabilizer (PSS) input (PSSin). true = PSS input (Vs) added to error signal false = PSS input (Vs) added to voltage regulator output. Typical value = true. Default: False + :ta: Voltage regulator time constant (TA) (>= 0). Typical value = 0. Default: 0 + :tb: Voltage regulator time constant (TB) (>= 0). Typical value = 10. Default: 0 + :tb1: Voltage regulator time constant (TB1) (>= 0). Typical value = 0. Default: 0 + :tc: Voltage regulator time constant (TC) (>= 0). Typical value = 1. Default: 0 + :tc1: Voltage regulator time constant (TC1) (>= 0). Typical value = 0. Default: 0 + :tf: Excitation control system stabilizer time constant (TF) (>= 0). Typical value = 1. Default: 0 + :uelin: Selector of the connection of the UEL input (UELin). Typical value = ignoreUELsignal. Default: None + :vamax: Maximum voltage regulator output (VAMAX) (> 0). Typical value = 14,5. Default: 0.0 + :vamin: Minimum voltage regulator output (VAMIN) (< 0). Typical value = -14,5. Default: 0.0 + :vimax: Maximum voltage regulator input limit (VIMAX) (> 0). Typical value = 999. Default: 0.0 + :vimin: Minimum voltage regulator input limit (VIMIN) (< 0). Typical value = -999. Default: 0.0 + :vrmax: Maximum voltage regulator outputs (VRMAX) (> 0). Typical value = 7,8. Default: 0.0 + :vrmin: Minimum voltage regulator outputs (VRMIN) (< 0). Typical value = -6,7. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ilr': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'klr': [cgmesProfile.DY.value, ], + 'pssin': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tb1': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'tc1': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'uelin': [cgmesProfile.DY.value, ], + 'vamax': [cgmesProfile.DY.value, ], + 'vamin': [cgmesProfile.DY.value, ], + 'vimax': [cgmesProfile.DY.value, ], + 'vimin': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ilr = 0.0, ka = 0.0, kc = 0.0, kf = 0.0, klr = 0.0, pssin = False, ta = 0, tb = 0, tb1 = 0, tc = 0, tc1 = 0, tf = 0, uelin = None, vamax = 0.0, vamin = 0.0, vimax = 0.0, vimin = 0.0, vrmax = 0.0, vrmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ilr = ilr + self.ka = ka + self.kc = kc + self.kf = kf + self.klr = klr + self.pssin = pssin + self.ta = ta + self.tb = tb + self.tb1 = tb1 + self.tc = tc + self.tc1 = tc1 + self.tf = tf + self.uelin = uelin + self.vamax = vamax + self.vamin = vamin + self.vimax = vimax + self.vimin = vimin + self.vrmax = vrmax + self.vrmin = vrmin + + def __str__(self): + str = 'class=ExcIEEEST1A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEST1AUELselectorKind.py b/cimpy/cgmes_v3_0_0/ExcIEEEST1AUELselectorKind.py new file mode 100644 index 00000000..b85ad4d7 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEST1AUELselectorKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class ExcIEEEST1AUELselectorKind(Base): + ''' + Types of connections for the UEL input used in ExcIEEEST1A. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=ExcIEEEST1AUELselectorKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEST2A.py b/cimpy/cgmes_v3_0_0/ExcIEEEST2A.py new file mode 100644 index 00000000..c0b816f2 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEST2A.py @@ -0,0 +1,67 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEST2A(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type ST2A model. Some static systems use both current and voltage sources (generator terminal quantities) to comprise the power source. The regulator controls the exciter output through controlled saturation of the power transformer components. These compound-source rectifier excitation systems are designated type ST2A and are represented by ExcIEEEST2A. Reference: IEEE 421.5-2005, 7.2. + + :ka: Voltage regulator gain (KA) (> 0). Typical value = 120. Default: 0.0 + :ta: Voltage regulator time constant (TA) (> 0). Typical value = 0,15. Default: 0 + :vrmax: Maximum voltage regulator outputs (VRMAX) (> 0). Typical value = 1. Default: 0.0 + :vrmin: Minimum voltage regulator outputs (VRMIN) (<= 0). Typical value = 0. Default: 0.0 + :ke: Exciter constant related to self-excited field (KE). Typical value = 1. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (TE) (> 0). Typical value = 0,5. Default: 0 + :kf: Excitation control system stabilizer gains (KF) (>= 0). Typical value = 0,05. Default: 0.0 + :tf: Excitation control system stabilizer time constant (TF) (>= 0). Typical value = 1. Default: 0 + :kp: Potential circuit gain coefficient (KP) (>= 0). Typical value = 4,88. Default: 0.0 + :ki: Potential circuit gain coefficient (KI) (>= 0). Typical value = 8. Default: 0.0 + :kc: Rectifier loading factor proportional to commutating reactance (KC) (>= 0). Typical value = 1,82. Default: 0.0 + :efdmax: Maximum field voltage (EFDMax) (>= 0). Typical value = 99. Default: 0.0 + :uelin: UEL input (UELin). true = HV gate false = add to error signal. Typical value = true. Default: False + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'efdmax': [cgmesProfile.DY.value, ], + 'uelin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ka = 0.0, ta = 0, vrmax = 0.0, vrmin = 0.0, ke = 0.0, te = 0, kf = 0.0, tf = 0, kp = 0.0, ki = 0.0, kc = 0.0, efdmax = 0.0, uelin = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.ta = ta + self.vrmax = vrmax + self.vrmin = vrmin + self.ke = ke + self.te = te + self.kf = kf + self.tf = tf + self.kp = kp + self.ki = ki + self.kc = kc + self.efdmax = efdmax + self.uelin = uelin + + def __str__(self): + str = 'class=ExcIEEEST2A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEST3A.py b/cimpy/cgmes_v3_0_0/ExcIEEEST3A.py new file mode 100644 index 00000000..0d73c0fd --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEST3A.py @@ -0,0 +1,88 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEST3A(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type ST3A model. Some static systems utilize a field voltage control loop to linearize the exciter control characteristic. This also makes the output independent of supply source variations until supply limitations are reached. These systems utilize a variety of controlled-rectifier designs: full thyristor complements or hybrid bridges in either series or shunt configurations. The power source can consist of only a potential source, either fed from the machine terminals or from internal windings. Some designs can have compound power sources utilizing both machine potential and current. These power sources are represented as phasor combinations of machine terminal current and voltage and are accommodated by suitable parameters in model type ST3A which is represented by ExcIEEEST3A. Reference: IEEE 421.5-2005, 7.3. + + :vimax: Maximum voltage regulator input limit (VIMAX) (> 0). Typical value = 0,2. Default: 0.0 + :vimin: Minimum voltage regulator input limit (VIMIN) (< 0). Typical value = -0,2. Default: 0.0 + :ka: Voltage regulator gain (KA) (> 0). This is parameter K in the IEEE standard. Typical value = 200. Default: 0.0 + :ta: Voltage regulator time constant (TA) (>= 0). Typical value = 0. Default: 0 + :tb: Voltage regulator time constant (TB) (>= 0). Typical value = 10. Default: 0 + :tc: Voltage regulator time constant (TC) (>= 0). Typical value = 1. Default: 0 + :vrmax: Maximum voltage regulator output (VRMAX) (> 0). Typical value = 10. Default: 0.0 + :vrmin: Minimum voltage regulator output (VRMIN) (< 0). Typical value = -10. Default: 0.0 + :km: Forward gain constant of the inner loop field regulator (KM) (> 0). Typical value = 7,93. Default: 0.0 + :tm: Forward time constant of inner loop field regulator (TM) (> 0). Typical value = 0,4. Default: 0 + :vmmax: Maximum inner loop output (VMMax) (> 0). Typical value = 1. Default: 0.0 + :vmmin: Minimum inner loop output (VMMin) (<= 0). Typical value = 0. Default: 0.0 + :kg: Feedback gain constant of the inner loop field regulator (KG) (>= 0). Typical value = 1. Default: 0.0 + :kp: Potential circuit gain coefficient (KP) (> 0). Typical value = 6,15. Default: 0.0 + :thetap: Potential circuit phase angle (thetap). Typical value = 0. Default: 0.0 + :ki: Potential circuit gain coefficient (KI) (>= 0). Typical value = 0. Default: 0.0 + :kc: Rectifier loading factor proportional to commutating reactance (KC) (>= 0). Typical value = 0,2. Default: 0.0 + :xl: Reactance associated with potential source (XL) (>= 0). Typical value = 0,081. Default: 0.0 + :vbmax: Maximum excitation voltage (VBMax) (> 0). Typical value = 6,9. Default: 0.0 + :vgmax: Maximum inner loop feedback voltage (VGMax) (>= 0). Typical value = 5,8. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'vimax': [cgmesProfile.DY.value, ], + 'vimin': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'km': [cgmesProfile.DY.value, ], + 'tm': [cgmesProfile.DY.value, ], + 'vmmax': [cgmesProfile.DY.value, ], + 'vmmin': [cgmesProfile.DY.value, ], + 'kg': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'thetap': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'xl': [cgmesProfile.DY.value, ], + 'vbmax': [cgmesProfile.DY.value, ], + 'vgmax': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, vimax = 0.0, vimin = 0.0, ka = 0.0, ta = 0, tb = 0, tc = 0, vrmax = 0.0, vrmin = 0.0, km = 0.0, tm = 0, vmmax = 0.0, vmmin = 0.0, kg = 0.0, kp = 0.0, thetap = 0.0, ki = 0.0, kc = 0.0, xl = 0.0, vbmax = 0.0, vgmax = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.vimax = vimax + self.vimin = vimin + self.ka = ka + self.ta = ta + self.tb = tb + self.tc = tc + self.vrmax = vrmax + self.vrmin = vrmin + self.km = km + self.tm = tm + self.vmmax = vmmax + self.vmmin = vmmin + self.kg = kg + self.kp = kp + self.thetap = thetap + self.ki = ki + self.kc = kc + self.xl = xl + self.vbmax = vbmax + self.vgmax = vgmax + + def __str__(self): + str = 'class=ExcIEEEST3A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEST4B.py b/cimpy/cgmes_v3_0_0/ExcIEEEST4B.py new file mode 100644 index 00000000..59f59e50 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEST4B.py @@ -0,0 +1,76 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEST4B(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type ST4B model. This model is a variation of the type ST3A model, with a proportional plus integral (PI) regulator block replacing the lag-lead regulator characteristic that is in the ST3A model. Both potential and compound source rectifier excitation systems are modelled. The PI regulator blocks have non-windup limits that are represented. The voltage regulator of this model is typically implemented digitally. Reference: IEEE 421.5-2005, 7.4. + + :kpr: Voltage regulator proportional gain (KPR). Typical value = 10,75. Default: 0.0 + :kir: Voltage regulator integral gain (KIR). Typical value = 10,75. Default: 0.0 + :ta: Voltage regulator time constant (TA) (>= 0). Typical value = 0,02. Default: 0 + :vrmax: Maximum voltage regulator output (VRMAX) (> 0). Typical value = 1. Default: 0.0 + :vrmin: Minimum voltage regulator output (VRMIN) (< 0). Typical value = -0,87. Default: 0.0 + :kpm: Voltage regulator proportional gain output (KPM). Typical value = 1. Default: 0.0 + :kim: Voltage regulator integral gain output (KIM). Typical value = 0. Default: 0.0 + :vmmax: Maximum inner loop output (VMMax) (> ExcIEEEST4B.vmmin). Typical value = 99. Default: 0.0 + :vmmin: Minimum inner loop output (VMMin) (< ExcIEEEST4B.vmmax). Typical value = -99. Default: 0.0 + :kg: Feedback gain constant of the inner loop field regulator (KG) (>= 0). Typical value = 0. Default: 0.0 + :kp: Potential circuit gain coefficient (KP) (> 0). Typical value = 9,3. Default: 0.0 + :thetap: Potential circuit phase angle (thetap). Typical value = 0. Default: 0.0 + :ki: Potential circuit gain coefficient (KI) (>= 0). Typical value = 0. Default: 0.0 + :kc: Rectifier loading factor proportional to commutating reactance (KC) (>= 0). Typical value = 0,113. Default: 0.0 + :xl: Reactance associated with potential source (XL) (>= 0). Typical value = 0,124. Default: 0.0 + :vbmax: Maximum excitation voltage (VBMax) (> 0). Typical value = 11,63. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'kpr': [cgmesProfile.DY.value, ], + 'kir': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'kpm': [cgmesProfile.DY.value, ], + 'kim': [cgmesProfile.DY.value, ], + 'vmmax': [cgmesProfile.DY.value, ], + 'vmmin': [cgmesProfile.DY.value, ], + 'kg': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'thetap': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'xl': [cgmesProfile.DY.value, ], + 'vbmax': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, kpr = 0.0, kir = 0.0, ta = 0, vrmax = 0.0, vrmin = 0.0, kpm = 0.0, kim = 0.0, vmmax = 0.0, vmmin = 0.0, kg = 0.0, kp = 0.0, thetap = 0.0, ki = 0.0, kc = 0.0, xl = 0.0, vbmax = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.kpr = kpr + self.kir = kir + self.ta = ta + self.vrmax = vrmax + self.vrmin = vrmin + self.kpm = kpm + self.kim = kim + self.vmmax = vmmax + self.vmmin = vmmin + self.kg = kg + self.kp = kp + self.thetap = thetap + self.ki = ki + self.kc = kc + self.xl = xl + self.vbmax = vbmax + + def __str__(self): + str = 'class=ExcIEEEST4B\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEST5B.py b/cimpy/cgmes_v3_0_0/ExcIEEEST5B.py new file mode 100644 index 00000000..ac1b1893 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEST5B.py @@ -0,0 +1,79 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEST5B(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type ST5B model. The type ST5B excitation system is a variation of the type ST1A model, with alternative overexcitation and underexcitation inputs and additional limits. The block diagram in the IEEE 421.5 standard has input signal Vc and does not indicate the summation point with Vref. The implementation of the ExcIEEEST5B shall consider summation point with Vref. Reference: IEEE 421.5-2005, 7.5. + + :kr: Regulator gain (KR) (> 0). Typical value = 200. Default: 0.0 + :t1: Firing circuit time constant (T1) (>= 0). Typical value = 0,004. Default: 0 + :kc: Rectifier regulation factor (KC) (>= 0). Typical value = 0,004. Default: 0.0 + :vrmax: Maximum voltage regulator output (VRMAX) (> 0). Typical value = 5. Default: 0.0 + :vrmin: Minimum voltage regulator output (VRMIN) (< 0). Typical value = -4. Default: 0.0 + :tc1: Regulator lead time constant (TC1) (>= 0). Typical value = 0,8. Default: 0 + :tb1: Regulator lag time constant (TB1) (>= 0). Typical value = 6. Default: 0 + :tc2: Regulator lead time constant (TC2) (>= 0). Typical value = 0,08. Default: 0 + :tb2: Regulator lag time constant (TB2) (>= 0). Typical value = 0,01. Default: 0 + :toc1: OEL lead time constant (TOC1) (>= 0). Typical value = 0,1. Default: 0 + :tob1: OEL lag time constant (TOB1) (>= 0). Typical value = 2. Default: 0 + :toc2: OEL lead time constant (TOC2) (>= 0). Typical value = 0,08. Default: 0 + :tob2: OEL lag time constant (TOB2) (>= 0). Typical value = 0,08. Default: 0 + :tuc1: UEL lead time constant (TUC1) (>= 0). Typical value = 2. Default: 0 + :tub1: UEL lag time constant (TUB1) (>= 0). Typical value = 10. Default: 0 + :tuc2: UEL lead time constant (TUC2) (>= 0). Typical value = 0,1. Default: 0 + :tub2: UEL lag time constant (TUB2) (>= 0). Typical value = 0,05. Default: 0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'kr': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'tc1': [cgmesProfile.DY.value, ], + 'tb1': [cgmesProfile.DY.value, ], + 'tc2': [cgmesProfile.DY.value, ], + 'tb2': [cgmesProfile.DY.value, ], + 'toc1': [cgmesProfile.DY.value, ], + 'tob1': [cgmesProfile.DY.value, ], + 'toc2': [cgmesProfile.DY.value, ], + 'tob2': [cgmesProfile.DY.value, ], + 'tuc1': [cgmesProfile.DY.value, ], + 'tub1': [cgmesProfile.DY.value, ], + 'tuc2': [cgmesProfile.DY.value, ], + 'tub2': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, kr = 0.0, t1 = 0, kc = 0.0, vrmax = 0.0, vrmin = 0.0, tc1 = 0, tb1 = 0, tc2 = 0, tb2 = 0, toc1 = 0, tob1 = 0, toc2 = 0, tob2 = 0, tuc1 = 0, tub1 = 0, tuc2 = 0, tub2 = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.kr = kr + self.t1 = t1 + self.kc = kc + self.vrmax = vrmax + self.vrmin = vrmin + self.tc1 = tc1 + self.tb1 = tb1 + self.tc2 = tc2 + self.tb2 = tb2 + self.toc1 = toc1 + self.tob1 = tob1 + self.toc2 = toc2 + self.tob2 = tob2 + self.tuc1 = tuc1 + self.tub1 = tub1 + self.tuc2 = tuc2 + self.tub2 = tub2 + + def __str__(self): + str = 'class=ExcIEEEST5B\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEST6B.py b/cimpy/cgmes_v3_0_0/ExcIEEEST6B.py new file mode 100644 index 00000000..39024d21 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEST6B.py @@ -0,0 +1,70 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEST6B(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type ST6B model. This model consists of a PI voltage regulator with an inner loop field voltage regulator and pre-control. The field voltage regulator implements a proportional control. The pre-control and the delay in the feedback circuit increase the dynamic response. Reference: IEEE 421.5-2005, 7.6. + + :ilr: Exciter output current limit reference (ILR) (> 0). Typical value = 4,164. Default: 0.0 + :kci: Exciter output current limit adjustment (KCI) (> 0). Typical value = 1,0577. Default: 0.0 + :kff: Pre-control gain constant of the inner loop field regulator (KFF). Typical value = 1. Default: 0.0 + :kg: Feedback gain constant of the inner loop field regulator (KG) (>= 0). Typical value = 1. Default: 0.0 + :kia: Voltage regulator integral gain (KIA) (> 0). Typical value = 45,094. Default: 0.0 + :klr: Exciter output current limiter gain (KLR) (> 0). Typical value = 17,33. Default: 0.0 + :km: Forward gain constant of the inner loop field regulator (KM). Typical value = 1. Default: 0.0 + :kpa: Voltage regulator proportional gain (KPA) (> 0). Typical value = 18,038. Default: 0.0 + :oelin: OEL input selector (OELin). Typical value = noOELinput. Default: None + :tg: Feedback time constant of inner loop field voltage regulator (TG) (>= 0). Typical value = 0,02. Default: 0 + :vamax: Maximum voltage regulator output (VAMAX) (> 0). Typical value = 4,81. Default: 0.0 + :vamin: Minimum voltage regulator output (VAMIN) (< 0). Typical value = -3,85. Default: 0.0 + :vrmax: Maximum voltage regulator output (VRMAX) (> 0). Typical value = 4,81. Default: 0.0 + :vrmin: Minimum voltage regulator output (VRMIN) (< 0). Typical value = -3,85. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ilr': [cgmesProfile.DY.value, ], + 'kci': [cgmesProfile.DY.value, ], + 'kff': [cgmesProfile.DY.value, ], + 'kg': [cgmesProfile.DY.value, ], + 'kia': [cgmesProfile.DY.value, ], + 'klr': [cgmesProfile.DY.value, ], + 'km': [cgmesProfile.DY.value, ], + 'kpa': [cgmesProfile.DY.value, ], + 'oelin': [cgmesProfile.DY.value, ], + 'tg': [cgmesProfile.DY.value, ], + 'vamax': [cgmesProfile.DY.value, ], + 'vamin': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ilr = 0.0, kci = 0.0, kff = 0.0, kg = 0.0, kia = 0.0, klr = 0.0, km = 0.0, kpa = 0.0, oelin = None, tg = 0, vamax = 0.0, vamin = 0.0, vrmax = 0.0, vrmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ilr = ilr + self.kci = kci + self.kff = kff + self.kg = kg + self.kia = kia + self.klr = klr + self.km = km + self.kpa = kpa + self.oelin = oelin + self.tg = tg + self.vamax = vamax + self.vamin = vamin + self.vrmax = vrmax + self.vrmin = vrmin + + def __str__(self): + str = 'class=ExcIEEEST6B\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcIEEEST7B.py b/cimpy/cgmes_v3_0_0/ExcIEEEST7B.py new file mode 100644 index 00000000..17104dcb --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcIEEEST7B.py @@ -0,0 +1,73 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcIEEEST7B(ExcitationSystemDynamics): + ''' + IEEE 421.5-2005 type ST7B model. This model is representative of static potential-source excitation systems. In this system, the AVR consists of a PI voltage regulator. A phase lead-lag filter in series allows the introduction of a derivative function, typically used with brushless excitation systems. In that case, the regulator is of the PID type. In addition, the terminal voltage channel includes a phase lead-lag filter. The AVR includes the appropriate inputs on its reference for overexcitation limiter (OEL1), underexcitation limiter (UEL), stator current limiter (SCL), and current compensator (DROOP). All these limitations, when they work at voltage reference level, keep the PSS (VS signal from PSS) in operation. However, the UEL limitation can also be transferred to the high value (HV) gate acting on the output signal. In addition, the output signal passes through a low value (LV) gate for a ceiling overexcitation limiter (OEL2). Reference: IEEE 421.5-2005, 7.7. + + :kh: High-value gate feedback gain (KH) (>= 0). Typical value = 1. Default: 0.0 + :kia: Voltage regulator integral gain (KIA) (>= 0). Typical value = 1. Default: 0.0 + :kl: Low-value gate feedback gain (KL) (>= 0). Typical value = 1. Default: 0.0 + :kpa: Voltage regulator proportional gain (KPA) (> 0). Typical value = 40. Default: 0.0 + :oelin: OEL input selector (OELin). Typical value = noOELinput. Default: None + :tb: Regulator lag time constant (TB) (>= 0). Typical value = 1. Default: 0 + :tc: Regulator lead time constant (TC) (>= 0). Typical value = 1. Default: 0 + :tf: Excitation control system stabilizer time constant (TF) (>= 0). Typical value = 1. Default: 0 + :tg: Feedback time constant of inner loop field voltage regulator (TG) (>= 0). Typical value = 1. Default: 0 + :tia: Feedback time constant (TIA) (>= 0). Typical value = 3. Default: 0 + :uelin: UEL input selector (UELin). Typical value = noUELinput. Default: None + :vmax: Maximum voltage reference signal (VMAX) (> 0 and > ExcIEEEST7B.vmin). Typical value = 1,1. Default: 0.0 + :vmin: Minimum voltage reference signal (VMIN) (> 0 and < ExcIEEEST7B.vmax). Typical value = 0,9. Default: 0.0 + :vrmax: Maximum voltage regulator output (VRMAX) (> 0). Typical value = 5. Default: 0.0 + :vrmin: Minimum voltage regulator output (VRMIN) (< 0). Typical value = -4,5. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'kh': [cgmesProfile.DY.value, ], + 'kia': [cgmesProfile.DY.value, ], + 'kl': [cgmesProfile.DY.value, ], + 'kpa': [cgmesProfile.DY.value, ], + 'oelin': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'tg': [cgmesProfile.DY.value, ], + 'tia': [cgmesProfile.DY.value, ], + 'uelin': [cgmesProfile.DY.value, ], + 'vmax': [cgmesProfile.DY.value, ], + 'vmin': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, kh = 0.0, kia = 0.0, kl = 0.0, kpa = 0.0, oelin = None, tb = 0, tc = 0, tf = 0, tg = 0, tia = 0, uelin = None, vmax = 0.0, vmin = 0.0, vrmax = 0.0, vrmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.kh = kh + self.kia = kia + self.kl = kl + self.kpa = kpa + self.oelin = oelin + self.tb = tb + self.tc = tc + self.tf = tf + self.tg = tg + self.tia = tia + self.uelin = uelin + self.vmax = vmax + self.vmin = vmin + self.vrmax = vrmax + self.vrmin = vrmin + + def __str__(self): + str = 'class=ExcIEEEST7B\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcNI.py b/cimpy/cgmes_v3_0_0/ExcNI.py new file mode 100644 index 00000000..2a19a237 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcNI.py @@ -0,0 +1,58 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcNI(ExcitationSystemDynamics): + ''' + Bus or solid fed SCR (silicon-controlled rectifier) bridge excitation system model type NI (NVE). + + :busFedSelector: Fed by selector (BusFedSelector). true = bus fed (switch is closed) false = solid fed (switch is open). Typical value = true. Default: False + :tr: Time constant (Tr) (>= 0). Typical value = 0,02. Default: 0 + :ka: Voltage regulator gain (Ka) (> 0). Typical value = 210. Default: 0.0 + :ta: Voltage regulator time constant (Ta) (> 0). Typical value = 0,02. Default: 0 + :vrmax: Maximum voltage regulator ouput (Vrmax) (> ExcNI.vrmin). Typical value = 5,0. Default: 0.0 + :vrmin: Minimum voltage regulator ouput (Vrmin) (< ExcNI.vrmax). Typical value = -2,0. Default: 0.0 + :kf: Excitation control system stabilizer gain (Kf) (> 0). Typical value 0,01. Default: 0.0 + :tf2: Excitation control system stabilizer time constant (Tf2) (> 0). Typical value = 0,1. Default: 0 + :tf1: Excitation control system stabilizer time constant (Tf1) (> 0). Typical value = 1,0. Default: 0 + :r: rc / rfd (R) (>= 0). 0 means exciter has negative current capability > 0 means exciter does not have negative current capability. Typical value = 5. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'busFedSelector': [cgmesProfile.DY.value, ], + 'tr': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf2': [cgmesProfile.DY.value, ], + 'tf1': [cgmesProfile.DY.value, ], + 'r': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, busFedSelector = False, tr = 0, ka = 0.0, ta = 0, vrmax = 0.0, vrmin = 0.0, kf = 0.0, tf2 = 0, tf1 = 0, r = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.busFedSelector = busFedSelector + self.tr = tr + self.ka = ka + self.ta = ta + self.vrmax = vrmax + self.vrmin = vrmin + self.kf = kf + self.tf2 = tf2 + self.tf1 = tf1 + self.r = r + + def __str__(self): + str = 'class=ExcNI\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcOEX3T.py b/cimpy/cgmes_v3_0_0/ExcOEX3T.py new file mode 100644 index 00000000..3fb96b4f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcOEX3T.py @@ -0,0 +1,85 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcOEX3T(ExcitationSystemDynamics): + ''' + Modified IEEE type ST1 excitation system with semi-continuous and acting terminal voltage limiter. + + :t1: Time constant (T1) (>= 0). Default: 0 + :t2: Time constant (T2) (>= 0). Default: 0 + :t3: Time constant (T3) (>= 0). Default: 0 + :t4: Time constant (T4) (>= 0). Default: 0 + :ka: Gain (KA). Default: 0.0 + :t5: Time constant (T5) (>= 0). Default: 0 + :t6: Time constant (T6) (>= 0). Default: 0 + :vrmax: Limiter (VRMAX) (> ExcOEX3T.vrmin). Default: 0.0 + :vrmin: Limiter (VRMIN) (< ExcOEX3T.vrmax). Default: 0.0 + :te: Time constant (TE) (>= 0). Default: 0 + :kf: Gain (KF). Default: 0.0 + :tf: Time constant (TF) (>= 0). Default: 0 + :kc: Gain (KC). Default: 0.0 + :kd: Gain (KD). Default: 0.0 + :ke: Gain (KE). Default: 0.0 + :e1: Saturation parameter (E1). Default: 0.0 + :see1: Saturation parameter (SE[E1]). Default: 0.0 + :e2: Saturation parameter (E2). Default: 0.0 + :see2: Saturation parameter (SE[E2]). Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 't6': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'e1': [cgmesProfile.DY.value, ], + 'see1': [cgmesProfile.DY.value, ], + 'e2': [cgmesProfile.DY.value, ], + 'see2': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, t1 = 0, t2 = 0, t3 = 0, t4 = 0, ka = 0.0, t5 = 0, t6 = 0, vrmax = 0.0, vrmin = 0.0, te = 0, kf = 0.0, tf = 0, kc = 0.0, kd = 0.0, ke = 0.0, e1 = 0.0, see1 = 0.0, e2 = 0.0, see2 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.t4 = t4 + self.ka = ka + self.t5 = t5 + self.t6 = t6 + self.vrmax = vrmax + self.vrmin = vrmin + self.te = te + self.kf = kf + self.tf = tf + self.kc = kc + self.kd = kd + self.ke = ke + self.e1 = e1 + self.see1 = see1 + self.e2 = e2 + self.see2 = see2 + + def __str__(self): + str = 'class=ExcOEX3T\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcPIC.py b/cimpy/cgmes_v3_0_0/ExcPIC.py new file mode 100644 index 00000000..8ffec4f7 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcPIC.py @@ -0,0 +1,97 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcPIC(ExcitationSystemDynamics): + ''' + Proportional/integral regulator excitation system. This model can be used to represent excitation systems with a proportional-integral (PI) voltage regulator controller. + + :ka: PI controller gain (Ka). Typical value = 3,15. Default: 0.0 + :ta1: PI controller time constant (Ta1) (>= 0). Typical value = 1. Default: 0 + :vr1: PI maximum limit (Vr1). Typical value = 1. Default: 0.0 + :vr2: PI minimum limit (Vr2). Typical value = -0,87. Default: 0.0 + :ta2: Voltage regulator time constant (Ta2) (>= 0). Typical value = 0,01. Default: 0 + :ta3: Lead time constant (Ta3) (>= 0). Typical value = 0. Default: 0 + :ta4: Lag time constant (Ta4) (>= 0). Typical value = 0. Default: 0 + :vrmax: Voltage regulator maximum limit (Vrmax) (> ExcPIC.vrmin). Typical value = 1. Default: 0.0 + :vrmin: Voltage regulator minimum limit (Vrmin) (< ExcPIC.vrmax). Typical value = -0,87. Default: 0.0 + :kf: Rate feedback gain (Kf). Typical value = 0. Default: 0.0 + :tf1: Rate feedback time constant (Tf1) (>= 0). Typical value = 0. Default: 0 + :tf2: Rate feedback lag time constant (Tf2) (>= 0). Typical value = 0. Default: 0 + :efdmax: Exciter maximum limit (Efdmax) (> ExcPIC.efdmin). Typical value = 8. Default: 0.0 + :efdmin: Exciter minimum limit (Efdmin) (< ExcPIC.efdmax). Typical value = -0,87. Default: 0.0 + :ke: Exciter constant (Ke). Typical value = 0. Default: 0.0 + :te: Exciter time constant (Te) (>= 0). Typical value = 0. Default: 0 + :e1: Field voltage value 1 (E1). Typical value = 0. Default: 0.0 + :se1: Saturation factor at E1 (Se1). Typical value = 0. Default: 0.0 + :e2: Field voltage value 2 (E2). Typical value = 0. Default: 0.0 + :se2: Saturation factor at E2 (Se2). Typical value = 0. Default: 0.0 + :kp: Potential source gain (Kp). Typical value = 6,5. Default: 0.0 + :ki: Current source gain (Ki). Typical value = 0. Default: 0.0 + :kc: Exciter regulation factor (Kc). Typical value = 0,08. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta1': [cgmesProfile.DY.value, ], + 'vr1': [cgmesProfile.DY.value, ], + 'vr2': [cgmesProfile.DY.value, ], + 'ta2': [cgmesProfile.DY.value, ], + 'ta3': [cgmesProfile.DY.value, ], + 'ta4': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf1': [cgmesProfile.DY.value, ], + 'tf2': [cgmesProfile.DY.value, ], + 'efdmax': [cgmesProfile.DY.value, ], + 'efdmin': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'e1': [cgmesProfile.DY.value, ], + 'se1': [cgmesProfile.DY.value, ], + 'e2': [cgmesProfile.DY.value, ], + 'se2': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ka = 0.0, ta1 = 0, vr1 = 0.0, vr2 = 0.0, ta2 = 0, ta3 = 0, ta4 = 0, vrmax = 0.0, vrmin = 0.0, kf = 0.0, tf1 = 0, tf2 = 0, efdmax = 0.0, efdmin = 0.0, ke = 0.0, te = 0, e1 = 0.0, se1 = 0.0, e2 = 0.0, se2 = 0.0, kp = 0.0, ki = 0.0, kc = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.ta1 = ta1 + self.vr1 = vr1 + self.vr2 = vr2 + self.ta2 = ta2 + self.ta3 = ta3 + self.ta4 = ta4 + self.vrmax = vrmax + self.vrmin = vrmin + self.kf = kf + self.tf1 = tf1 + self.tf2 = tf2 + self.efdmax = efdmax + self.efdmin = efdmin + self.ke = ke + self.te = te + self.e1 = e1 + self.se1 = se1 + self.e2 = e2 + self.se2 = se2 + self.kp = kp + self.ki = ki + self.kc = kc + + def __str__(self): + str = 'class=ExcPIC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcREXS.py b/cimpy/cgmes_v3_0_0/ExcREXS.py new file mode 100644 index 00000000..9c92ff90 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcREXS.py @@ -0,0 +1,136 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcREXS(ExcitationSystemDynamics): + ''' + General purpose rotating excitation system. This model can be used to represent a wide range of excitation systems whose DC power source is an AC or DC generator. It encompasses IEEE type AC1, AC2, DC1, and DC2 excitation system models. + + :e1: Field voltage value 1 (E1). Typical value = 3. Default: 0.0 + :e2: Field voltage value 2 (E2). Typical value = 4. Default: 0.0 + :fbf: Rate feedback signal flag (fbf). Typical value = fieldCurrent. Default: None + :flimf: Limit type flag (Flimf). Typical value = 0. Default: 0.0 + :kc: Rectifier regulation factor (Kc). Typical value = 0,05. Default: 0.0 + :kd: Exciter regulation factor (Kd). Typical value = 2. Default: 0.0 + :ke: Exciter field proportional constant (Ke). Typical value = 1. Default: 0.0 + :kefd: Field voltage feedback gain (Kefd). Typical value = 0. Default: 0.0 + :kf: Rate feedback gain (Kf) (>= 0). Typical value = 0,05. Default: 0 + :kh: Field voltage controller feedback gain (Kh). Typical value = 0. Default: 0.0 + :kii: Field current regulator integral gain (Kii). Typical value = 0. Default: 0.0 + :kip: Field current regulator proportional gain (Kip). Typical value = 1. Default: 0.0 + :ks: Coefficient to allow different usage of the model-speed coefficient (Ks). Typical value = 0. Default: 0.0 + :kvi: Voltage regulator integral gain (Kvi). Typical value = 0. Default: 0.0 + :kvp: Voltage regulator proportional gain (Kvp). Typical value = 2800. Default: 0.0 + :kvphz: V/Hz limiter gain (Kvphz). Typical value = 0. Default: 0.0 + :nvphz: Pickup speed of V/Hz limiter (Nvphz). Typical value = 0. Default: 0.0 + :se1: Saturation factor at E1 (Se1). Typical value = 0,0001. Default: 0.0 + :se2: Saturation factor at E2 (Se2). Typical value = 0,001. Default: 0.0 + :ta: Voltage regulator time constant (Ta) (>= 0). If = 0, block is bypassed. Typical value = 0,01. Default: 0 + :tb1: Lag time constant (Tb1) (>= 0). If = 0, block is bypassed. Typical value = 0. Default: 0 + :tb2: Lag time constant (Tb2) (>= 0). If = 0, block is bypassed. Typical value = 0. Default: 0 + :tc1: Lead time constant (Tc1) (>= 0). Typical value = 0. Default: 0 + :tc2: Lead time constant (Tc2) (>= 0). Typical value = 0. Default: 0 + :te: Exciter field time constant (Te) (> 0). Typical value = 1,2. Default: 0 + :tf: Rate feedback time constant (Tf) (>= 0). If = 0, the feedback path is not used. Typical value = 1. Default: 0 + :tf1: Feedback lead time constant (Tf1) (>= 0). Typical value = 0. Default: 0 + :tf2: Feedback lag time constant (Tf2) (>= 0). If = 0, block is bypassed. Typical value = 0. Default: 0 + :tp: Field current bridge time constant (Tp) (>= 0). Typical value = 0. Default: 0 + :vcmax: Maximum compounding voltage (Vcmax). Typical value = 0. Default: 0.0 + :vfmax: Maximum exciter field current (Vfmax) (> ExcREXS.vfmin). Typical value = 47. Default: 0.0 + :vfmin: Minimum exciter field current (Vfmin) (< ExcREXS.vfmax). Typical value = -20. Default: 0.0 + :vimax: Voltage regulator input limit (Vimax). Typical value = 0,1. Default: 0.0 + :vrmax: Maximum controller output (Vrmax) (> ExcREXS.vrmin). Typical value = 47. Default: 0.0 + :vrmin: Minimum controller output (Vrmin) (< ExcREXS.vrmax). Typical value = -20. Default: 0.0 + :xc: Exciter compounding reactance (Xc). Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'e1': [cgmesProfile.DY.value, ], + 'e2': [cgmesProfile.DY.value, ], + 'fbf': [cgmesProfile.DY.value, ], + 'flimf': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'kefd': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'kh': [cgmesProfile.DY.value, ], + 'kii': [cgmesProfile.DY.value, ], + 'kip': [cgmesProfile.DY.value, ], + 'ks': [cgmesProfile.DY.value, ], + 'kvi': [cgmesProfile.DY.value, ], + 'kvp': [cgmesProfile.DY.value, ], + 'kvphz': [cgmesProfile.DY.value, ], + 'nvphz': [cgmesProfile.DY.value, ], + 'se1': [cgmesProfile.DY.value, ], + 'se2': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tb1': [cgmesProfile.DY.value, ], + 'tb2': [cgmesProfile.DY.value, ], + 'tc1': [cgmesProfile.DY.value, ], + 'tc2': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'tf1': [cgmesProfile.DY.value, ], + 'tf2': [cgmesProfile.DY.value, ], + 'tp': [cgmesProfile.DY.value, ], + 'vcmax': [cgmesProfile.DY.value, ], + 'vfmax': [cgmesProfile.DY.value, ], + 'vfmin': [cgmesProfile.DY.value, ], + 'vimax': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'xc': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, e1 = 0.0, e2 = 0.0, fbf = None, flimf = 0.0, kc = 0.0, kd = 0.0, ke = 0.0, kefd = 0.0, kf = 0, kh = 0.0, kii = 0.0, kip = 0.0, ks = 0.0, kvi = 0.0, kvp = 0.0, kvphz = 0.0, nvphz = 0.0, se1 = 0.0, se2 = 0.0, ta = 0, tb1 = 0, tb2 = 0, tc1 = 0, tc2 = 0, te = 0, tf = 0, tf1 = 0, tf2 = 0, tp = 0, vcmax = 0.0, vfmax = 0.0, vfmin = 0.0, vimax = 0.0, vrmax = 0.0, vrmin = 0.0, xc = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.e1 = e1 + self.e2 = e2 + self.fbf = fbf + self.flimf = flimf + self.kc = kc + self.kd = kd + self.ke = ke + self.kefd = kefd + self.kf = kf + self.kh = kh + self.kii = kii + self.kip = kip + self.ks = ks + self.kvi = kvi + self.kvp = kvp + self.kvphz = kvphz + self.nvphz = nvphz + self.se1 = se1 + self.se2 = se2 + self.ta = ta + self.tb1 = tb1 + self.tb2 = tb2 + self.tc1 = tc1 + self.tc2 = tc2 + self.te = te + self.tf = tf + self.tf1 = tf1 + self.tf2 = tf2 + self.tp = tp + self.vcmax = vcmax + self.vfmax = vfmax + self.vfmin = vfmin + self.vimax = vimax + self.vrmax = vrmax + self.vrmin = vrmin + self.xc = xc + + def __str__(self): + str = 'class=ExcREXS\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcREXSFeedbackSignalKind.py b/cimpy/cgmes_v3_0_0/ExcREXSFeedbackSignalKind.py new file mode 100644 index 00000000..c2e64cfb --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcREXSFeedbackSignalKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class ExcREXSFeedbackSignalKind(Base): + ''' + Types of rate feedback signals. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=ExcREXSFeedbackSignalKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcRQB.py b/cimpy/cgmes_v3_0_0/ExcRQB.py new file mode 100644 index 00000000..6efc62c2 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcRQB.py @@ -0,0 +1,67 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcRQB(ExcitationSystemDynamics): + ''' + Excitation system type RQB (four-loop regulator, r?gulateur quatre boucles, developed in France) primarily used in nuclear or thermal generating units. This excitation system shall be always used together with power system stabilizer type PssRQB. + + :ki0: Voltage reference input gain (Ki0). Typical value = 12,7. Default: 0.0 + :ki1: Voltage input gain (Ki1). Typical value = -16,8. Default: 0.0 + :te: Lead lag time constant (TE) (>= 0). Typical value = 0,22. Default: 0 + :tc: Lead lag time constant (TC) (>= 0). Typical value = 0,02. Default: 0 + :klir: OEL input gain (KLIR). Typical value = 12,13. Default: 0.0 + :ucmin: Minimum voltage reference limit (UCMIN) (< ExcRQB.ucmax). Typical value = 0,9. Default: 0.0 + :ucmax: Maximum voltage reference limit (UCMAX) (> ExcRQB.ucmin). Typical value = 1,1. Default: 0.0 + :lus: Setpoint (LUS). Typical value = 0,12. Default: 0.0 + :klus: Limiter gain (KLUS). Typical value = 50. Default: 0.0 + :mesu: Voltage input time constant (MESU) (>= 0). Typical value = 0,02. Default: 0 + :t4m: Input time constant (T4M) (>= 0). Typical value = 5. Default: 0 + :lsat: Integrator limiter (LSAT). Typical value = 5,73. Default: 0.0 + :tf: Exciter time constant (TF) (>= 0). Typical value = 0,01. Default: 0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ki0': [cgmesProfile.DY.value, ], + 'ki1': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'klir': [cgmesProfile.DY.value, ], + 'ucmin': [cgmesProfile.DY.value, ], + 'ucmax': [cgmesProfile.DY.value, ], + 'lus': [cgmesProfile.DY.value, ], + 'klus': [cgmesProfile.DY.value, ], + 'mesu': [cgmesProfile.DY.value, ], + 't4m': [cgmesProfile.DY.value, ], + 'lsat': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ki0 = 0.0, ki1 = 0.0, te = 0, tc = 0, klir = 0.0, ucmin = 0.0, ucmax = 0.0, lus = 0.0, klus = 0.0, mesu = 0, t4m = 0, lsat = 0.0, tf = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ki0 = ki0 + self.ki1 = ki1 + self.te = te + self.tc = tc + self.klir = klir + self.ucmin = ucmin + self.ucmax = ucmax + self.lus = lus + self.klus = klus + self.mesu = mesu + self.t4m = t4m + self.lsat = lsat + self.tf = tf + + def __str__(self): + str = 'class=ExcRQB\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcSCRX.py b/cimpy/cgmes_v3_0_0/ExcSCRX.py new file mode 100644 index 00000000..a641c57a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcSCRX.py @@ -0,0 +1,52 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcSCRX(ExcitationSystemDynamics): + ''' + Simple excitation system with generic characteristics typical of many excitation systems; intended for use where negative field current could be a problem. + + :tatb: Gain reduction ratio of lag-lead element ([Ta / Tb]). The parameter Ta is not defined explicitly. Typical value = 0.1. Default: 0.0 + :tb: Denominator time constant of lag-lead block (Tb) (>= 0). Typical value = 10. Default: 0 + :k: Gain (K) (> 0). Typical value = 200. Default: 0.0 + :te: Time constant of gain block (Te) (> 0). Typical value = 0,02. Default: 0 + :emin: Minimum field voltage output (Emin) (< ExcSCRX.emax). Typical value = 0. Default: 0.0 + :emax: Maximum field voltage output (Emax) (> ExcSCRX.emin). Typical value = 5. Default: 0.0 + :cswitch: Power source switch (Cswitch). true = fixed voltage of 1.0 PU false = generator terminal voltage. Default: False + :rcrfd: Ratio of field discharge resistance to field winding resistance ([rc / rfd]). Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'tatb': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'k': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'emin': [cgmesProfile.DY.value, ], + 'emax': [cgmesProfile.DY.value, ], + 'cswitch': [cgmesProfile.DY.value, ], + 'rcrfd': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, tatb = 0.0, tb = 0, k = 0.0, te = 0, emin = 0.0, emax = 0.0, cswitch = False, rcrfd = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.tatb = tatb + self.tb = tb + self.k = k + self.te = te + self.emin = emin + self.emax = emax + self.cswitch = cswitch + self.rcrfd = rcrfd + + def __str__(self): + str = 'class=ExcSCRX\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcSEXS.py b/cimpy/cgmes_v3_0_0/ExcSEXS.py new file mode 100644 index 00000000..a88cd74a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcSEXS.py @@ -0,0 +1,58 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcSEXS(ExcitationSystemDynamics): + ''' + Simplified excitation system. + + :tatb: Gain reduction ratio of lag-lead element ([Ta / Tb]). Typical value = 0,1. Default: 0.0 + :tb: Denominator time constant of lag-lead block (Tb) (>= 0). Typical value = 10. Default: 0 + :k: Gain (K) (> 0). Typical value = 100. Default: 0.0 + :te: Time constant of gain block (Te) (> 0). Typical value = 0,05. Default: 0 + :emin: Minimum field voltage output (Emin) (< ExcSEXS.emax). Typical value = -5. Default: 0.0 + :emax: Maximum field voltage output (Emax) (> ExcSEXS.emin). Typical value = 5. Default: 0.0 + :kc: PI controller gain (Kc) (> 0 if ExcSEXS.tc > 0). Typical value = 0,08. Default: 0.0 + :tc: PI controller phase lead time constant (Tc) (>= 0). Typical value = 0. Default: 0 + :efdmin: Field voltage clipping minimum limit (Efdmin) (< ExcSEXS.efdmax). Typical value = -5. Default: 0.0 + :efdmax: Field voltage clipping maximum limit (Efdmax) (> ExcSEXS.efdmin). Typical value = 5. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'tatb': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'k': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'emin': [cgmesProfile.DY.value, ], + 'emax': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'efdmin': [cgmesProfile.DY.value, ], + 'efdmax': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, tatb = 0.0, tb = 0, k = 0.0, te = 0, emin = 0.0, emax = 0.0, kc = 0.0, tc = 0, efdmin = 0.0, efdmax = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.tatb = tatb + self.tb = tb + self.k = k + self.te = te + self.emin = emin + self.emax = emax + self.kc = kc + self.tc = tc + self.efdmin = efdmin + self.efdmax = efdmax + + def __str__(self): + str = 'class=ExcSEXS\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcSK.py b/cimpy/cgmes_v3_0_0/ExcSK.py new file mode 100644 index 00000000..f5a39512 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcSK.py @@ -0,0 +1,124 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcSK(ExcitationSystemDynamics): + ''' + Slovakian excitation system. UEL and secondary voltage control are included in this model. When this model is used, there cannot be a separate underexcitation limiter or VAr controller model. + + :efdmax: Field voltage clipping upper level limit (Efdmax) (> ExcSK.efdmin). Default: 0.0 + :efdmin: Field voltage clipping lower level limit (Efdmin) (< ExcSK.efdmax). Default: 0.0 + :emax: Maximum field voltage output (Emax) (> ExcSK.emin). Typical value = 20. Default: 0.0 + :emin: Minimum field voltage output (Emin) (< ExcSK.emax). Typical value = -20. Default: 0.0 + :k: Gain (K). Typical value = 1. Default: 0.0 + :k1: Parameter of underexcitation limit (K1). Typical value = 0,1364. Default: 0.0 + :k2: Parameter of underexcitation limit (K2). Typical value = -0,3861. Default: 0.0 + :kc: PI controller gain (Kc). Typical value = 70. Default: 0.0 + :kce: Rectifier regulation factor (Kce). Typical value = 0. Default: 0.0 + :kd: Exciter internal reactance (Kd). Typical value = 0. Default: 0.0 + :kgob: P controller gain (Kgob). Typical value = 10. Default: 0.0 + :kp: PI controller gain (Kp). Typical value = 1. Default: 0.0 + :kqi: PI controller gain of integral component (Kqi). Typical value = 0. Default: 0.0 + :kqob: Rate of rise of the reactive power (Kqob). Default: 0.0 + :kqp: PI controller gain (Kqp). Typical value = 0. Default: 0.0 + :nq: Deadband of reactive power (nq). Determines the range of sensitivity. Typical value = 0,001. Default: 0.0 + :qconoff: Secondary voltage control state (Qc_on_off). true = secondary voltage control is on false = secondary voltage control is off. Typical value = false. Default: False + :qz: Desired value (setpoint) of reactive power, manual setting (Qz). Default: 0.0 + :remote: Selector to apply automatic calculation in secondary controller model (remote). true = automatic calculation is activated false = manual set is active; the use of desired value of reactive power (Qz) is required. Typical value = true. Default: False + :sbase: Apparent power of the unit (Sbase) (> 0). Unit = MVA. Typical value = 259. Default: 0.0 + :tc: PI controller phase lead time constant (Tc) (>= 0). Typical value = 8. Default: 0 + :te: Time constant of gain block (Te) (>= 0). Typical value = 0,1. Default: 0 + :ti: PI controller phase lead time constant (Ti) (>= 0). Typical value = 2. Default: 0 + :tp: Time constant (Tp) (>= 0). Typical value = 0,1. Default: 0 + :tr: Voltage transducer time constant (Tr) (>= 0). Typical value = 0,01. Default: 0 + :uimax: Maximum error (UImax) (> ExcSK.uimin). Typical value = 10. Default: 0.0 + :uimin: Minimum error (UImin) (< ExcSK.uimax). Typical value = -10. Default: 0.0 + :urmax: Maximum controller output (URmax) (> ExcSK.urmin). Typical value = 10. Default: 0.0 + :urmin: Minimum controller output (URmin) (< ExcSK.urmax). Typical value = -10. Default: 0.0 + :vtmax: Maximum terminal voltage input (Vtmax) (> ExcSK.vtmin). Determines the range of voltage deadband. Typical value = 1,05. Default: 0.0 + :vtmin: Minimum terminal voltage input (Vtmin) (< ExcSK.vtmax). Determines the range of voltage deadband. Typical value = 0,95. Default: 0.0 + :yp: Maximum output (Yp). Typical value = 1. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'efdmax': [cgmesProfile.DY.value, ], + 'efdmin': [cgmesProfile.DY.value, ], + 'emax': [cgmesProfile.DY.value, ], + 'emin': [cgmesProfile.DY.value, ], + 'k': [cgmesProfile.DY.value, ], + 'k1': [cgmesProfile.DY.value, ], + 'k2': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kce': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'kgob': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'kqi': [cgmesProfile.DY.value, ], + 'kqob': [cgmesProfile.DY.value, ], + 'kqp': [cgmesProfile.DY.value, ], + 'nq': [cgmesProfile.DY.value, ], + 'qconoff': [cgmesProfile.DY.value, ], + 'qz': [cgmesProfile.DY.value, ], + 'remote': [cgmesProfile.DY.value, ], + 'sbase': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'ti': [cgmesProfile.DY.value, ], + 'tp': [cgmesProfile.DY.value, ], + 'tr': [cgmesProfile.DY.value, ], + 'uimax': [cgmesProfile.DY.value, ], + 'uimin': [cgmesProfile.DY.value, ], + 'urmax': [cgmesProfile.DY.value, ], + 'urmin': [cgmesProfile.DY.value, ], + 'vtmax': [cgmesProfile.DY.value, ], + 'vtmin': [cgmesProfile.DY.value, ], + 'yp': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, efdmax = 0.0, efdmin = 0.0, emax = 0.0, emin = 0.0, k = 0.0, k1 = 0.0, k2 = 0.0, kc = 0.0, kce = 0.0, kd = 0.0, kgob = 0.0, kp = 0.0, kqi = 0.0, kqob = 0.0, kqp = 0.0, nq = 0.0, qconoff = False, qz = 0.0, remote = False, sbase = 0.0, tc = 0, te = 0, ti = 0, tp = 0, tr = 0, uimax = 0.0, uimin = 0.0, urmax = 0.0, urmin = 0.0, vtmax = 0.0, vtmin = 0.0, yp = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.efdmax = efdmax + self.efdmin = efdmin + self.emax = emax + self.emin = emin + self.k = k + self.k1 = k1 + self.k2 = k2 + self.kc = kc + self.kce = kce + self.kd = kd + self.kgob = kgob + self.kp = kp + self.kqi = kqi + self.kqob = kqob + self.kqp = kqp + self.nq = nq + self.qconoff = qconoff + self.qz = qz + self.remote = remote + self.sbase = sbase + self.tc = tc + self.te = te + self.ti = ti + self.tp = tp + self.tr = tr + self.uimax = uimax + self.uimin = uimin + self.urmax = urmax + self.urmin = urmin + self.vtmax = vtmax + self.vtmin = vtmin + self.yp = yp + + def __str__(self): + str = 'class=ExcSK\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcST1A.py b/cimpy/cgmes_v3_0_0/ExcST1A.py new file mode 100644 index 00000000..bc3d0e98 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcST1A.py @@ -0,0 +1,82 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcST1A(ExcitationSystemDynamics): + ''' + Modification of an old IEEE ST1A static excitation system without overexcitation limiter (OEL) and underexcitation limiter (UEL). + + :vimax: Maximum voltage regulator input limit (Vimax) (> 0). Typical value = 999. Default: 0.0 + :vimin: Minimum voltage regulator input limit (Vimin) (< 0). Typical value = -999. Default: 0.0 + :tc: Voltage regulator time constant (Tc) (>= 0). Typical value = 1. Default: 0 + :tb: Voltage regulator time constant (Tb) (>= 0). Typical value = 10. Default: 0 + :ka: Voltage regulator gain (Ka) (> 0). Typical value = 190. Default: 0.0 + :ta: Voltage regulator time constant (Ta) (>= 0). Typical value = 0,02. Default: 0 + :vrmax: Maximum voltage regulator outputs (Vrmax) (> 0) . Typical value = 7,8. Default: 0.0 + :vrmin: Minimum voltage regulator outputs (Vrmin) (< 0). Typical value = -6,7. Default: 0.0 + :kc: Rectifier loading factor proportional to commutating reactance (Kc) (>= 0). Typical value = 0,05. Default: 0.0 + :kf: Excitation control system stabilizer gains (Kf) (>= 0). Typical value = 0. Default: 0.0 + :tf: Excitation control system stabilizer time constant (Tf) (>= 0). Typical value = 1. Default: 0 + :tc1: Voltage regulator time constant (Tc1) (>= 0). Typical value = 0. Default: 0 + :tb1: Voltage regulator time constant (Tb1) (>= 0). Typical value = 0. Default: 0 + :vamax: Maximum voltage regulator output (Vamax) (> 0). Typical value = 999. Default: 0.0 + :vamin: Minimum voltage regulator output (Vamin) (< 0). Typical value = -999. Default: 0.0 + :ilr: Exciter output current limit reference (Ilr). Typical value = 0. Default: 0.0 + :klr: Exciter output current limiter gain (Klr). Typical value = 0. Default: 0.0 + :xe: Excitation xfmr effective reactance (Xe). Typical value = 0,04. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'vimax': [cgmesProfile.DY.value, ], + 'vimin': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'tc1': [cgmesProfile.DY.value, ], + 'tb1': [cgmesProfile.DY.value, ], + 'vamax': [cgmesProfile.DY.value, ], + 'vamin': [cgmesProfile.DY.value, ], + 'ilr': [cgmesProfile.DY.value, ], + 'klr': [cgmesProfile.DY.value, ], + 'xe': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, vimax = 0.0, vimin = 0.0, tc = 0, tb = 0, ka = 0.0, ta = 0, vrmax = 0.0, vrmin = 0.0, kc = 0.0, kf = 0.0, tf = 0, tc1 = 0, tb1 = 0, vamax = 0.0, vamin = 0.0, ilr = 0.0, klr = 0.0, xe = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.vimax = vimax + self.vimin = vimin + self.tc = tc + self.tb = tb + self.ka = ka + self.ta = ta + self.vrmax = vrmax + self.vrmin = vrmin + self.kc = kc + self.kf = kf + self.tf = tf + self.tc1 = tc1 + self.tb1 = tb1 + self.vamax = vamax + self.vamin = vamin + self.ilr = ilr + self.klr = klr + self.xe = xe + + def __str__(self): + str = 'class=ExcST1A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcST2A.py b/cimpy/cgmes_v3_0_0/ExcST2A.py new file mode 100644 index 00000000..de8f74a7 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcST2A.py @@ -0,0 +1,73 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcST2A(ExcitationSystemDynamics): + ''' + Modified IEEE ST2A static excitation system with another lead-lag block added to match the model defined by WECC. + + :ka: Voltage regulator gain (Ka) (> 0). Typical value = 120. Default: 0.0 + :ta: Voltage regulator time constant (Ta) (> 0). Typical value = 0,15. Default: 0 + :vrmax: Maximum voltage regulator outputs (Vrmax) (> 0). Typical value = 1. Default: 0.0 + :vrmin: Minimum voltage regulator outputs (Vrmin) (< 0). Typical value = -1. Default: 0.0 + :ke: Exciter constant related to self-excited field (Ke). Typical value = 1. Default: 0.0 + :te: Exciter time constant, integration rate associated with exciter control (Te) (> 0). Typical value = 0,5. Default: 0 + :kf: Excitation control system stabilizer gains (kf) (>= 0). Typical value = 0,05. Default: 0.0 + :tf: Excitation control system stabilizer time constant (Tf) (>= 0). Typical value = 0,7. Default: 0 + :kp: Potential circuit gain coefficient (Kp) (>= 0). Typical value = 4,88. Default: 0.0 + :ki: Potential circuit gain coefficient (Ki) (>= 0). Typical value = 8. Default: 0.0 + :kc: Rectifier loading factor proportional to commutating reactance (Kc) (>= 0). Typical value = 1,82. Default: 0.0 + :efdmax: Maximum field voltage (Efdmax) (>= 0). Typical value = 99. Default: 0.0 + :uelin: UEL input (UELin). true = HV gate false = add to error signal. Typical value = false. Default: False + :tb: Voltage regulator time constant (Tb) (>= 0). Typical value = 0. Default: 0 + :tc: Voltage regulator time constant (Tc) (>= 0). Typical value = 0. Default: 0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'efdmax': [cgmesProfile.DY.value, ], + 'uelin': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ka = 0.0, ta = 0, vrmax = 0.0, vrmin = 0.0, ke = 0.0, te = 0, kf = 0.0, tf = 0, kp = 0.0, ki = 0.0, kc = 0.0, efdmax = 0.0, uelin = False, tb = 0, tc = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.ta = ta + self.vrmax = vrmax + self.vrmin = vrmin + self.ke = ke + self.te = te + self.kf = kf + self.tf = tf + self.kp = kp + self.ki = ki + self.kc = kc + self.efdmax = efdmax + self.uelin = uelin + self.tb = tb + self.tc = tc + + def __str__(self): + str = 'class=ExcST2A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcST3A.py b/cimpy/cgmes_v3_0_0/ExcST3A.py new file mode 100644 index 00000000..8303dae2 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcST3A.py @@ -0,0 +1,88 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcST3A(ExcitationSystemDynamics): + ''' + Modified IEEE ST3A static excitation system with added speed multiplier. + + :vimax: Maximum voltage regulator input limit (Vimax) (> 0). Typical value = 0,2. Default: 0.0 + :vimin: Minimum voltage regulator input limit (Vimin) (< 0). Typical value = -0,2. Default: 0.0 + :kj: AVR gain (Kj) (> 0). Typical value = 200. Default: 0.0 + :tb: Voltage regulator time constant (Tb) (>= 0). Typical value = 6,67. Default: 0 + :tc: Voltage regulator time constant (Tc) (>= 0). Typical value = 1. Default: 0 + :efdmax: Maximum AVR output (Efdmax) (>= 0). Typical value = 6,9. Default: 0.0 + :km: Forward gain constant of the inner loop field regulator (Km) (> 0). Typical value = 7,04. Default: 0.0 + :tm: Forward time constant of inner loop field regulator (Tm) (> 0). Typical value = 1. Default: 0 + :vrmax: Maximum voltage regulator output (Vrmax) (> 0). Typical value = 1. Default: 0.0 + :vrmin: Minimum voltage regulator output (Vrmin) (< 0). Typical value = -1. Default: 0.0 + :kg: Feedback gain constant of the inner loop field regulator (Kg) (>= 0). Typical value = 1. Default: 0.0 + :kp: Potential source gain (Kp) (> 0). Typical value = 4,37. Default: 0.0 + :thetap: Potential circuit phase angle (thetap). Typical value = 20. Default: 0.0 + :ki: Potential circuit gain coefficient (Ki) (>= 0). Typical value = 4,83. Default: 0.0 + :kc: Rectifier loading factor proportional to commutating reactance (Kc) (>= 0). Typical value = 1,1. Default: 0.0 + :xl: Reactance associated with potential source (Xl) (>= 0). Typical value = 0,09. Default: 0.0 + :vbmax: Maximum excitation voltage (Vbmax) (> 0). Typical value = 8,63. Default: 0.0 + :vgmax: Maximum inner loop feedback voltage (Vgmax) (>= 0). Typical value = 6,53. Default: 0.0 + :ks: Coefficient to allow different usage of the model-speed coefficient (Ks). Typical value = 0. Default: 0.0 + :ks1: Coefficient to allow different usage of the model-speed coefficient (Ks1). Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'vimax': [cgmesProfile.DY.value, ], + 'vimin': [cgmesProfile.DY.value, ], + 'kj': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'efdmax': [cgmesProfile.DY.value, ], + 'km': [cgmesProfile.DY.value, ], + 'tm': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'kg': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'thetap': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'xl': [cgmesProfile.DY.value, ], + 'vbmax': [cgmesProfile.DY.value, ], + 'vgmax': [cgmesProfile.DY.value, ], + 'ks': [cgmesProfile.DY.value, ], + 'ks1': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, vimax = 0.0, vimin = 0.0, kj = 0.0, tb = 0, tc = 0, efdmax = 0.0, km = 0.0, tm = 0, vrmax = 0.0, vrmin = 0.0, kg = 0.0, kp = 0.0, thetap = 0.0, ki = 0.0, kc = 0.0, xl = 0.0, vbmax = 0.0, vgmax = 0.0, ks = 0.0, ks1 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.vimax = vimax + self.vimin = vimin + self.kj = kj + self.tb = tb + self.tc = tc + self.efdmax = efdmax + self.km = km + self.tm = tm + self.vrmax = vrmax + self.vrmin = vrmin + self.kg = kg + self.kp = kp + self.thetap = thetap + self.ki = ki + self.kc = kc + self.xl = xl + self.vbmax = vbmax + self.vgmax = vgmax + self.ks = ks + self.ks1 = ks1 + + def __str__(self): + str = 'class=ExcST3A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcST4B.py b/cimpy/cgmes_v3_0_0/ExcST4B.py new file mode 100644 index 00000000..a400ab32 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcST4B.py @@ -0,0 +1,85 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcST4B(ExcitationSystemDynamics): + ''' + Modified IEEE ST4B static excitation system with maximum inner loop feedback gain Vgmax. + + :kpr: Voltage regulator proportional gain (Kpr). Typical value = 10,75. Default: 0.0 + :kir: Voltage regulator integral gain (Kir). Typical value = 10,75. Default: 0.0 + :ta: Voltage regulator time constant (Ta) (>= 0). Typical value = 0,02. Default: 0 + :vrmax: Maximum voltage regulator output (Vrmax) (> 0). Typical value = 1. Default: 0.0 + :vrmin: Minimum voltage regulator output (Vrmin) (< 0). Typical value = -0,87. Default: 0.0 + :kpm: Voltage regulator proportional gain output (Kpm). Typical value = 1. Default: 0.0 + :kim: Voltage regulator integral gain output (Kim). Typical value = 0. Default: 0.0 + :vmmax: Maximum inner loop output (Vmmax) (> ExcST4B.vmmin). Typical value = 99. Default: 0.0 + :vmmin: Minimum inner loop output (Vmmin) (< ExcST4B.vmmax). Typical value = -99. Default: 0.0 + :kg: Feedback gain constant of the inner loop field regulator (Kg) (>= 0). Typical value = 0. Default: 0.0 + :kp: Potential circuit gain coefficient (Kp) (> 0). Typical value = 9,3. Default: 0.0 + :thetap: Potential circuit phase angle (thetap). Typical value = 0. Default: 0.0 + :ki: Potential circuit gain coefficient (Ki) (>= 0). Typical value = 0. Default: 0.0 + :kc: Rectifier loading factor proportional to commutating reactance (Kc) (>= 0). Typical value = 0,113. Default: 0.0 + :xl: Reactance associated with potential source (Xl) (>= 0). Typical value = 0,124. Default: 0.0 + :vbmax: Maximum excitation voltage (Vbmax) (> 0). Typical value = 11,63. Default: 0.0 + :vgmax: Maximum inner loop feedback voltage (Vgmax) (>= 0). Typical value = 5,8. Default: 0.0 + :uel: Selector (UEL). true = UEL is part of block diagram false = UEL is not part of block diagram. Typical value = false. Default: False + :lvgate: Selector (LVGate). true = LVGate is part of the block diagram false = LVGate is not part of the block diagram. Typical value = false. Default: False + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'kpr': [cgmesProfile.DY.value, ], + 'kir': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'kpm': [cgmesProfile.DY.value, ], + 'kim': [cgmesProfile.DY.value, ], + 'vmmax': [cgmesProfile.DY.value, ], + 'vmmin': [cgmesProfile.DY.value, ], + 'kg': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'thetap': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'xl': [cgmesProfile.DY.value, ], + 'vbmax': [cgmesProfile.DY.value, ], + 'vgmax': [cgmesProfile.DY.value, ], + 'uel': [cgmesProfile.DY.value, ], + 'lvgate': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, kpr = 0.0, kir = 0.0, ta = 0, vrmax = 0.0, vrmin = 0.0, kpm = 0.0, kim = 0.0, vmmax = 0.0, vmmin = 0.0, kg = 0.0, kp = 0.0, thetap = 0.0, ki = 0.0, kc = 0.0, xl = 0.0, vbmax = 0.0, vgmax = 0.0, uel = False, lvgate = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.kpr = kpr + self.kir = kir + self.ta = ta + self.vrmax = vrmax + self.vrmin = vrmin + self.kpm = kpm + self.kim = kim + self.vmmax = vmmax + self.vmmin = vmmin + self.kg = kg + self.kp = kp + self.thetap = thetap + self.ki = ki + self.kc = kc + self.xl = xl + self.vbmax = vbmax + self.vgmax = vgmax + self.uel = uel + self.lvgate = lvgate + + def __str__(self): + str = 'class=ExcST4B\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcST6B.py b/cimpy/cgmes_v3_0_0/ExcST6B.py new file mode 100644 index 00000000..b903ec90 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcST6B.py @@ -0,0 +1,97 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcST6B(ExcitationSystemDynamics): + ''' + Modified IEEE ST6B static excitation system with PID controller and optional inner feedback loop. + + :ilr: Exciter output current limit reference (Ilr) (> 0). Typical value = 4,164. Default: 0.0 + :k1: Selector (K1). true = feedback is from Ifd false = feedback is not from Ifd. Typical value = true. Default: False + :kcl: Exciter output current limit adjustment (Kcl) (> 0). Typical value = 1,0577. Default: 0.0 + :kff: Pre-control gain constant of the inner loop field regulator (Kff). Typical value = 1. Default: 0.0 + :kg: Feedback gain constant of the inner loop field regulator (Kg) (>= 0). Typical value = 1. Default: 0.0 + :kia: Voltage regulator integral gain (Kia) (> 0). Typical value = 45,094. Default: 0.0 + :klr: Exciter output current limit adjustment (Kcl) (> 0). Typical value = 17,33. Default: 0.0 + :km: Forward gain constant of the inner loop field regulator (Km). Typical value = 1. Default: 0.0 + :kpa: Voltage regulator proportional gain (Kpa) (> 0). Typical value = 18,038. Default: 0.0 + :kvd: Voltage regulator derivative gain (Kvd). Typical value = 0. Default: 0.0 + :oelin: OEL input selector (OELin). Typical value = noOELinput (corresponds to OELin = 0 on diagram). Default: None + :tg: Feedback time constant of inner loop field voltage regulator (Tg) (>= 0). Typical value = 0,02. Default: 0 + :ts: Rectifier firing time constant (Ts) (>= 0). Typical value = 0. Default: 0 + :tvd: Voltage regulator derivative gain (Tvd) (>= 0). Typical value = 0. Default: 0 + :vamax: Maximum voltage regulator output (Vamax) (> 0). Typical value = 4,81. Default: 0.0 + :vamin: Minimum voltage regulator output (Vamin) (< 0). Typical value = -3,85. Default: 0.0 + :vilim: Selector (Vilim). true = Vimin-Vimax limiter is active false = Vimin-Vimax limiter is not active. Typical value = true. Default: False + :vimax: Maximum voltage regulator input limit (Vimax) (> ExcST6B.vimin). Typical value = 10. Default: 0.0 + :vimin: Minimum voltage regulator input limit (Vimin) (< ExcST6B.vimax). Typical value = -10. Default: 0.0 + :vmult: Selector (vmult). true = multiply regulator output by terminal voltage false = do not multiply regulator output by terminal voltage. Typical value = true. Default: False + :vrmax: Maximum voltage regulator output (Vrmax) (> 0). Typical value = 4,81. Default: 0.0 + :vrmin: Minimum voltage regulator output (Vrmin) (< 0). Typical value = -3,85. Default: 0.0 + :xc: Excitation source reactance (Xc). Typical value = 0,05. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ilr': [cgmesProfile.DY.value, ], + 'k1': [cgmesProfile.DY.value, ], + 'kcl': [cgmesProfile.DY.value, ], + 'kff': [cgmesProfile.DY.value, ], + 'kg': [cgmesProfile.DY.value, ], + 'kia': [cgmesProfile.DY.value, ], + 'klr': [cgmesProfile.DY.value, ], + 'km': [cgmesProfile.DY.value, ], + 'kpa': [cgmesProfile.DY.value, ], + 'kvd': [cgmesProfile.DY.value, ], + 'oelin': [cgmesProfile.DY.value, ], + 'tg': [cgmesProfile.DY.value, ], + 'ts': [cgmesProfile.DY.value, ], + 'tvd': [cgmesProfile.DY.value, ], + 'vamax': [cgmesProfile.DY.value, ], + 'vamin': [cgmesProfile.DY.value, ], + 'vilim': [cgmesProfile.DY.value, ], + 'vimax': [cgmesProfile.DY.value, ], + 'vimin': [cgmesProfile.DY.value, ], + 'vmult': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'xc': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, ilr = 0.0, k1 = False, kcl = 0.0, kff = 0.0, kg = 0.0, kia = 0.0, klr = 0.0, km = 0.0, kpa = 0.0, kvd = 0.0, oelin = None, tg = 0, ts = 0, tvd = 0, vamax = 0.0, vamin = 0.0, vilim = False, vimax = 0.0, vimin = 0.0, vmult = False, vrmax = 0.0, vrmin = 0.0, xc = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ilr = ilr + self.k1 = k1 + self.kcl = kcl + self.kff = kff + self.kg = kg + self.kia = kia + self.klr = klr + self.km = km + self.kpa = kpa + self.kvd = kvd + self.oelin = oelin + self.tg = tg + self.ts = ts + self.tvd = tvd + self.vamax = vamax + self.vamin = vamin + self.vilim = vilim + self.vimax = vimax + self.vimin = vimin + self.vmult = vmult + self.vrmax = vrmax + self.vrmin = vrmin + self.xc = xc + + def __str__(self): + str = 'class=ExcST6B\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcST6BOELselectorKind.py b/cimpy/cgmes_v3_0_0/ExcST6BOELselectorKind.py new file mode 100644 index 00000000..67d4c0de --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcST6BOELselectorKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class ExcST6BOELselectorKind(Base): + ''' + Types of connections for the OEL input used for static excitation systems type 6B. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=ExcST6BOELselectorKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcST7B.py b/cimpy/cgmes_v3_0_0/ExcST7B.py new file mode 100644 index 00000000..20dd4bbd --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcST7B.py @@ -0,0 +1,76 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcST7B(ExcitationSystemDynamics): + ''' + Modified IEEE ST7B static excitation system without stator current limiter (SCL) and current compensator (DROOP) inputs. + + :kh: High-value gate feedback gain (Kh) (>= 0). Typical value = 1. Default: 0.0 + :kia: Voltage regulator integral gain (Kia) (>= 0). Typical value = 1. Default: 0.0 + :kl: Low-value gate feedback gain (Kl) (>= 0). Typical value = 1. Default: 0.0 + :kpa: Voltage regulator proportional gain (Kpa) (> 0). Typical value = 40. Default: 0.0 + :oelin: OEL input selector (OELin). Typical value = noOELinput. Default: None + :tb: Regulator lag time constant (Tb) (>= 0). Typical value = 1. Default: 0 + :tc: Regulator lead time constant (Tc) (>= 0). Typical value = 1. Default: 0 + :tf: Excitation control system stabilizer time constant (Tf) (>= 0). Typical value = 1. Default: 0 + :tg: Feedback time constant of inner loop field voltage regulator (Tg) (>= 0). Typical value = 1. Default: 0 + :tia: Feedback time constant (Tia) (>= 0). Typical value = 3. Default: 0 + :ts: Rectifier firing time constant (Ts) (>= 0). Typical value = 0. Default: 0 + :uelin: UEL input selector (UELin). Typical value = noUELinput. Default: None + :vmax: Maximum voltage reference signal (Vmax) (> 0 and > ExcST7B.vmin)). Typical value = 1,1. Default: 0.0 + :vmin: Minimum voltage reference signal (Vmin) (> 0 and < ExcST7B.vmax). Typical value = 0,9. Default: 0.0 + :vrmax: Maximum voltage regulator output (Vrmax) (> 0). Typical value = 5. Default: 0.0 + :vrmin: Minimum voltage regulator output (Vrmin) (< 0). Typical value = -4,5. Default: 0.0 + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'kh': [cgmesProfile.DY.value, ], + 'kia': [cgmesProfile.DY.value, ], + 'kl': [cgmesProfile.DY.value, ], + 'kpa': [cgmesProfile.DY.value, ], + 'oelin': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'tg': [cgmesProfile.DY.value, ], + 'tia': [cgmesProfile.DY.value, ], + 'ts': [cgmesProfile.DY.value, ], + 'uelin': [cgmesProfile.DY.value, ], + 'vmax': [cgmesProfile.DY.value, ], + 'vmin': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, kh = 0.0, kia = 0.0, kl = 0.0, kpa = 0.0, oelin = None, tb = 0, tc = 0, tf = 0, tg = 0, tia = 0, ts = 0, uelin = None, vmax = 0.0, vmin = 0.0, vrmax = 0.0, vrmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.kh = kh + self.kia = kia + self.kl = kl + self.kpa = kpa + self.oelin = oelin + self.tb = tb + self.tc = tc + self.tf = tf + self.tg = tg + self.tia = tia + self.ts = ts + self.uelin = uelin + self.vmax = vmax + self.vmin = vmin + self.vrmax = vrmax + self.vrmin = vrmin + + def __str__(self): + str = 'class=ExcST7B\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcST7BOELselectorKind.py b/cimpy/cgmes_v3_0_0/ExcST7BOELselectorKind.py new file mode 100644 index 00000000..dcd7e3b9 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcST7BOELselectorKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class ExcST7BOELselectorKind(Base): + ''' + Types of connections for the OEL input used for static excitation systems type 7B. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=ExcST7BOELselectorKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcST7BUELselectorKind.py b/cimpy/cgmes_v3_0_0/ExcST7BUELselectorKind.py new file mode 100644 index 00000000..a662a968 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcST7BUELselectorKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class ExcST7BUELselectorKind(Base): + ''' + Types of connections for the UEL input used for static excitation systems type 7B. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=ExcST7BUELselectorKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcitationSystemDynamics.py b/cimpy/cgmes_v3_0_0/ExcitationSystemDynamics.py new file mode 100644 index 00000000..65900a8b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcitationSystemDynamics.py @@ -0,0 +1,52 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class ExcitationSystemDynamics(DynamicsFunctionBlock): + ''' + Excitation system function block whose behaviour is described by reference to a standard model or by definition of a user-defined model. + + :SynchronousMachineDynamics: Synchronous machine model with which this excitation system model is associated. Default: None + :VoltageCompensatorDynamics: Voltage compensator model associated with this excitation system model. Default: None + :OverexcitationLimiterDynamics: Overexcitation limiter model associated with this excitation system model. Default: None + :PFVArControllerType2Dynamics: Power factor or VAr controller type 2 model associated with this excitation system model. Default: None + :DiscontinuousExcitationControlDynamics: Discontinuous excitation control model associated with this excitation system model. Default: None + :PowerSystemStabilizerDynamics: Power system stabilizer model associated with this excitation system model. Default: None + :UnderexcitationLimiterDynamics: Undrexcitation limiter model associated with this excitation system model. Default: None + :PFVArControllerType1Dynamics: Power factor or VAr controller type 1 model associated with this excitation system model. Default: None + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'SynchronousMachineDynamics': [cgmesProfile.DY.value, ], + 'VoltageCompensatorDynamics': [cgmesProfile.DY.value, ], + 'OverexcitationLimiterDynamics': [cgmesProfile.DY.value, ], + 'PFVArControllerType2Dynamics': [cgmesProfile.DY.value, ], + 'DiscontinuousExcitationControlDynamics': [cgmesProfile.DY.value, ], + 'PowerSystemStabilizerDynamics': [cgmesProfile.DY.value, ], + 'UnderexcitationLimiterDynamics': [cgmesProfile.DY.value, ], + 'PFVArControllerType1Dynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, SynchronousMachineDynamics = None, VoltageCompensatorDynamics = None, OverexcitationLimiterDynamics = None, PFVArControllerType2Dynamics = None, DiscontinuousExcitationControlDynamics = None, PowerSystemStabilizerDynamics = None, UnderexcitationLimiterDynamics = None, PFVArControllerType1Dynamics = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.SynchronousMachineDynamics = SynchronousMachineDynamics + self.VoltageCompensatorDynamics = VoltageCompensatorDynamics + self.OverexcitationLimiterDynamics = OverexcitationLimiterDynamics + self.PFVArControllerType2Dynamics = PFVArControllerType2Dynamics + self.DiscontinuousExcitationControlDynamics = DiscontinuousExcitationControlDynamics + self.PowerSystemStabilizerDynamics = PowerSystemStabilizerDynamics + self.UnderexcitationLimiterDynamics = UnderexcitationLimiterDynamics + self.PFVArControllerType1Dynamics = PFVArControllerType1Dynamics + + def __str__(self): + str = 'class=ExcitationSystemDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExcitationSystemUserDefined.py b/cimpy/cgmes_v3_0_0/ExcitationSystemUserDefined.py new file mode 100644 index 00000000..4334772a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExcitationSystemUserDefined.py @@ -0,0 +1,34 @@ +from .ExcitationSystemDynamics import ExcitationSystemDynamics + + +class ExcitationSystemUserDefined(ExcitationSystemDynamics): + ''' + Excitation system function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = ExcitationSystemDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ExcitationSystemDynamics: \n' + ExcitationSystemDynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=ExcitationSystemUserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ExternalNetworkInjection.py b/cimpy/cgmes_v3_0_0/ExternalNetworkInjection.py new file mode 100644 index 00000000..a13e1617 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ExternalNetworkInjection.py @@ -0,0 +1,82 @@ +from .RegulatingCondEq import RegulatingCondEq + + +class ExternalNetworkInjection(RegulatingCondEq): + ''' + This class represents the external network and it is used for IEC 60909 calculations. + + :referencePriority: Priority of unit for use as powerflow voltage phase angle reference bus selection. 0 = don t care (default) 1 = highest priority. 2 is less than 1 and so on. Default: 0 + :p: Active power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions. Default: 0.0 + :q: Reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for steady state solutions. Default: 0.0 + :governorSCD: Power Frequency Bias. This is the change in power injection divided by the change in frequency and negated. A positive value of the power frequency bias provides additional power injection upon a drop in frequency. Default: 0.0 + :maxP: Maximum active power of the injection. Default: 0.0 + :maxQ: Maximum reactive power limit. It is used for modelling of infeed for load flow exchange and not for short circuit modelling. Default: 0.0 + :minP: Minimum active power of the injection. Default: 0.0 + :minQ: Minimum reactive power limit. It is used for modelling of infeed for load flow exchange and not for short circuit modelling. Default: 0.0 + :ikSecond: Indicates whether initial symmetrical short-circuit current and power have been calculated according to IEC (Ik`). Used only if short circuit calculations are done according to superposition method. Default: False + :maxInitialSymShCCurrent: Maximum initial symmetrical short-circuit currents (Ik` max) in A (Ik` = Sk`/(SQRT(3) Un)). Used for short circuit data exchange according to IEC 60909. Default: 0.0 + :maxR0ToX0Ratio: Maximum ratio of zero sequence resistance of Network Feeder to its zero sequence reactance (R(0)/X(0) max). Used for short circuit data exchange according to IEC 60909. Default: 0.0 + :maxR1ToX1Ratio: Maximum ratio of positive sequence resistance of Network Feeder to its positive sequence reactance (R(1)/X(1) max). Used for short circuit data exchange according to IEC 60909. Default: 0.0 + :maxZ0ToZ1Ratio: Maximum ratio of zero sequence impedance to its positive sequence impedance (Z(0)/Z(1) max). Used for short circuit data exchange according to IEC 60909. Default: 0.0 + :minInitialSymShCCurrent: Minimum initial symmetrical short-circuit currents (Ik` min) in A (Ik` = Sk`/(SQRT(3) Un)). Used for short circuit data exchange according to IEC 60909. Default: 0.0 + :minR0ToX0Ratio: Indicates whether initial symmetrical short-circuit current and power have been calculated according to IEC (Ik`). Used for short circuit data exchange according to IEC 6090. Default: 0.0 + :minR1ToX1Ratio: Minimum ratio of positive sequence resistance of Network Feeder to its positive sequence reactance (R(1)/X(1) min). Used for short circuit data exchange according to IEC 60909. Default: 0.0 + :minZ0ToZ1Ratio: Minimum ratio of zero sequence impedance to its positive sequence impedance (Z(0)/Z(1) min). Used for short circuit data exchange according to IEC 60909. Default: 0.0 + :voltageFactor: Voltage factor in pu, which was used to calculate short-circuit current Ik` and power Sk`. Used only if short circuit calculations are done according to superposition method. Default: 0.0 + ''' + + cgmesProfile = RegulatingCondEq.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'referencePriority': [cgmesProfile.SSH.value, ], + 'p': [cgmesProfile.SSH.value, ], + 'q': [cgmesProfile.SSH.value, ], + 'governorSCD': [cgmesProfile.EQ.value, ], + 'maxP': [cgmesProfile.EQ.value, ], + 'maxQ': [cgmesProfile.EQ.value, ], + 'minP': [cgmesProfile.EQ.value, ], + 'minQ': [cgmesProfile.EQ.value, ], + 'ikSecond': [cgmesProfile.SC.value, ], + 'maxInitialSymShCCurrent': [cgmesProfile.SC.value, ], + 'maxR0ToX0Ratio': [cgmesProfile.SC.value, ], + 'maxR1ToX1Ratio': [cgmesProfile.SC.value, ], + 'maxZ0ToZ1Ratio': [cgmesProfile.SC.value, ], + 'minInitialSymShCCurrent': [cgmesProfile.SC.value, ], + 'minR0ToX0Ratio': [cgmesProfile.SC.value, ], + 'minR1ToX1Ratio': [cgmesProfile.SC.value, ], + 'minZ0ToZ1Ratio': [cgmesProfile.SC.value, ], + 'voltageFactor': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class RegulatingCondEq: \n' + RegulatingCondEq.__doc__ + + def __init__(self, referencePriority = 0, p = 0.0, q = 0.0, governorSCD = 0.0, maxP = 0.0, maxQ = 0.0, minP = 0.0, minQ = 0.0, ikSecond = False, maxInitialSymShCCurrent = 0.0, maxR0ToX0Ratio = 0.0, maxR1ToX1Ratio = 0.0, maxZ0ToZ1Ratio = 0.0, minInitialSymShCCurrent = 0.0, minR0ToX0Ratio = 0.0, minR1ToX1Ratio = 0.0, minZ0ToZ1Ratio = 0.0, voltageFactor = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.referencePriority = referencePriority + self.p = p + self.q = q + self.governorSCD = governorSCD + self.maxP = maxP + self.maxQ = maxQ + self.minP = minP + self.minQ = minQ + self.ikSecond = ikSecond + self.maxInitialSymShCCurrent = maxInitialSymShCCurrent + self.maxR0ToX0Ratio = maxR0ToX0Ratio + self.maxR1ToX1Ratio = maxR1ToX1Ratio + self.maxZ0ToZ1Ratio = maxZ0ToZ1Ratio + self.minInitialSymShCCurrent = minInitialSymShCCurrent + self.minR0ToX0Ratio = minR0ToX0Ratio + self.minR1ToX1Ratio = minR1ToX1Ratio + self.minZ0ToZ1Ratio = minZ0ToZ1Ratio + self.voltageFactor = voltageFactor + + def __str__(self): + str = 'class=ExternalNetworkInjection\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/FaultIndicator.py b/cimpy/cgmes_v3_0_0/FaultIndicator.py new file mode 100644 index 00000000..33617fa7 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/FaultIndicator.py @@ -0,0 +1,29 @@ +from .AuxiliaryEquipment import AuxiliaryEquipment + + +class FaultIndicator(AuxiliaryEquipment): + ''' + A FaultIndicator is typically only an indicator (which may or may not be remotely monitored), and not a piece of equipment that actually initiates a protection event. It is used for FLISR (Fault Location, Isolation and Restoration) purposes, assisting with the dispatch of crews to "most likely" part of the network (i.e. assists with determining circuit section where the fault most likely happened). + + ''' + + cgmesProfile = AuxiliaryEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class AuxiliaryEquipment: \n' + AuxiliaryEquipment.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=FaultIndicator\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Float.py b/cimpy/cgmes_v3_0_0/Float.py new file mode 100644 index 00000000..4c530759 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Float.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class Float(Base): + ''' + A floating point number. The range is unspecified and not limited. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.DL.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=Float\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/FossilFuel.py b/cimpy/cgmes_v3_0_0/FossilFuel.py new file mode 100644 index 00000000..67d67586 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/FossilFuel.py @@ -0,0 +1,34 @@ +from .IdentifiedObject import IdentifiedObject + + +class FossilFuel(IdentifiedObject): + ''' + The fossil fuel consumed by the non-nuclear thermal generating unit. For example, coal, oil, gas, etc. These are the specific fuels that the generating unit can consume. + + :fossilFuelType: The type of fossil fuel, such as coal, oil, or gas. Default: None + :ThermalGeneratingUnit: A thermal generating unit may have one or more fossil fuels. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'fossilFuelType': [cgmesProfile.EQ.value, ], + 'ThermalGeneratingUnit': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, fossilFuelType = None, ThermalGeneratingUnit = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.fossilFuelType = fossilFuelType + self.ThermalGeneratingUnit = ThermalGeneratingUnit + + def __str__(self): + str = 'class=FossilFuel\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/FrancisGovernorControlKind.py b/cimpy/cgmes_v3_0_0/FrancisGovernorControlKind.py new file mode 100644 index 00000000..df41d15e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/FrancisGovernorControlKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class FrancisGovernorControlKind(Base): + ''' + Governor control flag for Francis hydro model. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=FrancisGovernorControlKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Frequency.py b/cimpy/cgmes_v3_0_0/Frequency.py new file mode 100644 index 00000000..3ac07063 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Frequency.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class Frequency(Base): + ''' + Cycles per second. + + :value: Default: 0.0 + :unit: Default: None + :multiplier: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.EQ.value, ], + 'value': [cgmesProfile.DY.value, cgmesProfile.EQ.value, ], + 'unit': [cgmesProfile.DY.value, cgmesProfile.EQ.value, ], + 'multiplier': [cgmesProfile.DY.value, cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, unit = None, multiplier = None, ): + + self.value = value + self.unit = unit + self.multiplier = multiplier + + def __str__(self): + str = 'class=Frequency\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/FuelType.py b/cimpy/cgmes_v3_0_0/FuelType.py new file mode 100644 index 00000000..2090dc64 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/FuelType.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class FuelType(Base): + ''' + Type of fuel. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=FuelType\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Fuse.py b/cimpy/cgmes_v3_0_0/Fuse.py new file mode 100644 index 00000000..ca43b329 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Fuse.py @@ -0,0 +1,29 @@ +from .Switch import Switch + + +class Fuse(Switch): + ''' + An overcurrent protective device with a circuit opening fusible part that is heated and severed by the passage of overcurrent through it. A fuse is considered a switching device because it breaks current. + + ''' + + cgmesProfile = Switch.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Switch: \n' + Switch.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=Fuse\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GenICompensationForGenJ.py b/cimpy/cgmes_v3_0_0/GenICompensationForGenJ.py new file mode 100644 index 00000000..e3dc3b58 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GenICompensationForGenJ.py @@ -0,0 +1,40 @@ +from .IdentifiedObject import IdentifiedObject + + +class GenICompensationForGenJ(IdentifiedObject): + ''' + Resistive and reactive components of compensation for generator associated with IEEE type 2 voltage compensator for current flow out of another generator in the interconnection. + + :SynchronousMachineDynamics: Standard synchronous machine out of which current flow is being compensated for. Default: None + :VcompIEEEType2: The standard IEEE type 2 voltage compensator of this compensation. Default: None + :rcij: Resistive component of compensation of generator associated with this IEEE type 2 voltage compensator for current flow out of another generator (Rcij). Default: 0.0 + :xcij: Reactive component of compensation of generator associated with this IEEE type 2 voltage compensator for current flow out of another generator (Xcij). Default: 0.0 + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'SynchronousMachineDynamics': [cgmesProfile.DY.value, ], + 'VcompIEEEType2': [cgmesProfile.DY.value, ], + 'rcij': [cgmesProfile.DY.value, ], + 'xcij': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, SynchronousMachineDynamics = None, VcompIEEEType2 = None, rcij = 0.0, xcij = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.SynchronousMachineDynamics = SynchronousMachineDynamics + self.VcompIEEEType2 = VcompIEEEType2 + self.rcij = rcij + self.xcij = xcij + + def __str__(self): + str = 'class=GenICompensationForGenJ\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GeneratingUnit.py b/cimpy/cgmes_v3_0_0/GeneratingUnit.py new file mode 100644 index 00000000..3e2bab7d --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GeneratingUnit.py @@ -0,0 +1,85 @@ +from .Equipment import Equipment + + +class GeneratingUnit(Equipment): + ''' + A single or set of synchronous machines for converting mechanical power into alternating-current power. For example, individual machines within a set may be defined for scheduling purposes while a single control signal is derived for the set. In this case there would be a GeneratingUnit for each member of the set and an additional GeneratingUnit corresponding to the set. + + :normalPF: Generating unit economic participation factor. The sum of the participation factors across generating units does not have to sum to one. It is used for representing distributed slack participation factor. The attribute shall be a positive value or zero. Default: 0.0 + :ControlAreaGeneratingUnit: ControlArea specifications for this generating unit. Default: "list" + :genControlSource: The source of controls for a generating unit. Defines the control status of the generating unit. Default: None + :governorSCD: Governor Speed Changer Droop. This is the change in generator power output divided by the change in frequency normalized by the nominal power of the generator and the nominal frequency and expressed in percent and negated. A positive value of speed change droop provides additional generator output upon a drop in frequency. Default: 0.0 + :longPF: Generating unit long term economic participation factor. Default: 0.0 + :maximumAllowableSpinningReserve: Maximum allowable spinning reserve. Spinning reserve will never be considered greater than this value regardless of the current operating point. Default: 0.0 + :maxOperatingP: This is the maximum operating active power limit the dispatcher can enter for this unit. Default: 0.0 + :minOperatingP: This is the minimum operating active power limit the dispatcher can enter for this unit. Default: 0.0 + :nominalP: The nominal power of the generating unit. Used to give precise meaning to percentage based attributes such as the governor speed change droop (governorSCD attribute). The attribute shall be a positive value equal to or less than RotatingMachine.ratedS. Default: 0.0 + :ratedGrossMaxP: The unit`s gross rated maximum capacity (book value). The attribute shall be a positive value. Default: 0.0 + :ratedGrossMinP: The gross rated minimum generation level which the unit can safely operate at while delivering power to the transmission grid. The attribute shall be a positive value. Default: 0.0 + :ratedNetMaxP: The net rated maximum capacity determined by subtracting the auxiliary power used to operate the internal plant machinery from the rated gross maximum capacity. The attribute shall be a positive value. Default: 0.0 + :shortPF: Generating unit short term economic participation factor. Default: 0.0 + :startupCost: The initial startup cost incurred for each start of the GeneratingUnit. Default: 0.0 + :variableCost: The variable cost component of production per unit of ActivePower. Default: 0.0 + :startupTime: Time it takes to get the unit on-line, from the time that the prime mover mechanical power is applied. Default: 0 + :totalEfficiency: The efficiency of the unit in converting the fuel into electrical energy. Default: 0.0 + :GrossToNetActivePowerCurves: A generating unit may have a gross active power to net active power curve, describing the losses and auxiliary power requirements of the unit. Default: "list" + :RotatingMachine: A synchronous machine may operate as a generator and as such becomes a member of a generating unit. Default: "list" + ''' + + cgmesProfile = Equipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'normalPF': [cgmesProfile.SSH.value, ], + 'ControlAreaGeneratingUnit': [cgmesProfile.EQ.value, ], + 'genControlSource': [cgmesProfile.EQ.value, ], + 'governorSCD': [cgmesProfile.EQ.value, ], + 'longPF': [cgmesProfile.EQ.value, ], + 'maximumAllowableSpinningReserve': [cgmesProfile.EQ.value, ], + 'maxOperatingP': [cgmesProfile.EQ.value, ], + 'minOperatingP': [cgmesProfile.EQ.value, ], + 'nominalP': [cgmesProfile.EQ.value, ], + 'ratedGrossMaxP': [cgmesProfile.EQ.value, ], + 'ratedGrossMinP': [cgmesProfile.EQ.value, ], + 'ratedNetMaxP': [cgmesProfile.EQ.value, ], + 'shortPF': [cgmesProfile.EQ.value, ], + 'startupCost': [cgmesProfile.EQ.value, ], + 'variableCost': [cgmesProfile.EQ.value, ], + 'startupTime': [cgmesProfile.EQ.value, ], + 'totalEfficiency': [cgmesProfile.EQ.value, ], + 'GrossToNetActivePowerCurves': [cgmesProfile.EQ.value, ], + 'RotatingMachine': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Equipment: \n' + Equipment.__doc__ + + def __init__(self, normalPF = 0.0, ControlAreaGeneratingUnit = "list", genControlSource = None, governorSCD = 0.0, longPF = 0.0, maximumAllowableSpinningReserve = 0.0, maxOperatingP = 0.0, minOperatingP = 0.0, nominalP = 0.0, ratedGrossMaxP = 0.0, ratedGrossMinP = 0.0, ratedNetMaxP = 0.0, shortPF = 0.0, startupCost = 0.0, variableCost = 0.0, startupTime = 0, totalEfficiency = 0.0, GrossToNetActivePowerCurves = "list", RotatingMachine = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.normalPF = normalPF + self.ControlAreaGeneratingUnit = ControlAreaGeneratingUnit + self.genControlSource = genControlSource + self.governorSCD = governorSCD + self.longPF = longPF + self.maximumAllowableSpinningReserve = maximumAllowableSpinningReserve + self.maxOperatingP = maxOperatingP + self.minOperatingP = minOperatingP + self.nominalP = nominalP + self.ratedGrossMaxP = ratedGrossMaxP + self.ratedGrossMinP = ratedGrossMinP + self.ratedNetMaxP = ratedNetMaxP + self.shortPF = shortPF + self.startupCost = startupCost + self.variableCost = variableCost + self.startupTime = startupTime + self.totalEfficiency = totalEfficiency + self.GrossToNetActivePowerCurves = GrossToNetActivePowerCurves + self.RotatingMachine = RotatingMachine + + def __str__(self): + str = 'class=GeneratingUnit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GeneratorControlSource.py b/cimpy/cgmes_v3_0_0/GeneratorControlSource.py new file mode 100644 index 00000000..d88b1528 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GeneratorControlSource.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class GeneratorControlSource(Base): + ''' + The source of controls for a generating unit. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=GeneratorControlSource\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GenericNonLinearLoadModelKind.py b/cimpy/cgmes_v3_0_0/GenericNonLinearLoadModelKind.py new file mode 100644 index 00000000..00ca0663 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GenericNonLinearLoadModelKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class GenericNonLinearLoadModelKind(Base): + ''' + Type of generic non-linear load model. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=GenericNonLinearLoadModelKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GeographicalRegion.py b/cimpy/cgmes_v3_0_0/GeographicalRegion.py new file mode 100644 index 00000000..d13f85d5 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GeographicalRegion.py @@ -0,0 +1,31 @@ +from .IdentifiedObject import IdentifiedObject + + +class GeographicalRegion(IdentifiedObject): + ''' + A geographical region of a power system network model. + + :Regions: All sub-geographical regions within this geographical region. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'Regions': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, Regions = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Regions = Regions + + def __str__(self): + str = 'class=GeographicalRegion\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovCT1.py b/cimpy/cgmes_v3_0_0/GovCT1.py new file mode 100644 index 00000000..75594f19 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovCT1.py @@ -0,0 +1,133 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovCT1(TurbineGovernorDynamics): + ''' + General model for any prime mover with a PID governor, used primarily for combustion turbine and combined cycle units. This model can be used to represent a variety of prime movers controlled by PID governors. It is suitable, for example, for the representation of: Additional information on this model is available in the 2012 IEEE report, Dynamic Models for Turbine-Governors in Power System Studies, 3.1.2.3 pages 3-4 (GGOV1). + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :r: Permanent droop (R). Typical value = 0,04. Default: 0.0 + :rselect: Feedback signal for droop (Rselect). Typical value = electricalPower. Default: None + :tpelec: Electrical power transducer time constant (Tpelec) (> 0). Typical value = 1. Default: 0 + :maxerr: Maximum value for speed error signal (maxerr) (> GovCT1.minerr). Typical value = 0,05. Default: 0.0 + :minerr: Minimum value for speed error signal (minerr) (< GovCT1.maxerr). Typical value = -0,05. Default: 0.0 + :kpgov: Governor proportional gain (Kpgov). Typical value = 10. Default: 0.0 + :kigov: Governor integral gain (Kigov). Typical value = 2. Default: 0.0 + :kdgov: Governor derivative gain (Kdgov). Typical value = 0. Default: 0.0 + :tdgov: Governor derivative controller time constant (Tdgov) (>= 0). Typical value = 1. Default: 0 + :vmax: Maximum valve position limit (Vmax) (> GovCT1.vmin). Typical value = 1. Default: 0.0 + :vmin: Minimum valve position limit (Vmin) (< GovCT1.vmax). Typical value = 0,15. Default: 0.0 + :tact: Actuator time constant (Tact) (>= 0). Typical value = 0,5. Default: 0 + :kturb: Turbine gain (Kturb) (> 0). Typical value = 1,5. Default: 0.0 + :wfnl: No load fuel flow (Wfnl). Typical value = 0,2. Default: 0.0 + :tb: Turbine lag time constant (Tb) (> 0). Typical value = 0,5. Default: 0 + :tc: Turbine lead time constant (Tc) (>= 0). Typical value = 0. Default: 0 + :wfspd: Switch for fuel source characteristic to recognize that fuel flow, for a given fuel valve stroke, can be proportional to engine speed (Wfspd). true = fuel flow proportional to speed (for some gas turbines and diesel engines with positive displacement fuel injectors) false = fuel control system keeps fuel flow independent of engine speed. Typical value = true. Default: False + :teng: Transport time delay for diesel engine used in representing diesel engines where there is a small but measurable transport delay between a change in fuel flow setting and the development of torque (Teng) (>= 0). Teng should be zero in all but special cases where this transport delay is of particular concern. Typical value = 0. Default: 0 + :tfload: Load-limiter time constant (Tfload) (> 0). Typical value = 3. Default: 0 + :kpload: Load limiter proportional gain for PI controller (Kpload). Typical value = 2. Default: 0.0 + :kiload: Load limiter integral gain for PI controller (Kiload). Typical value = 0,67. Default: 0.0 + :ldref: Load limiter reference value (Ldref). Typical value = 1. Default: 0.0 + :dm: Speed sensitivity coefficient (Dm). Dm can represent either the variation of the engine power with the shaft speed or the variation of maximum power capability with shaft speed. If it is positive it describes the falling slope of the engine speed verses power characteristic as speed increases. A slightly falling characteristic is typical for reciprocating engines and some aero-derivative turbines. If it is negative the engine power is assumed to be unaffected by the shaft speed, but the maximum permissible fuel flow is taken to fall with falling shaft speed. This is characteristic of single-shaft industrial turbines due to exhaust temperature limits. Typical value = 0. Default: 0.0 + :ropen: Maximum valve opening rate (Ropen). Unit = PU / s. Typical value = 0.10. Default: 0.0 + :rclose: Minimum valve closing rate (Rclose). Unit = PU / s. Typical value = -0,1. Default: 0.0 + :kimw: Power controller (reset) gain (Kimw). The default value of 0,01 corresponds to a reset time of 100 s. A value of 0,001 corresponds to a relatively slow-acting load controller. Typical value = 0,01. Default: 0.0 + :aset: Acceleration limiter setpoint (Aset). Unit = PU / s. Typical value = 0,01. Default: 0.0 + :ka: Acceleration limiter gain (Ka). Typical value = 10. Default: 0.0 + :ta: Acceleration limiter time constant (Ta) (> 0). Typical value = 0,1. Default: 0 + :db: Speed governor deadband in PU speed (db). In the majority of applications, it is recommended that this value be set to zero. Typical value = 0. Default: 0.0 + :tsa: Temperature detection lead time constant (Tsa) (>= 0). Typical value = 4. Default: 0 + :tsb: Temperature detection lag time constant (Tsb) (>= 0). Typical value = 5. Default: 0 + :rup: Maximum rate of load limit increase (Rup). Typical value = 99. Default: 0.0 + :rdown: Maximum rate of load limit decrease (Rdown). Typical value = -99. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'r': [cgmesProfile.DY.value, ], + 'rselect': [cgmesProfile.DY.value, ], + 'tpelec': [cgmesProfile.DY.value, ], + 'maxerr': [cgmesProfile.DY.value, ], + 'minerr': [cgmesProfile.DY.value, ], + 'kpgov': [cgmesProfile.DY.value, ], + 'kigov': [cgmesProfile.DY.value, ], + 'kdgov': [cgmesProfile.DY.value, ], + 'tdgov': [cgmesProfile.DY.value, ], + 'vmax': [cgmesProfile.DY.value, ], + 'vmin': [cgmesProfile.DY.value, ], + 'tact': [cgmesProfile.DY.value, ], + 'kturb': [cgmesProfile.DY.value, ], + 'wfnl': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'wfspd': [cgmesProfile.DY.value, ], + 'teng': [cgmesProfile.DY.value, ], + 'tfload': [cgmesProfile.DY.value, ], + 'kpload': [cgmesProfile.DY.value, ], + 'kiload': [cgmesProfile.DY.value, ], + 'ldref': [cgmesProfile.DY.value, ], + 'dm': [cgmesProfile.DY.value, ], + 'ropen': [cgmesProfile.DY.value, ], + 'rclose': [cgmesProfile.DY.value, ], + 'kimw': [cgmesProfile.DY.value, ], + 'aset': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'db': [cgmesProfile.DY.value, ], + 'tsa': [cgmesProfile.DY.value, ], + 'tsb': [cgmesProfile.DY.value, ], + 'rup': [cgmesProfile.DY.value, ], + 'rdown': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, r = 0.0, rselect = None, tpelec = 0, maxerr = 0.0, minerr = 0.0, kpgov = 0.0, kigov = 0.0, kdgov = 0.0, tdgov = 0, vmax = 0.0, vmin = 0.0, tact = 0, kturb = 0.0, wfnl = 0.0, tb = 0, tc = 0, wfspd = False, teng = 0, tfload = 0, kpload = 0.0, kiload = 0.0, ldref = 0.0, dm = 0.0, ropen = 0.0, rclose = 0.0, kimw = 0.0, aset = 0.0, ka = 0.0, ta = 0, db = 0.0, tsa = 0, tsb = 0, rup = 0.0, rdown = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.r = r + self.rselect = rselect + self.tpelec = tpelec + self.maxerr = maxerr + self.minerr = minerr + self.kpgov = kpgov + self.kigov = kigov + self.kdgov = kdgov + self.tdgov = tdgov + self.vmax = vmax + self.vmin = vmin + self.tact = tact + self.kturb = kturb + self.wfnl = wfnl + self.tb = tb + self.tc = tc + self.wfspd = wfspd + self.teng = teng + self.tfload = tfload + self.kpload = kpload + self.kiload = kiload + self.ldref = ldref + self.dm = dm + self.ropen = ropen + self.rclose = rclose + self.kimw = kimw + self.aset = aset + self.ka = ka + self.ta = ta + self.db = db + self.tsa = tsa + self.tsb = tsb + self.rup = rup + self.rdown = rdown + + def __str__(self): + str = 'class=GovCT1\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovCT2.py b/cimpy/cgmes_v3_0_0/GovCT2.py new file mode 100644 index 00000000..22f38604 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovCT2.py @@ -0,0 +1,196 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovCT2(TurbineGovernorDynamics): + ''' + General governor with frequency-dependent fuel flow limit. This model is a modification of the GovCT1 model in order to represent the frequency-dependent fuel flow limit of a specific gas turbine manufacturer. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :r: Permanent droop (R). Typical value = 0,05. Default: 0.0 + :rselect: Feedback signal for droop (Rselect). Typical value = electricalPower. Default: None + :tpelec: Electrical power transducer time constant (Tpelec) (>= 0). Typical value = 2,5. Default: 0 + :maxerr: Maximum value for speed error signal (Maxerr) (> GovCT2.minerr). Typical value = 1. Default: 0.0 + :minerr: Minimum value for speed error signal (Minerr) (< GovCT2.maxerr). Typical value = -1. Default: 0.0 + :kpgov: Governor proportional gain (Kpgov). Typical value = 4. Default: 0.0 + :kigov: Governor integral gain (Kigov). Typical value = 0,45. Default: 0.0 + :kdgov: Governor derivative gain (Kdgov). Typical value = 0. Default: 0.0 + :tdgov: Governor derivative controller time constant (Tdgov) (>= 0). Typical value = 1. Default: 0 + :vmax: Maximum valve position limit (Vmax) (> GovCT2.vmin). Typical value = 1. Default: 0.0 + :vmin: Minimum valve position limit (Vmin) (< GovCT2.vmax). Typical value = 0,175. Default: 0.0 + :tact: Actuator time constant (Tact) (>= 0). Typical value = 0,4. Default: 0 + :kturb: Turbine gain (Kturb). Typical value = 1,9168. Default: 0.0 + :wfnl: No load fuel flow (Wfnl). Typical value = 0,187. Default: 0.0 + :tb: Turbine lag time constant (Tb) (>= 0). Typical value = 0,1. Default: 0 + :tc: Turbine lead time constant (Tc) (>= 0). Typical value = 0. Default: 0 + :wfspd: Switch for fuel source characteristic to recognize that fuel flow, for a given fuel valve stroke, can be proportional to engine speed (Wfspd). true = fuel flow proportional to speed (for some gas turbines and diesel engines with positive displacement fuel injectors) false = fuel control system keeps fuel flow independent of engine speed. Typical value = false. Default: False + :teng: Transport time delay for diesel engine used in representing diesel engines where there is a small but measurable transport delay between a change in fuel flow setting and the development of torque (Teng) (>= 0). Teng should be zero in all but special cases where this transport delay is of particular concern. Typical value = 0. Default: 0 + :tfload: Load limiter time constant (Tfload) (>= 0). Typical value = 3. Default: 0 + :kpload: Load limiter proportional gain for PI controller (Kpload). Typical value = 1. Default: 0.0 + :kiload: Load limiter integral gain for PI controller (Kiload). Typical value = 1. Default: 0.0 + :ldref: Load limiter reference value (Ldref). Typical value = 1. Default: 0.0 + :dm: Speed sensitivity coefficient (Dm). Dm can represent either the variation of the engine power with the shaft speed or the variation of maximum power capability with shaft speed. If it is positive it describes the falling slope of the engine speed verses power characteristic as speed increases. A slightly falling characteristic is typical for reciprocating engines and some aero-derivative turbines. If it is negative the engine power is assumed to be unaffected by the shaft speed, but the maximum permissible fuel flow is taken to fall with falling shaft speed. This is characteristic of single-shaft industrial turbines due to exhaust temperature limits. Typical value = 0. Default: 0.0 + :ropen: Maximum valve opening rate (Ropen). Unit = PU / s. Typical value = 99. Default: 0.0 + :rclose: Minimum valve closing rate (Rclose). Unit = PU / s. Typical value = -99. Default: 0.0 + :kimw: Power controller (reset) gain (Kimw). The default value of 0,01 corresponds to a reset time of 100 seconds. A value of 0,001 corresponds to a relatively slow-acting load controller. Typical value = 0. Default: 0.0 + :aset: Acceleration limiter setpoint (Aset). Unit = PU / s. Typical value = 10. Default: 0.0 + :ka: Acceleration limiter gain (Ka). Typical value = 10. Default: 0.0 + :ta: Acceleration limiter time constant (Ta) (>= 0). Typical value = 1. Default: 0 + :db: Speed governor deadband in PU speed (db). In the majority of applications, it is recommended that this value be set to zero. Typical value = 0. Default: 0.0 + :tsa: Temperature detection lead time constant (Tsa) (>= 0). Typical value = 0. Default: 0 + :tsb: Temperature detection lag time constant (Tsb) (>= 0). Typical value = 50. Default: 0 + :rup: Maximum rate of load limit increase (Rup). Typical value = 99. Default: 0.0 + :rdown: Maximum rate of load limit decrease (Rdown). Typical value = -99. Default: 0.0 + :prate: Ramp rate for frequency-dependent power limit (Prate). Typical value = 0,017. Default: 0.0 + :flim1: Frequency threshold 1 (Flim1). Unit = Hz. Typical value = 59. Default: 0.0 + :plim1: Power limit 1 (Plim1). Typical value = 0,8325. Default: 0.0 + :flim2: Frequency threshold 2 (Flim2). Unit = Hz. Typical value = 0. Default: 0.0 + :plim2: Power limit 2 (Plim2). Typical value = 0. Default: 0.0 + :flim3: Frequency threshold 3 (Flim3). Unit = Hz. Typical value = 0. Default: 0.0 + :plim3: Power limit 3 (Plim3). Typical value = 0. Default: 0.0 + :flim4: Frequency threshold 4 (Flim4). Unit = Hz. Typical value = 0. Default: 0.0 + :plim4: Power limit 4 (Plim4). Typical value = 0. Default: 0.0 + :flim5: Frequency threshold 5 (Flim5). Unit = Hz. Typical value = 0. Default: 0.0 + :plim5: Power limit 5 (Plim5). Typical value = 0. Default: 0.0 + :flim6: Frequency threshold 6 (Flim6). Unit = Hz. Typical value = 0. Default: 0.0 + :plim6: Power limit 6 (Plim6). Typical value = 0. Default: 0.0 + :flim7: Frequency threshold 7 (Flim7). Unit = Hz. Typical value = 0. Default: 0.0 + :plim7: Power limit 7 (Plim7). Typical value = 0. Default: 0.0 + :flim8: Frequency threshold 8 (Flim8). Unit = Hz. Typical value = 0. Default: 0.0 + :plim8: Power limit 8 (Plim8). Typical value = 0. Default: 0.0 + :flim9: Frequency threshold 9 (Flim9). Unit = Hz. Typical value = 0. Default: 0.0 + :plim9: Power Limit 9 (Plim9). Typical value = 0. Default: 0.0 + :flim10: Frequency threshold 10 (Flim10). Unit = Hz. Typical value = 0. Default: 0.0 + :plim10: Power limit 10 (Plim10). Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'r': [cgmesProfile.DY.value, ], + 'rselect': [cgmesProfile.DY.value, ], + 'tpelec': [cgmesProfile.DY.value, ], + 'maxerr': [cgmesProfile.DY.value, ], + 'minerr': [cgmesProfile.DY.value, ], + 'kpgov': [cgmesProfile.DY.value, ], + 'kigov': [cgmesProfile.DY.value, ], + 'kdgov': [cgmesProfile.DY.value, ], + 'tdgov': [cgmesProfile.DY.value, ], + 'vmax': [cgmesProfile.DY.value, ], + 'vmin': [cgmesProfile.DY.value, ], + 'tact': [cgmesProfile.DY.value, ], + 'kturb': [cgmesProfile.DY.value, ], + 'wfnl': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'wfspd': [cgmesProfile.DY.value, ], + 'teng': [cgmesProfile.DY.value, ], + 'tfload': [cgmesProfile.DY.value, ], + 'kpload': [cgmesProfile.DY.value, ], + 'kiload': [cgmesProfile.DY.value, ], + 'ldref': [cgmesProfile.DY.value, ], + 'dm': [cgmesProfile.DY.value, ], + 'ropen': [cgmesProfile.DY.value, ], + 'rclose': [cgmesProfile.DY.value, ], + 'kimw': [cgmesProfile.DY.value, ], + 'aset': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'db': [cgmesProfile.DY.value, ], + 'tsa': [cgmesProfile.DY.value, ], + 'tsb': [cgmesProfile.DY.value, ], + 'rup': [cgmesProfile.DY.value, ], + 'rdown': [cgmesProfile.DY.value, ], + 'prate': [cgmesProfile.DY.value, ], + 'flim1': [cgmesProfile.DY.value, ], + 'plim1': [cgmesProfile.DY.value, ], + 'flim2': [cgmesProfile.DY.value, ], + 'plim2': [cgmesProfile.DY.value, ], + 'flim3': [cgmesProfile.DY.value, ], + 'plim3': [cgmesProfile.DY.value, ], + 'flim4': [cgmesProfile.DY.value, ], + 'plim4': [cgmesProfile.DY.value, ], + 'flim5': [cgmesProfile.DY.value, ], + 'plim5': [cgmesProfile.DY.value, ], + 'flim6': [cgmesProfile.DY.value, ], + 'plim6': [cgmesProfile.DY.value, ], + 'flim7': [cgmesProfile.DY.value, ], + 'plim7': [cgmesProfile.DY.value, ], + 'flim8': [cgmesProfile.DY.value, ], + 'plim8': [cgmesProfile.DY.value, ], + 'flim9': [cgmesProfile.DY.value, ], + 'plim9': [cgmesProfile.DY.value, ], + 'flim10': [cgmesProfile.DY.value, ], + 'plim10': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, r = 0.0, rselect = None, tpelec = 0, maxerr = 0.0, minerr = 0.0, kpgov = 0.0, kigov = 0.0, kdgov = 0.0, tdgov = 0, vmax = 0.0, vmin = 0.0, tact = 0, kturb = 0.0, wfnl = 0.0, tb = 0, tc = 0, wfspd = False, teng = 0, tfload = 0, kpload = 0.0, kiload = 0.0, ldref = 0.0, dm = 0.0, ropen = 0.0, rclose = 0.0, kimw = 0.0, aset = 0.0, ka = 0.0, ta = 0, db = 0.0, tsa = 0, tsb = 0, rup = 0.0, rdown = 0.0, prate = 0.0, flim1 = 0.0, plim1 = 0.0, flim2 = 0.0, plim2 = 0.0, flim3 = 0.0, plim3 = 0.0, flim4 = 0.0, plim4 = 0.0, flim5 = 0.0, plim5 = 0.0, flim6 = 0.0, plim6 = 0.0, flim7 = 0.0, plim7 = 0.0, flim8 = 0.0, plim8 = 0.0, flim9 = 0.0, plim9 = 0.0, flim10 = 0.0, plim10 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.r = r + self.rselect = rselect + self.tpelec = tpelec + self.maxerr = maxerr + self.minerr = minerr + self.kpgov = kpgov + self.kigov = kigov + self.kdgov = kdgov + self.tdgov = tdgov + self.vmax = vmax + self.vmin = vmin + self.tact = tact + self.kturb = kturb + self.wfnl = wfnl + self.tb = tb + self.tc = tc + self.wfspd = wfspd + self.teng = teng + self.tfload = tfload + self.kpload = kpload + self.kiload = kiload + self.ldref = ldref + self.dm = dm + self.ropen = ropen + self.rclose = rclose + self.kimw = kimw + self.aset = aset + self.ka = ka + self.ta = ta + self.db = db + self.tsa = tsa + self.tsb = tsb + self.rup = rup + self.rdown = rdown + self.prate = prate + self.flim1 = flim1 + self.plim1 = plim1 + self.flim2 = flim2 + self.plim2 = plim2 + self.flim3 = flim3 + self.plim3 = plim3 + self.flim4 = flim4 + self.plim4 = plim4 + self.flim5 = flim5 + self.plim5 = plim5 + self.flim6 = flim6 + self.plim6 = plim6 + self.flim7 = flim7 + self.plim7 = plim7 + self.flim8 = flim8 + self.plim8 = plim8 + self.flim9 = flim9 + self.plim9 = plim9 + self.flim10 = flim10 + self.plim10 = plim10 + + def __str__(self): + str = 'class=GovCT2\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovGAST.py b/cimpy/cgmes_v3_0_0/GovGAST.py new file mode 100644 index 00000000..d1a4cb11 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovGAST.py @@ -0,0 +1,58 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovGAST(TurbineGovernorDynamics): + ''' + Single shaft gas turbine. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :r: Permanent droop (R) (>0). Typical value = 0,04. Default: 0.0 + :t1: Governor mechanism time constant (T1) (>= 0). T1 represents the natural valve positioning time constant of the governor for small disturbances, as seen when rate limiting is not in effect. Typical value = 0,5. Default: 0 + :t2: Turbine power time constant (T2) (>= 0). T2 represents delay due to internal energy storage of the gas turbine engine. T2 can be used to give a rough approximation to the delay associated with acceleration of the compressor spool of a multi-shaft engine, or with the compressibility of gas in the plenum of a free power turbine of an aero-derivative unit, for example. Typical value = 0,5. Default: 0 + :t3: Turbine exhaust temperature time constant (T3) (>= 0). Typical value = 3. Default: 0 + :at: Ambient temperature load limit (Load Limit). Typical value = 1. Default: 0.0 + :kt: Temperature limiter gain (Kt). Typical value = 3. Default: 0.0 + :vmax: Maximum turbine power, PU of MWbase (Vmax) (> GovGAST.vmin). Typical value = 1. Default: 0.0 + :vmin: Minimum turbine power, PU of MWbase (Vmin) (< GovGAST.vmax). Typical value = 0. Default: 0.0 + :dturb: Turbine damping factor (Dturb). Typical value = 0,18. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'r': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 'at': [cgmesProfile.DY.value, ], + 'kt': [cgmesProfile.DY.value, ], + 'vmax': [cgmesProfile.DY.value, ], + 'vmin': [cgmesProfile.DY.value, ], + 'dturb': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, r = 0.0, t1 = 0, t2 = 0, t3 = 0, at = 0.0, kt = 0.0, vmax = 0.0, vmin = 0.0, dturb = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.r = r + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.at = at + self.kt = kt + self.vmax = vmax + self.vmin = vmin + self.dturb = dturb + + def __str__(self): + str = 'class=GovGAST\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovGAST1.py b/cimpy/cgmes_v3_0_0/GovGAST1.py new file mode 100644 index 00000000..a7c6dc99 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovGAST1.py @@ -0,0 +1,130 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovGAST1(TurbineGovernorDynamics): + ''' + Modified single shaft gas turbine. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :r: Permanent droop (R) (>0). Typical value = 0,04. Default: 0.0 + :t1: Governor mechanism time constant (T1) (>= 0). T1 represents the natural valve positioning time constant of the governor for small disturbances, as seen when rate limiting is not in effect. Typical value = 0,5. Default: 0 + :t2: Turbine power time constant (T2) (>= 0). T2 represents delay due to internal energy storage of the gas turbine engine. T2 can be used to give a rough approximation to the delay associated with acceleration of the compressor spool of a multi-shaft engine, or with the compressibility of gas in the plenum of the free power turbine of an aero-derivative unit, for example. Typical value = 0,5. Default: 0 + :t3: Turbine exhaust temperature time constant (T3) (>= 0). T3 represents delay in the exhaust temperature and load limiting system. Typical value = 3. Default: 0 + :lmax: Ambient temperature load limit (Lmax). Lmax is the turbine power output corresponding to the limiting exhaust gas temperature. Typical value = 1. Default: 0.0 + :kt: Temperature limiter gain (Kt). Typical value = 3. Default: 0.0 + :vmax: Maximum turbine power, PU of MWbase (Vmax) (> GovGAST1.vmin). Typical value = 1. Default: 0.0 + :vmin: Minimum turbine power, PU of MWbase (Vmin) (< GovGAST1.vmax). Typical value = 0. Default: 0.0 + :fidle: Fuel flow at zero power output (Fidle). Typical value = 0,18. Default: 0.0 + :rmax: Maximum fuel valve opening rate (Rmax). Unit = PU / s. Typical value = 1. Default: 0.0 + :loadinc: Valve position change allowed at fast rate (Loadinc). Typical value = 0,05. Default: 0.0 + :tltr: Valve position averaging time constant (Tltr) (>= 0). Typical value = 10. Default: 0 + :ltrate: Maximum long term fuel valve opening rate (Ltrate). Typical value = 0,02. Default: 0.0 + :a: Turbine power time constant numerator scale factor (a). Typical value = 0,8. Default: 0.0 + :b: Turbine power time constant denominator scale factor (b) (>0). Typical value = 1. Default: 0.0 + :db1: Intentional dead-band width (db1). Unit = Hz. Typical value = 0. Default: 0.0 + :eps: Intentional db hysteresis (eps). Unit = Hz. Typical value = 0. Default: 0.0 + :db2: Unintentional dead-band (db2). Unit = MW. Typical value = 0. Default: 0.0 + :gv1: Nonlinear gain point 1, PU gv (Gv1). Typical value = 0. Default: 0.0 + :pgv1: Nonlinear gain point 1, PU power (Pgv1). Typical value = 0. Default: 0.0 + :gv2: Nonlinear gain point 2,PU gv (Gv2). Typical value = 0. Default: 0.0 + :pgv2: Nonlinear gain point 2, PU power (Pgv2). Typical value = 0. Default: 0.0 + :gv3: Nonlinear gain point 3, PU gv (Gv3). Typical value = 0. Default: 0.0 + :pgv3: Nonlinear gain point 3, PU power (Pgv3). Typical value = 0. Default: 0.0 + :gv4: Nonlinear gain point 4, PU gv (Gv4). Typical value = 0. Default: 0.0 + :pgv4: Nonlinear gain point 4, PU power (Pgv4). Typical value = 0. Default: 0.0 + :gv5: Nonlinear gain point 5, PU gv (Gv5). Typical value = 0. Default: 0.0 + :pgv5: Nonlinear gain point 5, PU power (Pgv5). Typical value = 0. Default: 0.0 + :gv6: Nonlinear gain point 6, PU gv (Gv6). Typical value = 0. Default: 0.0 + :pgv6: Nonlinear gain point 6, PU power (Pgv6). Typical value = 0. Default: 0.0 + :ka: Governor gain (Ka). Typical value = 0. Default: 0.0 + :t4: Governor lead time constant (T4) (>= 0). Typical value = 0. Default: 0 + :t5: Governor lag time constant (T5) (>= 0). If = 0, entire gain and lead-lag block is bypassed. Typical value = 0. Default: 0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'r': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 'lmax': [cgmesProfile.DY.value, ], + 'kt': [cgmesProfile.DY.value, ], + 'vmax': [cgmesProfile.DY.value, ], + 'vmin': [cgmesProfile.DY.value, ], + 'fidle': [cgmesProfile.DY.value, ], + 'rmax': [cgmesProfile.DY.value, ], + 'loadinc': [cgmesProfile.DY.value, ], + 'tltr': [cgmesProfile.DY.value, ], + 'ltrate': [cgmesProfile.DY.value, ], + 'a': [cgmesProfile.DY.value, ], + 'b': [cgmesProfile.DY.value, ], + 'db1': [cgmesProfile.DY.value, ], + 'eps': [cgmesProfile.DY.value, ], + 'db2': [cgmesProfile.DY.value, ], + 'gv1': [cgmesProfile.DY.value, ], + 'pgv1': [cgmesProfile.DY.value, ], + 'gv2': [cgmesProfile.DY.value, ], + 'pgv2': [cgmesProfile.DY.value, ], + 'gv3': [cgmesProfile.DY.value, ], + 'pgv3': [cgmesProfile.DY.value, ], + 'gv4': [cgmesProfile.DY.value, ], + 'pgv4': [cgmesProfile.DY.value, ], + 'gv5': [cgmesProfile.DY.value, ], + 'pgv5': [cgmesProfile.DY.value, ], + 'gv6': [cgmesProfile.DY.value, ], + 'pgv6': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, r = 0.0, t1 = 0, t2 = 0, t3 = 0, lmax = 0.0, kt = 0.0, vmax = 0.0, vmin = 0.0, fidle = 0.0, rmax = 0.0, loadinc = 0.0, tltr = 0, ltrate = 0.0, a = 0.0, b = 0.0, db1 = 0.0, eps = 0.0, db2 = 0.0, gv1 = 0.0, pgv1 = 0.0, gv2 = 0.0, pgv2 = 0.0, gv3 = 0.0, pgv3 = 0.0, gv4 = 0.0, pgv4 = 0.0, gv5 = 0.0, pgv5 = 0.0, gv6 = 0.0, pgv6 = 0.0, ka = 0.0, t4 = 0, t5 = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.r = r + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.lmax = lmax + self.kt = kt + self.vmax = vmax + self.vmin = vmin + self.fidle = fidle + self.rmax = rmax + self.loadinc = loadinc + self.tltr = tltr + self.ltrate = ltrate + self.a = a + self.b = b + self.db1 = db1 + self.eps = eps + self.db2 = db2 + self.gv1 = gv1 + self.pgv1 = pgv1 + self.gv2 = gv2 + self.pgv2 = pgv2 + self.gv3 = gv3 + self.pgv3 = pgv3 + self.gv4 = gv4 + self.pgv4 = pgv4 + self.gv5 = gv5 + self.pgv5 = pgv5 + self.gv6 = gv6 + self.pgv6 = pgv6 + self.ka = ka + self.t4 = t4 + self.t5 = t5 + + def __str__(self): + str = 'class=GovGAST1\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovGAST2.py b/cimpy/cgmes_v3_0_0/GovGAST2.py new file mode 100644 index 00000000..40aa068f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovGAST2.py @@ -0,0 +1,124 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovGAST2(TurbineGovernorDynamics): + ''' + Gas turbine. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :w: Governor gain (1/droop) on turbine rating (W). Default: 0.0 + :x: Governor lead time constant (X) (>= 0). Default: 0 + :y: Governor lag time constant (Y) (> 0). Default: 0 + :z: Governor mode (Z). 1 = droop 0 = isochronous. Default: 0 + :etd: Turbine and exhaust delay (Etd) (>= 0). Default: 0 + :tcd: Compressor discharge time constant (Tcd) (>= 0). Default: 0 + :trate: Turbine rating (Trate). Unit = MW. Default: 0.0 + :t: Fuel control time constant (T) (>= 0). Default: 0 + :tmax: Maximum turbine limit (Tmax) (> GovGAST2.tmin). Default: 0.0 + :tmin: Minimum turbine limit (Tmin) (< GovGAST2.tmax). Default: 0.0 + :ecr: Combustion reaction time delay (Ecr) (>= 0). Default: 0 + :k3: Ratio of fuel adjustment (K3). Default: 0.0 + :a: Valve positioner (A). Default: 0.0 + :b: Valve positioner (B). Default: 0.0 + :c: Valve positioner (C). Default: 0.0 + :tf: Fuel system time constant (Tf) (>= 0). Default: 0 + :kf: Fuel system feedback (Kf). Default: 0.0 + :k5: Gain of radiation shield (K5). Default: 0.0 + :k4: Gain of radiation shield (K4). Default: 0.0 + :t3: Radiation shield time constant (T3) (>= 0). Default: 0 + :t4: Thermocouple time constant (T4) (>= 0). Default: 0 + :tt: Temperature controller integration rate (Tt) (>= 0). Default: 0 + :t5: Temperature control time constant (T5) (>= 0). Default: 0 + :af1: Exhaust temperature parameter (Af1). Unit = PU temperature. Based on temperature in degrees C. Default: 0.0 + :bf1: (Bf1). Bf1 = E(1 - W) where E (speed sensitivity coefficient) is 0,55 to 0,65 x Tr. Unit = PU temperature. Based on temperature in degrees C. Default: 0.0 + :af2: Coefficient equal to 0,5(1-speed) (Af2). Default: 0.0 + :bf2: Turbine torque coefficient Khhv (depends on heating value of fuel stream in combustion chamber) (Bf2). Default: 0.0 + :cf2: Coefficient defining fuel flow where power output is 0% (Cf2). Synchronous but no output. Typically 0,23 x Khhv (23% fuel flow). Default: 0.0 + :tr: Rated temperature (Tr). Unit = [SYMBOL REMOVED]C depending on parameters Af1 and Bf1. Default: 0.0 + :k6: Minimum fuel flow (K6). Default: 0.0 + :tc: Temperature control (Tc). Unit = [SYMBOL REMOVED]F or [SYMBOL REMOVED]C depending on parameters Af1 and Bf1. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'w': [cgmesProfile.DY.value, ], + 'x': [cgmesProfile.DY.value, ], + 'y': [cgmesProfile.DY.value, ], + 'z': [cgmesProfile.DY.value, ], + 'etd': [cgmesProfile.DY.value, ], + 'tcd': [cgmesProfile.DY.value, ], + 'trate': [cgmesProfile.DY.value, ], + 't': [cgmesProfile.DY.value, ], + 'tmax': [cgmesProfile.DY.value, ], + 'tmin': [cgmesProfile.DY.value, ], + 'ecr': [cgmesProfile.DY.value, ], + 'k3': [cgmesProfile.DY.value, ], + 'a': [cgmesProfile.DY.value, ], + 'b': [cgmesProfile.DY.value, ], + 'c': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'k5': [cgmesProfile.DY.value, ], + 'k4': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 'tt': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 'af1': [cgmesProfile.DY.value, ], + 'bf1': [cgmesProfile.DY.value, ], + 'af2': [cgmesProfile.DY.value, ], + 'bf2': [cgmesProfile.DY.value, ], + 'cf2': [cgmesProfile.DY.value, ], + 'tr': [cgmesProfile.DY.value, ], + 'k6': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, w = 0.0, x = 0, y = 0, z = 0, etd = 0, tcd = 0, trate = 0.0, t = 0, tmax = 0.0, tmin = 0.0, ecr = 0, k3 = 0.0, a = 0.0, b = 0.0, c = 0.0, tf = 0, kf = 0.0, k5 = 0.0, k4 = 0.0, t3 = 0, t4 = 0, tt = 0, t5 = 0, af1 = 0.0, bf1 = 0.0, af2 = 0.0, bf2 = 0.0, cf2 = 0.0, tr = 0.0, k6 = 0.0, tc = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.w = w + self.x = x + self.y = y + self.z = z + self.etd = etd + self.tcd = tcd + self.trate = trate + self.t = t + self.tmax = tmax + self.tmin = tmin + self.ecr = ecr + self.k3 = k3 + self.a = a + self.b = b + self.c = c + self.tf = tf + self.kf = kf + self.k5 = k5 + self.k4 = k4 + self.t3 = t3 + self.t4 = t4 + self.tt = tt + self.t5 = t5 + self.af1 = af1 + self.bf1 = bf1 + self.af2 = af2 + self.bf2 = bf2 + self.cf2 = cf2 + self.tr = tr + self.k6 = k6 + self.tc = tc + + def __str__(self): + str = 'class=GovGAST2\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovGAST3.py b/cimpy/cgmes_v3_0_0/GovGAST3.py new file mode 100644 index 00000000..c8b414bc --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovGAST3.py @@ -0,0 +1,91 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovGAST3(TurbineGovernorDynamics): + ''' + Generic turbogas with acceleration and temperature controller. + + :bp: Droop (bp). Typical value = 0,05. Default: 0.0 + :tg: Time constant of speed governor (Tg) (>= 0). Typical value = 0,05. Default: 0 + :rcmx: Maximum fuel flow (RCMX). Typical value = 1. Default: 0.0 + :rcmn: Minimum fuel flow (RCMN). Typical value = -0,1. Default: 0.0 + :ky: Coefficient of transfer function of fuel valve positioner (Ky). Typical value = 1. Default: 0.0 + :ty: Time constant of fuel valve positioner (Ty) (>= 0). Typical value = 0,2. Default: 0 + :tac: Fuel control time constant (Tac) (>= 0). Typical value = 0,1. Default: 0 + :kac: Fuel system feedback (KAC). Typical value = 0. Default: 0.0 + :tc: Compressor discharge volume time constant (Tc) (>= 0). Typical value = 0,2. Default: 0 + :bca: Acceleration limit set-point (Bca). Unit = 1/s. Typical value = 0,01. Default: 0.0 + :kca: Acceleration control integral gain (Kca). Unit = 1/s. Typical value = 100. Default: 0.0 + :dtc: Exhaust temperature variation due to fuel flow increasing from 0 to 1 PU (deltaTc). Typical value = 390. Default: 0.0 + :ka: Minimum fuel flow (Ka). Typical value = 0,23. Default: 0.0 + :tsi: Time constant of radiation shield (Tsi) (>= 0). Typical value = 15. Default: 0 + :ksi: Gain of radiation shield (Ksi). Typical value = 0,8. Default: 0.0 + :ttc: Time constant of thermocouple (Ttc) (>= 0). Typical value = 2,5. Default: 0 + :tfen: Turbine rated exhaust temperature correspondent to Pm=1 PU (Tfen). Typical value = 540. Default: 0.0 + :td: Temperature controller derivative gain (Td) (>= 0). Typical value = 3,3. Default: 0 + :tt: Temperature controller integration rate (Tt). Typical value = 250. Default: 0.0 + :mxef: Fuel flow maximum positive error value (MXef). Typical value = 0,05. Default: 0.0 + :mnef: Fuel flow maximum negative error value (MNef). Typical value = -0,05. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'bp': [cgmesProfile.DY.value, ], + 'tg': [cgmesProfile.DY.value, ], + 'rcmx': [cgmesProfile.DY.value, ], + 'rcmn': [cgmesProfile.DY.value, ], + 'ky': [cgmesProfile.DY.value, ], + 'ty': [cgmesProfile.DY.value, ], + 'tac': [cgmesProfile.DY.value, ], + 'kac': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'bca': [cgmesProfile.DY.value, ], + 'kca': [cgmesProfile.DY.value, ], + 'dtc': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'tsi': [cgmesProfile.DY.value, ], + 'ksi': [cgmesProfile.DY.value, ], + 'ttc': [cgmesProfile.DY.value, ], + 'tfen': [cgmesProfile.DY.value, ], + 'td': [cgmesProfile.DY.value, ], + 'tt': [cgmesProfile.DY.value, ], + 'mxef': [cgmesProfile.DY.value, ], + 'mnef': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, bp = 0.0, tg = 0, rcmx = 0.0, rcmn = 0.0, ky = 0.0, ty = 0, tac = 0, kac = 0.0, tc = 0, bca = 0.0, kca = 0.0, dtc = 0.0, ka = 0.0, tsi = 0, ksi = 0.0, ttc = 0, tfen = 0.0, td = 0, tt = 0.0, mxef = 0.0, mnef = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.bp = bp + self.tg = tg + self.rcmx = rcmx + self.rcmn = rcmn + self.ky = ky + self.ty = ty + self.tac = tac + self.kac = kac + self.tc = tc + self.bca = bca + self.kca = kca + self.dtc = dtc + self.ka = ka + self.tsi = tsi + self.ksi = ksi + self.ttc = ttc + self.tfen = tfen + self.td = td + self.tt = tt + self.mxef = mxef + self.mnef = mnef + + def __str__(self): + str = 'class=GovGAST3\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovGAST4.py b/cimpy/cgmes_v3_0_0/GovGAST4.py new file mode 100644 index 00000000..8308e373 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovGAST4.py @@ -0,0 +1,61 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovGAST4(TurbineGovernorDynamics): + ''' + Generic turbogas. + + :bp: Droop (bp). Typical value = 0,05. Default: 0.0 + :ty: Time constant of fuel valve positioner (Ty) (>= 0). Typical value = 0,1. Default: 0 + :ta: Maximum gate opening velocity (TA) (>= 0). Typical value = 3. Default: 0 + :tc: Maximum gate closing velocity (TC) (>= 0). Typical value = 0,5. Default: 0 + :tcm: Fuel control time constant (Tcm) (>= 0). Typical value = 0,1. Default: 0 + :ktm: Compressor gain (Ktm). Typical value = 0. Default: 0.0 + :tm: Compressor discharge volume time constant (Tm) (>= 0). Typical value = 0,2. Default: 0 + :rymx: Maximum valve opening (RYMX). Typical value = 1,1. Default: 0.0 + :rymn: Minimum valve opening (RYMN). Typical value = 0. Default: 0.0 + :mxef: Fuel flow maximum positive error value (MXef). Typical value = 0,05. Default: 0.0 + :mnef: Fuel flow maximum negative error value (MNef). Typical value = -0,05. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'bp': [cgmesProfile.DY.value, ], + 'ty': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'tcm': [cgmesProfile.DY.value, ], + 'ktm': [cgmesProfile.DY.value, ], + 'tm': [cgmesProfile.DY.value, ], + 'rymx': [cgmesProfile.DY.value, ], + 'rymn': [cgmesProfile.DY.value, ], + 'mxef': [cgmesProfile.DY.value, ], + 'mnef': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, bp = 0.0, ty = 0, ta = 0, tc = 0, tcm = 0, ktm = 0.0, tm = 0, rymx = 0.0, rymn = 0.0, mxef = 0.0, mnef = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.bp = bp + self.ty = ty + self.ta = ta + self.tc = tc + self.tcm = tcm + self.ktm = ktm + self.tm = tm + self.rymx = rymx + self.rymn = rymn + self.mxef = mxef + self.mnef = mnef + + def __str__(self): + str = 'class=GovGAST4\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovGASTWD.py b/cimpy/cgmes_v3_0_0/GovGASTWD.py new file mode 100644 index 00000000..a3b3f912 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovGASTWD.py @@ -0,0 +1,127 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovGASTWD(TurbineGovernorDynamics): + ''' + Woodward™ gas turbine governor. [Footnote: Woodward gas turbines are an example of suitable products available commercially. This information is given for the convenience of users of this document and does not constitute an endorsement by IEC of these products.] + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :kdroop: (Kdroop) (>= 0). Default: 0.0 + :kp: PID proportional gain (Kp). Default: 0.0 + :ki: Isochronous Governor Gain (Ki). Default: 0.0 + :kd: Drop governor gain (Kd). Default: 0.0 + :etd: Turbine and exhaust delay (Etd) (>= 0). Default: 0 + :tcd: Compressor discharge time constant (Tcd) (>= 0). Default: 0 + :trate: Turbine rating (Trate). Unit = MW. Default: 0.0 + :t: Fuel control time constant (T) (>= 0). Default: 0 + :tmax: Maximum Turbine limit (Tmax) (> GovGASTWD.tmin). Default: 0.0 + :tmin: Minimum turbine limit (Tmin) (< GovGASTWD.tmax). Default: 0.0 + :ecr: Combustion reaction time delay (Ecr) (>= 0). Default: 0 + :k3: Ratio of fuel adjustment (K3). Default: 0.0 + :a: Valve positioner (A). Default: 0.0 + :b: Valve positioner (B). Default: 0.0 + :c: Valve positioner (C). Default: 0.0 + :tf: Fuel system time constant (Tf) (>= 0). Default: 0 + :kf: Fuel system feedback (Kf). Default: 0.0 + :k5: Gain of radiation shield (K5). Default: 0.0 + :k4: Gain of radiation shield (K4). Default: 0.0 + :t3: Radiation shield time constant (T3) (>= 0). Default: 0 + :t4: Thermocouple time constant (T4) (>= 0). Default: 0 + :tt: Temperature controller integration rate (Tt) (>= 0). Default: 0 + :t5: Temperature control time constant (T5) (>= 0). Default: 0 + :af1: Exhaust temperature parameter (Af1). Default: 0.0 + :bf1: (Bf1). Bf1 = E(1-w) where E (speed sensitivity coefficient) is 0,55 to 0,65 x Tr. Default: 0.0 + :af2: Coefficient equal to 0,5(1-speed) (Af2). Default: 0.0 + :bf2: Turbine torque coefficient Khhv (depends on heating value of fuel stream in combustion chamber) (Bf2). Default: 0.0 + :cf2: Coefficient defining fuel flow where power output is 0 % (Cf2). Synchronous but no output. Typically 0,23 x Khhv (23 % fuel flow). Default: 0.0 + :tr: Rated temperature (Tr). Default: 0.0 + :k6: Minimum fuel flow (K6). Default: 0.0 + :tc: Temperature control (Tc). Default: 0.0 + :td: Power transducer time constant (Td) (>= 0). Default: 0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'kdroop': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'etd': [cgmesProfile.DY.value, ], + 'tcd': [cgmesProfile.DY.value, ], + 'trate': [cgmesProfile.DY.value, ], + 't': [cgmesProfile.DY.value, ], + 'tmax': [cgmesProfile.DY.value, ], + 'tmin': [cgmesProfile.DY.value, ], + 'ecr': [cgmesProfile.DY.value, ], + 'k3': [cgmesProfile.DY.value, ], + 'a': [cgmesProfile.DY.value, ], + 'b': [cgmesProfile.DY.value, ], + 'c': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'k5': [cgmesProfile.DY.value, ], + 'k4': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 'tt': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 'af1': [cgmesProfile.DY.value, ], + 'bf1': [cgmesProfile.DY.value, ], + 'af2': [cgmesProfile.DY.value, ], + 'bf2': [cgmesProfile.DY.value, ], + 'cf2': [cgmesProfile.DY.value, ], + 'tr': [cgmesProfile.DY.value, ], + 'k6': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'td': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, kdroop = 0.0, kp = 0.0, ki = 0.0, kd = 0.0, etd = 0, tcd = 0, trate = 0.0, t = 0, tmax = 0.0, tmin = 0.0, ecr = 0, k3 = 0.0, a = 0.0, b = 0.0, c = 0.0, tf = 0, kf = 0.0, k5 = 0.0, k4 = 0.0, t3 = 0, t4 = 0, tt = 0, t5 = 0, af1 = 0.0, bf1 = 0.0, af2 = 0.0, bf2 = 0.0, cf2 = 0.0, tr = 0.0, k6 = 0.0, tc = 0.0, td = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.kdroop = kdroop + self.kp = kp + self.ki = ki + self.kd = kd + self.etd = etd + self.tcd = tcd + self.trate = trate + self.t = t + self.tmax = tmax + self.tmin = tmin + self.ecr = ecr + self.k3 = k3 + self.a = a + self.b = b + self.c = c + self.tf = tf + self.kf = kf + self.k5 = k5 + self.k4 = k4 + self.t3 = t3 + self.t4 = t4 + self.tt = tt + self.t5 = t5 + self.af1 = af1 + self.bf1 = bf1 + self.af2 = af2 + self.bf2 = bf2 + self.cf2 = cf2 + self.tr = tr + self.k6 = k6 + self.tc = tc + self.td = td + + def __str__(self): + str = 'class=GovGASTWD\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovHydro1.py b/cimpy/cgmes_v3_0_0/GovHydro1.py new file mode 100644 index 00000000..56725d35 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovHydro1.py @@ -0,0 +1,70 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovHydro1(TurbineGovernorDynamics): + ''' + Basic hydro turbine governor. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :rperm: Permanent droop (R) (> 0). Typical value = 0,04. Default: 0.0 + :rtemp: Temporary droop (r) (> GovHydro1.rperm). Typical value = 0,3. Default: 0.0 + :tr: Washout time constant (Tr) (> 0). Typical value = 5. Default: 0 + :tf: Filter time constant (Tf) (> 0). Typical value = 0,05. Default: 0 + :tg: Gate servo time constant (Tg) (> 0). Typical value = 0,5. Default: 0 + :velm: Maximum gate velocity (Vlem) (> 0). Typical value = 0,2. Default: 0.0 + :gmax: Maximum gate opening (Gmax) (> 0 and > GovHydro.gmin). Typical value = 1. Default: 0.0 + :gmin: Minimum gate opening (Gmin) (>= 0 and < GovHydro1.gmax). Typical value = 0. Default: 0.0 + :tw: Water inertia time constant (Tw) (> 0). Typical value = 1. Default: 0 + :at: Turbine gain (At) (> 0). Typical value = 1,2. Default: 0.0 + :dturb: Turbine damping factor (Dturb) (>= 0). Typical value = 0,5. Default: 0.0 + :qnl: No-load flow at nominal head (qnl) (>= 0). Typical value = 0,08. Default: 0.0 + :hdam: Turbine nominal head (hdam). Typical value = 1. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'rperm': [cgmesProfile.DY.value, ], + 'rtemp': [cgmesProfile.DY.value, ], + 'tr': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'tg': [cgmesProfile.DY.value, ], + 'velm': [cgmesProfile.DY.value, ], + 'gmax': [cgmesProfile.DY.value, ], + 'gmin': [cgmesProfile.DY.value, ], + 'tw': [cgmesProfile.DY.value, ], + 'at': [cgmesProfile.DY.value, ], + 'dturb': [cgmesProfile.DY.value, ], + 'qnl': [cgmesProfile.DY.value, ], + 'hdam': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, rperm = 0.0, rtemp = 0.0, tr = 0, tf = 0, tg = 0, velm = 0.0, gmax = 0.0, gmin = 0.0, tw = 0, at = 0.0, dturb = 0.0, qnl = 0.0, hdam = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.rperm = rperm + self.rtemp = rtemp + self.tr = tr + self.tf = tf + self.tg = tg + self.velm = velm + self.gmax = gmax + self.gmin = gmin + self.tw = tw + self.at = at + self.dturb = dturb + self.qnl = qnl + self.hdam = hdam + + def __str__(self): + str = 'class=GovHydro1\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovHydro2.py b/cimpy/cgmes_v3_0_0/GovHydro2.py new file mode 100644 index 00000000..cae6930f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovHydro2.py @@ -0,0 +1,115 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovHydro2(TurbineGovernorDynamics): + ''' + IEEE hydro turbine governor with straightforward penstock configuration and hydraulic-dashpot governor. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :tg: Gate servo time constant (Tg) (> 0). Typical value = 0,5. Default: 0 + :tp: Pilot servo valve time constant (Tp) (>= 0). Typical value = 0,03. Default: 0 + :uo: Maximum gate opening velocity (Uo). Unit = PU / s. Typical value = 0,1. Default: 0.0 + :uc: Maximum gate closing velocity (Uc) (< 0). Unit = PU / s. Typical value = -0,1. Default: 0.0 + :pmax: Maximum gate opening (Pmax) (> GovHydro2.pmin). Typical value = 1. Default: 0.0 + :pmin: Minimum gate opening (Pmin) (< GovHydro2.pmax). Typical value = 0. Default: 0.0 + :rperm: Permanent droop (Rperm). Typical value = 0,05. Default: 0.0 + :rtemp: Temporary droop (Rtemp). Typical value = 0,5. Default: 0.0 + :tr: Dashpot time constant (Tr) (>= 0). Typical value = 12. Default: 0 + :tw: Water inertia time constant (Tw) (>= 0). Typical value = 2. Default: 0 + :kturb: Turbine gain (Kturb). Typical value = 1. Default: 0.0 + :aturb: Turbine numerator multiplier (Aturb). Typical value = -1. Default: 0.0 + :bturb: Turbine denominator multiplier (Bturb) (> 0). Typical value = 0,5. Default: 0.0 + :db1: Intentional deadband width (db1). Unit = Hz. Typical value = 0. Default: 0.0 + :eps: Intentional db hysteresis (eps). Unit = Hz. Typical value = 0. Default: 0.0 + :db2: Unintentional deadband (db2). Unit = MW. Typical value = 0. Default: 0.0 + :gv1: Nonlinear gain point 1, PU gv (Gv1). Typical value = 0. Default: 0.0 + :pgv1: Nonlinear gain point 1, PU power (Pgv1). Typical value = 0. Default: 0.0 + :gv2: Nonlinear gain point 2, PU gv (Gv2). Typical value = 0. Default: 0.0 + :pgv2: Nonlinear gain point 2, PU power (Pgv2). Typical value = 0. Default: 0.0 + :gv3: Nonlinear gain point 3, PU gv (Gv3). Typical value = 0. Default: 0.0 + :pgv3: Nonlinear gain point 3, PU power (Pgv3). Typical value = 0. Default: 0.0 + :gv4: Nonlinear gain point 4, PU gv (Gv4). Typical value = 0. Default: 0.0 + :pgv4: Nonlinear gain point 4, PU power (Pgv4). Typical value = 0. Default: 0.0 + :gv5: Nonlinear gain point 5, PU gv (Gv5). Typical value = 0. Default: 0.0 + :pgv5: Nonlinear gain point 5, PU power (Pgv5). Typical value = 0. Default: 0.0 + :gv6: Nonlinear gain point 6, PU gv (Gv6). Typical value = 0. Default: 0.0 + :pgv6: Nonlinear gain point 6, PU power (Pgv6). Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'tg': [cgmesProfile.DY.value, ], + 'tp': [cgmesProfile.DY.value, ], + 'uo': [cgmesProfile.DY.value, ], + 'uc': [cgmesProfile.DY.value, ], + 'pmax': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + 'rperm': [cgmesProfile.DY.value, ], + 'rtemp': [cgmesProfile.DY.value, ], + 'tr': [cgmesProfile.DY.value, ], + 'tw': [cgmesProfile.DY.value, ], + 'kturb': [cgmesProfile.DY.value, ], + 'aturb': [cgmesProfile.DY.value, ], + 'bturb': [cgmesProfile.DY.value, ], + 'db1': [cgmesProfile.DY.value, ], + 'eps': [cgmesProfile.DY.value, ], + 'db2': [cgmesProfile.DY.value, ], + 'gv1': [cgmesProfile.DY.value, ], + 'pgv1': [cgmesProfile.DY.value, ], + 'gv2': [cgmesProfile.DY.value, ], + 'pgv2': [cgmesProfile.DY.value, ], + 'gv3': [cgmesProfile.DY.value, ], + 'pgv3': [cgmesProfile.DY.value, ], + 'gv4': [cgmesProfile.DY.value, ], + 'pgv4': [cgmesProfile.DY.value, ], + 'gv5': [cgmesProfile.DY.value, ], + 'pgv5': [cgmesProfile.DY.value, ], + 'gv6': [cgmesProfile.DY.value, ], + 'pgv6': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, tg = 0, tp = 0, uo = 0.0, uc = 0.0, pmax = 0.0, pmin = 0.0, rperm = 0.0, rtemp = 0.0, tr = 0, tw = 0, kturb = 0.0, aturb = 0.0, bturb = 0.0, db1 = 0.0, eps = 0.0, db2 = 0.0, gv1 = 0.0, pgv1 = 0.0, gv2 = 0.0, pgv2 = 0.0, gv3 = 0.0, pgv3 = 0.0, gv4 = 0.0, pgv4 = 0.0, gv5 = 0.0, pgv5 = 0.0, gv6 = 0.0, pgv6 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.tg = tg + self.tp = tp + self.uo = uo + self.uc = uc + self.pmax = pmax + self.pmin = pmin + self.rperm = rperm + self.rtemp = rtemp + self.tr = tr + self.tw = tw + self.kturb = kturb + self.aturb = aturb + self.bturb = bturb + self.db1 = db1 + self.eps = eps + self.db2 = db2 + self.gv1 = gv1 + self.pgv1 = pgv1 + self.gv2 = gv2 + self.pgv2 = pgv2 + self.gv3 = gv3 + self.pgv3 = pgv3 + self.gv4 = gv4 + self.pgv4 = pgv4 + self.gv5 = gv5 + self.pgv5 = pgv5 + self.gv6 = gv6 + self.pgv6 = pgv6 + + def __str__(self): + str = 'class=GovHydro2\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovHydro3.py b/cimpy/cgmes_v3_0_0/GovHydro3.py new file mode 100644 index 00000000..a93884a6 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovHydro3.py @@ -0,0 +1,136 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovHydro3(TurbineGovernorDynamics): + ''' + Modified IEEE hydro governor-turbine. This model differs from that defined in the IEEE modelling guideline paper in that the limits on gate position and velocity do not permit "wind up" of the upstream signals. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :pmax: Maximum gate opening, PU of MWbase (Pmax) (> GovHydro3.pmin). Typical value = 1. Default: 0.0 + :pmin: Minimum gate opening, PU of MWbase (Pmin) (< GovHydro3.pmax). Typical value = 0. Default: 0.0 + :governorControl: Governor control flag (Cflag). true = PID control is active false = double derivative control is active. Typical value = true. Default: False + :rgate: Steady-state droop, PU, for governor output feedback (Rgate). Typical value = 0. Default: 0.0 + :relec: Steady-state droop, PU, for electrical power feedback (Relec). Typical value = 0,05. Default: 0.0 + :td: Input filter time constant (Td) (>= 0). Typical value = 0,05. Default: 0 + :tf: Washout time constant (Tf) (>= 0). Typical value = 0,1. Default: 0 + :tp: Gate servo time constant (Tp) (>= 0). Typical value = 0,05. Default: 0 + :velop: Maximum gate opening velocity (Velop). Unit = PU / s. Typical value = 0,2. Default: 0.0 + :velcl: Maximum gate closing velocity (Velcl). Unit = PU / s. Typical value = -0,2. Default: 0.0 + :k1: Derivative gain (K1). Typical value = 0,01. Default: 0.0 + :k2: Double derivative gain, if Cflag = -1 (K2). Typical value = 2,5. Default: 0.0 + :ki: Integral gain (Ki). Typical value = 0,5. Default: 0.0 + :kg: Gate servo gain (Kg). Typical value = 2. Default: 0.0 + :tt: Power feedback time constant (Tt) (>= 0). Typical value = 0,2. Default: 0 + :db1: Intentional dead-band width (db1). Unit = Hz. Typical value = 0. Default: 0.0 + :eps: Intentional db hysteresis (eps). Unit = Hz. Typical value = 0. Default: 0.0 + :db2: Unintentional dead-band (db2). Unit = MW. Typical value = 0. Default: 0.0 + :tw: Water inertia time constant (Tw) (>= 0). If = 0, block is bypassed. Typical value = 1. Default: 0 + :at: Turbine gain (At) (>0). Typical value = 1,2. Default: 0.0 + :dturb: Turbine damping factor (Dturb). Typical value = 0,2. Default: 0.0 + :qnl: No-load turbine flow at nominal head (Qnl). Typical value = 0,08. Default: 0.0 + :h0: Turbine nominal head (H0). Typical value = 1. Default: 0.0 + :gv1: Nonlinear gain point 1, PU gv (Gv1). Typical value = 0. Default: 0.0 + :pgv1: Nonlinear gain point 1, PU power (Pgv1). Typical value = 0. Default: 0.0 + :gv2: Nonlinear gain point 2, PU gv (Gv2). Typical value = 0. Default: 0.0 + :pgv2: Nonlinear gain point 2, PU power (Pgv2). Typical value = 0. Default: 0.0 + :gv3: Nonlinear gain point 3, PU gv (Gv3). Typical value = 0. Default: 0.0 + :pgv3: Nonlinear gain point 3, PU power (Pgv3). Typical value = 0. Default: 0.0 + :gv4: Nonlinear gain point 4, PU gv (Gv4). Typical value = 0. Default: 0.0 + :pgv4: Nonlinear gain point 4, PU power (Pgv4). Typical value = 0. Default: 0.0 + :gv5: Nonlinear gain point 5, PU gv (Gv5). Typical value = 0. Default: 0.0 + :pgv5: Nonlinear gain point 5, PU power (Pgv5). Typical value = 0. Default: 0.0 + :gv6: Nonlinear gain point 6, PU gv (Gv6). Typical value = 0. Default: 0.0 + :pgv6: Nonlinear gain point 6, PU power (Pgv6). Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'pmax': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + 'governorControl': [cgmesProfile.DY.value, ], + 'rgate': [cgmesProfile.DY.value, ], + 'relec': [cgmesProfile.DY.value, ], + 'td': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'tp': [cgmesProfile.DY.value, ], + 'velop': [cgmesProfile.DY.value, ], + 'velcl': [cgmesProfile.DY.value, ], + 'k1': [cgmesProfile.DY.value, ], + 'k2': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'kg': [cgmesProfile.DY.value, ], + 'tt': [cgmesProfile.DY.value, ], + 'db1': [cgmesProfile.DY.value, ], + 'eps': [cgmesProfile.DY.value, ], + 'db2': [cgmesProfile.DY.value, ], + 'tw': [cgmesProfile.DY.value, ], + 'at': [cgmesProfile.DY.value, ], + 'dturb': [cgmesProfile.DY.value, ], + 'qnl': [cgmesProfile.DY.value, ], + 'h0': [cgmesProfile.DY.value, ], + 'gv1': [cgmesProfile.DY.value, ], + 'pgv1': [cgmesProfile.DY.value, ], + 'gv2': [cgmesProfile.DY.value, ], + 'pgv2': [cgmesProfile.DY.value, ], + 'gv3': [cgmesProfile.DY.value, ], + 'pgv3': [cgmesProfile.DY.value, ], + 'gv4': [cgmesProfile.DY.value, ], + 'pgv4': [cgmesProfile.DY.value, ], + 'gv5': [cgmesProfile.DY.value, ], + 'pgv5': [cgmesProfile.DY.value, ], + 'gv6': [cgmesProfile.DY.value, ], + 'pgv6': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, pmax = 0.0, pmin = 0.0, governorControl = False, rgate = 0.0, relec = 0.0, td = 0, tf = 0, tp = 0, velop = 0.0, velcl = 0.0, k1 = 0.0, k2 = 0.0, ki = 0.0, kg = 0.0, tt = 0, db1 = 0.0, eps = 0.0, db2 = 0.0, tw = 0, at = 0.0, dturb = 0.0, qnl = 0.0, h0 = 0.0, gv1 = 0.0, pgv1 = 0.0, gv2 = 0.0, pgv2 = 0.0, gv3 = 0.0, pgv3 = 0.0, gv4 = 0.0, pgv4 = 0.0, gv5 = 0.0, pgv5 = 0.0, gv6 = 0.0, pgv6 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.pmax = pmax + self.pmin = pmin + self.governorControl = governorControl + self.rgate = rgate + self.relec = relec + self.td = td + self.tf = tf + self.tp = tp + self.velop = velop + self.velcl = velcl + self.k1 = k1 + self.k2 = k2 + self.ki = ki + self.kg = kg + self.tt = tt + self.db1 = db1 + self.eps = eps + self.db2 = db2 + self.tw = tw + self.at = at + self.dturb = dturb + self.qnl = qnl + self.h0 = h0 + self.gv1 = gv1 + self.pgv1 = pgv1 + self.gv2 = gv2 + self.pgv2 = pgv2 + self.gv3 = gv3 + self.pgv3 = pgv3 + self.gv4 = gv4 + self.pgv4 = pgv4 + self.gv5 = gv5 + self.pgv5 = pgv5 + self.gv6 = gv6 + self.pgv6 = pgv6 + + def __str__(self): + str = 'class=GovHydro3\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovHydro4.py b/cimpy/cgmes_v3_0_0/GovHydro4.py new file mode 100644 index 00000000..8e75dd5d --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovHydro4.py @@ -0,0 +1,145 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovHydro4(TurbineGovernorDynamics): + ''' + Hydro turbine and governor. Represents plants with straight-forward penstock configurations and hydraulic governors of the traditional 'dashpot' type. This model can be used to represent simple, Francis/Pelton or Kaplan turbines. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :tg: Gate servo time constant (Tg) (> 0). Typical value = 0,5. Default: 0 + :tp: Pilot servo time constant (Tp) (>= 0). Typical value = 0,1. Default: 0 + :uo: Max gate opening velocity (Uo). Typical value = 0,2. Default: 0.0 + :uc: Max gate closing velocity (Uc). Typical value = 0,2. Default: 0.0 + :gmax: Maximum gate opening, PU of MWbase (Gmax) (> GovHydro4.gmin). Typical value = 1. Default: 0.0 + :gmin: Minimum gate opening, PU of MWbase (Gmin) (< GovHydro4.gmax). Typical value = 0. Default: 0.0 + :rperm: Permanent droop (Rperm) (>= 0). Typical value = 0,05. Default: 0 + :rtemp: Temporary droop (Rtemp) (>= 0). Typical value = 0,3. Default: 0 + :tr: Dashpot time constant (Tr) (>= 0). Typical value = 5. Default: 0 + :tw: Water inertia time constant (Tw) (> 0). Typical value = 1. Default: 0 + :at: Turbine gain (At). Typical value = 1,2. Default: 0.0 + :dturb: Turbine damping factor (Dturb). Unit = delta P (PU of MWbase) / delta speed (PU). Typical value for simple = 0,5, Francis/Pelton = 1,1, Kaplan = 1,1. Default: 0.0 + :hdam: Head available at dam (hdam). Typical value = 1. Default: 0.0 + :qnl: No-load flow at nominal head (Qnl). Typical value for simple = 0,08, Francis/Pelton = 0, Kaplan = 0. Default: 0.0 + :db1: Intentional deadband width (db1). Unit = Hz. Typical value = 0. Default: 0.0 + :eps: Intentional db hysteresis (eps). Unit = Hz. Typical value = 0. Default: 0.0 + :db2: Unintentional dead-band (db2). Unit = MW. Typical value = 0. Default: 0.0 + :gv0: Nonlinear gain point 0, PU gv (Gv0) (= 0 for simple). Typical for Francis/Pelton = 0,1, Kaplan = 0,1. Default: 0.0 + :pgv0: Nonlinear gain point 0, PU power (Pgv0) (= 0 for simple). Typical value = 0. Default: 0.0 + :gv1: Nonlinear gain point 1, PU gv (Gv1) (= 0 for simple, > GovHydro4.gv0 for Francis/Pelton and Kaplan). Typical value for Francis/Pelton = 0,4, Kaplan = 0,4. Default: 0.0 + :pgv1: Nonlinear gain point 1, PU power (Pgv1) (= 0 for simple). Typical value for Francis/Pelton = 0,42, Kaplan = 0,35. Default: 0.0 + :gv2: Nonlinear gain point 2, PU gv (Gv2) (= 0 for simple, > GovHydro4.gv1 for Francis/Pelton and Kaplan). Typical value for Francis/Pelton = 0,5, Kaplan = 0,5. Default: 0.0 + :pgv2: Nonlinear gain point 2, PU power (Pgv2) (= 0 for simple). Typical value for Francis/Pelton = 0,56, Kaplan = 0,468. Default: 0.0 + :gv3: Nonlinear gain point 3, PU gv (Gv3) (= 0 for simple, > GovHydro4.gv2 for Francis/Pelton and Kaplan). Typical value for Francis/Pelton = 0,7, Kaplan = 0,7. Default: 0.0 + :pgv3: Nonlinear gain point 3, PU power (Pgv3) (= 0 for simple). Typical value for Francis/Pelton = 0,8, Kaplan = 0,796. Default: 0.0 + :gv4: Nonlinear gain point 4, PU gv (Gv4) (= 0 for simple, > GovHydro4.gv3 for Francis/Pelton and Kaplan). Typical value for Francis/Pelton = 0,8, Kaplan = 0,8. Default: 0.0 + :pgv4: Nonlinear gain point 4, PU power (Pgv4) (= 0 for simple). Typical value for Francis/Pelton = 0,9, Kaplan = 0,917. Default: 0.0 + :gv5: Nonlinear gain point 5, PU gv (Gv5) (= 0 for simple, < 1 and > GovHydro4.gv4 for Francis/Pelton and Kaplan). Typical value for Francis/Pelton = 0,9, Kaplan = 0,9. Default: 0.0 + :pgv5: Nonlinear gain point 5, PU power (Pgv5) (= 0 for simple). Typical value for Francis/Pelton = 0,97, Kaplan = 0,99. Default: 0.0 + :bgv0: Kaplan blade servo point 0 (Bgv0) (= 0 for simple, = 0 for Francis/Pelton). Typical value for Kaplan = 0. Default: 0.0 + :bgv1: Kaplan blade servo point 1 (Bgv1) (= 0 for simple, = 0 for Francis/Pelton). Typical value for Kaplan = 0. Default: 0.0 + :bgv2: Kaplan blade servo point 2 (Bgv2) (= 0 for simple, = 0 for Francis/Pelton). Typical value for Kaplan = 0,1. Default: 0.0 + :bgv3: Kaplan blade servo point 3 (Bgv3) (= 0 for simple, = 0 for Francis/Pelton). Typical value for Kaplan = 0,667. Default: 0.0 + :bgv4: Kaplan blade servo point 4 (Bgv4) (= 0 for simple, = 0 for Francis/Pelton). Typical value for Kaplan = 0,9. Default: 0.0 + :bgv5: Kaplan blade servo point 5 (Bgv5) (= 0 for simple, = 0 for Francis/Pelton). Typical value for Kaplan = 1. Default: 0.0 + :bmax: Maximum blade adjustment factor (Bmax) (= 0 for simple, = 0 for Francis/Pelton). Typical value for Kaplan = 1,1276. Default: 0.0 + :tblade: Blade servo time constant (Tblade) (>= 0). Typical value = 100. Default: 0 + :model: The kind of model being represented (simple, Francis/Pelton or Kaplan). Default: None + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'tg': [cgmesProfile.DY.value, ], + 'tp': [cgmesProfile.DY.value, ], + 'uo': [cgmesProfile.DY.value, ], + 'uc': [cgmesProfile.DY.value, ], + 'gmax': [cgmesProfile.DY.value, ], + 'gmin': [cgmesProfile.DY.value, ], + 'rperm': [cgmesProfile.DY.value, ], + 'rtemp': [cgmesProfile.DY.value, ], + 'tr': [cgmesProfile.DY.value, ], + 'tw': [cgmesProfile.DY.value, ], + 'at': [cgmesProfile.DY.value, ], + 'dturb': [cgmesProfile.DY.value, ], + 'hdam': [cgmesProfile.DY.value, ], + 'qnl': [cgmesProfile.DY.value, ], + 'db1': [cgmesProfile.DY.value, ], + 'eps': [cgmesProfile.DY.value, ], + 'db2': [cgmesProfile.DY.value, ], + 'gv0': [cgmesProfile.DY.value, ], + 'pgv0': [cgmesProfile.DY.value, ], + 'gv1': [cgmesProfile.DY.value, ], + 'pgv1': [cgmesProfile.DY.value, ], + 'gv2': [cgmesProfile.DY.value, ], + 'pgv2': [cgmesProfile.DY.value, ], + 'gv3': [cgmesProfile.DY.value, ], + 'pgv3': [cgmesProfile.DY.value, ], + 'gv4': [cgmesProfile.DY.value, ], + 'pgv4': [cgmesProfile.DY.value, ], + 'gv5': [cgmesProfile.DY.value, ], + 'pgv5': [cgmesProfile.DY.value, ], + 'bgv0': [cgmesProfile.DY.value, ], + 'bgv1': [cgmesProfile.DY.value, ], + 'bgv2': [cgmesProfile.DY.value, ], + 'bgv3': [cgmesProfile.DY.value, ], + 'bgv4': [cgmesProfile.DY.value, ], + 'bgv5': [cgmesProfile.DY.value, ], + 'bmax': [cgmesProfile.DY.value, ], + 'tblade': [cgmesProfile.DY.value, ], + 'model': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, tg = 0, tp = 0, uo = 0.0, uc = 0.0, gmax = 0.0, gmin = 0.0, rperm = 0, rtemp = 0, tr = 0, tw = 0, at = 0.0, dturb = 0.0, hdam = 0.0, qnl = 0.0, db1 = 0.0, eps = 0.0, db2 = 0.0, gv0 = 0.0, pgv0 = 0.0, gv1 = 0.0, pgv1 = 0.0, gv2 = 0.0, pgv2 = 0.0, gv3 = 0.0, pgv3 = 0.0, gv4 = 0.0, pgv4 = 0.0, gv5 = 0.0, pgv5 = 0.0, bgv0 = 0.0, bgv1 = 0.0, bgv2 = 0.0, bgv3 = 0.0, bgv4 = 0.0, bgv5 = 0.0, bmax = 0.0, tblade = 0, model = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.tg = tg + self.tp = tp + self.uo = uo + self.uc = uc + self.gmax = gmax + self.gmin = gmin + self.rperm = rperm + self.rtemp = rtemp + self.tr = tr + self.tw = tw + self.at = at + self.dturb = dturb + self.hdam = hdam + self.qnl = qnl + self.db1 = db1 + self.eps = eps + self.db2 = db2 + self.gv0 = gv0 + self.pgv0 = pgv0 + self.gv1 = gv1 + self.pgv1 = pgv1 + self.gv2 = gv2 + self.pgv2 = pgv2 + self.gv3 = gv3 + self.pgv3 = pgv3 + self.gv4 = gv4 + self.pgv4 = pgv4 + self.gv5 = gv5 + self.pgv5 = pgv5 + self.bgv0 = bgv0 + self.bgv1 = bgv1 + self.bgv2 = bgv2 + self.bgv3 = bgv3 + self.bgv4 = bgv4 + self.bgv5 = bgv5 + self.bmax = bmax + self.tblade = tblade + self.model = model + + def __str__(self): + str = 'class=GovHydro4\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovHydro4ModelKind.py b/cimpy/cgmes_v3_0_0/GovHydro4ModelKind.py new file mode 100644 index 00000000..aaae8c30 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovHydro4ModelKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class GovHydro4ModelKind(Base): + ''' + Possible types of GovHydro4 models. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=GovHydro4ModelKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovHydroDD.py b/cimpy/cgmes_v3_0_0/GovHydroDD.py new file mode 100644 index 00000000..1f8c217d --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovHydroDD.py @@ -0,0 +1,133 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovHydroDD(TurbineGovernorDynamics): + ''' + Double derivative hydro governor and turbine. + + :mwbase: Base for power values (MWbase) (>0). Unit = MW. Default: 0.0 + :pmax: Maximum gate opening, PU of MWbase (Pmax) (> GovHydroDD.pmin). Typical value = 1. Default: 0.0 + :pmin: Minimum gate opening, PU of MWbase (Pmin) (> GovHydroDD.pmax). Typical value = 0. Default: 0.0 + :r: Steady state droop (R). Typical value = 0,05. Default: 0.0 + :td: Input filter time constant (Td) (>= 0). If = 0, block is bypassed. Typical value = 0. Default: 0 + :tf: Washout time constant (Tf) (>= 0). Typical value = 0,1. Default: 0 + :tp: Gate servo time constant (Tp) (>= 0). If = 0, block is bypassed. Typical value = 0,35. Default: 0 + :velop: Maximum gate opening velocity (Velop). Unit = PU / s. Typical value = 0,09. Default: 0.0 + :velcl: Maximum gate closing velocity (Velcl). Unit = PU / s. Typical value = -0,14. Default: 0.0 + :k1: Single derivative gain (K1). Typical value = 3,6. Default: 0.0 + :k2: Double derivative gain (K2). Typical value = 0,2. Default: 0.0 + :ki: Integral gain (Ki). Typical value = 1. Default: 0.0 + :kg: Gate servo gain (Kg). Typical value = 3. Default: 0.0 + :tturb: Turbine time constant (Tturb) (>= 0). See parameter detail 3. Typical value = 0,8. Default: 0 + :aturb: Turbine numerator multiplier (Aturb) (see parameter detail 3). Typical value = -1. Default: 0.0 + :bturb: Turbine denominator multiplier (Bturb) (see parameter detail 3). Typical value = 0,5. Default: 0.0 + :tt: Power feedback time constant (Tt) (>= 0). If = 0, block is bypassed. Typical value = 0,02. Default: 0 + :db1: Intentional dead-band width (db1). Unit = Hz. Typical value = 0. Default: 0.0 + :eps: Intentional db hysteresis (eps). Unit = Hz. Typical value = 0. Default: 0.0 + :db2: Unintentional dead-band (db2). Unit = MW. Typical value = 0. Default: 0.0 + :gv1: Nonlinear gain point 1, PU gv (Gv1). Typical value = 0. Default: 0.0 + :pgv1: Nonlinear gain point 1, PU power (Pgv1). Typical value = 0. Default: 0.0 + :gv2: Nonlinear gain point 2, PU gv (Gv2). Typical value = 0. Default: 0.0 + :pgv2: Nonlinear gain point 2, PU power (Pgv2). Typical value = 0. Default: 0.0 + :gv3: Nonlinear gain point 3, PU gv (Gv3). Typical value = 0. Default: 0.0 + :pgv3: Nonlinear gain point 3, PU power (Pgv3). Typical value = 0. Default: 0.0 + :gv4: Nonlinear gain point 4, PU gv (Gv4). Typical value = 0. Default: 0.0 + :pgv4: Nonlinear gain point 4, PU power (Pgv4). Typical value = 0. Default: 0.0 + :gv5: Nonlinear gain point 5, PU gv (Gv5). Typical value = 0. Default: 0.0 + :pgv5: Nonlinear gain point 5, PU power (Pgv5). Typical value = 0. Default: 0.0 + :gv6: Nonlinear gain point 6, PU gv (Gv6). Typical value = 0. Default: 0.0 + :pgv6: Nonlinear gain point 6, PU power (Pgv6). Typical value = 0. Default: 0.0 + :gmax: Maximum gate opening (Gmax) (> GovHydroDD.gmin). Typical value = 0. Default: 0.0 + :gmin: Minimum gate opening (Gmin) (< GovHydroDD.gmax). Typical value = 0. Default: 0.0 + :inputSignal: Input signal switch (Flag). true = Pe input is used false = feedback is received from CV. Flag is normally dependent on Tt. If Tt is zero, Flag is set to false. If Tt is not zero, Flag is set to true. Typical value = true. Default: False + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'pmax': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + 'r': [cgmesProfile.DY.value, ], + 'td': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'tp': [cgmesProfile.DY.value, ], + 'velop': [cgmesProfile.DY.value, ], + 'velcl': [cgmesProfile.DY.value, ], + 'k1': [cgmesProfile.DY.value, ], + 'k2': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'kg': [cgmesProfile.DY.value, ], + 'tturb': [cgmesProfile.DY.value, ], + 'aturb': [cgmesProfile.DY.value, ], + 'bturb': [cgmesProfile.DY.value, ], + 'tt': [cgmesProfile.DY.value, ], + 'db1': [cgmesProfile.DY.value, ], + 'eps': [cgmesProfile.DY.value, ], + 'db2': [cgmesProfile.DY.value, ], + 'gv1': [cgmesProfile.DY.value, ], + 'pgv1': [cgmesProfile.DY.value, ], + 'gv2': [cgmesProfile.DY.value, ], + 'pgv2': [cgmesProfile.DY.value, ], + 'gv3': [cgmesProfile.DY.value, ], + 'pgv3': [cgmesProfile.DY.value, ], + 'gv4': [cgmesProfile.DY.value, ], + 'pgv4': [cgmesProfile.DY.value, ], + 'gv5': [cgmesProfile.DY.value, ], + 'pgv5': [cgmesProfile.DY.value, ], + 'gv6': [cgmesProfile.DY.value, ], + 'pgv6': [cgmesProfile.DY.value, ], + 'gmax': [cgmesProfile.DY.value, ], + 'gmin': [cgmesProfile.DY.value, ], + 'inputSignal': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, pmax = 0.0, pmin = 0.0, r = 0.0, td = 0, tf = 0, tp = 0, velop = 0.0, velcl = 0.0, k1 = 0.0, k2 = 0.0, ki = 0.0, kg = 0.0, tturb = 0, aturb = 0.0, bturb = 0.0, tt = 0, db1 = 0.0, eps = 0.0, db2 = 0.0, gv1 = 0.0, pgv1 = 0.0, gv2 = 0.0, pgv2 = 0.0, gv3 = 0.0, pgv3 = 0.0, gv4 = 0.0, pgv4 = 0.0, gv5 = 0.0, pgv5 = 0.0, gv6 = 0.0, pgv6 = 0.0, gmax = 0.0, gmin = 0.0, inputSignal = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.pmax = pmax + self.pmin = pmin + self.r = r + self.td = td + self.tf = tf + self.tp = tp + self.velop = velop + self.velcl = velcl + self.k1 = k1 + self.k2 = k2 + self.ki = ki + self.kg = kg + self.tturb = tturb + self.aturb = aturb + self.bturb = bturb + self.tt = tt + self.db1 = db1 + self.eps = eps + self.db2 = db2 + self.gv1 = gv1 + self.pgv1 = pgv1 + self.gv2 = gv2 + self.pgv2 = pgv2 + self.gv3 = gv3 + self.pgv3 = pgv3 + self.gv4 = gv4 + self.pgv4 = pgv4 + self.gv5 = gv5 + self.pgv5 = pgv5 + self.gv6 = gv6 + self.pgv6 = pgv6 + self.gmax = gmax + self.gmin = gmin + self.inputSignal = inputSignal + + def __str__(self): + str = 'class=GovHydroDD\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovHydroFrancis.py b/cimpy/cgmes_v3_0_0/GovHydroFrancis.py new file mode 100644 index 00000000..4840c2bf --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovHydroFrancis.py @@ -0,0 +1,109 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovHydroFrancis(TurbineGovernorDynamics): + ''' + Detailed hydro unit - Francis model. This model can be used to represent three types of governors. A schematic of the hydraulic system of detailed hydro unit models, such as Francis and Pelton, is provided in the DetailedHydroModelHydraulicSystem diagram. + + :am: Opening section SEFF at the maximum efficiency (Am). Typical value = 0,7. Default: 0.0 + :av0: Area of the surge tank (AV0). Unit = m2. Typical value = 30. Default: 0.0 + :av1: Area of the compensation tank (AV1). Unit = m2. Typical value = 700. Default: 0.0 + :bp: Droop (Bp). Typical value = 0,05. Default: 0.0 + :db1: Intentional dead-band width (DB1). Unit = Hz. Typical value = 0. Default: 0.0 + :etamax: Maximum efficiency (EtaMax). Typical value = 1,05. Default: 0.0 + :governorControl: Governor control flag (Cflag). Typical value = mechanicHydrolicTachoAccelerator. Default: None + :h1: Head of compensation chamber water level with respect to the level of penstock (H1). Unit = km. Typical value = 0,004. Default: 0.0 + :h2: Head of surge tank water level with respect to the level of penstock (H2). Unit = km. Typical value = 0,040. Default: 0.0 + :hn: Rated hydraulic head (Hn). Unit = km. Typical value = 0,250. Default: 0.0 + :kc: Penstock loss coefficient (due to friction) (Kc). Typical value = 0,025. Default: 0.0 + :kg: Water tunnel and surge chamber loss coefficient (due to friction) (Kg). Typical value = 0,025. Default: 0.0 + :kt: Washout gain (Kt). Typical value = 0,25. Default: 0.0 + :qc0: No-load turbine flow at nominal head (Qc0). Typical value = 0,1. Default: 0.0 + :qn: Rated flow (Qn). Unit = m3/s. Typical value = 250. Default: 0.0 + :ta: Derivative gain (Ta) (>= 0). Typical value = 3. Default: 0 + :td: Washout time constant (Td) (>= 0). Typical value = 6. Default: 0 + :ts: Gate servo time constant (Ts) (>= 0). Typical value = 0,5. Default: 0 + :twnc: Water inertia time constant (Twnc) (>= 0). Typical value = 1. Default: 0 + :twng: Water tunnel and surge chamber inertia time constant (Twng) (>= 0). Typical value = 3. Default: 0 + :tx: Derivative feedback gain (Tx) (>= 0). Typical value = 1. Default: 0 + :va: Maximum gate opening velocity (Va). Unit = PU / s. Typical value = 0,06. Default: 0.0 + :valvmax: Maximum gate opening (ValvMax) (> GovHydroFrancis.valvmin). Typical value = 1,1. Default: 0.0 + :valvmin: Minimum gate opening (ValvMin) (< GovHydroFrancis.valvmax). Typical value = 0. Default: 0.0 + :vc: Maximum gate closing velocity (Vc). Unit = PU / s. Typical value = -0,06. Default: 0.0 + :waterTunnelSurgeChamberSimulation: Water tunnel and surge chamber simulation (Tflag). true = enable of water tunnel and surge chamber simulation false = inhibit of water tunnel and surge chamber simulation. Typical value = false. Default: False + :zsfc: Head of upper water level with respect to the level of penstock (Zsfc). Unit = km. Typical value = 0,025. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'am': [cgmesProfile.DY.value, ], + 'av0': [cgmesProfile.DY.value, ], + 'av1': [cgmesProfile.DY.value, ], + 'bp': [cgmesProfile.DY.value, ], + 'db1': [cgmesProfile.DY.value, ], + 'etamax': [cgmesProfile.DY.value, ], + 'governorControl': [cgmesProfile.DY.value, ], + 'h1': [cgmesProfile.DY.value, ], + 'h2': [cgmesProfile.DY.value, ], + 'hn': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kg': [cgmesProfile.DY.value, ], + 'kt': [cgmesProfile.DY.value, ], + 'qc0': [cgmesProfile.DY.value, ], + 'qn': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'td': [cgmesProfile.DY.value, ], + 'ts': [cgmesProfile.DY.value, ], + 'twnc': [cgmesProfile.DY.value, ], + 'twng': [cgmesProfile.DY.value, ], + 'tx': [cgmesProfile.DY.value, ], + 'va': [cgmesProfile.DY.value, ], + 'valvmax': [cgmesProfile.DY.value, ], + 'valvmin': [cgmesProfile.DY.value, ], + 'vc': [cgmesProfile.DY.value, ], + 'waterTunnelSurgeChamberSimulation': [cgmesProfile.DY.value, ], + 'zsfc': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, am = 0.0, av0 = 0.0, av1 = 0.0, bp = 0.0, db1 = 0.0, etamax = 0.0, governorControl = None, h1 = 0.0, h2 = 0.0, hn = 0.0, kc = 0.0, kg = 0.0, kt = 0.0, qc0 = 0.0, qn = 0.0, ta = 0, td = 0, ts = 0, twnc = 0, twng = 0, tx = 0, va = 0.0, valvmax = 0.0, valvmin = 0.0, vc = 0.0, waterTunnelSurgeChamberSimulation = False, zsfc = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.am = am + self.av0 = av0 + self.av1 = av1 + self.bp = bp + self.db1 = db1 + self.etamax = etamax + self.governorControl = governorControl + self.h1 = h1 + self.h2 = h2 + self.hn = hn + self.kc = kc + self.kg = kg + self.kt = kt + self.qc0 = qc0 + self.qn = qn + self.ta = ta + self.td = td + self.ts = ts + self.twnc = twnc + self.twng = twng + self.tx = tx + self.va = va + self.valvmax = valvmax + self.valvmin = valvmin + self.vc = vc + self.waterTunnelSurgeChamberSimulation = waterTunnelSurgeChamberSimulation + self.zsfc = zsfc + + def __str__(self): + str = 'class=GovHydroFrancis\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovHydroIEEE0.py b/cimpy/cgmes_v3_0_0/GovHydroIEEE0.py new file mode 100644 index 00000000..24240527 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovHydroIEEE0.py @@ -0,0 +1,52 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovHydroIEEE0(TurbineGovernorDynamics): + ''' + IEEE simplified hydro governor-turbine model. Used for mechanical-hydraulic and electro-hydraulic turbine governors, with or without steam feedback. Typical values given are for mechanical-hydraulic turbine-governor. Reference: IEEE Transactions on Power Apparatus and Systems, November/December 1973, Volume PAS-92, Number 6, Dynamic Models for Steam and Hydro Turbines in Power System Studies, page 1904. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :k: Governor gain (K). Default: 0.0 + :t1: Governor lag time constant (T1) (>= 0). Typical value = 0,25. Default: 0 + :t2: Governor lead time constant (T2) (>= 0). Typical value = 0. Default: 0 + :t3: Gate actuator time constant (T3) (>= 0). Typical value = 0,1. Default: 0 + :t4: Water starting time (T4) (>= 0). Default: 0 + :pmax: Gate maximum (Pmax) (> GovHydroIEEE0.pmin). Default: 0.0 + :pmin: Gate minimum (Pmin) (< GovHydroIEEE.pmax). Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'k': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 'pmax': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, k = 0.0, t1 = 0, t2 = 0, t3 = 0, t4 = 0, pmax = 0.0, pmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.k = k + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.t4 = t4 + self.pmax = pmax + self.pmin = pmin + + def __str__(self): + str = 'class=GovHydroIEEE0\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovHydroIEEE2.py b/cimpy/cgmes_v3_0_0/GovHydroIEEE2.py new file mode 100644 index 00000000..a45f24f1 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovHydroIEEE2.py @@ -0,0 +1,106 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovHydroIEEE2(TurbineGovernorDynamics): + ''' + IEEE hydro turbine governor model represents plants with straightforward penstock configurations and hydraulic-dashpot governors. Reference: IEEE Transactions on Power Apparatus and Systems, November/December 1973, Volume PAS-92, Number 6, Dynamic Models for Steam and Hydro Turbines in Power System Studies, page 1904. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :tg: Gate servo time constant (Tg) (>= 0). Typical value = 0,5. Default: 0 + :tp: Pilot servo valve time constant (Tp) (>= 0). Typical value = 0,03. Default: 0 + :uo: Maximum gate opening velocity (Uo). Unit = PU / s. Typical value = 0,1. Default: 0.0 + :uc: Maximum gate closing velocity (Uc) (<0). Typical value = -0,1. Default: 0.0 + :pmax: Maximum gate opening (Pmax) (> GovHydroIEEE2.pmin). Typical value = 1. Default: 0.0 + :pmin: Minimum gate opening (Pmin) (<GovHydroIEEE2.pmax). Typical value = 0. Default: 0.0 + :rperm: Permanent droop (Rperm). Typical value = 0,05. Default: 0.0 + :rtemp: Temporary droop (Rtemp). Typical value = 0,5. Default: 0.0 + :tr: Dashpot time constant (Tr) (>= 0). Typical value = 12. Default: 0 + :tw: Water inertia time constant (Tw) (>= 0). Typical value = 2. Default: 0 + :kturb: Turbine gain (Kturb). Typical value = 1. Default: 0.0 + :aturb: Turbine numerator multiplier (Aturb). Typical value = -1. Default: 0.0 + :bturb: Turbine denominator multiplier (Bturb) (> 0). Typical value = 0,5. Default: 0.0 + :gv1: Nonlinear gain point 1, PU gv (Gv1). Typical value = 0. Default: 0.0 + :pgv1: Nonlinear gain point 1, PU power (Pgv1). Typical value = 0. Default: 0.0 + :gv2: Nonlinear gain point 2, PU gv (Gv2). Typical value = 0. Default: 0.0 + :pgv2: Nonlinear gain point 2, PU power (Pgv2). Typical value = 0. Default: 0.0 + :gv3: Nonlinear gain point 3, PU gv (Gv3). Typical value = 0. Default: 0.0 + :pgv3: Nonlinear gain point 3, PU power (Pgv3). Typical value = 0. Default: 0.0 + :gv4: Nonlinear gain point 4, PU gv (Gv4). Typical value = 0. Default: 0.0 + :pgv4: Nonlinear gain point 4, PU power (Pgv4). Typical value = 0. Default: 0.0 + :gv5: Nonlinear gain point 5, PU gv (Gv5). Typical value = 0. Default: 0.0 + :pgv5: Nonlinear gain point 5, PU power (Pgv5). Typical value = 0. Default: 0.0 + :gv6: Nonlinear gain point 6, PU gv (Gv6). Typical value = 0. Default: 0.0 + :pgv6: Nonlinear gain point 6, PU power (Pgv6). Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'tg': [cgmesProfile.DY.value, ], + 'tp': [cgmesProfile.DY.value, ], + 'uo': [cgmesProfile.DY.value, ], + 'uc': [cgmesProfile.DY.value, ], + 'pmax': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + 'rperm': [cgmesProfile.DY.value, ], + 'rtemp': [cgmesProfile.DY.value, ], + 'tr': [cgmesProfile.DY.value, ], + 'tw': [cgmesProfile.DY.value, ], + 'kturb': [cgmesProfile.DY.value, ], + 'aturb': [cgmesProfile.DY.value, ], + 'bturb': [cgmesProfile.DY.value, ], + 'gv1': [cgmesProfile.DY.value, ], + 'pgv1': [cgmesProfile.DY.value, ], + 'gv2': [cgmesProfile.DY.value, ], + 'pgv2': [cgmesProfile.DY.value, ], + 'gv3': [cgmesProfile.DY.value, ], + 'pgv3': [cgmesProfile.DY.value, ], + 'gv4': [cgmesProfile.DY.value, ], + 'pgv4': [cgmesProfile.DY.value, ], + 'gv5': [cgmesProfile.DY.value, ], + 'pgv5': [cgmesProfile.DY.value, ], + 'gv6': [cgmesProfile.DY.value, ], + 'pgv6': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, tg = 0, tp = 0, uo = 0.0, uc = 0.0, pmax = 0.0, pmin = 0.0, rperm = 0.0, rtemp = 0.0, tr = 0, tw = 0, kturb = 0.0, aturb = 0.0, bturb = 0.0, gv1 = 0.0, pgv1 = 0.0, gv2 = 0.0, pgv2 = 0.0, gv3 = 0.0, pgv3 = 0.0, gv4 = 0.0, pgv4 = 0.0, gv5 = 0.0, pgv5 = 0.0, gv6 = 0.0, pgv6 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.tg = tg + self.tp = tp + self.uo = uo + self.uc = uc + self.pmax = pmax + self.pmin = pmin + self.rperm = rperm + self.rtemp = rtemp + self.tr = tr + self.tw = tw + self.kturb = kturb + self.aturb = aturb + self.bturb = bturb + self.gv1 = gv1 + self.pgv1 = pgv1 + self.gv2 = gv2 + self.pgv2 = pgv2 + self.gv3 = gv3 + self.pgv3 = pgv3 + self.gv4 = gv4 + self.pgv4 = pgv4 + self.gv5 = gv5 + self.pgv5 = pgv5 + self.gv6 = gv6 + self.pgv6 = pgv6 + + def __str__(self): + str = 'class=GovHydroIEEE2\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovHydroPID.py b/cimpy/cgmes_v3_0_0/GovHydroPID.py new file mode 100644 index 00000000..b9bc37d6 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovHydroPID.py @@ -0,0 +1,127 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovHydroPID(TurbineGovernorDynamics): + ''' + PID governor and turbine. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :pmax: Maximum gate opening, PU of MWbase (Pmax) (> GovHydroPID.pmin). Typical value = 1. Default: 0.0 + :pmin: Minimum gate opening, PU of MWbase (Pmin) (< GovHydroPID.pmax). Typical value = 0. Default: 0.0 + :r: Steady state droop (R). Typical value = 0,05. Default: 0.0 + :td: Input filter time constant (Td) (>= 0). If = 0, block is bypassed. Typical value = 0. Default: 0 + :tf: Washout time constant (Tf) (>= 0). Typical value = 0,1. Default: 0 + :tp: Gate servo time constant (Tp) (>= 0). If = 0, block is bypassed. Typical value = 0,35. Default: 0 + :velop: Maximum gate opening velocity (Velop). Unit = PU / s. Typical value = 0,09. Default: 0.0 + :velcl: Maximum gate closing velocity (Velcl). Unit = PU / s. Typical value = -0,14. Default: 0.0 + :kd: Derivative gain (Kd). Typical value = 1,11. Default: 0.0 + :kp: Proportional gain (Kp). Typical value = 0,1. Default: 0.0 + :ki: Integral gain (Ki). Typical value = 0,36. Default: 0.0 + :kg: Gate servo gain (Kg). Typical value = 2,5. Default: 0.0 + :tturb: Turbine time constant (Tturb) (>= 0). See Parameter detail 3. Typical value = 0,8. Default: 0 + :aturb: Turbine numerator multiplier (Aturb) (see parameter detail 3). Typical value -1. Default: 0.0 + :bturb: Turbine denominator multiplier (Bturb) (see parameter detail 3). Typical value = 0,5. Default: 0.0 + :tt: Power feedback time constant (Tt) (>= 0). If = 0, block is bypassed. Typical value = 0,02. Default: 0 + :db1: Intentional dead-band width (db1). Unit = Hz. Typical value = 0. Default: 0.0 + :inputSignal: Input signal switch (Flag). true = Pe input is used false = feedback is received from CV. Flag is normally dependent on Tt. If Tt is zero, Flag is set to false. If Tt is not zero, Flag is set to true. Typical value = true. Default: False + :eps: Intentional db hysteresis (eps). Unit = Hz. Typical value = 0. Default: 0.0 + :db2: Unintentional dead-band (db2). Unit = MW. Typical value = 0. Default: 0.0 + :gv1: Nonlinear gain point 1, PU gv (Gv1). Typical value = 0. Default: 0.0 + :pgv1: Nonlinear gain point 1, PU power (Pgv1). Typical value = 0. Default: 0.0 + :gv2: Nonlinear gain point 2, PU gv (Gv2). Typical value = 0. Default: 0.0 + :pgv2: Nonlinear gain point 2, PU power (Pgv2). Typical value = 0. Default: 0.0 + :gv3: Nonlinear gain point 3, PU gv (Gv3). Typical value = 0. Default: 0.0 + :pgv3: Nonlinear gain point 3, PU power (Pgv3). Typical value = 0. Default: 0.0 + :gv4: Nonlinear gain point 4, PU gv (Gv4). Typical value = 0. Default: 0.0 + :pgv4: Nonlinear gain point 4, PU power (Pgv4). Typical value = 0. Default: 0.0 + :gv5: Nonlinear gain point 5, PU gv (Gv5). Typical value = 0. Default: 0.0 + :pgv5: Nonlinear gain point 5, PU power (Pgv5). Typical value = 0. Default: 0.0 + :gv6: Nonlinear gain point 6, PU gv (Gv6). Typical value = 0. Default: 0.0 + :pgv6: Nonlinear gain point 6, PU power (Pgv6). Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'pmax': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + 'r': [cgmesProfile.DY.value, ], + 'td': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'tp': [cgmesProfile.DY.value, ], + 'velop': [cgmesProfile.DY.value, ], + 'velcl': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'kg': [cgmesProfile.DY.value, ], + 'tturb': [cgmesProfile.DY.value, ], + 'aturb': [cgmesProfile.DY.value, ], + 'bturb': [cgmesProfile.DY.value, ], + 'tt': [cgmesProfile.DY.value, ], + 'db1': [cgmesProfile.DY.value, ], + 'inputSignal': [cgmesProfile.DY.value, ], + 'eps': [cgmesProfile.DY.value, ], + 'db2': [cgmesProfile.DY.value, ], + 'gv1': [cgmesProfile.DY.value, ], + 'pgv1': [cgmesProfile.DY.value, ], + 'gv2': [cgmesProfile.DY.value, ], + 'pgv2': [cgmesProfile.DY.value, ], + 'gv3': [cgmesProfile.DY.value, ], + 'pgv3': [cgmesProfile.DY.value, ], + 'gv4': [cgmesProfile.DY.value, ], + 'pgv4': [cgmesProfile.DY.value, ], + 'gv5': [cgmesProfile.DY.value, ], + 'pgv5': [cgmesProfile.DY.value, ], + 'gv6': [cgmesProfile.DY.value, ], + 'pgv6': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, pmax = 0.0, pmin = 0.0, r = 0.0, td = 0, tf = 0, tp = 0, velop = 0.0, velcl = 0.0, kd = 0.0, kp = 0.0, ki = 0.0, kg = 0.0, tturb = 0, aturb = 0.0, bturb = 0.0, tt = 0, db1 = 0.0, inputSignal = False, eps = 0.0, db2 = 0.0, gv1 = 0.0, pgv1 = 0.0, gv2 = 0.0, pgv2 = 0.0, gv3 = 0.0, pgv3 = 0.0, gv4 = 0.0, pgv4 = 0.0, gv5 = 0.0, pgv5 = 0.0, gv6 = 0.0, pgv6 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.pmax = pmax + self.pmin = pmin + self.r = r + self.td = td + self.tf = tf + self.tp = tp + self.velop = velop + self.velcl = velcl + self.kd = kd + self.kp = kp + self.ki = ki + self.kg = kg + self.tturb = tturb + self.aturb = aturb + self.bturb = bturb + self.tt = tt + self.db1 = db1 + self.inputSignal = inputSignal + self.eps = eps + self.db2 = db2 + self.gv1 = gv1 + self.pgv1 = pgv1 + self.gv2 = gv2 + self.pgv2 = pgv2 + self.gv3 = gv3 + self.pgv3 = pgv3 + self.gv4 = gv4 + self.pgv4 = pgv4 + self.gv5 = gv5 + self.pgv5 = pgv5 + self.gv6 = gv6 + self.pgv6 = pgv6 + + def __str__(self): + str = 'class=GovHydroPID\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovHydroPID2.py b/cimpy/cgmes_v3_0_0/GovHydroPID2.py new file mode 100644 index 00000000..95034c9c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovHydroPID2.py @@ -0,0 +1,94 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovHydroPID2(TurbineGovernorDynamics): + ''' + Hydro turbine and governor. Represents plants with straightforward penstock configurations and "three term" electro-hydraulic governors (i.e. WoodwardTM electronic). [Footnote: Woodward electronic governors are an example of suitable products available commercially. This information is given for the convenience of users of this document and does not constitute an endorsement by IEC of these products.] + + :mwbase: Base for power values (MWbase) (>0). Unit = MW. Default: 0.0 + :treg: Speed detector time constant (Treg) (>= 0). Typical value = 0. Default: 0 + :rperm: Permanent drop (Rperm). Typical value = 0. Default: 0.0 + :kp: Proportional gain (Kp). Typical value = 0. Default: 0.0 + :ki: Reset gain (Ki). Unit = PU/s. Typical value = 0. Default: 0.0 + :kd: Derivative gain (Kd). Typical value = 0. Default: 0.0 + :ta: Controller time constant (Ta) (>= 0). Typical value = 0. Default: 0 + :tb: Gate servo time constant (Tb) (> 0). Default: 0 + :velmax: Maximum gate opening velocity (Velmax) (< GovHydroPID2.velmin). Unit = PU / s. Typical value = 0. Default: 0.0 + :velmin: Maximum gate closing velocity (Velmin) (> GovHydroPID2.velmax). Unit = PU / s. Typical value = 0. Default: 0.0 + :gmax: Maximum gate opening (Gmax) (> GovHydroPID2.gmin). Typical value = 0. Default: 0.0 + :gmin: Minimum gate opening (Gmin) (> GovHydroPID2.gmax). Typical value = 0. Default: 0.0 + :tw: Water inertia time constant (Tw) (>= 0). Typical value = 0. Default: 0 + :d: Turbine damping factor (D). Unit = delta P / delta speed. Typical value = 0. Default: 0.0 + :g0: Gate opening at speed no load (G0). Typical value = 0. Default: 0.0 + :g1: Intermediate gate opening (G1). Typical value = 0. Default: 0.0 + :p1: Power at gate opening G1 (P1). Typical value = 0. Default: 0.0 + :g2: Intermediate gate opening (G2). Typical value = 0. Default: 0.0 + :p2: Power at gate opening G2 (P2). Typical value = 0. Default: 0.0 + :p3: Power at full opened gate (P3). Typical value = 0. Default: 0.0 + :atw: Factor multiplying Tw (Atw). Typical value = 0. Default: 0.0 + :feedbackSignal: Feedback signal type flag (Flag). true = use gate position feedback signal false = use Pe. Default: False + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'treg': [cgmesProfile.DY.value, ], + 'rperm': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'velmax': [cgmesProfile.DY.value, ], + 'velmin': [cgmesProfile.DY.value, ], + 'gmax': [cgmesProfile.DY.value, ], + 'gmin': [cgmesProfile.DY.value, ], + 'tw': [cgmesProfile.DY.value, ], + 'd': [cgmesProfile.DY.value, ], + 'g0': [cgmesProfile.DY.value, ], + 'g1': [cgmesProfile.DY.value, ], + 'p1': [cgmesProfile.DY.value, ], + 'g2': [cgmesProfile.DY.value, ], + 'p2': [cgmesProfile.DY.value, ], + 'p3': [cgmesProfile.DY.value, ], + 'atw': [cgmesProfile.DY.value, ], + 'feedbackSignal': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, treg = 0, rperm = 0.0, kp = 0.0, ki = 0.0, kd = 0.0, ta = 0, tb = 0, velmax = 0.0, velmin = 0.0, gmax = 0.0, gmin = 0.0, tw = 0, d = 0.0, g0 = 0.0, g1 = 0.0, p1 = 0.0, g2 = 0.0, p2 = 0.0, p3 = 0.0, atw = 0.0, feedbackSignal = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.treg = treg + self.rperm = rperm + self.kp = kp + self.ki = ki + self.kd = kd + self.ta = ta + self.tb = tb + self.velmax = velmax + self.velmin = velmin + self.gmax = gmax + self.gmin = gmin + self.tw = tw + self.d = d + self.g0 = g0 + self.g1 = g1 + self.p1 = p1 + self.g2 = g2 + self.p2 = p2 + self.p3 = p3 + self.atw = atw + self.feedbackSignal = feedbackSignal + + def __str__(self): + str = 'class=GovHydroPID2\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovHydroPelton.py b/cimpy/cgmes_v3_0_0/GovHydroPelton.py new file mode 100644 index 00000000..22cbf385 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovHydroPelton.py @@ -0,0 +1,112 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovHydroPelton(TurbineGovernorDynamics): + ''' + Detailed hydro unit - Pelton model. This model can be used to represent the dynamic related to water tunnel and surge chamber. The DetailedHydroModelHydraulicSystem diagram, located under the GovHydroFrancis class, provides a schematic of the hydraulic system of detailed hydro unit models, such as Francis and Pelton. + + :av0: Area of the surge tank (AV0). Unit = m2. Typical value = 30. Default: 0.0 + :av1: Area of the compensation tank (AV1). Unit = m2. Typical value = 700. Default: 0.0 + :bp: Droop (bp). Typical value = 0,05. Default: 0.0 + :db1: Intentional dead-band width (DB1). Unit = Hz. Typical value = 0. Default: 0.0 + :db2: Intentional dead-band width of valve opening error (DB2). Unit = Hz. Typical value = 0,01. Default: 0.0 + :h1: Head of compensation chamber water level with respect to the level of penstock (H1). Unit = km. Typical value = 0,004. Default: 0.0 + :h2: Head of surge tank water level with respect to the level of penstock (H2). Unit = km. Typical value = 0,040. Default: 0.0 + :hn: Rated hydraulic head (Hn). Unit = km. Typical value = 0,250. Default: 0.0 + :kc: Penstock loss coefficient (due to friction) (Kc). Typical value = 0,025. Default: 0.0 + :kg: Water tunnel and surge chamber loss coefficient (due to friction) (Kg). Typical value = 0,025. Default: 0.0 + :qc0: No-load turbine flow at nominal head (Qc0). Typical value = 0,05. Default: 0.0 + :qn: Rated flow (Qn). Unit = m3/s. Typical value = 250. Default: 0.0 + :simplifiedPelton: Simplified Pelton model simulation (Sflag). true = enable of simplified Pelton model simulation false = enable of complete Pelton model simulation (non-linear gain). Typical value = true. Default: False + :staticCompensating: Static compensating characteristic (Cflag). It should be true if simplifiedPelton = false. true = enable of static compensating characteristic false = inhibit of static compensating characteristic. Typical value = false. Default: False + :ta: Derivative gain (accelerometer time constant) (Ta) (>= 0). Typical value = 3. Default: 0 + :ts: Gate servo time constant (Ts) (>= 0). Typical value = 0,15. Default: 0 + :tv: Servomotor integrator time constant (Tv) (>= 0). Typical value = 0,3. Default: 0 + :twnc: Water inertia time constant (Twnc) (>= 0). Typical value = 1. Default: 0 + :twng: Water tunnel and surge chamber inertia time constant (Twng) (>= 0). Typical value = 3. Default: 0 + :tx: Electronic integrator time constant (Tx) (>= 0). Typical value = 0,5. Default: 0 + :va: Maximum gate opening velocity (Va). Unit = PU / s. Typical value = 0,06. Default: 0.0 + :valvmax: Maximum gate opening (ValvMax) (> GovHydroPelton.valvmin). Typical value = 1,1. Default: 0.0 + :valvmin: Minimum gate opening (ValvMin) (< GovHydroPelton.valvmax). Typical value = 0. Default: 0.0 + :vav: Maximum servomotor valve opening velocity (Vav). Typical value = 0,1. Default: 0.0 + :vc: Maximum gate closing velocity (Vc). Unit = PU / s. Typical value = -0,06. Default: 0.0 + :vcv: Maximum servomotor valve closing velocity (Vcv). Typical value = -0,1. Default: 0.0 + :waterTunnelSurgeChamberSimulation: Water tunnel and surge chamber simulation (Tflag). true = enable of water tunnel and surge chamber simulation false = inhibit of water tunnel and surge chamber simulation. Typical value = false. Default: False + :zsfc: Head of upper water level with respect to the level of penstock (Zsfc). Unit = km. Typical value = 0,025. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'av0': [cgmesProfile.DY.value, ], + 'av1': [cgmesProfile.DY.value, ], + 'bp': [cgmesProfile.DY.value, ], + 'db1': [cgmesProfile.DY.value, ], + 'db2': [cgmesProfile.DY.value, ], + 'h1': [cgmesProfile.DY.value, ], + 'h2': [cgmesProfile.DY.value, ], + 'hn': [cgmesProfile.DY.value, ], + 'kc': [cgmesProfile.DY.value, ], + 'kg': [cgmesProfile.DY.value, ], + 'qc0': [cgmesProfile.DY.value, ], + 'qn': [cgmesProfile.DY.value, ], + 'simplifiedPelton': [cgmesProfile.DY.value, ], + 'staticCompensating': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'ts': [cgmesProfile.DY.value, ], + 'tv': [cgmesProfile.DY.value, ], + 'twnc': [cgmesProfile.DY.value, ], + 'twng': [cgmesProfile.DY.value, ], + 'tx': [cgmesProfile.DY.value, ], + 'va': [cgmesProfile.DY.value, ], + 'valvmax': [cgmesProfile.DY.value, ], + 'valvmin': [cgmesProfile.DY.value, ], + 'vav': [cgmesProfile.DY.value, ], + 'vc': [cgmesProfile.DY.value, ], + 'vcv': [cgmesProfile.DY.value, ], + 'waterTunnelSurgeChamberSimulation': [cgmesProfile.DY.value, ], + 'zsfc': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, av0 = 0.0, av1 = 0.0, bp = 0.0, db1 = 0.0, db2 = 0.0, h1 = 0.0, h2 = 0.0, hn = 0.0, kc = 0.0, kg = 0.0, qc0 = 0.0, qn = 0.0, simplifiedPelton = False, staticCompensating = False, ta = 0, ts = 0, tv = 0, twnc = 0, twng = 0, tx = 0, va = 0.0, valvmax = 0.0, valvmin = 0.0, vav = 0.0, vc = 0.0, vcv = 0.0, waterTunnelSurgeChamberSimulation = False, zsfc = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.av0 = av0 + self.av1 = av1 + self.bp = bp + self.db1 = db1 + self.db2 = db2 + self.h1 = h1 + self.h2 = h2 + self.hn = hn + self.kc = kc + self.kg = kg + self.qc0 = qc0 + self.qn = qn + self.simplifiedPelton = simplifiedPelton + self.staticCompensating = staticCompensating + self.ta = ta + self.ts = ts + self.tv = tv + self.twnc = twnc + self.twng = twng + self.tx = tx + self.va = va + self.valvmax = valvmax + self.valvmin = valvmin + self.vav = vav + self.vc = vc + self.vcv = vcv + self.waterTunnelSurgeChamberSimulation = waterTunnelSurgeChamberSimulation + self.zsfc = zsfc + + def __str__(self): + str = 'class=GovHydroPelton\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovHydroR.py b/cimpy/cgmes_v3_0_0/GovHydroR.py new file mode 100644 index 00000000..5b937a5d --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovHydroR.py @@ -0,0 +1,154 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovHydroR(TurbineGovernorDynamics): + ''' + Fourth order lead-lag governor and hydro turbine. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :pmax: Maximum gate opening, PU of MWbase (Pmax) (> GovHydroR.pmin). Typical value = 1. Default: 0.0 + :pmin: Minimum gate opening, PU of MWbase (Pmin) (< GovHydroR.pmax). Typical value = 0. Default: 0.0 + :r: Steady-state droop (R). Typical value = 0,05. Default: 0.0 + :td: Input filter time constant (Td) (>= 0). Typical value = 0,05. Default: 0 + :t1: Lead time constant 1 (T1) (>= 0). Typical value = 1,5. Default: 0 + :t2: Lag time constant 1 (T2) (>= 0). Typical value = 0,1. Default: 0 + :t3: Lead time constant 2 (T3) (>= 0). Typical value = 1,5. Default: 0 + :t4: Lag time constant 2 (T4) (>= 0). Typical value = 0,1. Default: 0 + :t5: Lead time constant 3 (T5) (>= 0). Typical value = 0. Default: 0 + :t6: Lag time constant 3 (T6) (>= 0). Typical value = 0,05. Default: 0 + :t7: Lead time constant 4 (T7) (>= 0). Typical value = 0. Default: 0 + :t8: Lag time constant 4 (T8) (>= 0). Typical value = 0,05. Default: 0 + :tp: Gate servo time constant (Tp) (>= 0). Typical value = 0,05. Default: 0 + :velop: Maximum gate opening velocity (Velop). Unit = PU / s. Typical value = 0,2. Default: 0.0 + :velcl: Maximum gate closing velocity (Velcl). Unit = PU / s. Typical value = -0,2. Default: 0.0 + :ki: Integral gain (Ki). Typical value = 0,5. Default: 0.0 + :kg: Gate servo gain (Kg). Typical value = 2. Default: 0.0 + :gmax: Maximum governor output (Gmax) (> GovHydroR.gmin). Typical value = 1,05. Default: 0.0 + :gmin: Minimum governor output (Gmin) (< GovHydroR.gmax). Typical value = -0,05. Default: 0.0 + :tt: Power feedback time constant (Tt) (>= 0). Typical value = 0. Default: 0 + :inputSignal: Input signal switch (Flag). true = Pe input is used false = feedback is received from CV. Flag is normally dependent on Tt. If Tt is zero, Flag is set to false. If Tt is not zero, Flag is set to true. Typical value = true. Default: False + :db1: Intentional dead-band width (db1). Unit = Hz. Typical value = 0. Default: 0.0 + :eps: Intentional db hysteresis (eps). Unit = Hz. Typical value = 0. Default: 0.0 + :db2: Unintentional dead-band (db2). Unit = MW. Typical value = 0. Default: 0.0 + :tw: Water inertia time constant (Tw) (> 0). Typical value = 1. Default: 0 + :at: Turbine gain (At). Typical value = 1,2. Default: 0.0 + :dturb: Turbine damping factor (Dturb). Typical value = 0,2. Default: 0.0 + :qnl: No-load turbine flow at nominal head (Qnl). Typical value = 0,08. Default: 0.0 + :h0: Turbine nominal head (H0). Typical value = 1. Default: 0.0 + :gv1: Nonlinear gain point 1, PU gv (Gv1). Typical value = 0. Default: 0.0 + :pgv1: Nonlinear gain point 1, PU power (Pgv1). Typical value = 0. Default: 0.0 + :gv2: Nonlinear gain point 2, PU gv (Gv2). Typical value = 0. Default: 0.0 + :pgv2: Nonlinear gain point 2, PU power (Pgv2). Typical value = 0. Default: 0.0 + :gv3: Nonlinear gain point 3, PU gv (Gv3). Typical value = 0. Default: 0.0 + :pgv3: Nonlinear gain point 3, PU power (Pgv3). Typical value = 0. Default: 0.0 + :gv4: Nonlinear gain point 4, PU gv (Gv4). Typical value = 0. Default: 0.0 + :pgv4: Nonlinear gain point 4, PU power (Pgv4). Typical value = 0. Default: 0.0 + :gv5: Nonlinear gain point 5, PU gv (Gv5). Typical value = 0. Default: 0.0 + :pgv5: Nonlinear gain point 5, PU power (Pgv5). Typical value = 0. Default: 0.0 + :gv6: Nonlinear gain point 6, PU gv (Gv6). Typical value = 0. Default: 0.0 + :pgv6: Nonlinear gain point 6, PU power (Pgv6). Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'pmax': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + 'r': [cgmesProfile.DY.value, ], + 'td': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 't6': [cgmesProfile.DY.value, ], + 't7': [cgmesProfile.DY.value, ], + 't8': [cgmesProfile.DY.value, ], + 'tp': [cgmesProfile.DY.value, ], + 'velop': [cgmesProfile.DY.value, ], + 'velcl': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'kg': [cgmesProfile.DY.value, ], + 'gmax': [cgmesProfile.DY.value, ], + 'gmin': [cgmesProfile.DY.value, ], + 'tt': [cgmesProfile.DY.value, ], + 'inputSignal': [cgmesProfile.DY.value, ], + 'db1': [cgmesProfile.DY.value, ], + 'eps': [cgmesProfile.DY.value, ], + 'db2': [cgmesProfile.DY.value, ], + 'tw': [cgmesProfile.DY.value, ], + 'at': [cgmesProfile.DY.value, ], + 'dturb': [cgmesProfile.DY.value, ], + 'qnl': [cgmesProfile.DY.value, ], + 'h0': [cgmesProfile.DY.value, ], + 'gv1': [cgmesProfile.DY.value, ], + 'pgv1': [cgmesProfile.DY.value, ], + 'gv2': [cgmesProfile.DY.value, ], + 'pgv2': [cgmesProfile.DY.value, ], + 'gv3': [cgmesProfile.DY.value, ], + 'pgv3': [cgmesProfile.DY.value, ], + 'gv4': [cgmesProfile.DY.value, ], + 'pgv4': [cgmesProfile.DY.value, ], + 'gv5': [cgmesProfile.DY.value, ], + 'pgv5': [cgmesProfile.DY.value, ], + 'gv6': [cgmesProfile.DY.value, ], + 'pgv6': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, pmax = 0.0, pmin = 0.0, r = 0.0, td = 0, t1 = 0, t2 = 0, t3 = 0, t4 = 0, t5 = 0, t6 = 0, t7 = 0, t8 = 0, tp = 0, velop = 0.0, velcl = 0.0, ki = 0.0, kg = 0.0, gmax = 0.0, gmin = 0.0, tt = 0, inputSignal = False, db1 = 0.0, eps = 0.0, db2 = 0.0, tw = 0, at = 0.0, dturb = 0.0, qnl = 0.0, h0 = 0.0, gv1 = 0.0, pgv1 = 0.0, gv2 = 0.0, pgv2 = 0.0, gv3 = 0.0, pgv3 = 0.0, gv4 = 0.0, pgv4 = 0.0, gv5 = 0.0, pgv5 = 0.0, gv6 = 0.0, pgv6 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.pmax = pmax + self.pmin = pmin + self.r = r + self.td = td + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.t4 = t4 + self.t5 = t5 + self.t6 = t6 + self.t7 = t7 + self.t8 = t8 + self.tp = tp + self.velop = velop + self.velcl = velcl + self.ki = ki + self.kg = kg + self.gmax = gmax + self.gmin = gmin + self.tt = tt + self.inputSignal = inputSignal + self.db1 = db1 + self.eps = eps + self.db2 = db2 + self.tw = tw + self.at = at + self.dturb = dturb + self.qnl = qnl + self.h0 = h0 + self.gv1 = gv1 + self.pgv1 = pgv1 + self.gv2 = gv2 + self.pgv2 = pgv2 + self.gv3 = gv3 + self.pgv3 = pgv3 + self.gv4 = gv4 + self.pgv4 = pgv4 + self.gv5 = gv5 + self.pgv5 = pgv5 + self.gv6 = gv6 + self.pgv6 = pgv6 + + def __str__(self): + str = 'class=GovHydroR\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovHydroWEH.py b/cimpy/cgmes_v3_0_0/GovHydroWEH.py new file mode 100644 index 00000000..88c0e6c8 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovHydroWEH.py @@ -0,0 +1,181 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovHydroWEH(TurbineGovernorDynamics): + ''' + WoodwardTM electric hydro governor. [Footnote: Woodward electric hydro governors are an example of suitable products available commercially. This information is given for the convenience of users of this document and does not constitute an endorsement by IEC of these products.] + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :rpg: Permanent droop for governor output feedback (R-Perm-Gate). Default: 0.0 + :rpp: Permanent droop for electrical power feedback (R-Perm-Pe). Default: 0.0 + :tpe: Electrical power droop time constant (Tpe) (>= 0). Default: 0 + :kp: Derivative control gain (Kp). Default: 0.0 + :ki: Derivative controller Integral gain (Ki). Default: 0.0 + :kd: Derivative controller derivative gain (Kd). Default: 0.0 + :td: Derivative controller time constant (Td) (>= 0). Limits the derivative characteristic beyond a breakdown frequency to avoid amplification of high-frequency noise. Default: 0 + :tp: Pilot valve time lag time constant (Tp) (>= 0). Default: 0 + :tdv: Distributive valve time lag time constant (Tdv) (>= 0). Default: 0 + :tg: Value to allow the distribution valve controller to advance beyond the gate movement rate limit (Tg) (>= 0). Default: 0 + :gtmxop: Maximum gate opening rate (Gtmxop). Default: 0.0 + :gtmxcl: Maximum gate closing rate (Gtmxcl). Default: 0.0 + :gmax: Maximum gate position (Gmax) (> GovHydroWEH.gmin). Default: 0.0 + :gmin: Minimum gate position (Gmin) (< GovHydroWEH.gmax). Default: 0.0 + :dturb: Turbine damping factor (Dturb). Unit = delta P (PU of MWbase) / delta speed (PU). Default: 0.0 + :tw: Water inertia time constant (Tw) (> 0). Default: 0 + :db: Speed deadband (db). Default: 0.0 + :dpv: Value to allow the pilot valve controller to advance beyond the gate limits (Dpv). Default: 0.0 + :dicn: Value to allow the integral controller to advance beyond the gate limits (Dicn). Default: 0.0 + :feedbackSignal: Feedback signal selection (Sw). true = PID output (if R-Perm-Gate = droop and R-Perm-Pe = 0) false = electrical power (if R-Perm-Gate = 0 and R-Perm-Pe = droop) or false = gate position (if R-Perm-Gate = droop and R-Perm-Pe = 0). Typical value = false. Default: False + :gv1: Gate 1 (Gv1). Gate Position value for point 1 for lookup table representing water flow through the turbine as a function of gate position to produce steady state flow. Default: 0.0 + :gv2: Gate 2 (Gv2). Gate Position value for point 2 for lookup table representing water flow through the turbine as a function of gate position to produce steady state flow. Default: 0.0 + :gv3: Gate 3 (Gv3). Gate Position value for point 3 for lookup table representing water flow through the turbine as a function of gate position to produce steady state flow. Default: 0.0 + :gv4: Gate 4 (Gv4). Gate Position value for point 4 for lookup table representing water flow through the turbine as a function of gate position to produce steady state flow. Default: 0.0 + :gv5: Gate 5 (Gv5). Gate Position value for point 5 for lookup table representing water flow through the turbine as a function of gate position to produce steady state flow. Default: 0.0 + :fl1: Flowgate 1 (Fl1). Flow value for gate position point 1 for lookup table representing water flow through the turbine as a function of gate position to produce steady state flow. Default: 0.0 + :fl2: Flowgate 2 (Fl2). Flow value for gate position point 2 for lookup table representing water flow through the turbine as a function of gate position to produce steady state flow. Default: 0.0 + :fl3: Flowgate 3 (Fl3). Flow value for gate position point 3 for lookup table representing water flow through the turbine as a function of gate position to produce steady state flow. Default: 0.0 + :fl4: Flowgate 4 (Fl4). Flow value for gate position point 4 for lookup table representing water flow through the turbine as a function of gate position to produce steady state flow. Default: 0.0 + :fl5: Flowgate 5 (Fl5). Flow value for gate position point 5 for lookup table representing water flow through the turbine as a function of gate position to produce steady state flow. Default: 0.0 + :fp1: Flow P1 (Fp1). Turbine flow value for point 1 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :fp2: Flow P2 (Fp2). Turbine flow value for point 2 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :fp3: Flow P3 (Fp3). Turbine flow value for point 3 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :fp4: Flow P4 (Fp4). Turbine flow value for point 4 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :fp5: Flow P5 (Fp5). Turbine flow value for point 5 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :fp6: Flow P6 (Fp6). Turbine flow value for point 6 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :fp7: Flow P7 (Fp7). Turbine flow value for point 7 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :fp8: Flow P8 (Fp8). Turbine flow value for point 8 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :fp9: Flow P9 (Fp9). Turbine flow value for point 9 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :fp10: Flow P10 (Fp10). Turbine flow value for point 10 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :pmss1: Pmss flow P1 (Pmss1). Mechanical power output for turbine flow point 1 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :pmss2: Pmss flow P2 (Pmss2). Mechanical power output for turbine flow point 2 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :pmss3: Pmss flow P3 (Pmss3). Mechanical power output for turbine flow point 3 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :pmss4: Pmss flow P4 (Pmss4). Mechanical power output for turbine flow point 4 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :pmss5: Pmss flow P5 (Pmss5). Mechanical power output for turbine flow point 5 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :pmss6: Pmss flow P6 (Pmss6). Mechanical power output for turbine flow point 6 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :pmss7: Pmss flow P7 (Pmss7). Mechanical power output for turbine flow point 7 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :pmss8: Pmss flow P8 (Pmss8). Mechanical power output for turbine flow point 8 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :pmss9: Pmss flow P9 (Pmss9). Mechanical power output for turbine flow point 9 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + :pmss10: Pmss flow P10 (Pmss10). Mechanical power output for turbine flow point 10 for lookup table representing PU mechanical power on machine MVA rating as a function of turbine flow. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'rpg': [cgmesProfile.DY.value, ], + 'rpp': [cgmesProfile.DY.value, ], + 'tpe': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'td': [cgmesProfile.DY.value, ], + 'tp': [cgmesProfile.DY.value, ], + 'tdv': [cgmesProfile.DY.value, ], + 'tg': [cgmesProfile.DY.value, ], + 'gtmxop': [cgmesProfile.DY.value, ], + 'gtmxcl': [cgmesProfile.DY.value, ], + 'gmax': [cgmesProfile.DY.value, ], + 'gmin': [cgmesProfile.DY.value, ], + 'dturb': [cgmesProfile.DY.value, ], + 'tw': [cgmesProfile.DY.value, ], + 'db': [cgmesProfile.DY.value, ], + 'dpv': [cgmesProfile.DY.value, ], + 'dicn': [cgmesProfile.DY.value, ], + 'feedbackSignal': [cgmesProfile.DY.value, ], + 'gv1': [cgmesProfile.DY.value, ], + 'gv2': [cgmesProfile.DY.value, ], + 'gv3': [cgmesProfile.DY.value, ], + 'gv4': [cgmesProfile.DY.value, ], + 'gv5': [cgmesProfile.DY.value, ], + 'fl1': [cgmesProfile.DY.value, ], + 'fl2': [cgmesProfile.DY.value, ], + 'fl3': [cgmesProfile.DY.value, ], + 'fl4': [cgmesProfile.DY.value, ], + 'fl5': [cgmesProfile.DY.value, ], + 'fp1': [cgmesProfile.DY.value, ], + 'fp2': [cgmesProfile.DY.value, ], + 'fp3': [cgmesProfile.DY.value, ], + 'fp4': [cgmesProfile.DY.value, ], + 'fp5': [cgmesProfile.DY.value, ], + 'fp6': [cgmesProfile.DY.value, ], + 'fp7': [cgmesProfile.DY.value, ], + 'fp8': [cgmesProfile.DY.value, ], + 'fp9': [cgmesProfile.DY.value, ], + 'fp10': [cgmesProfile.DY.value, ], + 'pmss1': [cgmesProfile.DY.value, ], + 'pmss2': [cgmesProfile.DY.value, ], + 'pmss3': [cgmesProfile.DY.value, ], + 'pmss4': [cgmesProfile.DY.value, ], + 'pmss5': [cgmesProfile.DY.value, ], + 'pmss6': [cgmesProfile.DY.value, ], + 'pmss7': [cgmesProfile.DY.value, ], + 'pmss8': [cgmesProfile.DY.value, ], + 'pmss9': [cgmesProfile.DY.value, ], + 'pmss10': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, rpg = 0.0, rpp = 0.0, tpe = 0, kp = 0.0, ki = 0.0, kd = 0.0, td = 0, tp = 0, tdv = 0, tg = 0, gtmxop = 0.0, gtmxcl = 0.0, gmax = 0.0, gmin = 0.0, dturb = 0.0, tw = 0, db = 0.0, dpv = 0.0, dicn = 0.0, feedbackSignal = False, gv1 = 0.0, gv2 = 0.0, gv3 = 0.0, gv4 = 0.0, gv5 = 0.0, fl1 = 0.0, fl2 = 0.0, fl3 = 0.0, fl4 = 0.0, fl5 = 0.0, fp1 = 0.0, fp2 = 0.0, fp3 = 0.0, fp4 = 0.0, fp5 = 0.0, fp6 = 0.0, fp7 = 0.0, fp8 = 0.0, fp9 = 0.0, fp10 = 0.0, pmss1 = 0.0, pmss2 = 0.0, pmss3 = 0.0, pmss4 = 0.0, pmss5 = 0.0, pmss6 = 0.0, pmss7 = 0.0, pmss8 = 0.0, pmss9 = 0.0, pmss10 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.rpg = rpg + self.rpp = rpp + self.tpe = tpe + self.kp = kp + self.ki = ki + self.kd = kd + self.td = td + self.tp = tp + self.tdv = tdv + self.tg = tg + self.gtmxop = gtmxop + self.gtmxcl = gtmxcl + self.gmax = gmax + self.gmin = gmin + self.dturb = dturb + self.tw = tw + self.db = db + self.dpv = dpv + self.dicn = dicn + self.feedbackSignal = feedbackSignal + self.gv1 = gv1 + self.gv2 = gv2 + self.gv3 = gv3 + self.gv4 = gv4 + self.gv5 = gv5 + self.fl1 = fl1 + self.fl2 = fl2 + self.fl3 = fl3 + self.fl4 = fl4 + self.fl5 = fl5 + self.fp1 = fp1 + self.fp2 = fp2 + self.fp3 = fp3 + self.fp4 = fp4 + self.fp5 = fp5 + self.fp6 = fp6 + self.fp7 = fp7 + self.fp8 = fp8 + self.fp9 = fp9 + self.fp10 = fp10 + self.pmss1 = pmss1 + self.pmss2 = pmss2 + self.pmss3 = pmss3 + self.pmss4 = pmss4 + self.pmss5 = pmss5 + self.pmss6 = pmss6 + self.pmss7 = pmss7 + self.pmss8 = pmss8 + self.pmss9 = pmss9 + self.pmss10 = pmss10 + + def __str__(self): + str = 'class=GovHydroWEH\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovHydroWPID.py b/cimpy/cgmes_v3_0_0/GovHydroWPID.py new file mode 100644 index 00000000..75da1708 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovHydroWPID.py @@ -0,0 +1,94 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovHydroWPID(TurbineGovernorDynamics): + ''' + WoodwardTM PID hydro governor. [Footnote: Woodward PID hydro governors are an example of suitable products available commercially. This information is given for the convenience of users of this document and does not constitute an endorsement by IEC of these products.] + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :treg: Speed detector time constant (Treg) (>= 0). Default: 0 + :reg: Permanent drop (Reg). Default: 0.0 + :kp: Proportional gain (Kp). Typical value = 0,1. Default: 0.0 + :ki: Reset gain (Ki). Typical value = 0,36. Default: 0.0 + :kd: Derivative gain (Kd). Typical value = 1,11. Default: 0.0 + :ta: Controller time constant (Ta) (>= 0). Typical value = 0. Default: 0 + :tb: Gate servo time constant (Tb) (>= 0). Typical value = 0. Default: 0 + :velmax: Maximum gate opening velocity (Velmax) (> GovHydroWPID.velmin). Unit = PU / s. Typical value = 0. Default: 0.0 + :velmin: Maximum gate closing velocity (Velmin) (< GovHydroWPID.velmax). Unit = PU / s. Typical value = 0. Default: 0.0 + :gatmax: Gate opening limit maximum (Gatmax) (> GovHydroWPID.gatmin). Default: 0.0 + :gatmin: Gate opening limit minimum (Gatmin) (< GovHydroWPID.gatmax). Default: 0.0 + :tw: Water inertia time constant (Tw) (>= 0). Typical value = 0. Default: 0 + :pmax: Maximum power output (Pmax) (> GovHydroWPID.pmin). Default: 0.0 + :pmin: Minimum power output (Pmin) (< GovHydroWPID.pmax). Default: 0.0 + :d: Turbine damping factor (D). Unit = delta P / delta speed. Default: 0.0 + :gv3: Gate position 3 (Gv3) (= 1,0). Default: 0.0 + :gv1: Gate position 1 (Gv1). Default: 0.0 + :pgv1: Output at Gv1 PU of MWbase (Pgv1). Default: 0.0 + :gv2: Gate position 2 (Gv2). Default: 0.0 + :pgv2: Output at Gv2 PU of MWbase (Pgv2). Default: 0.0 + :pgv3: Output at Gv3 PU of MWbase (Pgv3). Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'treg': [cgmesProfile.DY.value, ], + 'reg': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'velmax': [cgmesProfile.DY.value, ], + 'velmin': [cgmesProfile.DY.value, ], + 'gatmax': [cgmesProfile.DY.value, ], + 'gatmin': [cgmesProfile.DY.value, ], + 'tw': [cgmesProfile.DY.value, ], + 'pmax': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + 'd': [cgmesProfile.DY.value, ], + 'gv3': [cgmesProfile.DY.value, ], + 'gv1': [cgmesProfile.DY.value, ], + 'pgv1': [cgmesProfile.DY.value, ], + 'gv2': [cgmesProfile.DY.value, ], + 'pgv2': [cgmesProfile.DY.value, ], + 'pgv3': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, treg = 0, reg = 0.0, kp = 0.0, ki = 0.0, kd = 0.0, ta = 0, tb = 0, velmax = 0.0, velmin = 0.0, gatmax = 0.0, gatmin = 0.0, tw = 0, pmax = 0.0, pmin = 0.0, d = 0.0, gv3 = 0.0, gv1 = 0.0, pgv1 = 0.0, gv2 = 0.0, pgv2 = 0.0, pgv3 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.treg = treg + self.reg = reg + self.kp = kp + self.ki = ki + self.kd = kd + self.ta = ta + self.tb = tb + self.velmax = velmax + self.velmin = velmin + self.gatmax = gatmax + self.gatmin = gatmin + self.tw = tw + self.pmax = pmax + self.pmin = pmin + self.d = d + self.gv3 = gv3 + self.gv1 = gv1 + self.pgv1 = pgv1 + self.gv2 = gv2 + self.pgv2 = pgv2 + self.pgv3 = pgv3 + + def __str__(self): + str = 'class=GovHydroWPID\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovSteam0.py b/cimpy/cgmes_v3_0_0/GovSteam0.py new file mode 100644 index 00000000..dc90709e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovSteam0.py @@ -0,0 +1,52 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovSteam0(TurbineGovernorDynamics): + ''' + A simplified steam turbine governor. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :r: Permanent droop (R). Typical value = 0,05. Default: 0.0 + :t1: Steam bowl time constant (T1) (> 0). Typical value = 0,5. Default: 0 + :vmax: Maximum valve position, PU of mwcap (Vmax) (> GovSteam0.vmin). Typical value = 1. Default: 0.0 + :vmin: Minimum valve position, PU of mwcap (Vmin) (< GovSteam0.vmax). Typical value = 0. Default: 0.0 + :t2: Numerator time constant of T2/T3 block (T2) (>= 0). Typical value = 3. Default: 0 + :t3: Reheater time constant (T3) (> 0). Typical value = 10. Default: 0 + :dt: Turbine damping coefficient (Dt). Unit = delta P / delta speed. Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'r': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 'vmax': [cgmesProfile.DY.value, ], + 'vmin': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 'dt': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, r = 0.0, t1 = 0, vmax = 0.0, vmin = 0.0, t2 = 0, t3 = 0, dt = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.r = r + self.t1 = t1 + self.vmax = vmax + self.vmin = vmin + self.t2 = t2 + self.t3 = t3 + self.dt = dt + + def __str__(self): + str = 'class=GovSteam0\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovSteam1.py b/cimpy/cgmes_v3_0_0/GovSteam1.py new file mode 100644 index 00000000..69d8c6f2 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovSteam1.py @@ -0,0 +1,145 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovSteam1(TurbineGovernorDynamics): + ''' + Steam turbine governor, based on the GovSteamIEEE1 (with optional deadband and nonlinear valve gain added). + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :k: Governor gain (reciprocal of droop) (K) (> 0). Typical value = 25. Default: 0.0 + :t1: Governor lag time constant (T1) (>= 0). Typical value = 0. Default: 0 + :t2: Governor lead time constant (T2) (>= 0). Typical value = 0. Default: 0 + :t3: Valve positioner time constant (T3) (> 0). Typical value = 0,1. Default: 0 + :uo: Maximum valve opening velocity (Uo) (> 0). Unit = PU / s. Typical value = 1. Default: 0.0 + :uc: Maximum valve closing velocity (Uc) (< 0). Unit = PU / s. Typical value = -10. Default: 0.0 + :pmax: Maximum valve opening (Pmax) (> GovSteam1.pmin). Typical value = 1. Default: 0.0 + :pmin: Minimum valve opening (Pmin) (>= 0 and < GovSteam1.pmax). Typical value = 0. Default: 0.0 + :t4: Inlet piping/steam bowl time constant (T4) (>= 0). Typical value = 0,3. Default: 0 + :k1: Fraction of HP shaft power after first boiler pass (K1). Typical value = 0,2. Default: 0.0 + :k2: Fraction of LP shaft power after first boiler pass (K2). Typical value = 0. Default: 0.0 + :t5: Time constant of second boiler pass (T5) (>= 0). Typical value = 5. Default: 0 + :k3: Fraction of HP shaft power after second boiler pass (K3). Typical value = 0,3. Default: 0.0 + :k4: Fraction of LP shaft power after second boiler pass (K4). Typical value = 0. Default: 0.0 + :t6: Time constant of third boiler pass (T6) (>= 0). Typical value = 0,5. Default: 0 + :k5: Fraction of HP shaft power after third boiler pass (K5). Typical value = 0,5. Default: 0.0 + :k6: Fraction of LP shaft power after third boiler pass (K6). Typical value = 0. Default: 0.0 + :t7: Time constant of fourth boiler pass (T7) (>= 0). Typical value = 0. Default: 0 + :k7: Fraction of HP shaft power after fourth boiler pass (K7). Typical value = 0. Default: 0.0 + :k8: Fraction of LP shaft power after fourth boiler pass (K8). Typical value = 0. Default: 0.0 + :db1: Intentional deadband width (db1). Unit = Hz. Typical value = 0. Default: 0.0 + :eps: Intentional db hysteresis (eps). Unit = Hz. Typical value = 0. Default: 0.0 + :sdb1: Intentional deadband indicator. true = intentional deadband is applied false = intentional deadband is not applied. Typical value = true. Default: False + :sdb2: Unintentional deadband location. true = intentional deadband is applied before point `A` false = intentional deadband is applied after point `A`. Typical value = true. Default: False + :db2: Unintentional deadband (db2). Unit = MW. Typical value = 0. Default: 0.0 + :valve: Nonlinear valve characteristic. true = nonlinear valve characteristic is used false = nonlinear valve characteristic is not used. Typical value = true. Default: False + :gv1: Nonlinear gain valve position point 1 (GV1). Typical value = 0. Default: 0.0 + :pgv1: Nonlinear gain power value point 1 (Pgv1). Typical value = 0. Default: 0.0 + :gv2: Nonlinear gain valve position point 2 (GV2). Typical value = 0,4. Default: 0.0 + :pgv2: Nonlinear gain power value point 2 (Pgv2). Typical value = 0,75. Default: 0.0 + :gv3: Nonlinear gain valve position point 3 (GV3). Typical value = 0,5. Default: 0.0 + :pgv3: Nonlinear gain power value point 3 (Pgv3). Typical value = 0,91. Default: 0.0 + :gv4: Nonlinear gain valve position point 4 (GV4). Typical value = 0,6. Default: 0.0 + :pgv4: Nonlinear gain power value point 4 (Pgv4). Typical value = 0,98. Default: 0.0 + :gv5: Nonlinear gain valve position point 5 (GV5). Typical value = 1. Default: 0.0 + :pgv5: Nonlinear gain power value point 5 (Pgv5). Typical value = 1. Default: 0.0 + :gv6: Nonlinear gain valve position point 6 (GV6). Typical value = 0. Default: 0.0 + :pgv6: Nonlinear gain power value point 6 (Pgv6). Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'k': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 'uo': [cgmesProfile.DY.value, ], + 'uc': [cgmesProfile.DY.value, ], + 'pmax': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 'k1': [cgmesProfile.DY.value, ], + 'k2': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 'k3': [cgmesProfile.DY.value, ], + 'k4': [cgmesProfile.DY.value, ], + 't6': [cgmesProfile.DY.value, ], + 'k5': [cgmesProfile.DY.value, ], + 'k6': [cgmesProfile.DY.value, ], + 't7': [cgmesProfile.DY.value, ], + 'k7': [cgmesProfile.DY.value, ], + 'k8': [cgmesProfile.DY.value, ], + 'db1': [cgmesProfile.DY.value, ], + 'eps': [cgmesProfile.DY.value, ], + 'sdb1': [cgmesProfile.DY.value, ], + 'sdb2': [cgmesProfile.DY.value, ], + 'db2': [cgmesProfile.DY.value, ], + 'valve': [cgmesProfile.DY.value, ], + 'gv1': [cgmesProfile.DY.value, ], + 'pgv1': [cgmesProfile.DY.value, ], + 'gv2': [cgmesProfile.DY.value, ], + 'pgv2': [cgmesProfile.DY.value, ], + 'gv3': [cgmesProfile.DY.value, ], + 'pgv3': [cgmesProfile.DY.value, ], + 'gv4': [cgmesProfile.DY.value, ], + 'pgv4': [cgmesProfile.DY.value, ], + 'gv5': [cgmesProfile.DY.value, ], + 'pgv5': [cgmesProfile.DY.value, ], + 'gv6': [cgmesProfile.DY.value, ], + 'pgv6': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, k = 0.0, t1 = 0, t2 = 0, t3 = 0, uo = 0.0, uc = 0.0, pmax = 0.0, pmin = 0.0, t4 = 0, k1 = 0.0, k2 = 0.0, t5 = 0, k3 = 0.0, k4 = 0.0, t6 = 0, k5 = 0.0, k6 = 0.0, t7 = 0, k7 = 0.0, k8 = 0.0, db1 = 0.0, eps = 0.0, sdb1 = False, sdb2 = False, db2 = 0.0, valve = False, gv1 = 0.0, pgv1 = 0.0, gv2 = 0.0, pgv2 = 0.0, gv3 = 0.0, pgv3 = 0.0, gv4 = 0.0, pgv4 = 0.0, gv5 = 0.0, pgv5 = 0.0, gv6 = 0.0, pgv6 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.k = k + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.uo = uo + self.uc = uc + self.pmax = pmax + self.pmin = pmin + self.t4 = t4 + self.k1 = k1 + self.k2 = k2 + self.t5 = t5 + self.k3 = k3 + self.k4 = k4 + self.t6 = t6 + self.k5 = k5 + self.k6 = k6 + self.t7 = t7 + self.k7 = k7 + self.k8 = k8 + self.db1 = db1 + self.eps = eps + self.sdb1 = sdb1 + self.sdb2 = sdb2 + self.db2 = db2 + self.valve = valve + self.gv1 = gv1 + self.pgv1 = pgv1 + self.gv2 = gv2 + self.pgv2 = pgv2 + self.gv3 = gv3 + self.pgv3 = pgv3 + self.gv4 = gv4 + self.pgv4 = pgv4 + self.gv5 = gv5 + self.pgv5 = pgv5 + self.gv6 = gv6 + self.pgv6 = pgv6 + + def __str__(self): + str = 'class=GovSteam1\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovSteam2.py b/cimpy/cgmes_v3_0_0/GovSteam2.py new file mode 100644 index 00000000..77b8c171 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovSteam2.py @@ -0,0 +1,52 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovSteam2(TurbineGovernorDynamics): + ''' + Simplified governor. + + :k: Governor gain (reciprocal of droop) (K). Typical value = 20. Default: 0.0 + :dbf: Frequency deadband (DBF). Typical value = 0. Default: 0.0 + :t1: Governor lag time constant (T1) (> 0). Typical value = 0,45. Default: 0 + :t2: Governor lead time constant (T2) (>= 0). Typical value = 0. Default: 0 + :pmax: Maximum fuel flow (PMAX) (> GovSteam2.pmin). Typical value = 1. Default: 0.0 + :pmin: Minimum fuel flow (PMIN) (< GovSteam2.pmax). Typical value = 0. Default: 0.0 + :mxef: Fuel flow maximum positive error value (MXEF). Typical value = 1. Default: 0.0 + :mnef: Fuel flow maximum negative error value (MNEF). Typical value = -1. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'k': [cgmesProfile.DY.value, ], + 'dbf': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 'pmax': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + 'mxef': [cgmesProfile.DY.value, ], + 'mnef': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, k = 0.0, dbf = 0.0, t1 = 0, t2 = 0, pmax = 0.0, pmin = 0.0, mxef = 0.0, mnef = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.k = k + self.dbf = dbf + self.t1 = t1 + self.t2 = t2 + self.pmax = pmax + self.pmin = pmin + self.mxef = mxef + self.mnef = mnef + + def __str__(self): + str = 'class=GovSteam2\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovSteamBB.py b/cimpy/cgmes_v3_0_0/GovSteamBB.py new file mode 100644 index 00000000..e08ce8d1 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovSteamBB.py @@ -0,0 +1,79 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovSteamBB(TurbineGovernorDynamics): + ''' + European governor model. + + :fcut: Frequency deadband (fcut) (>= 0). Typical value = 0,002. Default: 0.0 + :ks: Gain (Ks). Typical value = 21,0. Default: 0.0 + :kls: Gain (Kls) (> 0). Typical value = 0,1. Default: 0.0 + :kg: Gain (Kg). Typical value = 1,0. Default: 0.0 + :t1: Time constant (T1). Typical value = 0,05. Default: 0 + :kp: Gain (Kp). Typical value = 1,0. Default: 0.0 + :tn: Time constant (Tn) (> 0). Typical value = 1,0. Default: 0 + :kd: Gain (Kd). Typical value = 1,0. Default: 0.0 + :td: Time constant (Td) (> 0). Typical value = 1,0. Default: 0 + :pmax: High power limit (Pmax) (> GovSteamBB.pmin). Typical value = 1,0. Default: 0.0 + :pmin: Low power limit (Pmin) (< GovSteamBB.pmax). Typical value = 0. Default: 0.0 + :t4: Time constant (T4). Typical value = 0,15. Default: 0 + :k2: Gain (K2). Typical value = 0,75. Default: 0.0 + :t5: Time constant (T5). Typical value = 12,0. Default: 0 + :k3: Gain (K3). Typical value = 0,5. Default: 0.0 + :t6: Time constant (T6). Typical value = 0,75. Default: 0 + :peflag: Electric power input selection (Peflag). true = electric power input false = feedback signal. Typical value = false. Default: False + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'fcut': [cgmesProfile.DY.value, ], + 'ks': [cgmesProfile.DY.value, ], + 'kls': [cgmesProfile.DY.value, ], + 'kg': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'tn': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'td': [cgmesProfile.DY.value, ], + 'pmax': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 'k2': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 'k3': [cgmesProfile.DY.value, ], + 't6': [cgmesProfile.DY.value, ], + 'peflag': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, fcut = 0.0, ks = 0.0, kls = 0.0, kg = 0.0, t1 = 0, kp = 0.0, tn = 0, kd = 0.0, td = 0, pmax = 0.0, pmin = 0.0, t4 = 0, k2 = 0.0, t5 = 0, k3 = 0.0, t6 = 0, peflag = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.fcut = fcut + self.ks = ks + self.kls = kls + self.kg = kg + self.t1 = t1 + self.kp = kp + self.tn = tn + self.kd = kd + self.td = td + self.pmax = pmax + self.pmin = pmin + self.t4 = t4 + self.k2 = k2 + self.t5 = t5 + self.k3 = k3 + self.t6 = t6 + self.peflag = peflag + + def __str__(self): + str = 'class=GovSteamBB\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovSteamCC.py b/cimpy/cgmes_v3_0_0/GovSteamCC.py new file mode 100644 index 00000000..c672ba03 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovSteamCC.py @@ -0,0 +1,79 @@ +from .CrossCompoundTurbineGovernorDynamics import CrossCompoundTurbineGovernorDynamics + + +class GovSteamCC(CrossCompoundTurbineGovernorDynamics): + ''' + Cross compound turbine governor. Unlike tandem compound units, cross compound units are not on the same shaft. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :pmaxhp: Maximum HP value position (Pmaxhp). Typical value = 1. Default: 0.0 + :rhp: HP governor droop (Rhp) (> 0). Typical value = 0,05. Default: 0.0 + :t1hp: HP governor time constant (T1hp) (>= 0). Typical value = 0,1. Default: 0 + :t3hp: HP turbine time constant (T3hp) (>= 0). Typical value = 0,1. Default: 0 + :t4hp: HP turbine time constant (T4hp) (>= 0). Typical value = 0,1. Default: 0 + :t5hp: HP reheater time constant (T5hp) (>= 0). Typical value = 10. Default: 0 + :fhp: Fraction of HP power ahead of reheater (Fhp). Typical value = 0,3. Default: 0.0 + :dhp: HP damping factor (Dhp). Typical value = 0. Default: 0.0 + :pmaxlp: Maximum LP value position (Pmaxlp). Typical value = 1. Default: 0.0 + :rlp: LP governor droop (Rlp) (> 0). Typical value = 0,05. Default: 0.0 + :t1lp: LP governor time constant (T1lp) (>= 0). Typical value = 0,1. Default: 0 + :t3lp: LP turbine time constant (T3lp) (>= 0). Typical value = 0,1. Default: 0 + :t4lp: LP turbine time constant (T4lp) (>= 0). Typical value = 0,1. Default: 0 + :t5lp: LP reheater time constant (T5lp) (>= 0). Typical value = 10. Default: 0 + :flp: Fraction of LP power ahead of reheater (Flp). Typical value = 0,7. Default: 0.0 + :dlp: LP damping factor (Dlp). Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = CrossCompoundTurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'pmaxhp': [cgmesProfile.DY.value, ], + 'rhp': [cgmesProfile.DY.value, ], + 't1hp': [cgmesProfile.DY.value, ], + 't3hp': [cgmesProfile.DY.value, ], + 't4hp': [cgmesProfile.DY.value, ], + 't5hp': [cgmesProfile.DY.value, ], + 'fhp': [cgmesProfile.DY.value, ], + 'dhp': [cgmesProfile.DY.value, ], + 'pmaxlp': [cgmesProfile.DY.value, ], + 'rlp': [cgmesProfile.DY.value, ], + 't1lp': [cgmesProfile.DY.value, ], + 't3lp': [cgmesProfile.DY.value, ], + 't4lp': [cgmesProfile.DY.value, ], + 't5lp': [cgmesProfile.DY.value, ], + 'flp': [cgmesProfile.DY.value, ], + 'dlp': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class CrossCompoundTurbineGovernorDynamics: \n' + CrossCompoundTurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, pmaxhp = 0.0, rhp = 0.0, t1hp = 0, t3hp = 0, t4hp = 0, t5hp = 0, fhp = 0.0, dhp = 0.0, pmaxlp = 0.0, rlp = 0.0, t1lp = 0, t3lp = 0, t4lp = 0, t5lp = 0, flp = 0.0, dlp = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.pmaxhp = pmaxhp + self.rhp = rhp + self.t1hp = t1hp + self.t3hp = t3hp + self.t4hp = t4hp + self.t5hp = t5hp + self.fhp = fhp + self.dhp = dhp + self.pmaxlp = pmaxlp + self.rlp = rlp + self.t1lp = t1lp + self.t3lp = t3lp + self.t4lp = t4lp + self.t5lp = t5lp + self.flp = flp + self.dlp = dlp + + def __str__(self): + str = 'class=GovSteamCC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovSteamEU.py b/cimpy/cgmes_v3_0_0/GovSteamEU.py new file mode 100644 index 00000000..1155eb06 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovSteamEU.py @@ -0,0 +1,133 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovSteamEU(TurbineGovernorDynamics): + ''' + Simplified boiler and steam turbine with PID governor. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :tp: Power transducer time constant (Tp) (>= 0). Typical value = 0,07. Default: 0 + :ke: Gain of the power controller (Ke). Typical value = 0,65. Default: 0.0 + :tip: Integral time constant of the power controller (Tip) (>= 0). Typical value = 2. Default: 0 + :tdp: Derivative time constant of the power controller (Tdp) (>= 0). Typical value = 0. Default: 0 + :tfp: Time constant of the power controller (Tfp) (>= 0). Typical value = 0. Default: 0 + :tf: Frequency transducer time constant (Tf) (>= 0). Typical value = 0. Default: 0 + :kfcor: Gain of the frequency corrector (Kfcor). Typical value = 20. Default: 0.0 + :db1: Deadband of the frequency corrector (db1). Typical value = 0. Default: 0.0 + :wfmax: Upper limit for frequency correction (Wfmax) (> GovSteamEU.wfmin). Typical value = 0,05. Default: 0.0 + :wfmin: Lower limit for frequency correction (Wfmin) (< GovSteamEU.wfmax). Typical value = -0,05. Default: 0.0 + :pmax: Maximal active power of the turbine (Pmax). Typical value = 1. Default: 0.0 + :ten: Electro hydraulic transducer (Ten) (>= 0). Typical value = 0,1. Default: 0 + :tw: Speed transducer time constant (Tw) (>= 0). Typical value = 0,02. Default: 0 + :komegacor: Gain of the speed governor (Kwcor). Typical value = 20. Default: 0.0 + :db2: Deadband of the speed governor (db2). Typical value = 0,0004. Default: 0.0 + :wwmax: Upper limit for the speed governor (Wwmax) (> GovSteamEU.wwmin). Typical value = 0,1. Default: 0.0 + :wwmin: Lower limit for the speed governor frequency correction (Wwmin) (< GovSteamEU.wwmax). Typical value = -1. Default: 0.0 + :wmax1: Emergency speed control lower limit (wmax1). Typical value = 1,025. Default: 0.0 + :wmax2: Emergency speed control upper limit (wmax2). Typical value = 1,05. Default: 0.0 + :tvhp: Control valves servo time constant (Tvhp) (>= 0). Typical value = 0,1. Default: 0 + :cho: Control valves rate opening limit (Cho). Unit = PU / s. Typical value = 0,17. Default: 0.0 + :chc: Control valves rate closing limit (Chc). Unit = PU / s. Typical value = -3,3. Default: 0.0 + :hhpmax: Maximum control valve position (Hhpmax). Typical value = 1. Default: 0.0 + :tvip: Intercept valves servo time constant (Tvip) (>= 0). Typical value = 0,15. Default: 0 + :cio: Intercept valves rate opening limit (Cio). Typical value = 0,123. Default: 0.0 + :cic: Intercept valves rate closing limit (Cic). Typical value = -2,2. Default: 0.0 + :simx: Intercept valves transfer limit (Simx). Typical value = 0,425. Default: 0.0 + :thp: High pressure (HP) time constant of the turbine (Thp) (>= 0). Typical value = 0,31. Default: 0 + :trh: Reheater time constant of the turbine (Trh) (>= 0). Typical value = 8. Default: 0 + :tlp: Low pressure (LP) time constant of the turbine (Tlp) (>= 0). Typical value = 0,45. Default: 0 + :prhmax: Maximum low pressure limit (Prhmax). Typical value = 1,4. Default: 0.0 + :khp: Fraction of total turbine output generated by HP part (Khp). Typical value = 0,277. Default: 0.0 + :klp: Fraction of total turbine output generated by HP part (Klp). Typical value = 0,723. Default: 0.0 + :tb: Boiler time constant (Tb) (>= 0). Typical value = 100. Default: 0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'tp': [cgmesProfile.DY.value, ], + 'ke': [cgmesProfile.DY.value, ], + 'tip': [cgmesProfile.DY.value, ], + 'tdp': [cgmesProfile.DY.value, ], + 'tfp': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'kfcor': [cgmesProfile.DY.value, ], + 'db1': [cgmesProfile.DY.value, ], + 'wfmax': [cgmesProfile.DY.value, ], + 'wfmin': [cgmesProfile.DY.value, ], + 'pmax': [cgmesProfile.DY.value, ], + 'ten': [cgmesProfile.DY.value, ], + 'tw': [cgmesProfile.DY.value, ], + 'komegacor': [cgmesProfile.DY.value, ], + 'db2': [cgmesProfile.DY.value, ], + 'wwmax': [cgmesProfile.DY.value, ], + 'wwmin': [cgmesProfile.DY.value, ], + 'wmax1': [cgmesProfile.DY.value, ], + 'wmax2': [cgmesProfile.DY.value, ], + 'tvhp': [cgmesProfile.DY.value, ], + 'cho': [cgmesProfile.DY.value, ], + 'chc': [cgmesProfile.DY.value, ], + 'hhpmax': [cgmesProfile.DY.value, ], + 'tvip': [cgmesProfile.DY.value, ], + 'cio': [cgmesProfile.DY.value, ], + 'cic': [cgmesProfile.DY.value, ], + 'simx': [cgmesProfile.DY.value, ], + 'thp': [cgmesProfile.DY.value, ], + 'trh': [cgmesProfile.DY.value, ], + 'tlp': [cgmesProfile.DY.value, ], + 'prhmax': [cgmesProfile.DY.value, ], + 'khp': [cgmesProfile.DY.value, ], + 'klp': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, tp = 0, ke = 0.0, tip = 0, tdp = 0, tfp = 0, tf = 0, kfcor = 0.0, db1 = 0.0, wfmax = 0.0, wfmin = 0.0, pmax = 0.0, ten = 0, tw = 0, komegacor = 0.0, db2 = 0.0, wwmax = 0.0, wwmin = 0.0, wmax1 = 0.0, wmax2 = 0.0, tvhp = 0, cho = 0.0, chc = 0.0, hhpmax = 0.0, tvip = 0, cio = 0.0, cic = 0.0, simx = 0.0, thp = 0, trh = 0, tlp = 0, prhmax = 0.0, khp = 0.0, klp = 0.0, tb = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.tp = tp + self.ke = ke + self.tip = tip + self.tdp = tdp + self.tfp = tfp + self.tf = tf + self.kfcor = kfcor + self.db1 = db1 + self.wfmax = wfmax + self.wfmin = wfmin + self.pmax = pmax + self.ten = ten + self.tw = tw + self.komegacor = komegacor + self.db2 = db2 + self.wwmax = wwmax + self.wwmin = wwmin + self.wmax1 = wmax1 + self.wmax2 = wmax2 + self.tvhp = tvhp + self.cho = cho + self.chc = chc + self.hhpmax = hhpmax + self.tvip = tvip + self.cio = cio + self.cic = cic + self.simx = simx + self.thp = thp + self.trh = trh + self.tlp = tlp + self.prhmax = prhmax + self.khp = khp + self.klp = klp + self.tb = tb + + def __str__(self): + str = 'class=GovSteamEU\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovSteamFV2.py b/cimpy/cgmes_v3_0_0/GovSteamFV2.py new file mode 100644 index 00000000..f8859140 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovSteamFV2.py @@ -0,0 +1,64 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovSteamFV2(TurbineGovernorDynamics): + ''' + Steam turbine governor with reheat time constants and modelling of the effects of fast valve closing to reduce mechanical power. + + :mwbase: Alternate base used instead of machine base in equipment model if necessary (MWbase) (> 0). Unit = MW. Default: 0.0 + :t1: Governor time constant (T1) (>= 0). Default: 0 + :vmax: (Vmax) (> GovSteamFV2.vmin). Default: 0.0 + :vmin: (Vmin) (< GovSteamFV2.vmax). Default: 0.0 + :k: Fraction of the turbine power developed by turbine sections not involved in fast valving (K). Default: 0.0 + :t3: Reheater time constant (T3) (>= 0). Default: 0 + :dt: (Dt). Default: 0.0 + :tt: Time constant with which power falls off after intercept valve closure (Tt) (>= 0). Default: 0 + :r: (R). Default: 0.0 + :ta: Time after initial time for valve to close (Ta) (>= 0). Default: 0 + :tb: Time after initial time for valve to begin opening (Tb) (>= 0). Default: 0 + :tc: Time after initial time for valve to become fully open (Tc) (>= 0). Default: 0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 'vmax': [cgmesProfile.DY.value, ], + 'vmin': [cgmesProfile.DY.value, ], + 'k': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 'dt': [cgmesProfile.DY.value, ], + 'tt': [cgmesProfile.DY.value, ], + 'r': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, t1 = 0, vmax = 0.0, vmin = 0.0, k = 0.0, t3 = 0, dt = 0.0, tt = 0, r = 0.0, ta = 0, tb = 0, tc = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.t1 = t1 + self.vmax = vmax + self.vmin = vmin + self.k = k + self.t3 = t3 + self.dt = dt + self.tt = tt + self.r = r + self.ta = ta + self.tb = tb + self.tc = tc + + def __str__(self): + str = 'class=GovSteamFV2\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovSteamFV3.py b/cimpy/cgmes_v3_0_0/GovSteamFV3.py new file mode 100644 index 00000000..793297d1 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovSteamFV3.py @@ -0,0 +1,121 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovSteamFV3(TurbineGovernorDynamics): + ''' + Simplified GovSteamIEEE1 steam turbine governor with Prmax limit and fast valving. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :k: Governor gain, (reciprocal of droop) (K). Typical value = 20. Default: 0.0 + :t1: Governor lead time constant (T1) (>= 0). Typical value = 0. Default: 0 + :t2: Governor lag time constant (T2) (>= 0). Typical value = 0. Default: 0 + :t3: Valve positioner time constant (T3) (> 0). Typical value = 0. Default: 0 + :uo: Maximum valve opening velocity (Uo). Unit = PU / s. Typical value = 0,1. Default: 0.0 + :uc: Maximum valve closing velocity (Uc). Unit = PU / s. Typical value = -1. Default: 0.0 + :pmax: Maximum valve opening, PU of MWbase (Pmax) (> GovSteamFV3.pmin). Typical value = 1. Default: 0.0 + :pmin: Minimum valve opening, PU of MWbase (Pmin) (< GovSteamFV3.pmax). Typical value = 0. Default: 0.0 + :t4: Inlet piping/steam bowl time constant (T4) (>= 0). Typical value = 0,2. Default: 0 + :k1: Fraction of turbine power developed after first boiler pass (K1). Typical value = 0,2. Default: 0.0 + :t5: Time constant of second boiler pass (i.e. reheater) (T5) (> 0 if fast valving is used, otherwise >= 0). Typical value = 0,5. Default: 0 + :k2: Fraction of turbine power developed after second boiler pass (K2). Typical value = 0,2. Default: 0.0 + :t6: Time constant of crossover or third boiler pass (T6) (>= 0). Typical value = 10. Default: 0 + :k3: Fraction of hp turbine power developed after crossover or third boiler pass (K3). Typical value = 0,6. Default: 0.0 + :ta: Time to close intercept valve (IV) (Ta) (>= 0). Typical value = 0,97. Default: 0 + :tb: Time until IV starts to reopen (Tb) (>= 0). Typical value = 0,98. Default: 0 + :tc: Time until IV is fully open (Tc) (>= 0). Typical value = 0,99. Default: 0 + :prmax: Max. pressure in reheater (Prmax). Typical value = 1. Default: 0.0 + :gv1: Nonlinear gain valve position point 1 (GV1). Typical value = 0. Default: 0.0 + :pgv1: Nonlinear gain power value point 1 (Pgv1). Typical value = 0. Default: 0.0 + :gv2: Nonlinear gain valve position point 2 (GV2). Typical value = 0,4. Default: 0.0 + :pgv2: Nonlinear gain power value point 2 (Pgv2). Typical value = 0,75. Default: 0.0 + :gv3: Nonlinear gain valve position point 3 (GV3). Typical value = 0,5. Default: 0.0 + :pgv3: Nonlinear gain power value point 3 (Pgv3). Typical value = 0,91. Default: 0.0 + :gv4: Nonlinear gain valve position point 4 (GV4). Typical value = 0,6. Default: 0.0 + :pgv4: Nonlinear gain power value point 4 (Pgv4). Typical value = 0,98. Default: 0.0 + :gv5: Nonlinear gain valve position point 5 (GV5). Typical value = 1. Default: 0.0 + :pgv5: Nonlinear gain power value point 5 (Pgv5). Typical value = 1. Default: 0.0 + :gv6: Nonlinear gain valve position point 6 (GV6). Typical value = 0. Default: 0.0 + :pgv6: Nonlinear gain power value point 6 (Pgv6). Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'k': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 'uo': [cgmesProfile.DY.value, ], + 'uc': [cgmesProfile.DY.value, ], + 'pmax': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 'k1': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 'k2': [cgmesProfile.DY.value, ], + 't6': [cgmesProfile.DY.value, ], + 'k3': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'prmax': [cgmesProfile.DY.value, ], + 'gv1': [cgmesProfile.DY.value, ], + 'pgv1': [cgmesProfile.DY.value, ], + 'gv2': [cgmesProfile.DY.value, ], + 'pgv2': [cgmesProfile.DY.value, ], + 'gv3': [cgmesProfile.DY.value, ], + 'pgv3': [cgmesProfile.DY.value, ], + 'gv4': [cgmesProfile.DY.value, ], + 'pgv4': [cgmesProfile.DY.value, ], + 'gv5': [cgmesProfile.DY.value, ], + 'pgv5': [cgmesProfile.DY.value, ], + 'gv6': [cgmesProfile.DY.value, ], + 'pgv6': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, k = 0.0, t1 = 0, t2 = 0, t3 = 0, uo = 0.0, uc = 0.0, pmax = 0.0, pmin = 0.0, t4 = 0, k1 = 0.0, t5 = 0, k2 = 0.0, t6 = 0, k3 = 0.0, ta = 0, tb = 0, tc = 0, prmax = 0.0, gv1 = 0.0, pgv1 = 0.0, gv2 = 0.0, pgv2 = 0.0, gv3 = 0.0, pgv3 = 0.0, gv4 = 0.0, pgv4 = 0.0, gv5 = 0.0, pgv5 = 0.0, gv6 = 0.0, pgv6 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.k = k + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.uo = uo + self.uc = uc + self.pmax = pmax + self.pmin = pmin + self.t4 = t4 + self.k1 = k1 + self.t5 = t5 + self.k2 = k2 + self.t6 = t6 + self.k3 = k3 + self.ta = ta + self.tb = tb + self.tc = tc + self.prmax = prmax + self.gv1 = gv1 + self.pgv1 = pgv1 + self.gv2 = gv2 + self.pgv2 = pgv2 + self.gv3 = gv3 + self.pgv3 = pgv3 + self.gv4 = gv4 + self.pgv4 = pgv4 + self.gv5 = gv5 + self.pgv5 = pgv5 + self.gv6 = gv6 + self.pgv6 = pgv6 + + def __str__(self): + str = 'class=GovSteamFV3\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovSteamFV4.py b/cimpy/cgmes_v3_0_0/GovSteamFV4.py new file mode 100644 index 00000000..00826b60 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovSteamFV4.py @@ -0,0 +1,181 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovSteamFV4(TurbineGovernorDynamics): + ''' + Detailed electro-hydraulic governor for steam unit. + + :kf1: Frequency bias (reciprocal of droop) (Kf1). Typical value = 20. Default: 0.0 + :kf3: Frequency control (reciprocal of droop) (Kf3). Typical value = 20. Default: 0.0 + :lps: Maximum positive power error (Lps). Typical value = 0,03. Default: 0.0 + :lpi: Maximum negative power error (Lpi). Typical value = -0,15. Default: 0.0 + :mxef: Upper limit for frequency correction (MXEF). Typical value = 0,05. Default: 0.0 + :mnef: Lower limit for frequency correction (MNEF). Typical value = -0,05. Default: 0.0 + :crmx: Maximum value of regulator set-point (Crmx). Typical value = 1,2. Default: 0.0 + :crmn: Minimum value of regulator set-point (Crmn). Typical value = 0. Default: 0.0 + :kpt: Proportional gain of electro-hydraulic regulator (Kpt). Typical value = 0,3. Default: 0.0 + :kit: Integral gain of electro-hydraulic regulator (Kit). Typical value = 0,04. Default: 0.0 + :rvgmx: Maximum value of integral regulator (Rvgmx). Typical value = 1,2. Default: 0.0 + :rvgmn: Minimum value of integral regulator (Rvgmn). Typical value = 0. Default: 0.0 + :svmx: Maximum regulator gate opening velocity (Svmx). Typical value = 0,0333. Default: 0.0 + :svmn: Maximum regulator gate closing velocity (Svmn). Typical value = -0,0333. Default: 0.0 + :srmx: Maximum valve opening (Srmx). Typical value = 1,1. Default: 0.0 + :srmn: Minimum valve opening (Srmn). Typical value = 0. Default: 0.0 + :kpp: Proportional gain of pressure feedback regulator (Kpp). Typical value = 1. Default: 0.0 + :kip: Integral gain of pressure feedback regulator (Kip). Typical value = 0,5. Default: 0.0 + :rsmimx: Maximum value of integral regulator (Rsmimx). Typical value = 1,1. Default: 0.0 + :rsmimn: Minimum value of integral regulator (Rsmimn). Typical value = 0. Default: 0.0 + :kmp1: First gain coefficient of intercept valves characteristic (Kmp1). Typical value = 0,5. Default: 0.0 + :kmp2: Second gain coefficient of intercept valves characteristic (Kmp2). Typical value = 3,5. Default: 0.0 + :srsmp: Intercept valves characteristic discontinuity point (Srsmp). Typical value = 0,43. Default: 0.0 + :ta: Control valves rate opening time (Ta) (>= 0). Typical value = 0,8. Default: 0 + :tc: Control valves rate closing time (Tc) (>= 0). Typical value = 0,5. Default: 0 + :ty: Control valves servo time constant (Ty) (>= 0). Typical value = 0,1. Default: 0 + :yhpmx: Maximum control valve position (Yhpmx). Typical value = 1,1. Default: 0.0 + :yhpmn: Minimum control valve position (Yhpmn). Typical value = 0. Default: 0.0 + :tam: Intercept valves rate opening time (Tam) (>= 0). Typical value = 0,8. Default: 0 + :tcm: Intercept valves rate closing time (Tcm) (>= 0). Typical value = 0,5. Default: 0 + :ympmx: Maximum intercept valve position (Ympmx). Typical value = 1,1. Default: 0.0 + :ympmn: Minimum intercept valve position (Ympmn). Typical value = 0. Default: 0.0 + :y: Coefficient of linearized equations of turbine (Stodola formulation) (Y). Typical value = 0,13. Default: 0.0 + :thp: High pressure (HP) time constant of the turbine (Thp) (>= 0). Typical value = 0,15. Default: 0 + :trh: Reheater time constant of the turbine (Trh) (>= 0). Typical value = 10. Default: 0 + :tmp: Low pressure (LP) time constant of the turbine (Tmp) (>= 0). Typical value = 0,4. Default: 0 + :khp: Fraction of total turbine output generated by HP part (Khp). Typical value = 0,35. Default: 0.0 + :pr1: First value of pressure set point static characteristic (Pr1). Typical value = 0,2. Default: 0.0 + :pr2: Second value of pressure set point static characteristic, corresponding to Ps0 = 1,0 PU (Pr2). Typical value = 0,75. Default: 0.0 + :psmn: Minimum value of pressure set point static characteristic (Psmn). Typical value = 1. Default: 0.0 + :kpc: Proportional gain of pressure regulator (Kpc). Typical value = 0,5. Default: 0.0 + :kic: Integral gain of pressure regulator (Kic). Typical value = 0,0033. Default: 0.0 + :kdc: Derivative gain of pressure regulator (Kdc). Typical value = 1. Default: 0.0 + :tdc: Derivative time constant of pressure regulator (Tdc) (>= 0). Typical value = 90. Default: 0 + :cpsmx: Maximum value of pressure regulator output (Cpsmx). Typical value = 1. Default: 0.0 + :cpsmn: Minimum value of pressure regulator output (Cpsmn). Typical value = -1. Default: 0.0 + :krc: Maximum variation of fuel flow (Krc). Typical value = 0,05. Default: 0.0 + :tf1: Time constant of fuel regulation (Tf1) (>= 0). Typical value = 10. Default: 0 + :tf2: Time constant of steam chest (Tf2) (>= 0). Typical value = 10. Default: 0 + :tv: Boiler time constant (Tv) (>= 0). Typical value = 60. Default: 0 + :ksh: Pressure loss due to flow friction in the boiler tubes (Ksh). Typical value = 0,08. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'kf1': [cgmesProfile.DY.value, ], + 'kf3': [cgmesProfile.DY.value, ], + 'lps': [cgmesProfile.DY.value, ], + 'lpi': [cgmesProfile.DY.value, ], + 'mxef': [cgmesProfile.DY.value, ], + 'mnef': [cgmesProfile.DY.value, ], + 'crmx': [cgmesProfile.DY.value, ], + 'crmn': [cgmesProfile.DY.value, ], + 'kpt': [cgmesProfile.DY.value, ], + 'kit': [cgmesProfile.DY.value, ], + 'rvgmx': [cgmesProfile.DY.value, ], + 'rvgmn': [cgmesProfile.DY.value, ], + 'svmx': [cgmesProfile.DY.value, ], + 'svmn': [cgmesProfile.DY.value, ], + 'srmx': [cgmesProfile.DY.value, ], + 'srmn': [cgmesProfile.DY.value, ], + 'kpp': [cgmesProfile.DY.value, ], + 'kip': [cgmesProfile.DY.value, ], + 'rsmimx': [cgmesProfile.DY.value, ], + 'rsmimn': [cgmesProfile.DY.value, ], + 'kmp1': [cgmesProfile.DY.value, ], + 'kmp2': [cgmesProfile.DY.value, ], + 'srsmp': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'ty': [cgmesProfile.DY.value, ], + 'yhpmx': [cgmesProfile.DY.value, ], + 'yhpmn': [cgmesProfile.DY.value, ], + 'tam': [cgmesProfile.DY.value, ], + 'tcm': [cgmesProfile.DY.value, ], + 'ympmx': [cgmesProfile.DY.value, ], + 'ympmn': [cgmesProfile.DY.value, ], + 'y': [cgmesProfile.DY.value, ], + 'thp': [cgmesProfile.DY.value, ], + 'trh': [cgmesProfile.DY.value, ], + 'tmp': [cgmesProfile.DY.value, ], + 'khp': [cgmesProfile.DY.value, ], + 'pr1': [cgmesProfile.DY.value, ], + 'pr2': [cgmesProfile.DY.value, ], + 'psmn': [cgmesProfile.DY.value, ], + 'kpc': [cgmesProfile.DY.value, ], + 'kic': [cgmesProfile.DY.value, ], + 'kdc': [cgmesProfile.DY.value, ], + 'tdc': [cgmesProfile.DY.value, ], + 'cpsmx': [cgmesProfile.DY.value, ], + 'cpsmn': [cgmesProfile.DY.value, ], + 'krc': [cgmesProfile.DY.value, ], + 'tf1': [cgmesProfile.DY.value, ], + 'tf2': [cgmesProfile.DY.value, ], + 'tv': [cgmesProfile.DY.value, ], + 'ksh': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, kf1 = 0.0, kf3 = 0.0, lps = 0.0, lpi = 0.0, mxef = 0.0, mnef = 0.0, crmx = 0.0, crmn = 0.0, kpt = 0.0, kit = 0.0, rvgmx = 0.0, rvgmn = 0.0, svmx = 0.0, svmn = 0.0, srmx = 0.0, srmn = 0.0, kpp = 0.0, kip = 0.0, rsmimx = 0.0, rsmimn = 0.0, kmp1 = 0.0, kmp2 = 0.0, srsmp = 0.0, ta = 0, tc = 0, ty = 0, yhpmx = 0.0, yhpmn = 0.0, tam = 0, tcm = 0, ympmx = 0.0, ympmn = 0.0, y = 0.0, thp = 0, trh = 0, tmp = 0, khp = 0.0, pr1 = 0.0, pr2 = 0.0, psmn = 0.0, kpc = 0.0, kic = 0.0, kdc = 0.0, tdc = 0, cpsmx = 0.0, cpsmn = 0.0, krc = 0.0, tf1 = 0, tf2 = 0, tv = 0, ksh = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.kf1 = kf1 + self.kf3 = kf3 + self.lps = lps + self.lpi = lpi + self.mxef = mxef + self.mnef = mnef + self.crmx = crmx + self.crmn = crmn + self.kpt = kpt + self.kit = kit + self.rvgmx = rvgmx + self.rvgmn = rvgmn + self.svmx = svmx + self.svmn = svmn + self.srmx = srmx + self.srmn = srmn + self.kpp = kpp + self.kip = kip + self.rsmimx = rsmimx + self.rsmimn = rsmimn + self.kmp1 = kmp1 + self.kmp2 = kmp2 + self.srsmp = srsmp + self.ta = ta + self.tc = tc + self.ty = ty + self.yhpmx = yhpmx + self.yhpmn = yhpmn + self.tam = tam + self.tcm = tcm + self.ympmx = ympmx + self.ympmn = ympmn + self.y = y + self.thp = thp + self.trh = trh + self.tmp = tmp + self.khp = khp + self.pr1 = pr1 + self.pr2 = pr2 + self.psmn = psmn + self.kpc = kpc + self.kic = kic + self.kdc = kdc + self.tdc = tdc + self.cpsmx = cpsmx + self.cpsmn = cpsmn + self.krc = krc + self.tf1 = tf1 + self.tf2 = tf2 + self.tv = tv + self.ksh = ksh + + def __str__(self): + str = 'class=GovSteamFV4\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovSteamIEEE1.py b/cimpy/cgmes_v3_0_0/GovSteamIEEE1.py new file mode 100644 index 00000000..e3953bc3 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovSteamIEEE1.py @@ -0,0 +1,91 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovSteamIEEE1(TurbineGovernorDynamics): + ''' + IEEE steam turbine governor model. Reference: IEEE Transactions on Power Apparatus and Systems, November/December 1973, Volume PAS-92, Number 6, Dynamic Models for Steam and Hydro Turbines in Power System Studies, page 1904. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :k: Governor gain (reciprocal of droop) (K) (> 0). Typical value = 25. Default: 0.0 + :t1: Governor lag time constant (T1) (>= 0). Typical value = 0. Default: 0 + :t2: Governor lead time constant (T2) (>= 0). Typical value = 0. Default: 0 + :t3: Valve positioner time constant (T3) (> 0). Typical value = 0,1. Default: 0 + :uo: Maximum valve opening velocity (Uo) (> 0). Unit = PU / s. Typical value = 1. Default: 0.0 + :uc: Maximum valve closing velocity (Uc) (< 0). Unit = PU / s. Typical value = -10. Default: 0.0 + :pmax: Maximum valve opening (Pmax) (> GovSteamIEEE1.pmin). Typical value = 1. Default: 0.0 + :pmin: Minimum valve opening (Pmin) (>= 0 and < GovSteamIEEE1.pmax). Typical value = 0. Default: 0.0 + :t4: Inlet piping/steam bowl time constant (T4) (>= 0). Typical value = 0,3. Default: 0 + :k1: Fraction of HP shaft power after first boiler pass (K1). Typical value = 0,2. Default: 0.0 + :k2: Fraction of LP shaft power after first boiler pass (K2). Typical value = 0. Default: 0.0 + :t5: Time constant of second boiler pass (T5) (>= 0). Typical value = 5. Default: 0 + :k3: Fraction of HP shaft power after second boiler pass (K3). Typical value = 0,3. Default: 0.0 + :k4: Fraction of LP shaft power after second boiler pass (K4). Typical value = 0. Default: 0.0 + :t6: Time constant of third boiler pass (T6) (>= 0). Typical value = 0,5. Default: 0 + :k5: Fraction of HP shaft power after third boiler pass (K5). Typical value = 0,5. Default: 0.0 + :k6: Fraction of LP shaft power after third boiler pass (K6). Typical value = 0. Default: 0.0 + :t7: Time constant of fourth boiler pass (T7) (>= 0). Typical value = 0. Default: 0 + :k7: Fraction of HP shaft power after fourth boiler pass (K7). Typical value = 0. Default: 0.0 + :k8: Fraction of LP shaft power after fourth boiler pass (K8). Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'k': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 'uo': [cgmesProfile.DY.value, ], + 'uc': [cgmesProfile.DY.value, ], + 'pmax': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 'k1': [cgmesProfile.DY.value, ], + 'k2': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 'k3': [cgmesProfile.DY.value, ], + 'k4': [cgmesProfile.DY.value, ], + 't6': [cgmesProfile.DY.value, ], + 'k5': [cgmesProfile.DY.value, ], + 'k6': [cgmesProfile.DY.value, ], + 't7': [cgmesProfile.DY.value, ], + 'k7': [cgmesProfile.DY.value, ], + 'k8': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, k = 0.0, t1 = 0, t2 = 0, t3 = 0, uo = 0.0, uc = 0.0, pmax = 0.0, pmin = 0.0, t4 = 0, k1 = 0.0, k2 = 0.0, t5 = 0, k3 = 0.0, k4 = 0.0, t6 = 0, k5 = 0.0, k6 = 0.0, t7 = 0, k7 = 0.0, k8 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.k = k + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.uo = uo + self.uc = uc + self.pmax = pmax + self.pmin = pmin + self.t4 = t4 + self.k1 = k1 + self.k2 = k2 + self.t5 = t5 + self.k3 = k3 + self.k4 = k4 + self.t6 = t6 + self.k5 = k5 + self.k6 = k6 + self.t7 = t7 + self.k7 = k7 + self.k8 = k8 + + def __str__(self): + str = 'class=GovSteamIEEE1\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GovSteamSGO.py b/cimpy/cgmes_v3_0_0/GovSteamSGO.py new file mode 100644 index 00000000..6bb03755 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GovSteamSGO.py @@ -0,0 +1,64 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class GovSteamSGO(TurbineGovernorDynamics): + ''' + Simplified steam turbine governor. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :t1: Controller lag (T1) (>= 0). Default: 0 + :t2: Controller lead compensation (T2) (>= 0). Default: 0 + :t3: Governor lag (T3) (> 0). Default: 0 + :t4: Delay due to steam inlet volumes associated with steam chest and inlet piping (T4) (>= 0). Default: 0 + :t5: Reheater delay including hot and cold leads (T5) (>= 0). Default: 0 + :t6: Delay due to IP-LP turbine, crossover pipes and LP end hoods (T6) (>= 0). Default: 0 + :k1: One / PU regulation (K1). Default: 0.0 + :k2: Fraction (K2). Default: 0.0 + :k3: Fraction (K3). Default: 0.0 + :pmax: Upper power limit (Pmax) (> GovSteamSGO.pmin). Default: 0.0 + :pmin: Lower power limit (Pmin) (>= 0 and < GovSteamSGO.pmax). Default: 0 + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 't6': [cgmesProfile.DY.value, ], + 'k1': [cgmesProfile.DY.value, ], + 'k2': [cgmesProfile.DY.value, ], + 'k3': [cgmesProfile.DY.value, ], + 'pmax': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, mwbase = 0.0, t1 = 0, t2 = 0, t3 = 0, t4 = 0, t5 = 0, t6 = 0, k1 = 0.0, k2 = 0.0, k3 = 0.0, pmax = 0.0, pmin = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.t4 = t4 + self.t5 = t5 + self.t6 = t6 + self.k1 = k1 + self.k2 = k2 + self.k3 = k3 + self.pmax = pmax + self.pmin = pmin + + def __str__(self): + str = 'class=GovSteamSGO\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GrossToNetActivePowerCurve.py b/cimpy/cgmes_v3_0_0/GrossToNetActivePowerCurve.py new file mode 100644 index 00000000..774569d8 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GrossToNetActivePowerCurve.py @@ -0,0 +1,31 @@ +from .Curve import Curve + + +class GrossToNetActivePowerCurve(Curve): + ''' + Relationship between the generating unit's gross active power output on the X-axis (measured at the terminals of the machine(s)) and the generating unit's net active power output on the Y-axis (based on utility-defined measurements at the power station). Station service loads, when modelled, should be treated as non-conforming bus loads. There may be more than one curve, depending on the auxiliary equipment that is in service. + + :GeneratingUnit: A generating unit may have a gross active power to net active power curve, describing the losses and auxiliary power requirements of the unit. Default: None + ''' + + cgmesProfile = Curve.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'GeneratingUnit': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Curve: \n' + Curve.__doc__ + + def __init__(self, GeneratingUnit = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.GeneratingUnit = GeneratingUnit + + def __str__(self): + str = 'class=GrossToNetActivePowerCurve\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Ground.py b/cimpy/cgmes_v3_0_0/Ground.py new file mode 100644 index 00000000..151d7e0f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Ground.py @@ -0,0 +1,29 @@ +from .ConductingEquipment import ConductingEquipment + + +class Ground(ConductingEquipment): + ''' + A point where the system is grounded used for connecting conducting equipment to ground. The power system model can have any number of grounds. + + ''' + + cgmesProfile = ConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ConductingEquipment: \n' + ConductingEquipment.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=Ground\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GroundDisconnector.py b/cimpy/cgmes_v3_0_0/GroundDisconnector.py new file mode 100644 index 00000000..cae79341 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GroundDisconnector.py @@ -0,0 +1,29 @@ +from .Switch import Switch + + +class GroundDisconnector(Switch): + ''' + A manually operated or motor operated mechanical switching device used for isolating a circuit or equipment from ground. + + ''' + + cgmesProfile = Switch.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Switch: \n' + Switch.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=GroundDisconnector\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/GroundingImpedance.py b/cimpy/cgmes_v3_0_0/GroundingImpedance.py new file mode 100644 index 00000000..9366807a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/GroundingImpedance.py @@ -0,0 +1,31 @@ +from .EarthFaultCompensator import EarthFaultCompensator + + +class GroundingImpedance(EarthFaultCompensator): + ''' + A fixed impedance device used for grounding. + + :x: Reactance of device. Default: 0.0 + ''' + + cgmesProfile = EarthFaultCompensator.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'x': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EarthFaultCompensator: \n' + EarthFaultCompensator.__doc__ + + def __init__(self, x = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.x = x + + def __str__(self): + str = 'class=GroundingImpedance\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/HVDCDynamics.py b/cimpy/cgmes_v3_0_0/HVDCDynamics.py new file mode 100644 index 00000000..af9f4b36 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/HVDCDynamics.py @@ -0,0 +1,29 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class HVDCDynamics(DynamicsFunctionBlock): + ''' + HVDC whose behaviour is described by reference to a standard model or by definition of a user-defined model. + + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=HVDCDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/HydroEnergyConversionKind.py b/cimpy/cgmes_v3_0_0/HydroEnergyConversionKind.py new file mode 100644 index 00000000..5f38ed4f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/HydroEnergyConversionKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class HydroEnergyConversionKind(Base): + ''' + Specifies the capability of the hydro generating unit to convert energy as a generator or pump. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=HydroEnergyConversionKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/HydroGeneratingUnit.py b/cimpy/cgmes_v3_0_0/HydroGeneratingUnit.py new file mode 100644 index 00000000..7492c375 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/HydroGeneratingUnit.py @@ -0,0 +1,40 @@ +from .GeneratingUnit import GeneratingUnit + + +class HydroGeneratingUnit(GeneratingUnit): + ''' + A generating unit whose prime mover is a hydraulic turbine (e.g., Francis, Pelton, Kaplan). + + :energyConversionCapability: Energy conversion capability for generating. Default: None + :dropHeight: The height water drops from the reservoir mid-point to the turbine. Default: 0.0 + :turbineType: Type of turbine. Default: None + :HydroPowerPlant: The hydro generating unit belongs to a hydro power plant. Default: None + ''' + + cgmesProfile = GeneratingUnit.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'energyConversionCapability': [cgmesProfile.EQ.value, ], + 'dropHeight': [cgmesProfile.EQ.value, ], + 'turbineType': [cgmesProfile.EQ.value, ], + 'HydroPowerPlant': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class GeneratingUnit: \n' + GeneratingUnit.__doc__ + + def __init__(self, energyConversionCapability = None, dropHeight = 0.0, turbineType = None, HydroPowerPlant = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.energyConversionCapability = energyConversionCapability + self.dropHeight = dropHeight + self.turbineType = turbineType + self.HydroPowerPlant = HydroPowerPlant + + def __str__(self): + str = 'class=HydroGeneratingUnit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/HydroPlantStorageKind.py b/cimpy/cgmes_v3_0_0/HydroPlantStorageKind.py new file mode 100644 index 00000000..c4a48018 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/HydroPlantStorageKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class HydroPlantStorageKind(Base): + ''' + The type of hydro power plant. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=HydroPlantStorageKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/HydroPowerPlant.py b/cimpy/cgmes_v3_0_0/HydroPowerPlant.py new file mode 100644 index 00000000..81fbbff8 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/HydroPowerPlant.py @@ -0,0 +1,37 @@ +from .PowerSystemResource import PowerSystemResource + + +class HydroPowerPlant(PowerSystemResource): + ''' + A hydro power station which can generate or pump. When generating, the generator turbines receive water from an upper reservoir. When pumping, the pumps receive their water from a lower reservoir. + + :HydroGeneratingUnits: The hydro generating unit belongs to a hydro power plant. Default: "list" + :hydroPlantStorageType: The type of hydro power plant water storage. Default: None + :HydroPumps: The hydro pump may be a member of a pumped storage plant or a pump for distributing water. Default: "list" + ''' + + cgmesProfile = PowerSystemResource.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'HydroGeneratingUnits': [cgmesProfile.EQ.value, ], + 'hydroPlantStorageType': [cgmesProfile.EQ.value, ], + 'HydroPumps': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemResource: \n' + PowerSystemResource.__doc__ + + def __init__(self, HydroGeneratingUnits = "list", hydroPlantStorageType = None, HydroPumps = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.HydroGeneratingUnits = HydroGeneratingUnits + self.hydroPlantStorageType = hydroPlantStorageType + self.HydroPumps = HydroPumps + + def __str__(self): + str = 'class=HydroPowerPlant\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/HydroPump.py b/cimpy/cgmes_v3_0_0/HydroPump.py new file mode 100644 index 00000000..9cceeb48 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/HydroPump.py @@ -0,0 +1,34 @@ +from .Equipment import Equipment + + +class HydroPump(Equipment): + ''' + A synchronous motor-driven pump, typically associated with a pumped storage plant. + + :HydroPowerPlant: The hydro pump may be a member of a pumped storage plant or a pump for distributing water. Default: None + :RotatingMachine: The synchronous machine drives the turbine which moves the water from a low elevation to a higher elevation. The direction of machine rotation for pumping may or may not be the same as for generating. Default: None + ''' + + cgmesProfile = Equipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'HydroPowerPlant': [cgmesProfile.EQ.value, ], + 'RotatingMachine': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Equipment: \n' + Equipment.__doc__ + + def __init__(self, HydroPowerPlant = None, RotatingMachine = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.HydroPowerPlant = HydroPowerPlant + self.RotatingMachine = RotatingMachine + + def __str__(self): + str = 'class=HydroPump\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/HydroTurbineKind.py b/cimpy/cgmes_v3_0_0/HydroTurbineKind.py new file mode 100644 index 00000000..4d356bd7 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/HydroTurbineKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class HydroTurbineKind(Base): + ''' + Type of turbine. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=HydroTurbineKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/IOPoint.py b/cimpy/cgmes_v3_0_0/IOPoint.py new file mode 100644 index 00000000..e369ad4a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/IOPoint.py @@ -0,0 +1,29 @@ +from .IdentifiedObject import IdentifiedObject + + +class IOPoint(IdentifiedObject): + ''' + The class describe a measurement or control value. The purpose is to enable having attributes and associations common for measurement and control. + + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=IOPoint\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/IdentifiedObject.py b/cimpy/cgmes_v3_0_0/IdentifiedObject.py new file mode 100644 index 00000000..08c8a487 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/IdentifiedObject.py @@ -0,0 +1,45 @@ +from .Base import Base + + +class IdentifiedObject(Base): + ''' + This is a root class to provide common identification for all classes needing identification and naming attributes. + + :mRID: Master resource identifier issued by a model authority. The mRID is unique within an exchange context. Global uniqueness is easily achieved by using a UUID, as specified in RFC 4122, for the mRID. The use of UUID is strongly recommended. For CIMXML data files in RDF syntax conforming to IEC 61970-552, the mRID is mapped to rdf:ID or rdf:about attributes that identify CIM object elements. Default: '' + :name: The name is any free human readable and possibly non unique text naming the object. Default: '' + :description: The description is a free human readable text describing or naming the object. It may be non unique and may not correlate to a naming hierarchy. Default: '' + :DiagramObjects: The diagram objects that are associated with the domain object. Default: "list" + :energyIdentCodeEic: The attribute is used for an exchange of the EIC code (Energy identification Code). The length of the string is 16 characters as defined by the EIC code. For details on EIC scheme please refer to ENTSO-E web site. Default: '' + :shortName: The attribute is used for an exchange of a human readable short name with length of the string 12 characters maximum. Default: '' + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.GL.value, cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.DL.value, cgmesProfile.TP.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'mRID': [cgmesProfile.GL.value, cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.DL.value, cgmesProfile.TP.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'name': [cgmesProfile.GL.value, cgmesProfile.DY.value, cgmesProfile.DL.value, cgmesProfile.TP.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SV.value, ], + 'description': [cgmesProfile.DY.value, cgmesProfile.DL.value, cgmesProfile.TP.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'DiagramObjects': [cgmesProfile.DL.value, ], + 'energyIdentCodeEic': [cgmesProfile.TP.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'shortName': [cgmesProfile.TP.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + } + + serializationProfile = {} + + + + def __init__(self, mRID = '', name = '', description = '', DiagramObjects = "list", energyIdentCodeEic = '', shortName = '', ): + + self.mRID = mRID + self.name = name + self.description = description + self.DiagramObjects = DiagramObjects + self.energyIdentCodeEic = energyIdentCodeEic + self.shortName = shortName + + def __str__(self): + str = 'class=IdentifiedObject\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/IfdBaseKind.py b/cimpy/cgmes_v3_0_0/IfdBaseKind.py new file mode 100644 index 00000000..61a69d68 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/IfdBaseKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class IfdBaseKind(Base): + ''' + Excitation base system mode. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=IfdBaseKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Inductance.py b/cimpy/cgmes_v3_0_0/Inductance.py new file mode 100644 index 00000000..4f0de585 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Inductance.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class Inductance(Base): + ''' + Inductive part of reactance (imaginary part of impedance), at rated frequency. + + :value: Default: 0.0 + :unit: Default: None + :multiplier: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'value': [cgmesProfile.EQ.value, ], + 'unit': [cgmesProfile.EQ.value, ], + 'multiplier': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, unit = None, multiplier = None, ): + + self.value = value + self.unit = unit + self.multiplier = multiplier + + def __str__(self): + str = 'class=Inductance\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/InputSignalKind.py b/cimpy/cgmes_v3_0_0/InputSignalKind.py new file mode 100644 index 00000000..173a70e9 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/InputSignalKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class InputSignalKind(Base): + ''' + Types of input signals. In dynamics modelling, commonly represented by the j parameter. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=InputSignalKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Integer.py b/cimpy/cgmes_v3_0_0/Integer.py new file mode 100644 index 00000000..dd9f15b6 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Integer.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class Integer(Base): + ''' + An integer number. The range is unspecified and not limited. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.GL.value, cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.DL.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=Integer\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Jumper.py b/cimpy/cgmes_v3_0_0/Jumper.py new file mode 100644 index 00000000..fbfc9bcc --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Jumper.py @@ -0,0 +1,29 @@ +from .Switch import Switch + + +class Jumper(Switch): + ''' + A short section of conductor with negligible impedance which can be manually removed and replaced if the circuit is de-energized. Note that zero-impedance branches can potentially be modelled by other equipment types. + + ''' + + cgmesProfile = Switch.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Switch: \n' + Switch.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=Jumper\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Junction.py b/cimpy/cgmes_v3_0_0/Junction.py new file mode 100644 index 00000000..731e68b5 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Junction.py @@ -0,0 +1,29 @@ +from .Connector import Connector + + +class Junction(Connector): + ''' + A point where one or more conducting equipments are connected with zero resistance. + + ''' + + cgmesProfile = Connector.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Connector: \n' + Connector.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=Junction\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Length.py b/cimpy/cgmes_v3_0_0/Length.py new file mode 100644 index 00000000..6f42a83a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Length.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class Length(Base): + ''' + Unit of length. It shall be a positive value or zero. + + :value: Default: 0.0 + :unit: Default: None + :multiplier: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'value': [cgmesProfile.DY.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'unit': [cgmesProfile.DY.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'multiplier': [cgmesProfile.DY.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, unit = None, multiplier = None, ): + + self.value = value + self.unit = unit + self.multiplier = multiplier + + def __str__(self): + str = 'class=Length\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Limit.py b/cimpy/cgmes_v3_0_0/Limit.py new file mode 100644 index 00000000..8eddda0a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Limit.py @@ -0,0 +1,29 @@ +from .IdentifiedObject import IdentifiedObject + + +class Limit(IdentifiedObject): + ''' + Specifies one limit value for a Measurement. A Measurement typically has several limits that are kept together by the LimitSet class. The actual meaning and use of a Limit instance (i.e., if it is an alarm or warning limit or if it is a high or low limit) is not captured in the Limit class. However the name of a Limit instance may indicate both meaning and use. + + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=Limit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/LimitKind.py b/cimpy/cgmes_v3_0_0/LimitKind.py new file mode 100644 index 00000000..9e575ec3 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/LimitKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class LimitKind(Base): + ''' + Limit kinds. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=LimitKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/LimitSet.py b/cimpy/cgmes_v3_0_0/LimitSet.py new file mode 100644 index 00000000..68b38cb5 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/LimitSet.py @@ -0,0 +1,31 @@ +from .IdentifiedObject import IdentifiedObject + + +class LimitSet(IdentifiedObject): + ''' + Specifies a set of Limits that are associated with a Measurement. A Measurement may have several LimitSets corresponding to seasonal or other changing conditions. The condition is captured in the name and description attributes. The same LimitSet may be used for several Measurements. In particular percentage limits are used this way. + + :isPercentageLimits: Tells if the limit values are in percentage of normalValue or the specified Unit for Measurements and Controls. Default: False + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'isPercentageLimits': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, isPercentageLimits = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.isPercentageLimits = isPercentageLimits + + def __str__(self): + str = 'class=LimitSet\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Line.py b/cimpy/cgmes_v3_0_0/Line.py new file mode 100644 index 00000000..a4169c20 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Line.py @@ -0,0 +1,31 @@ +from .EquipmentContainer import EquipmentContainer + + +class Line(EquipmentContainer): + ''' + Contains equipment beyond a substation belonging to a power transmission line. + + :Region: The sub-geographical region of the line. Default: None + ''' + + cgmesProfile = EquipmentContainer.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'Region': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EquipmentContainer: \n' + EquipmentContainer.__doc__ + + def __init__(self, Region = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Region = Region + + def __str__(self): + str = 'class=Line\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/LinearShuntCompensator.py b/cimpy/cgmes_v3_0_0/LinearShuntCompensator.py new file mode 100644 index 00000000..1d090b79 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/LinearShuntCompensator.py @@ -0,0 +1,40 @@ +from .ShuntCompensator import ShuntCompensator + + +class LinearShuntCompensator(ShuntCompensator): + ''' + A linear shunt compensator has banks or sections with equal admittance values. + + :bPerSection: Positive sequence shunt (charging) susceptance per section. Default: 0.0 + :gPerSection: Positive sequence shunt (charging) conductance per section. Default: 0.0 + :b0PerSection: Zero sequence shunt (charging) susceptance per section. Default: 0.0 + :g0PerSection: Zero sequence shunt (charging) conductance per section. Default: 0.0 + ''' + + cgmesProfile = ShuntCompensator.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'bPerSection': [cgmesProfile.EQ.value, ], + 'gPerSection': [cgmesProfile.EQ.value, ], + 'b0PerSection': [cgmesProfile.SC.value, ], + 'g0PerSection': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ShuntCompensator: \n' + ShuntCompensator.__doc__ + + def __init__(self, bPerSection = 0.0, gPerSection = 0.0, b0PerSection = 0.0, g0PerSection = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.bPerSection = bPerSection + self.gPerSection = gPerSection + self.b0PerSection = b0PerSection + self.g0PerSection = g0PerSection + + def __str__(self): + str = 'class=LinearShuntCompensator\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/LoadAggregate.py b/cimpy/cgmes_v3_0_0/LoadAggregate.py new file mode 100644 index 00000000..c42a82ff --- /dev/null +++ b/cimpy/cgmes_v3_0_0/LoadAggregate.py @@ -0,0 +1,34 @@ +from .LoadDynamics import LoadDynamics + + +class LoadAggregate(LoadDynamics): + ''' + Aggregate loads are used to represent all or part of the real and reactive load from one or more loads in the static (power flow) data. This load is usually the aggregation of many individual load devices and the load model is an approximate representation of the aggregate response of the load devices to system disturbances. Standard aggregate load model comprised of static and/or dynamic components. A static load model represents the sensitivity of the real and reactive power consumed by the load to the amplitude and frequency of the bus voltage. A dynamic load model can be used to represent the aggregate response of the motor components of the load. + + :LoadMotor: Aggregate motor (dynamic) load associated with this aggregate load. Default: None + :LoadStatic: Aggregate static load associated with this aggregate load. Default: None + ''' + + cgmesProfile = LoadDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'LoadMotor': [cgmesProfile.DY.value, ], + 'LoadStatic': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class LoadDynamics: \n' + LoadDynamics.__doc__ + + def __init__(self, LoadMotor = None, LoadStatic = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.LoadMotor = LoadMotor + self.LoadStatic = LoadStatic + + def __str__(self): + str = 'class=LoadAggregate\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/LoadArea.py b/cimpy/cgmes_v3_0_0/LoadArea.py new file mode 100644 index 00000000..5cbcb0fb --- /dev/null +++ b/cimpy/cgmes_v3_0_0/LoadArea.py @@ -0,0 +1,31 @@ +from .EnergyArea import EnergyArea + + +class LoadArea(EnergyArea): + ''' + The class is the root or first level in a hierarchical structure for grouping of loads for the purpose of load flow load scaling. + + :SubLoadAreas: The SubLoadAreas in the LoadArea. Default: "list" + ''' + + cgmesProfile = EnergyArea.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'SubLoadAreas': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EnergyArea: \n' + EnergyArea.__doc__ + + def __init__(self, SubLoadAreas = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.SubLoadAreas = SubLoadAreas + + def __str__(self): + str = 'class=LoadArea\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/LoadBreakSwitch.py b/cimpy/cgmes_v3_0_0/LoadBreakSwitch.py new file mode 100644 index 00000000..19019e2c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/LoadBreakSwitch.py @@ -0,0 +1,29 @@ +from .ProtectedSwitch import ProtectedSwitch + + +class LoadBreakSwitch(ProtectedSwitch): + ''' + A mechanical switching device capable of making, carrying, and breaking currents under normal operating conditions. + + ''' + + cgmesProfile = ProtectedSwitch.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ProtectedSwitch: \n' + ProtectedSwitch.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=LoadBreakSwitch\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/LoadComposite.py b/cimpy/cgmes_v3_0_0/LoadComposite.py new file mode 100644 index 00000000..cc0d935c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/LoadComposite.py @@ -0,0 +1,61 @@ +from .LoadDynamics import LoadDynamics + + +class LoadComposite(LoadDynamics): + ''' + Combined static load and induction motor load effects. The dynamics of the motor are simplified by linearizing the induction machine equations. + + :epvs: Active load-voltage dependence index (static) (Epvs). Typical value = 0,7. Default: 0.0 + :epfs: Active load-frequency dependence index (static) (Epfs). Typical value = 1,5. Default: 0.0 + :eqvs: Reactive load-voltage dependence index (static) (Eqvs). Typical value = 2. Default: 0.0 + :eqfs: Reactive load-frequency dependence index (static) (Eqfs). Typical value = 0. Default: 0.0 + :epvd: Active load-voltage dependence index (dynamic) (Epvd). Typical value = 0,7. Default: 0.0 + :epfd: Active load-frequency dependence index (dynamic) (Epfd). Typical value = 1,5. Default: 0.0 + :eqvd: Reactive load-voltage dependence index (dynamic) (Eqvd). Typical value = 2. Default: 0.0 + :eqfd: Reactive load-frequency dependence index (dynamic) (Eqfd). Typical value = 0. Default: 0.0 + :lfac: Loading factor (Lfac). The ratio of initial P to motor MVA base. Typical value = 0,8. Default: 0.0 + :h: Inertia constant (H) (>= 0). Typical value = 2,5. Default: 0 + :pfrac: Fraction of constant-power load to be represented by this motor model (PFRAC) (>= 0,0 and <= 1,0). Typical value = 0,5. Default: 0.0 + ''' + + cgmesProfile = LoadDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'epvs': [cgmesProfile.DY.value, ], + 'epfs': [cgmesProfile.DY.value, ], + 'eqvs': [cgmesProfile.DY.value, ], + 'eqfs': [cgmesProfile.DY.value, ], + 'epvd': [cgmesProfile.DY.value, ], + 'epfd': [cgmesProfile.DY.value, ], + 'eqvd': [cgmesProfile.DY.value, ], + 'eqfd': [cgmesProfile.DY.value, ], + 'lfac': [cgmesProfile.DY.value, ], + 'h': [cgmesProfile.DY.value, ], + 'pfrac': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class LoadDynamics: \n' + LoadDynamics.__doc__ + + def __init__(self, epvs = 0.0, epfs = 0.0, eqvs = 0.0, eqfs = 0.0, epvd = 0.0, epfd = 0.0, eqvd = 0.0, eqfd = 0.0, lfac = 0.0, h = 0, pfrac = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.epvs = epvs + self.epfs = epfs + self.eqvs = eqvs + self.eqfs = eqfs + self.epvd = epvd + self.epfd = epfd + self.eqvd = eqvd + self.eqfd = eqfd + self.lfac = lfac + self.h = h + self.pfrac = pfrac + + def __str__(self): + str = 'class=LoadComposite\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/LoadDynamics.py b/cimpy/cgmes_v3_0_0/LoadDynamics.py new file mode 100644 index 00000000..5abe72db --- /dev/null +++ b/cimpy/cgmes_v3_0_0/LoadDynamics.py @@ -0,0 +1,31 @@ +from .IdentifiedObject import IdentifiedObject + + +class LoadDynamics(IdentifiedObject): + ''' + Load whose behaviour is described by reference to a standard model or by definition of a user-defined model. A standard feature of dynamic load behaviour modelling is the ability to associate the same behaviour to multiple energy consumers by means of a single load definition. The load model is always applied to individual bus loads (energy consumers). + + :EnergyConsumer: Energy consumer to which this dynamics load model applies. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'EnergyConsumer': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, EnergyConsumer = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.EnergyConsumer = EnergyConsumer + + def __str__(self): + str = 'class=LoadDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/LoadGenericNonLinear.py b/cimpy/cgmes_v3_0_0/LoadGenericNonLinear.py new file mode 100644 index 00000000..6e81cd42 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/LoadGenericNonLinear.py @@ -0,0 +1,49 @@ +from .LoadDynamics import LoadDynamics + + +class LoadGenericNonLinear(LoadDynamics): + ''' + Generic non-linear dynamic (GNLD) load. This model can be used in mid-term and long-term voltage stability simulations (i.e., to study voltage collapse), as it can replace a more detailed representation of aggregate load, including induction motors, thermostatically controlled and static loads. + + :genericNonLinearLoadModelType: Type of generic non-linear load model. Default: None + :tp: Time constant of lag function of active power (TP) (> 0). Default: 0 + :tq: Time constant of lag function of reactive power (TQ) (> 0). Default: 0 + :ls: Steady state voltage index for active power (LS). Default: 0.0 + :lt: Transient voltage index for active power (LT). Default: 0.0 + :bs: Steady state voltage index for reactive power (BS). Default: 0.0 + :bt: Transient voltage index for reactive power (BT). Default: 0.0 + ''' + + cgmesProfile = LoadDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'genericNonLinearLoadModelType': [cgmesProfile.DY.value, ], + 'tp': [cgmesProfile.DY.value, ], + 'tq': [cgmesProfile.DY.value, ], + 'ls': [cgmesProfile.DY.value, ], + 'lt': [cgmesProfile.DY.value, ], + 'bs': [cgmesProfile.DY.value, ], + 'bt': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class LoadDynamics: \n' + LoadDynamics.__doc__ + + def __init__(self, genericNonLinearLoadModelType = None, tp = 0, tq = 0, ls = 0.0, lt = 0.0, bs = 0.0, bt = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.genericNonLinearLoadModelType = genericNonLinearLoadModelType + self.tp = tp + self.tq = tq + self.ls = ls + self.lt = lt + self.bs = bs + self.bt = bt + + def __str__(self): + str = 'class=LoadGenericNonLinear\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/LoadGroup.py b/cimpy/cgmes_v3_0_0/LoadGroup.py new file mode 100644 index 00000000..63afa945 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/LoadGroup.py @@ -0,0 +1,31 @@ +from .IdentifiedObject import IdentifiedObject + + +class LoadGroup(IdentifiedObject): + ''' + The class is the third level in a hierarchical structure for grouping of loads for the purpose of load flow load scaling. + + :SubLoadArea: The SubLoadArea where the Loadgroup belongs. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'SubLoadArea': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, SubLoadArea = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.SubLoadArea = SubLoadArea + + def __str__(self): + str = 'class=LoadGroup\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/LoadMotor.py b/cimpy/cgmes_v3_0_0/LoadMotor.py new file mode 100644 index 00000000..9b6e69d4 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/LoadMotor.py @@ -0,0 +1,70 @@ +from .IdentifiedObject import IdentifiedObject + + +class LoadMotor(IdentifiedObject): + ''' + Aggregate induction motor load. This model is used to represent a fraction of an ordinary load as "induction motor load". It allows a load that is treated as an ordinary constant power in power flow analysis to be represented by an induction motor in dynamic simulation. This model is intended for representation of aggregations of many motors dispersed through a load represented at a high voltage bus but where there is no information on the characteristics of individual motors. Either a "one-cage" or "two-cage" model of the induction machine can be modelled. Magnetic saturation is not modelled. This model treats a fraction of the constant power part of a load as a motor. During initialisation, the initial power drawn by the motor is set equal to Pfrac times the constant P part of the static load. The remainder of the load is left as a static load. The reactive power demand of the motor is calculated during initialisation as a function of voltage at the load bus. This reactive power demand can be less than or greater than the constant Q component of the load. If the motor's reactive demand is greater than the constant Q component of the load, the model inserts a shunt capacitor at the terminal of the motor to bring its reactive demand down to equal the constant Q reactive load. If an induction motor load model and a static load model are both present for a load, the motor Pfrac is assumed to be subtracted from the power flow constant P load before the static load model is applied. The remainder of the load, if any, is then represented by the static load model. + + :LoadAggregate: Aggregate load to which this aggregate motor (dynamic) load belongs. Default: None + :pfrac: Fraction of constant-power load to be represented by this motor model (Pfrac) (>= 0,0 and <= 1,0). Typical value = 0,3. Default: 0.0 + :lfac: Loading factor (Lfac). The ratio of initial P to motor MVA base. Typical value = 0,8. Default: 0.0 + :ls: Synchronous reactance (Ls). Typical value = 3,2. Default: 0.0 + :lp: Transient reactance (Lp). Typical value = 0,15. Default: 0.0 + :lpp: Subtransient reactance (Lpp). Typical value = 0,15. Default: 0.0 + :ra: Stator resistance (Ra). Typical value = 0. Default: 0.0 + :tpo: Transient rotor time constant (Tpo) (>= 0). Typical value = 1. Default: 0 + :tppo: Subtransient rotor time constant (Tppo) (>= 0). Typical value = 0,02. Default: 0 + :h: Inertia constant (H) (>= 0). Typical value = 0,4. Default: 0 + :d: Damping factor (D). Unit = delta P/delta speed. Typical value = 2. Default: 0.0 + :vt: Voltage threshold for tripping (Vt). Typical value = 0,7. Default: 0.0 + :tv: Voltage trip pickup time (Tv) (>= 0). Typical value = 0,1. Default: 0 + :tbkr: Circuit breaker operating time (Tbkr) (>= 0). Typical value = 0,08. Default: 0 + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'LoadAggregate': [cgmesProfile.DY.value, ], + 'pfrac': [cgmesProfile.DY.value, ], + 'lfac': [cgmesProfile.DY.value, ], + 'ls': [cgmesProfile.DY.value, ], + 'lp': [cgmesProfile.DY.value, ], + 'lpp': [cgmesProfile.DY.value, ], + 'ra': [cgmesProfile.DY.value, ], + 'tpo': [cgmesProfile.DY.value, ], + 'tppo': [cgmesProfile.DY.value, ], + 'h': [cgmesProfile.DY.value, ], + 'd': [cgmesProfile.DY.value, ], + 'vt': [cgmesProfile.DY.value, ], + 'tv': [cgmesProfile.DY.value, ], + 'tbkr': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, LoadAggregate = None, pfrac = 0.0, lfac = 0.0, ls = 0.0, lp = 0.0, lpp = 0.0, ra = 0.0, tpo = 0, tppo = 0, h = 0, d = 0.0, vt = 0.0, tv = 0, tbkr = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.LoadAggregate = LoadAggregate + self.pfrac = pfrac + self.lfac = lfac + self.ls = ls + self.lp = lp + self.lpp = lpp + self.ra = ra + self.tpo = tpo + self.tppo = tppo + self.h = h + self.d = d + self.vt = vt + self.tv = tv + self.tbkr = tbkr + + def __str__(self): + str = 'class=LoadMotor\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/LoadResponseCharacteristic.py b/cimpy/cgmes_v3_0_0/LoadResponseCharacteristic.py new file mode 100644 index 00000000..aa6d5a74 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/LoadResponseCharacteristic.py @@ -0,0 +1,64 @@ +from .IdentifiedObject import IdentifiedObject + + +class LoadResponseCharacteristic(IdentifiedObject): + ''' + Models the characteristic response of the load demand due to changes in system conditions such as voltage and frequency. It is not related to demand response. If LoadResponseCharacteristic.exponentModel is True, the exponential voltage or frequency dependent models are specified and used as to calculate active and reactive power components of the load model. The equations to calculate active and reactive power components of the load model are internal to the power flow calculation, hence they use different quantities depending on the use case of the data exchange. The equations for exponential voltage dependent load model injected power are: pInjection= Pnominal* (Voltage/cim:BaseVoltage.nominalVoltage) ** cim:LoadResponseCharacteristic.pVoltageExponent qInjection= Qnominal* (Voltage/cim:BaseVoltage.nominalVoltage) ** cim:LoadResponseCharacteristic.qVoltageExponent Where: 1) * means "multiply" and ** is "raised to power of"; 2) Pnominal and Qnominal represent the active power and reactive power at nominal voltage as any load described by the voltage exponential model shall be given at nominal voltage. This means that EnergyConsumer.p and EnergyConsumer.q are at nominal voltage. 3) After power flow is solved: -pInjection and qInjection correspond to SvPowerflow.p and SvPowerflow.q respectively. - Voltage corresponds to SvVoltage.v at the TopologicalNode where the load is connected. + + :EnergyConsumer: The set of loads that have the response characteristics. Default: "list" + :exponentModel: Indicates the exponential voltage dependency model is to be used. If false, the coefficient model is to be used. The exponential voltage dependency model consist of the attributes: - pVoltageExponent - qVoltageExponent - pFrequencyExponent - qFrequencyExponent. The coefficient model consist of the attributes: - pConstantImpedance - pConstantCurrent - pConstantPower - qConstantImpedance - qConstantCurrent - qConstantPower. The sum of pConstantImpedance, pConstantCurrent and pConstantPower shall equal 1. The sum of qConstantImpedance, qConstantCurrent and qConstantPower shall equal 1. Default: False + :pConstantCurrent: Portion of active power load modelled as constant current. Default: 0.0 + :pConstantImpedance: Portion of active power load modelled as constant impedance. Default: 0.0 + :pConstantPower: Portion of active power load modelled as constant power. Default: 0.0 + :pFrequencyExponent: Exponent of per unit frequency effecting active power. Default: 0.0 + :pVoltageExponent: Exponent of per unit voltage effecting real power. Default: 0.0 + :qConstantCurrent: Portion of reactive power load modelled as constant current. Default: 0.0 + :qConstantImpedance: Portion of reactive power load modelled as constant impedance. Default: 0.0 + :qConstantPower: Portion of reactive power load modelled as constant power. Default: 0.0 + :qFrequencyExponent: Exponent of per unit frequency effecting reactive power. Default: 0.0 + :qVoltageExponent: Exponent of per unit voltage effecting reactive power. Default: 0.0 + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'EnergyConsumer': [cgmesProfile.EQ.value, ], + 'exponentModel': [cgmesProfile.EQ.value, ], + 'pConstantCurrent': [cgmesProfile.EQ.value, ], + 'pConstantImpedance': [cgmesProfile.EQ.value, ], + 'pConstantPower': [cgmesProfile.EQ.value, ], + 'pFrequencyExponent': [cgmesProfile.EQ.value, ], + 'pVoltageExponent': [cgmesProfile.EQ.value, ], + 'qConstantCurrent': [cgmesProfile.EQ.value, ], + 'qConstantImpedance': [cgmesProfile.EQ.value, ], + 'qConstantPower': [cgmesProfile.EQ.value, ], + 'qFrequencyExponent': [cgmesProfile.EQ.value, ], + 'qVoltageExponent': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, EnergyConsumer = "list", exponentModel = False, pConstantCurrent = 0.0, pConstantImpedance = 0.0, pConstantPower = 0.0, pFrequencyExponent = 0.0, pVoltageExponent = 0.0, qConstantCurrent = 0.0, qConstantImpedance = 0.0, qConstantPower = 0.0, qFrequencyExponent = 0.0, qVoltageExponent = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.EnergyConsumer = EnergyConsumer + self.exponentModel = exponentModel + self.pConstantCurrent = pConstantCurrent + self.pConstantImpedance = pConstantImpedance + self.pConstantPower = pConstantPower + self.pFrequencyExponent = pFrequencyExponent + self.pVoltageExponent = pVoltageExponent + self.qConstantCurrent = qConstantCurrent + self.qConstantImpedance = qConstantImpedance + self.qConstantPower = qConstantPower + self.qFrequencyExponent = qFrequencyExponent + self.qVoltageExponent = qVoltageExponent + + def __str__(self): + str = 'class=LoadResponseCharacteristic\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/LoadStatic.py b/cimpy/cgmes_v3_0_0/LoadStatic.py new file mode 100644 index 00000000..4d6b9532 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/LoadStatic.py @@ -0,0 +1,82 @@ +from .IdentifiedObject import IdentifiedObject + + +class LoadStatic(IdentifiedObject): + ''' + General static load. This model represents the sensitivity of the real and reactive power consumed by the load to the amplitude and frequency of the bus voltage. + + :LoadAggregate: Aggregate load to which this aggregate static load belongs. Default: None + :staticLoadModelType: Type of static load model. Typical value = constantZ. Default: None + :kp1: First term voltage coefficient for active power (Kp1). Not used when .staticLoadModelType = constantZ. Default: 0.0 + :kp2: Second term voltage coefficient for active power (Kp2). Not used when .staticLoadModelType = constantZ. Default: 0.0 + :kp3: Third term voltage coefficient for active power (Kp3). Not used when .staticLoadModelType = constantZ. Default: 0.0 + :kp4: Frequency coefficient for active power (Kp4) (not = 0 if .staticLoadModelType = zIP2). Used only when .staticLoadModelType = zIP2. Default: 0.0 + :ep1: First term voltage exponent for active power (Ep1). Used only when .staticLoadModelType = exponential. Default: 0.0 + :ep2: Second term voltage exponent for active power (Ep2). Used only when .staticLoadModelType = exponential. Default: 0.0 + :ep3: Third term voltage exponent for active power (Ep3). Used only when .staticLoadModelType = exponential. Default: 0.0 + :kpf: Frequency deviation coefficient for active power (Kpf). Not used when .staticLoadModelType = constantZ. Default: 0.0 + :kq1: First term voltage coefficient for reactive power (Kq1). Not used when .staticLoadModelType = constantZ. Default: 0.0 + :kq2: Second term voltage coefficient for reactive power (Kq2). Not used when .staticLoadModelType = constantZ. Default: 0.0 + :kq3: Third term voltage coefficient for reactive power (Kq3). Not used when .staticLoadModelType = constantZ. Default: 0.0 + :kq4: Frequency coefficient for reactive power (Kq4) (not = 0 when .staticLoadModelType = zIP2). Used only when .staticLoadModelType - zIP2. Default: 0.0 + :eq1: First term voltage exponent for reactive power (Eq1). Used only when .staticLoadModelType = exponential. Default: 0.0 + :eq2: Second term voltage exponent for reactive power (Eq2). Used only when .staticLoadModelType = exponential. Default: 0.0 + :eq3: Third term voltage exponent for reactive power (Eq3). Used only when .staticLoadModelType = exponential. Default: 0.0 + :kqf: Frequency deviation coefficient for reactive power (Kqf). Not used when .staticLoadModelType = constantZ. Default: 0.0 + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'LoadAggregate': [cgmesProfile.DY.value, ], + 'staticLoadModelType': [cgmesProfile.DY.value, ], + 'kp1': [cgmesProfile.DY.value, ], + 'kp2': [cgmesProfile.DY.value, ], + 'kp3': [cgmesProfile.DY.value, ], + 'kp4': [cgmesProfile.DY.value, ], + 'ep1': [cgmesProfile.DY.value, ], + 'ep2': [cgmesProfile.DY.value, ], + 'ep3': [cgmesProfile.DY.value, ], + 'kpf': [cgmesProfile.DY.value, ], + 'kq1': [cgmesProfile.DY.value, ], + 'kq2': [cgmesProfile.DY.value, ], + 'kq3': [cgmesProfile.DY.value, ], + 'kq4': [cgmesProfile.DY.value, ], + 'eq1': [cgmesProfile.DY.value, ], + 'eq2': [cgmesProfile.DY.value, ], + 'eq3': [cgmesProfile.DY.value, ], + 'kqf': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, LoadAggregate = None, staticLoadModelType = None, kp1 = 0.0, kp2 = 0.0, kp3 = 0.0, kp4 = 0.0, ep1 = 0.0, ep2 = 0.0, ep3 = 0.0, kpf = 0.0, kq1 = 0.0, kq2 = 0.0, kq3 = 0.0, kq4 = 0.0, eq1 = 0.0, eq2 = 0.0, eq3 = 0.0, kqf = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.LoadAggregate = LoadAggregate + self.staticLoadModelType = staticLoadModelType + self.kp1 = kp1 + self.kp2 = kp2 + self.kp3 = kp3 + self.kp4 = kp4 + self.ep1 = ep1 + self.ep2 = ep2 + self.ep3 = ep3 + self.kpf = kpf + self.kq1 = kq1 + self.kq2 = kq2 + self.kq3 = kq3 + self.kq4 = kq4 + self.eq1 = eq1 + self.eq2 = eq2 + self.eq3 = eq3 + self.kqf = kqf + + def __str__(self): + str = 'class=LoadStatic\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/LoadUserDefined.py b/cimpy/cgmes_v3_0_0/LoadUserDefined.py new file mode 100644 index 00000000..1849a200 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/LoadUserDefined.py @@ -0,0 +1,34 @@ +from .LoadDynamics import LoadDynamics + + +class LoadUserDefined(LoadDynamics): + ''' + Load whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = LoadDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class LoadDynamics: \n' + LoadDynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=LoadUserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Location.py b/cimpy/cgmes_v3_0_0/Location.py new file mode 100644 index 00000000..1d503089 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Location.py @@ -0,0 +1,40 @@ +from .IdentifiedObject import IdentifiedObject + + +class Location(IdentifiedObject): + ''' + The place, scene, or point of something where someone or something has been, is, and/or will be at a given moment in time. It can be defined with one or more position points (coordinates) in a given coordinate system. + + :CoordinateSystem: Coordinate system used to describe position points of this location. Default: None + :mainAddress: Main address of the location. Default: 0.0 + :PowerSystemResources: All power system resources at this location. Default: None + :PositionPoints: Sequence of position points describing this location, expressed in coordinate system `Location.CoordinateSystem`. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.GL.value, ], + 'CoordinateSystem': [cgmesProfile.GL.value, ], + 'mainAddress': [cgmesProfile.GL.value, ], + 'PowerSystemResources': [cgmesProfile.GL.value, ], + 'PositionPoints': [cgmesProfile.GL.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, CoordinateSystem = None, mainAddress = 0.0, PowerSystemResources = None, PositionPoints = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.CoordinateSystem = CoordinateSystem + self.mainAddress = mainAddress + self.PowerSystemResources = PowerSystemResources + self.PositionPoints = PositionPoints + + def __str__(self): + str = 'class=Location\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Measurement.py b/cimpy/cgmes_v3_0_0/Measurement.py new file mode 100644 index 00000000..7a986ba3 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Measurement.py @@ -0,0 +1,46 @@ +from .IdentifiedObject import IdentifiedObject + + +class Measurement(IdentifiedObject): + ''' + A Measurement represents any measured, calculated or non-measured non-calculated quantity. Any piece of equipment may contain Measurements, e.g. a substation may have temperature measurements and door open indications, a transformer may have oil temperature and tank pressure measurements, a bay may contain a number of power flow measurements and a Breaker may contain a switch status measurement. The PSR - Measurement association is intended to capture this use of Measurement and is included in the naming hierarchy based on EquipmentContainer. The naming hierarchy typically has Measurements as leaves, e.g. Substation-VoltageLevel-Bay-Switch-Measurement. Some Measurements represent quantities related to a particular sensor location in the network, e.g. a voltage transformer (VT) or potential transformer (PT) at a busbar or a current transformer (CT) at the bar between a breaker and an isolator. The sensing position is not captured in the PSR - Measurement association. Instead it is captured by the Measurement - Terminal association that is used to define the sensing location in the network topology. The location is defined by the connection of the Terminal to ConductingEquipment. If both a Terminal and PSR are associated, and the PSR is of type ConductingEquipment, the associated Terminal should belong to that ConductingEquipment instance. When the sensor location is needed both Measurement-PSR and Measurement-Terminal are used. The Measurement-Terminal association is never used alone. + + :Terminal: One or more measurements may be associated with a terminal in the network. Default: None + :measurementType: Specifies the type of measurement. For example, this specifies if the measurement represents an indoor temperature, outdoor temperature, bus voltage, line flow, etc. When the measurementType is set to `Specialization`, the type of Measurement is defined in more detail by the specialized class which inherits from Measurement. Default: '' + :phases: Indicates to which phases the measurement applies and avoids the need to use `measurementType` to also encode phase information (which would explode the types). The phase information in Measurement, along with `measurementType` and `phases` uniquely defines a Measurement for a device, based on normal network phase. Their meaning will not change when the computed energizing phasing is changed due to jumpers or other reasons. If the attribute is missing three phases (ABC) shall be assumed. Default: None + :unitMultiplier: The unit multiplier of the measured quantity. Default: None + :unitSymbol: The unit of measure of the measured quantity. Default: None + :PowerSystemResource: The power system resource that contains the measurement. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'Terminal': [cgmesProfile.OP.value, ], + 'measurementType': [cgmesProfile.OP.value, ], + 'phases': [cgmesProfile.OP.value, ], + 'unitMultiplier': [cgmesProfile.OP.value, ], + 'unitSymbol': [cgmesProfile.OP.value, ], + 'PowerSystemResource': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, Terminal = None, measurementType = '', phases = None, unitMultiplier = None, unitSymbol = None, PowerSystemResource = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Terminal = Terminal + self.measurementType = measurementType + self.phases = phases + self.unitMultiplier = unitMultiplier + self.unitSymbol = unitSymbol + self.PowerSystemResource = PowerSystemResource + + def __str__(self): + str = 'class=Measurement\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/MeasurementValue.py b/cimpy/cgmes_v3_0_0/MeasurementValue.py new file mode 100644 index 00000000..580a50ef --- /dev/null +++ b/cimpy/cgmes_v3_0_0/MeasurementValue.py @@ -0,0 +1,40 @@ +from .IOPoint import IOPoint + + +class MeasurementValue(IOPoint): + ''' + The current state for a measurement. A state value is an instance of a measurement from a specific source. Measurements can be associated with many state values, each representing a different source for the measurement. + + :timeStamp: The time when the value was last updated. Default: '' + :sensorAccuracy: The limit, expressed as a percentage of the sensor maximum, that errors will not exceed when the sensor is used under reference conditions. Default: 0.0 + :MeasurementValueQuality: A MeasurementValue has a MeasurementValueQuality associated with it. Default: None + :MeasurementValueSource: A reference to the type of source that updates the MeasurementValue, e.g. SCADA, CCLink, manual, etc. User conventions for the names of sources are contained in the introduction to IEC 61970-301. Default: None + ''' + + cgmesProfile = IOPoint.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'timeStamp': [cgmesProfile.OP.value, ], + 'sensorAccuracy': [cgmesProfile.OP.value, ], + 'MeasurementValueQuality': [cgmesProfile.OP.value, ], + 'MeasurementValueSource': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IOPoint: \n' + IOPoint.__doc__ + + def __init__(self, timeStamp = '', sensorAccuracy = 0.0, MeasurementValueQuality = None, MeasurementValueSource = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.timeStamp = timeStamp + self.sensorAccuracy = sensorAccuracy + self.MeasurementValueQuality = MeasurementValueQuality + self.MeasurementValueSource = MeasurementValueSource + + def __str__(self): + str = 'class=MeasurementValue\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/MeasurementValueQuality.py b/cimpy/cgmes_v3_0_0/MeasurementValueQuality.py new file mode 100644 index 00000000..71231f38 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/MeasurementValueQuality.py @@ -0,0 +1,31 @@ +from .Quality61850 import Quality61850 + + +class MeasurementValueQuality(Quality61850): + ''' + Measurement quality flags. Bits 0-10 are defined for substation automation in IEC 61850-7-3. Bits 11-15 are reserved for future expansion by that document. Bits 16-31 are reserved for EMS applications. + + :MeasurementValue: A MeasurementValue has a MeasurementValueQuality associated with it. Default: None + ''' + + cgmesProfile = Quality61850.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'MeasurementValue': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Quality61850: \n' + Quality61850.__doc__ + + def __init__(self, MeasurementValue = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.MeasurementValue = MeasurementValue + + def __str__(self): + str = 'class=MeasurementValueQuality\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/MeasurementValueSource.py b/cimpy/cgmes_v3_0_0/MeasurementValueSource.py new file mode 100644 index 00000000..ec129b35 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/MeasurementValueSource.py @@ -0,0 +1,31 @@ +from .IdentifiedObject import IdentifiedObject + + +class MeasurementValueSource(IdentifiedObject): + ''' + MeasurementValueSource describes the alternative sources updating a MeasurementValue. User conventions for how to use the MeasurementValueSource attributes are defined in IEC 61970-301. + + :MeasurementValues: The MeasurementValues updated by the source. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'MeasurementValues': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, MeasurementValues = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.MeasurementValues = MeasurementValues + + def __str__(self): + str = 'class=MeasurementValueSource\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/MechLoad1.py b/cimpy/cgmes_v3_0_0/MechLoad1.py new file mode 100644 index 00000000..de3ee1ac --- /dev/null +++ b/cimpy/cgmes_v3_0_0/MechLoad1.py @@ -0,0 +1,40 @@ +from .MechanicalLoadDynamics import MechanicalLoadDynamics + + +class MechLoad1(MechanicalLoadDynamics): + ''' + Mechanical load model type 1. + + :a: Speed squared coefficient (a). Default: 0.0 + :b: Speed coefficient (b). Default: 0.0 + :d: Speed to the exponent coefficient (d). Default: 0.0 + :e: Exponent (e). Default: 0.0 + ''' + + cgmesProfile = MechanicalLoadDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'a': [cgmesProfile.DY.value, ], + 'b': [cgmesProfile.DY.value, ], + 'd': [cgmesProfile.DY.value, ], + 'e': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class MechanicalLoadDynamics: \n' + MechanicalLoadDynamics.__doc__ + + def __init__(self, a = 0.0, b = 0.0, d = 0.0, e = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.a = a + self.b = b + self.d = d + self.e = e + + def __str__(self): + str = 'class=MechLoad1\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/MechanicalLoadDynamics.py b/cimpy/cgmes_v3_0_0/MechanicalLoadDynamics.py new file mode 100644 index 00000000..241adb3a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/MechanicalLoadDynamics.py @@ -0,0 +1,34 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class MechanicalLoadDynamics(DynamicsFunctionBlock): + ''' + Mechanical load function block whose behaviour is described by reference to a standard model or by definition of a user-defined model. + + :SynchronousMachineDynamics: Synchronous machine model with which this mechanical load model is associated. MechanicalLoadDynamics shall have either an association to SynchronousMachineDynamics or AsynchronousMachineDyanmics. Default: None + :AsynchronousMachineDynamics: Asynchronous machine model with which this mechanical load model is associated. MechanicalLoadDynamics shall have either an association to SynchronousMachineDynamics or to AsynchronousMachineDynamics. Default: None + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'SynchronousMachineDynamics': [cgmesProfile.DY.value, ], + 'AsynchronousMachineDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, SynchronousMachineDynamics = None, AsynchronousMachineDynamics = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.SynchronousMachineDynamics = SynchronousMachineDynamics + self.AsynchronousMachineDynamics = AsynchronousMachineDynamics + + def __str__(self): + str = 'class=MechanicalLoadDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/MechanicalLoadUserDefined.py b/cimpy/cgmes_v3_0_0/MechanicalLoadUserDefined.py new file mode 100644 index 00000000..f0f843aa --- /dev/null +++ b/cimpy/cgmes_v3_0_0/MechanicalLoadUserDefined.py @@ -0,0 +1,34 @@ +from .MechanicalLoadDynamics import MechanicalLoadDynamics + + +class MechanicalLoadUserDefined(MechanicalLoadDynamics): + ''' + Mechanical load function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = MechanicalLoadDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class MechanicalLoadDynamics: \n' + MechanicalLoadDynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=MechanicalLoadUserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Money.py b/cimpy/cgmes_v3_0_0/Money.py new file mode 100644 index 00000000..bc217466 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Money.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class Money(Base): + ''' + Amount of money. + + :unit: Default: None + :multiplier: Default: None + :value: Default: 0.0 + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'unit': [cgmesProfile.EQ.value, ], + 'multiplier': [cgmesProfile.EQ.value, ], + 'value': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, unit = None, multiplier = None, value = 0.0, ): + + self.unit = unit + self.multiplier = multiplier + self.value = value + + def __str__(self): + str = 'class=Money\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/MonthDay.py b/cimpy/cgmes_v3_0_0/MonthDay.py new file mode 100644 index 00000000..372ff19c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/MonthDay.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class MonthDay(Base): + ''' + MonthDay format as "--mm-dd", which conforms with XSD data type gMonthDay. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=MonthDay\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/MutualCoupling.py b/cimpy/cgmes_v3_0_0/MutualCoupling.py new file mode 100644 index 00000000..4cb09b3e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/MutualCoupling.py @@ -0,0 +1,58 @@ +from .IdentifiedObject import IdentifiedObject + + +class MutualCoupling(IdentifiedObject): + ''' + This class represents the zero sequence line mutual coupling. + + :b0ch: Zero sequence mutual coupling shunt (charging) susceptance, uniformly distributed, of the entire line section. Default: 0.0 + :distance11: Distance to the start of the coupled region from the first line`s terminal having sequence number equal to 1. Default: 0.0 + :distance12: Distance to the end of the coupled region from the first line`s terminal with sequence number equal to 1. Default: 0.0 + :distance21: Distance to the start of coupled region from the second line`s terminal with sequence number equal to 1. Default: 0.0 + :distance22: Distance to the end of coupled region from the second line`s terminal with sequence number equal to 1. Default: 0.0 + :g0ch: Zero sequence mutual coupling shunt (charging) conductance, uniformly distributed, of the entire line section. Default: 0.0 + :r0: Zero sequence branch-to-branch mutual impedance coupling, resistance. Default: 0.0 + :x0: Zero sequence branch-to-branch mutual impedance coupling, reactance. Default: 0.0 + :Second_Terminal: The starting terminal for the calculation of distances along the second branch of the mutual coupling. Default: None + :First_Terminal: The starting terminal for the calculation of distances along the first branch of the mutual coupling. Normally MutualCoupling would only be used for terminals of AC line segments. The first and second terminals of a mutual coupling should point to different AC line segments. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SC.value, ], + 'b0ch': [cgmesProfile.SC.value, ], + 'distance11': [cgmesProfile.SC.value, ], + 'distance12': [cgmesProfile.SC.value, ], + 'distance21': [cgmesProfile.SC.value, ], + 'distance22': [cgmesProfile.SC.value, ], + 'g0ch': [cgmesProfile.SC.value, ], + 'r0': [cgmesProfile.SC.value, ], + 'x0': [cgmesProfile.SC.value, ], + 'Second_Terminal': [cgmesProfile.SC.value, ], + 'First_Terminal': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, b0ch = 0.0, distance11 = 0.0, distance12 = 0.0, distance21 = 0.0, distance22 = 0.0, g0ch = 0.0, r0 = 0.0, x0 = 0.0, Second_Terminal = None, First_Terminal = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.b0ch = b0ch + self.distance11 = distance11 + self.distance12 = distance12 + self.distance21 = distance21 + self.distance22 = distance22 + self.g0ch = g0ch + self.r0 = r0 + self.x0 = x0 + self.Second_Terminal = Second_Terminal + self.First_Terminal = First_Terminal + + def __str__(self): + str = 'class=MutualCoupling\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/NonConformLoad.py b/cimpy/cgmes_v3_0_0/NonConformLoad.py new file mode 100644 index 00000000..14abeb32 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/NonConformLoad.py @@ -0,0 +1,31 @@ +from .EnergyConsumer import EnergyConsumer + + +class NonConformLoad(EnergyConsumer): + ''' + NonConformLoad represents loads that do not follow a daily load change pattern and whose changes are not correlated with the daily load change pattern. + + :LoadGroup: Group of this ConformLoad. Default: None + ''' + + cgmesProfile = EnergyConsumer.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'LoadGroup': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EnergyConsumer: \n' + EnergyConsumer.__doc__ + + def __init__(self, LoadGroup = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.LoadGroup = LoadGroup + + def __str__(self): + str = 'class=NonConformLoad\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/NonConformLoadGroup.py b/cimpy/cgmes_v3_0_0/NonConformLoadGroup.py new file mode 100644 index 00000000..33d704b4 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/NonConformLoadGroup.py @@ -0,0 +1,34 @@ +from .LoadGroup import LoadGroup + + +class NonConformLoadGroup(LoadGroup): + ''' + Loads that do not follow a daily and seasonal load variation pattern. + + :EnergyConsumers: Conform loads assigned to this ConformLoadGroup. Default: "list" + :NonConformLoadSchedules: The NonConformLoadSchedules in the NonConformLoadGroup. Default: "list" + ''' + + cgmesProfile = LoadGroup.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'EnergyConsumers': [cgmesProfile.EQ.value, ], + 'NonConformLoadSchedules': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class LoadGroup: \n' + LoadGroup.__doc__ + + def __init__(self, EnergyConsumers = "list", NonConformLoadSchedules = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.EnergyConsumers = EnergyConsumers + self.NonConformLoadSchedules = NonConformLoadSchedules + + def __str__(self): + str = 'class=NonConformLoadGroup\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/NonConformLoadSchedule.py b/cimpy/cgmes_v3_0_0/NonConformLoadSchedule.py new file mode 100644 index 00000000..caa5fc72 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/NonConformLoadSchedule.py @@ -0,0 +1,31 @@ +from .SeasonDayTypeSchedule import SeasonDayTypeSchedule + + +class NonConformLoadSchedule(SeasonDayTypeSchedule): + ''' + An active power (Y1-axis) and reactive power (Y2-axis) schedule (curves) versus time (X-axis) for non-conforming loads, e.g., large industrial load or power station service (where modelled). + + :NonConformLoadGroup: The NonConformLoadGroup where the NonConformLoadSchedule belongs. Default: None + ''' + + cgmesProfile = SeasonDayTypeSchedule.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'NonConformLoadGroup': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class SeasonDayTypeSchedule: \n' + SeasonDayTypeSchedule.__doc__ + + def __init__(self, NonConformLoadGroup = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.NonConformLoadGroup = NonConformLoadGroup + + def __str__(self): + str = 'class=NonConformLoadSchedule\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/NonlinearShuntCompensator.py b/cimpy/cgmes_v3_0_0/NonlinearShuntCompensator.py new file mode 100644 index 00000000..af0b0d47 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/NonlinearShuntCompensator.py @@ -0,0 +1,31 @@ +from .ShuntCompensator import ShuntCompensator + + +class NonlinearShuntCompensator(ShuntCompensator): + ''' + A non linear shunt compensator has bank or section admittance values that differ. The attributes g, b, g0 and b0 of the associated NonlinearShuntCompensatorPoint describe the total conductance and admittance of a NonlinearShuntCompensatorPoint at a section number specified by NonlinearShuntCompensatorPoint.sectionNumber. + + :NonlinearShuntCompensatorPoints: All points of the non-linear shunt compensator. Default: "list" + ''' + + cgmesProfile = ShuntCompensator.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'NonlinearShuntCompensatorPoints': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ShuntCompensator: \n' + ShuntCompensator.__doc__ + + def __init__(self, NonlinearShuntCompensatorPoints = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.NonlinearShuntCompensatorPoints = NonlinearShuntCompensatorPoints + + def __str__(self): + str = 'class=NonlinearShuntCompensator\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/NonlinearShuntCompensatorPoint.py b/cimpy/cgmes_v3_0_0/NonlinearShuntCompensatorPoint.py new file mode 100644 index 00000000..54f99828 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/NonlinearShuntCompensatorPoint.py @@ -0,0 +1,45 @@ +from .Base import Base + + +class NonlinearShuntCompensatorPoint(Base): + ''' + A non linear shunt compensator bank or section admittance value. The number of NonlinearShuntCompenstorPoint instances associated with a NonlinearShuntCompensator shall be equal to ShuntCompensator.maximumSections. ShuntCompensator.sections shall only be set to one of the NonlinearShuntCompenstorPoint.sectionNumber. There is no interpolation between NonlinearShuntCompenstorPoint-s. + + :NonlinearShuntCompensator: Non-linear shunt compensator owning this point. Default: None + :b: Positive sequence shunt (charging) susceptance per section. Default: 0.0 + :g: Positive sequence shunt (charging) conductance per section. Default: 0.0 + :sectionNumber: The number of the section. Default: 0 + :b0: Zero sequence shunt (charging) susceptance per section. Default: 0.0 + :g0: Zero sequence shunt (charging) conductance per section. Default: 0.0 + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'NonlinearShuntCompensator': [cgmesProfile.EQ.value, ], + 'b': [cgmesProfile.EQ.value, ], + 'g': [cgmesProfile.EQ.value, ], + 'sectionNumber': [cgmesProfile.EQ.value, ], + 'b0': [cgmesProfile.SC.value, ], + 'g0': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + + + def __init__(self, NonlinearShuntCompensator = None, b = 0.0, g = 0.0, sectionNumber = 0, b0 = 0.0, g0 = 0.0, ): + + self.NonlinearShuntCompensator = NonlinearShuntCompensator + self.b = b + self.g = g + self.sectionNumber = sectionNumber + self.b0 = b0 + self.g0 = g0 + + def __str__(self): + str = 'class=NonlinearShuntCompensatorPoint\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/NuclearGeneratingUnit.py b/cimpy/cgmes_v3_0_0/NuclearGeneratingUnit.py new file mode 100644 index 00000000..56af292a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/NuclearGeneratingUnit.py @@ -0,0 +1,29 @@ +from .GeneratingUnit import GeneratingUnit + + +class NuclearGeneratingUnit(GeneratingUnit): + ''' + A nuclear generating unit. + + ''' + + cgmesProfile = GeneratingUnit.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class GeneratingUnit: \n' + GeneratingUnit.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=NuclearGeneratingUnit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/OperationalLimit.py b/cimpy/cgmes_v3_0_0/OperationalLimit.py new file mode 100644 index 00000000..5c9d1f58 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/OperationalLimit.py @@ -0,0 +1,34 @@ +from .IdentifiedObject import IdentifiedObject + + +class OperationalLimit(IdentifiedObject): + ''' + A value and normal value associated with a specific kind of limit. The sub class value and normalValue attributes vary inversely to the associated OperationalLimitType.acceptableDuration (acceptableDuration for short). If a particular piece of equipment has multiple operational limits of the same kind (apparent power, current, etc.), the limit with the greatest acceptableDuration shall have the smallest limit value and the limit with the smallest acceptableDuration shall have the largest limit value. Note: A large current can only be allowed to flow through a piece of equipment for a short duration without causing damage, but a lesser current can be allowed to flow for a longer duration. + + :OperationalLimitSet: The limit set to which the limit values belong. Default: None + :OperationalLimitType: The limit type associated with this limit. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'OperationalLimitSet': [cgmesProfile.EQ.value, ], + 'OperationalLimitType': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, OperationalLimitSet = None, OperationalLimitType = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.OperationalLimitSet = OperationalLimitSet + self.OperationalLimitType = OperationalLimitType + + def __str__(self): + str = 'class=OperationalLimit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/OperationalLimitDirectionKind.py b/cimpy/cgmes_v3_0_0/OperationalLimitDirectionKind.py new file mode 100644 index 00000000..04f3f3fa --- /dev/null +++ b/cimpy/cgmes_v3_0_0/OperationalLimitDirectionKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class OperationalLimitDirectionKind(Base): + ''' + The direction attribute describes the side of a limit that is a violation. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=OperationalLimitDirectionKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/OperationalLimitSet.py b/cimpy/cgmes_v3_0_0/OperationalLimitSet.py new file mode 100644 index 00000000..791da11f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/OperationalLimitSet.py @@ -0,0 +1,37 @@ +from .IdentifiedObject import IdentifiedObject + + +class OperationalLimitSet(IdentifiedObject): + ''' + A set of limits associated with equipment. Sets of limits might apply to a specific temperature, or season for example. A set of limits may contain different severities of limit levels that would apply to the same equipment. The set may contain limits of different types such as apparent power and current limits or high and low voltage limits that are logically applied together as a set. + + :Terminal: The terminal where the operational limit set apply. Default: None + :Equipment: The equipment to which the limit set applies. Default: None + :OperationalLimitValue: Values of equipment limits. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'Terminal': [cgmesProfile.EQ.value, ], + 'Equipment': [cgmesProfile.EQ.value, ], + 'OperationalLimitValue': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, Terminal = None, Equipment = None, OperationalLimitValue = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Terminal = Terminal + self.Equipment = Equipment + self.OperationalLimitValue = OperationalLimitValue + + def __str__(self): + str = 'class=OperationalLimitSet\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/OperationalLimitType.py b/cimpy/cgmes_v3_0_0/OperationalLimitType.py new file mode 100644 index 00000000..6bb0184d --- /dev/null +++ b/cimpy/cgmes_v3_0_0/OperationalLimitType.py @@ -0,0 +1,43 @@ +from .IdentifiedObject import IdentifiedObject + + +class OperationalLimitType(IdentifiedObject): + ''' + The operational meaning of a category of limits. + + :OperationalLimit: The operational limits associated with this type of limit. Default: "list" + :acceptableDuration: The nominal acceptable duration of the limit. Limits are commonly expressed in terms of the time limit for which the limit is normally acceptable. The actual acceptable duration of a specific limit may depend on other local factors such as temperature or wind speed. The attribute has meaning only if the flag isInfiniteDuration is set to false, hence it shall not be exchanged when isInfiniteDuration is set to true. Default: 0 + :direction: The direction of the limit. Default: None + :isInfiniteDuration: Defines if the operational limit type has infinite duration. If true, the limit has infinite duration. If false, the limit has definite duration which is defined by the attribute acceptableDuration. Default: False + :kind: Types of limits defined in the ENTSO-E Operational Handbook Policy 3. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'OperationalLimit': [cgmesProfile.EQ.value, ], + 'acceptableDuration': [cgmesProfile.EQ.value, ], + 'direction': [cgmesProfile.EQ.value, ], + 'isInfiniteDuration': [cgmesProfile.EQ.value, ], + 'kind': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, OperationalLimit = "list", acceptableDuration = 0, direction = None, isInfiniteDuration = False, kind = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.OperationalLimit = OperationalLimit + self.acceptableDuration = acceptableDuration + self.direction = direction + self.isInfiniteDuration = isInfiniteDuration + self.kind = kind + + def __str__(self): + str = 'class=OperationalLimitType\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/OrientationKind.py b/cimpy/cgmes_v3_0_0/OrientationKind.py new file mode 100644 index 00000000..67f1d367 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/OrientationKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class OrientationKind(Base): + ''' + The orientation of the coordinate system with respect to top, left, and the coordinate number system. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DL.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=OrientationKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/OverexcLim2.py b/cimpy/cgmes_v3_0_0/OverexcLim2.py new file mode 100644 index 00000000..7d710896 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/OverexcLim2.py @@ -0,0 +1,40 @@ +from .OverexcitationLimiterDynamics import OverexcitationLimiterDynamics + + +class OverexcLim2(OverexcitationLimiterDynamics): + ''' + Different from LimIEEEOEL, LimOEL2 has a fixed pickup threshold and reduces the excitation set-point by means of a non-windup integral regulator. Irated is the rated machine excitation current (calculated from nameplate conditions: Vnom, Pnom, CosPhinom). + + :koi: Gain Over excitation limiter (KOI). Typical value = 0,1. Default: 0.0 + :voimax: Maximum error signal (VOIMAX) (> OverexcLim2.voimin). Typical value = 0. Default: 0.0 + :voimin: Minimum error signal (VOIMIN) (< OverexcLim2.voimax). Typical value = -9999. Default: 0.0 + :ifdlim: Limit value of rated field current (IFDLIM). Typical value = 1,05. Default: 0.0 + ''' + + cgmesProfile = OverexcitationLimiterDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'koi': [cgmesProfile.DY.value, ], + 'voimax': [cgmesProfile.DY.value, ], + 'voimin': [cgmesProfile.DY.value, ], + 'ifdlim': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class OverexcitationLimiterDynamics: \n' + OverexcitationLimiterDynamics.__doc__ + + def __init__(self, koi = 0.0, voimax = 0.0, voimin = 0.0, ifdlim = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.koi = koi + self.voimax = voimax + self.voimin = voimin + self.ifdlim = ifdlim + + def __str__(self): + str = 'class=OverexcLim2\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/OverexcLimIEEE.py b/cimpy/cgmes_v3_0_0/OverexcLimIEEE.py new file mode 100644 index 00000000..0da4cac2 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/OverexcLimIEEE.py @@ -0,0 +1,46 @@ +from .OverexcitationLimiterDynamics import OverexcitationLimiterDynamics + + +class OverexcLimIEEE(OverexcitationLimiterDynamics): + ''' + The over excitation limiter model is intended to represent the significant features of OELs necessary for some large-scale system studies. It is the result of a pragmatic approach to obtain a model that can be widely applied with attainable data from generator owners. An attempt to include all variations in the functionality of OELs and duplicate how they interact with the rest of the excitation systems would likely result in a level of application insufficient for the studies for which they are intended. Reference: IEEE OEL 421.5-2005, 9. + + :itfpu: OEL timed field current limiter pickup level (ITFPU). Typical value = 1,05. Default: 0.0 + :ifdmax: OEL instantaneous field current limit (IFDMAX). Typical value = 1,5. Default: 0.0 + :ifdlim: OEL timed field current limit (IFDLIM). Typical value = 1,05. Default: 0.0 + :hyst: OEL pickup/drop-out hysteresis (HYST). Typical value = 0,03. Default: 0.0 + :kcd: OEL cooldown gain (KCD). Typical value = 1. Default: 0.0 + :kramp: OEL ramped limit rate (KRAMP). Unit = PU / s. Typical value = 10. Default: 0.0 + ''' + + cgmesProfile = OverexcitationLimiterDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'itfpu': [cgmesProfile.DY.value, ], + 'ifdmax': [cgmesProfile.DY.value, ], + 'ifdlim': [cgmesProfile.DY.value, ], + 'hyst': [cgmesProfile.DY.value, ], + 'kcd': [cgmesProfile.DY.value, ], + 'kramp': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class OverexcitationLimiterDynamics: \n' + OverexcitationLimiterDynamics.__doc__ + + def __init__(self, itfpu = 0.0, ifdmax = 0.0, ifdlim = 0.0, hyst = 0.0, kcd = 0.0, kramp = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.itfpu = itfpu + self.ifdmax = ifdmax + self.ifdlim = ifdlim + self.hyst = hyst + self.kcd = kcd + self.kramp = kramp + + def __str__(self): + str = 'class=OverexcLimIEEE\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/OverexcLimX1.py b/cimpy/cgmes_v3_0_0/OverexcLimX1.py new file mode 100644 index 00000000..19f3f43f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/OverexcLimX1.py @@ -0,0 +1,58 @@ +from .OverexcitationLimiterDynamics import OverexcitationLimiterDynamics + + +class OverexcLimX1(OverexcitationLimiterDynamics): + ''' + Field voltage over excitation limiter. + + :efdrated: Rated field voltage (EFDRATED). Typical value = 1,05. Default: 0.0 + :efd1: Low voltage point on the inverse time characteristic (EFD1). Typical value = 1,1. Default: 0.0 + :t1: Time to trip the exciter at the low voltage point on the inverse time characteristic (TIME1) (>= 0). Typical value = 120. Default: 0 + :efd2: Mid voltage point on the inverse time characteristic (EFD2). Typical value = 1,2. Default: 0.0 + :t2: Time to trip the exciter at the mid voltage point on the inverse time characteristic (TIME2) (>= 0). Typical value = 40. Default: 0 + :efd3: High voltage point on the inverse time characteristic (EFD3). Typical value = 1,5. Default: 0.0 + :t3: Time to trip the exciter at the high voltage point on the inverse time characteristic (TIME3) (>= 0). Typical value = 15. Default: 0 + :efddes: Desired field voltage (EFDDES). Typical value = 0,9. Default: 0.0 + :kmx: Gain (KMX). Typical value = 0,01. Default: 0.0 + :vlow: Low voltage limit (VLOW) (> 0). Default: 0.0 + ''' + + cgmesProfile = OverexcitationLimiterDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'efdrated': [cgmesProfile.DY.value, ], + 'efd1': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 'efd2': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 'efd3': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 'efddes': [cgmesProfile.DY.value, ], + 'kmx': [cgmesProfile.DY.value, ], + 'vlow': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class OverexcitationLimiterDynamics: \n' + OverexcitationLimiterDynamics.__doc__ + + def __init__(self, efdrated = 0.0, efd1 = 0.0, t1 = 0, efd2 = 0.0, t2 = 0, efd3 = 0.0, t3 = 0, efddes = 0.0, kmx = 0.0, vlow = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.efdrated = efdrated + self.efd1 = efd1 + self.t1 = t1 + self.efd2 = efd2 + self.t2 = t2 + self.efd3 = efd3 + self.t3 = t3 + self.efddes = efddes + self.kmx = kmx + self.vlow = vlow + + def __str__(self): + str = 'class=OverexcLimX1\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/OverexcLimX2.py b/cimpy/cgmes_v3_0_0/OverexcLimX2.py new file mode 100644 index 00000000..d4f4b1b6 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/OverexcLimX2.py @@ -0,0 +1,61 @@ +from .OverexcitationLimiterDynamics import OverexcitationLimiterDynamics + + +class OverexcLimX2(OverexcitationLimiterDynamics): + ''' + Field voltage or current overexcitation limiter designed to protect the generator field of an AC machine with automatic excitation control from overheating due to prolonged overexcitation. + + :m: (m). true = IFD limiting false = EFD limiting. Default: False + :efdrated: Rated field voltage if m = false or rated field current if m = true (EFDRATED). Typical value = 1,05. Default: 0.0 + :efd1: Low voltage or current point on the inverse time characteristic (EFD1). Typical value = 1,1. Default: 0.0 + :t1: Time to trip the exciter at the low voltage or current point on the inverse time characteristic (TIME1) (>= 0). Typical value = 120. Default: 0 + :efd2: Mid voltage or current point on the inverse time characteristic (EFD2). Typical value = 1,2. Default: 0.0 + :t2: Time to trip the exciter at the mid voltage or current point on the inverse time characteristic (TIME2) (>= 0). Typical value = 40. Default: 0 + :efd3: High voltage or current point on the inverse time characteristic (EFD3). Typical value = 1,5. Default: 0.0 + :t3: Time to trip the exciter at the high voltage or current point on the inverse time characteristic (TIME3) (>= 0). Typical value = 15. Default: 0 + :efddes: Desired field voltage if m = false or desired field current if m = true (EFDDES). Typical value = 1. Default: 0.0 + :kmx: Gain (KMX). Typical value = 0,002. Default: 0.0 + :vlow: Low voltage limit (VLOW) (> 0). Default: 0.0 + ''' + + cgmesProfile = OverexcitationLimiterDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'm': [cgmesProfile.DY.value, ], + 'efdrated': [cgmesProfile.DY.value, ], + 'efd1': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 'efd2': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 'efd3': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 'efddes': [cgmesProfile.DY.value, ], + 'kmx': [cgmesProfile.DY.value, ], + 'vlow': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class OverexcitationLimiterDynamics: \n' + OverexcitationLimiterDynamics.__doc__ + + def __init__(self, m = False, efdrated = 0.0, efd1 = 0.0, t1 = 0, efd2 = 0.0, t2 = 0, efd3 = 0.0, t3 = 0, efddes = 0.0, kmx = 0.0, vlow = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.m = m + self.efdrated = efdrated + self.efd1 = efd1 + self.t1 = t1 + self.efd2 = efd2 + self.t2 = t2 + self.efd3 = efd3 + self.t3 = t3 + self.efddes = efddes + self.kmx = kmx + self.vlow = vlow + + def __str__(self): + str = 'class=OverexcLimX2\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/OverexcitationLimiterDynamics.py b/cimpy/cgmes_v3_0_0/OverexcitationLimiterDynamics.py new file mode 100644 index 00000000..c8ee92ed --- /dev/null +++ b/cimpy/cgmes_v3_0_0/OverexcitationLimiterDynamics.py @@ -0,0 +1,31 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class OverexcitationLimiterDynamics(DynamicsFunctionBlock): + ''' + Overexcitation limiter function block whose behaviour is described by reference to a standard model or by definition of a user-defined model. + + :ExcitationSystemDynamics: Excitation system model with which this overexcitation limiter model is associated. Default: None + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ExcitationSystemDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, ExcitationSystemDynamics = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ExcitationSystemDynamics = ExcitationSystemDynamics + + def __str__(self): + str = 'class=OverexcitationLimiterDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/OverexcitationLimiterUserDefined.py b/cimpy/cgmes_v3_0_0/OverexcitationLimiterUserDefined.py new file mode 100644 index 00000000..80e164d1 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/OverexcitationLimiterUserDefined.py @@ -0,0 +1,34 @@ +from .OverexcitationLimiterDynamics import OverexcitationLimiterDynamics + + +class OverexcitationLimiterUserDefined(OverexcitationLimiterDynamics): + ''' + Overexcitation limiter system function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = OverexcitationLimiterDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class OverexcitationLimiterDynamics: \n' + OverexcitationLimiterDynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=OverexcitationLimiterUserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PFVArControllerType1Dynamics.py b/cimpy/cgmes_v3_0_0/PFVArControllerType1Dynamics.py new file mode 100644 index 00000000..3288fa9c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PFVArControllerType1Dynamics.py @@ -0,0 +1,37 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class PFVArControllerType1Dynamics(DynamicsFunctionBlock): + ''' + Power factor or VAr controller type 1 function block whose behaviour is described by reference to a standard model or by definition of a user-defined model. + + :RemoteInputSignal: Remote input signal used by this power factor or VAr controller type 1 model. Default: None + :ExcitationSystemDynamics: Excitation system model with which this power actor or VAr controller type 1 model is associated. Default: None + :VoltageAdjusterDynamics: Voltage adjuster model associated with this power factor or VAr controller type 1 model. Default: None + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'RemoteInputSignal': [cgmesProfile.DY.value, ], + 'ExcitationSystemDynamics': [cgmesProfile.DY.value, ], + 'VoltageAdjusterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, RemoteInputSignal = None, ExcitationSystemDynamics = None, VoltageAdjusterDynamics = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.RemoteInputSignal = RemoteInputSignal + self.ExcitationSystemDynamics = ExcitationSystemDynamics + self.VoltageAdjusterDynamics = VoltageAdjusterDynamics + + def __str__(self): + str = 'class=PFVArControllerType1Dynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PFVArControllerType1UserDefined.py b/cimpy/cgmes_v3_0_0/PFVArControllerType1UserDefined.py new file mode 100644 index 00000000..7d14ab00 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PFVArControllerType1UserDefined.py @@ -0,0 +1,34 @@ +from .PFVArControllerType1Dynamics import PFVArControllerType1Dynamics + + +class PFVArControllerType1UserDefined(PFVArControllerType1Dynamics): + ''' + Power factor or VAr controller type 1 function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = PFVArControllerType1Dynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PFVArControllerType1Dynamics: \n' + PFVArControllerType1Dynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=PFVArControllerType1UserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PFVArControllerType2Dynamics.py b/cimpy/cgmes_v3_0_0/PFVArControllerType2Dynamics.py new file mode 100644 index 00000000..5fb69391 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PFVArControllerType2Dynamics.py @@ -0,0 +1,31 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class PFVArControllerType2Dynamics(DynamicsFunctionBlock): + ''' + Power factor or VAr controller type 2 function block whose behaviour is described by reference to a standard model or by definition of a user-defined model. + + :ExcitationSystemDynamics: Excitation system model with which this power factor or VAr controller type 2 is associated. Default: None + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ExcitationSystemDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, ExcitationSystemDynamics = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ExcitationSystemDynamics = ExcitationSystemDynamics + + def __str__(self): + str = 'class=PFVArControllerType2Dynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PFVArControllerType2UserDefined.py b/cimpy/cgmes_v3_0_0/PFVArControllerType2UserDefined.py new file mode 100644 index 00000000..b86f5814 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PFVArControllerType2UserDefined.py @@ -0,0 +1,34 @@ +from .PFVArControllerType2Dynamics import PFVArControllerType2Dynamics + + +class PFVArControllerType2UserDefined(PFVArControllerType2Dynamics): + ''' + Power factor or VAr controller type 2 function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = PFVArControllerType2Dynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PFVArControllerType2Dynamics: \n' + PFVArControllerType2Dynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=PFVArControllerType2UserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PFVArType1IEEEPFController.py b/cimpy/cgmes_v3_0_0/PFVArType1IEEEPFController.py new file mode 100644 index 00000000..2f202822 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PFVArType1IEEEPFController.py @@ -0,0 +1,52 @@ +from .PFVArControllerType1Dynamics import PFVArControllerType1Dynamics + + +class PFVArType1IEEEPFController(PFVArControllerType1Dynamics): + ''' + IEEE PF controller type 1 which operates by moving the voltage reference directly. Reference: IEEE 421.5-2005, 11.2. + + :ovex: Overexcitation Flag (OVEX) true = overexcited false = underexcited. Default: False + :tpfc: PF controller time delay (TPFC) (>= 0). Typical value = 5. Default: 0 + :vitmin: Minimum machine terminal current needed to enable pf/var controller (VITMIN). Default: 0.0 + :vpf: Synchronous machine power factor (VPF). Default: 0.0 + :vpfcbw: PF controller deadband (VPFC_BW). Typical value = 0,05. Default: 0.0 + :vpfref: PF controller reference (VPFREF). Default: 0.0 + :vvtmax: Maximum machine terminal voltage needed for pf/var controller to be enabled (VVTMAX) (> PFVArType1IEEEPFController.vvtmin). Default: 0.0 + :vvtmin: Minimum machine terminal voltage needed to enable pf/var controller (VVTMIN) (< PFVArType1IEEEPFController.vvtmax). Default: 0.0 + ''' + + cgmesProfile = PFVArControllerType1Dynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ovex': [cgmesProfile.DY.value, ], + 'tpfc': [cgmesProfile.DY.value, ], + 'vitmin': [cgmesProfile.DY.value, ], + 'vpf': [cgmesProfile.DY.value, ], + 'vpfcbw': [cgmesProfile.DY.value, ], + 'vpfref': [cgmesProfile.DY.value, ], + 'vvtmax': [cgmesProfile.DY.value, ], + 'vvtmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PFVArControllerType1Dynamics: \n' + PFVArControllerType1Dynamics.__doc__ + + def __init__(self, ovex = False, tpfc = 0, vitmin = 0.0, vpf = 0.0, vpfcbw = 0.0, vpfref = 0.0, vvtmax = 0.0, vvtmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ovex = ovex + self.tpfc = tpfc + self.vitmin = vitmin + self.vpf = vpf + self.vpfcbw = vpfcbw + self.vpfref = vpfref + self.vvtmax = vvtmax + self.vvtmin = vvtmin + + def __str__(self): + str = 'class=PFVArType1IEEEPFController\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PFVArType1IEEEVArController.py b/cimpy/cgmes_v3_0_0/PFVArType1IEEEVArController.py new file mode 100644 index 00000000..8e22770c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PFVArType1IEEEVArController.py @@ -0,0 +1,46 @@ +from .PFVArControllerType1Dynamics import PFVArControllerType1Dynamics + + +class PFVArType1IEEEVArController(PFVArControllerType1Dynamics): + ''' + IEEE VAR controller type 1 which operates by moving the voltage reference directly. Reference: IEEE 421.5-2005, 11.3. + + :tvarc: Var controller time delay (TVARC) (>= 0). Typical value = 5. Default: 0 + :vvar: Synchronous machine power factor (VVAR). Default: 0.0 + :vvarcbw: Var controller deadband (VVARC_BW). Typical value = 0,02. Default: 0.0 + :vvarref: Var controller reference (VVARREF). Default: 0.0 + :vvtmax: Maximum machine terminal voltage needed for pf/VAr controller to be enabled (VVTMAX) (> PVFArType1IEEEVArController.vvtmin). Default: 0.0 + :vvtmin: Minimum machine terminal voltage needed to enable pf/var controller (VVTMIN) (< PVFArType1IEEEVArController.vvtmax). Default: 0.0 + ''' + + cgmesProfile = PFVArControllerType1Dynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'tvarc': [cgmesProfile.DY.value, ], + 'vvar': [cgmesProfile.DY.value, ], + 'vvarcbw': [cgmesProfile.DY.value, ], + 'vvarref': [cgmesProfile.DY.value, ], + 'vvtmax': [cgmesProfile.DY.value, ], + 'vvtmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PFVArControllerType1Dynamics: \n' + PFVArControllerType1Dynamics.__doc__ + + def __init__(self, tvarc = 0, vvar = 0.0, vvarcbw = 0.0, vvarref = 0.0, vvtmax = 0.0, vvtmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.tvarc = tvarc + self.vvar = vvar + self.vvarcbw = vvarcbw + self.vvarref = vvarref + self.vvtmax = vvtmax + self.vvtmin = vvtmin + + def __str__(self): + str = 'class=PFVArType1IEEEVArController\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PFVArType2Common1.py b/cimpy/cgmes_v3_0_0/PFVArType2Common1.py new file mode 100644 index 00000000..fc284eac --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PFVArType2Common1.py @@ -0,0 +1,43 @@ +from .PFVArControllerType2Dynamics import PFVArControllerType2Dynamics + + +class PFVArType2Common1(PFVArControllerType2Dynamics): + ''' + Power factor / reactive power regulator. This model represents the power factor or reactive power controller such as the Basler SCP-250. The controller measures power factor or reactive power (PU on generator rated power) and compares it with the operator's set point. [Footnote: Basler SCP-250 is an example of a suitable product available commercially. This information is given for the convenience of users of this document and does not constitute an endorsement by IEC of this product.] + + :j: Selector (J). true = control mode for reactive power false = control mode for power factor. Default: False + :kp: Proportional gain (Kp). Default: 0.0 + :ki: Reset gain (Ki). Default: 0.0 + :max: Output limit (max). Default: 0.0 + :ref: Reference value of reactive power or power factor (Ref). The reference value is initialised by this model. This initialisation can override the value exchanged by this attribute to represent a plant operator`s change of the reference setting. Default: 0.0 + ''' + + cgmesProfile = PFVArControllerType2Dynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'j': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'max': [cgmesProfile.DY.value, ], + 'ref': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PFVArControllerType2Dynamics: \n' + PFVArControllerType2Dynamics.__doc__ + + def __init__(self, j = False, kp = 0.0, ki = 0.0, max = 0.0, ref = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.j = j + self.kp = kp + self.ki = ki + self.max = max + self.ref = ref + + def __str__(self): + str = 'class=PFVArType2Common1\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PFVArType2IEEEPFController.py b/cimpy/cgmes_v3_0_0/PFVArType2IEEEPFController.py new file mode 100644 index 00000000..55630803 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PFVArType2IEEEPFController.py @@ -0,0 +1,49 @@ +from .PFVArControllerType2Dynamics import PFVArControllerType2Dynamics + + +class PFVArType2IEEEPFController(PFVArControllerType2Dynamics): + ''' + IEEE PF controller type 2 which is a summing point type controller making up the outside loop of a two-loop system. This controller is implemented as a slow PI type controller. The voltage regulator forms the inner loop and is implemented as a fast controller. Reference: IEEE 421.5-2005, 11.4. + + :pfref: Power factor reference (PFREF). Default: 0.0 + :vref: Voltage regulator reference (VREF). Default: 0.0 + :vclmt: Maximum output of the pf controller (VCLMT). Typical value = 0,1. Default: 0.0 + :kp: Proportional gain of the pf controller (KP). Typical value = 1. Default: 0.0 + :ki: Integral gain of the pf controller (KI). Typical value = 1. Default: 0.0 + :vs: Generator sensing voltage (VS). Default: 0.0 + :exlon: Overexcitation or under excitation flag (EXLON) true = 1 (not in the overexcitation or underexcitation state, integral action is active) false = 0 (in the overexcitation or underexcitation state, so integral action is disabled to allow the limiter to play its role). Default: False + ''' + + cgmesProfile = PFVArControllerType2Dynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'pfref': [cgmesProfile.DY.value, ], + 'vref': [cgmesProfile.DY.value, ], + 'vclmt': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'vs': [cgmesProfile.DY.value, ], + 'exlon': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PFVArControllerType2Dynamics: \n' + PFVArControllerType2Dynamics.__doc__ + + def __init__(self, pfref = 0.0, vref = 0.0, vclmt = 0.0, kp = 0.0, ki = 0.0, vs = 0.0, exlon = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.pfref = pfref + self.vref = vref + self.vclmt = vclmt + self.kp = kp + self.ki = ki + self.vs = vs + self.exlon = exlon + + def __str__(self): + str = 'class=PFVArType2IEEEPFController\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PFVArType2IEEEVArController.py b/cimpy/cgmes_v3_0_0/PFVArType2IEEEVArController.py new file mode 100644 index 00000000..75ed5fda --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PFVArType2IEEEVArController.py @@ -0,0 +1,49 @@ +from .PFVArControllerType2Dynamics import PFVArControllerType2Dynamics + + +class PFVArType2IEEEVArController(PFVArControllerType2Dynamics): + ''' + IEEE VAR controller type 2 which is a summing point type controller. It makes up the outside loop of a two-loop system. This controller is implemented as a slow PI type controller, and the voltage regulator forms the inner loop and is implemented as a fast controller. Reference: IEEE 421.5-2005, 11.5. + + :qref: Reactive power reference (QREF). Default: 0.0 + :vref: Voltage regulator reference (VREF). Default: 0.0 + :vclmt: Maximum output of the pf controller (VCLMT). Default: 0.0 + :kp: Proportional gain of the pf controller (KP). Default: 0.0 + :ki: Integral gain of the pf controller (KI). Default: 0.0 + :vs: Generator sensing voltage (VS). Default: 0.0 + :exlon: Overexcitation or under excitation flag (EXLON) true = 1 (not in the overexcitation or underexcitation state, integral action is active) false = 0 (in the overexcitation or underexcitation state, so integral action is disabled to allow the limiter to play its role). Default: False + ''' + + cgmesProfile = PFVArControllerType2Dynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'qref': [cgmesProfile.DY.value, ], + 'vref': [cgmesProfile.DY.value, ], + 'vclmt': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'vs': [cgmesProfile.DY.value, ], + 'exlon': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PFVArControllerType2Dynamics: \n' + PFVArControllerType2Dynamics.__doc__ + + def __init__(self, qref = 0.0, vref = 0.0, vclmt = 0.0, kp = 0.0, ki = 0.0, vs = 0.0, exlon = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.qref = qref + self.vref = vref + self.vclmt = vclmt + self.kp = kp + self.ki = ki + self.vs = vs + self.exlon = exlon + + def __str__(self): + str = 'class=PFVArType2IEEEVArController\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PU.py b/cimpy/cgmes_v3_0_0/PU.py new file mode 100644 index 00000000..f7fdd534 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PU.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class PU(Base): + ''' + Per Unit - a positive or negative value referred to a defined base. Values typically range from -10 to +10. + + :value: Default: 0.0 + :unit: Default: None + :multiplier: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.SC.value, ], + 'value': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.SC.value, ], + 'unit': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.SC.value, ], + 'multiplier': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, unit = None, multiplier = None, ): + + self.value = value + self.unit = unit + self.multiplier = multiplier + + def __str__(self): + str = 'class=PU\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PerCent.py b/cimpy/cgmes_v3_0_0/PerCent.py new file mode 100644 index 00000000..9e86e89e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PerCent.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class PerCent(Base): + ''' + Percentage on a defined base. For example, specify as 100 to indicate at the defined base. + + :value: Normally 0 to 100 on a defined base. Default: 0.0 + :unit: Default: None + :multiplier: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'value': [cgmesProfile.SSH.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'unit': [cgmesProfile.SSH.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'multiplier': [cgmesProfile.SSH.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, unit = None, multiplier = None, ): + + self.value = value + self.unit = unit + self.multiplier = multiplier + + def __str__(self): + str = 'class=PerCent\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PetersenCoil.py b/cimpy/cgmes_v3_0_0/PetersenCoil.py new file mode 100644 index 00000000..829cdc90 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PetersenCoil.py @@ -0,0 +1,49 @@ +from .EarthFaultCompensator import EarthFaultCompensator + + +class PetersenCoil(EarthFaultCompensator): + ''' + A variable impedance device normally used to offset line charging during single line faults in an ungrounded section of network. + + :mode: The mode of operation of the Petersen coil. Default: None + :nominalU: The nominal voltage for which the coil is designed. Default: 0.0 + :offsetCurrent: The offset current that the Petersen coil controller is operating from the resonant point. This is normally a fixed amount for which the controller is configured and could be positive or negative. Typically 0 to 60 A depending on voltage and resonance conditions. Default: 0.0 + :positionCurrent: The control current used to control the Petersen coil also known as the position current. Typically in the range of 20 mA to 200 mA. Default: 0.0 + :xGroundMax: The maximum reactance. Default: 0.0 + :xGroundMin: The minimum reactance. Default: 0.0 + :xGroundNominal: The nominal reactance. This is the operating point (normally over compensation) that is defined based on the resonance point in the healthy network condition. The impedance is calculated based on nominal voltage divided by position current. Default: 0.0 + ''' + + cgmesProfile = EarthFaultCompensator.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'mode': [cgmesProfile.SC.value, ], + 'nominalU': [cgmesProfile.SC.value, ], + 'offsetCurrent': [cgmesProfile.SC.value, ], + 'positionCurrent': [cgmesProfile.SC.value, ], + 'xGroundMax': [cgmesProfile.SC.value, ], + 'xGroundMin': [cgmesProfile.SC.value, ], + 'xGroundNominal': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EarthFaultCompensator: \n' + EarthFaultCompensator.__doc__ + + def __init__(self, mode = None, nominalU = 0.0, offsetCurrent = 0.0, positionCurrent = 0.0, xGroundMax = 0.0, xGroundMin = 0.0, xGroundNominal = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mode = mode + self.nominalU = nominalU + self.offsetCurrent = offsetCurrent + self.positionCurrent = positionCurrent + self.xGroundMax = xGroundMax + self.xGroundMin = xGroundMin + self.xGroundNominal = xGroundNominal + + def __str__(self): + str = 'class=PetersenCoil\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PetersenCoilModeKind.py b/cimpy/cgmes_v3_0_0/PetersenCoilModeKind.py new file mode 100644 index 00000000..1d939e4a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PetersenCoilModeKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class PetersenCoilModeKind(Base): + ''' + The mode of operation for a Petersen coil. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=PetersenCoilModeKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PhaseCode.py b/cimpy/cgmes_v3_0_0/PhaseCode.py new file mode 100644 index 00000000..8080e143 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PhaseCode.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class PhaseCode(Base): + ''' + An unordered enumeration of phase identifiers. Allows designation of phases for both transmission and distribution equipment, circuits and loads. The enumeration, by itself, does not describe how the phases are connected together or connected to ground. Ground is not explicitly denoted as a phase. Residential and small commercial loads are often served from single-phase, or split-phase, secondary circuits. For the example of s12N, phases 1 and 2 refer to hot wires that are 180 degrees out of phase, while N refers to the neutral wire. Through single-phase transformer connections, these secondary circuits may be served from one or two of the primary phases A, B, and C. For three-phase loads, use the A, B, C phase codes instead of s12N. The integer values are from IEC 61968-9 to support revenue metering applications. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=PhaseCode\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PhaseTapChanger.py b/cimpy/cgmes_v3_0_0/PhaseTapChanger.py new file mode 100644 index 00000000..c2e7a2a2 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PhaseTapChanger.py @@ -0,0 +1,31 @@ +from .TapChanger import TapChanger + + +class PhaseTapChanger(TapChanger): + ''' + A transformer phase shifting tap model that controls the phase angle difference across the power transformer and potentially the active power flow through the power transformer. This phase tap model may also impact the voltage magnitude. + + :TransformerEnd: Transformer end to which this phase tap changer belongs. Default: None + ''' + + cgmesProfile = TapChanger.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'TransformerEnd': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TapChanger: \n' + TapChanger.__doc__ + + def __init__(self, TransformerEnd = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.TransformerEnd = TransformerEnd + + def __str__(self): + str = 'class=PhaseTapChanger\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PhaseTapChangerAsymmetrical.py b/cimpy/cgmes_v3_0_0/PhaseTapChangerAsymmetrical.py new file mode 100644 index 00000000..0464aceb --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PhaseTapChangerAsymmetrical.py @@ -0,0 +1,31 @@ +from .PhaseTapChangerNonLinear import PhaseTapChangerNonLinear + + +class PhaseTapChangerAsymmetrical(PhaseTapChangerNonLinear): + ''' + Describes the tap model for an asymmetrical phase shifting transformer in which the difference voltage vector adds to the in-phase winding. The out-of-phase winding is the transformer end where the tap changer is located. The angle between the in-phase and out-of-phase windings is named the winding connection angle. The phase shift depends on both the difference voltage magnitude and the winding connection angle. + + :windingConnectionAngle: The phase angle between the in-phase winding and the out-of -phase winding used for creating phase shift. The out-of-phase winding produces what is known as the difference voltage. Setting this angle to 90 degrees is not the same as a symmetrical transformer. The attribute can only be multiples of 30 degrees. The allowed range is -150 degrees to 150 degrees excluding 0. Default: 0.0 + ''' + + cgmesProfile = PhaseTapChangerNonLinear.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'windingConnectionAngle': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PhaseTapChangerNonLinear: \n' + PhaseTapChangerNonLinear.__doc__ + + def __init__(self, windingConnectionAngle = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.windingConnectionAngle = windingConnectionAngle + + def __str__(self): + str = 'class=PhaseTapChangerAsymmetrical\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PhaseTapChangerLinear.py b/cimpy/cgmes_v3_0_0/PhaseTapChangerLinear.py new file mode 100644 index 00000000..21a14870 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PhaseTapChangerLinear.py @@ -0,0 +1,37 @@ +from .PhaseTapChanger import PhaseTapChanger + + +class PhaseTapChangerLinear(PhaseTapChanger): + ''' + Describes a tap changer with a linear relation between the tap step and the phase angle difference across the transformer. This is a mathematical model that is an approximation of a real phase tap changer. The phase angle is computed as stepPhaseShiftIncrement times the tap position. The voltage magnitude of both sides is the same. + + :stepPhaseShiftIncrement: Phase shift per step position. A positive value indicates a positive angle variation from the Terminal at the PowerTransformerEnd, where the TapChanger is located, into the transformer. The actual phase shift increment might be more accurately computed from the symmetrical or asymmetrical models or a tap step table lookup if those are available. Default: 0.0 + :xMax: The reactance depends on the tap position according to a `u` shaped curve. The maximum reactance (xMax) appears at the low and high tap positions. Depending on the `u` curve the attribute can be either higher or lower than PowerTransformerEnd.x. Default: 0.0 + :xMin: The reactance depends on the tap position according to a `u` shaped curve. The minimum reactance (xMin) appears at the mid tap position. PowerTransformerEnd.x shall be consistent with PhaseTapChangerLinear.xMin and PhaseTapChangerNonLinear.xMin. In case of inconsistency, PowerTransformerEnd.x shall be used. Default: 0.0 + ''' + + cgmesProfile = PhaseTapChanger.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'stepPhaseShiftIncrement': [cgmesProfile.EQ.value, ], + 'xMax': [cgmesProfile.EQ.value, ], + 'xMin': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PhaseTapChanger: \n' + PhaseTapChanger.__doc__ + + def __init__(self, stepPhaseShiftIncrement = 0.0, xMax = 0.0, xMin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.stepPhaseShiftIncrement = stepPhaseShiftIncrement + self.xMax = xMax + self.xMin = xMin + + def __str__(self): + str = 'class=PhaseTapChangerLinear\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PhaseTapChangerNonLinear.py b/cimpy/cgmes_v3_0_0/PhaseTapChangerNonLinear.py new file mode 100644 index 00000000..9afa07c3 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PhaseTapChangerNonLinear.py @@ -0,0 +1,37 @@ +from .PhaseTapChanger import PhaseTapChanger + + +class PhaseTapChangerNonLinear(PhaseTapChanger): + ''' + The non-linear phase tap changer describes the non-linear behaviour of a phase tap changer. This is a base class for the symmetrical and asymmetrical phase tap changer models. The details of these models can be found in IEC 61970-301. + + :voltageStepIncrement: The voltage step increment on the out of phase winding (the PowerTransformerEnd where the TapChanger is located) specified in percent of rated voltage of the PowerTransformerEnd. A positive value means a positive voltage variation from the Terminal at the PowerTransformerEnd, where the TapChanger is located, into the transformer. When the increment is negative, the voltage decreases when the tap step increases. Default: 0.0 + :xMax: The reactance depends on the tap position according to a `u` shaped curve. The maximum reactance (xMax) appears at the low and high tap positions. Depending on the `u` curve the attribute can be either higher or lower than PowerTransformerEnd.x. Default: 0.0 + :xMin: The reactance depend on the tap position according to a `u` shaped curve. The minimum reactance (xMin) appear at the mid tap position. PowerTransformerEnd.x shall be consistent with PhaseTapChangerLinear.xMin and PhaseTapChangerNonLinear.xMin. In case of inconsistency, PowerTransformerEnd.x shall be used. Default: 0.0 + ''' + + cgmesProfile = PhaseTapChanger.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'voltageStepIncrement': [cgmesProfile.EQ.value, ], + 'xMax': [cgmesProfile.EQ.value, ], + 'xMin': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PhaseTapChanger: \n' + PhaseTapChanger.__doc__ + + def __init__(self, voltageStepIncrement = 0.0, xMax = 0.0, xMin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.voltageStepIncrement = voltageStepIncrement + self.xMax = xMax + self.xMin = xMin + + def __str__(self): + str = 'class=PhaseTapChangerNonLinear\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PhaseTapChangerSymmetrical.py b/cimpy/cgmes_v3_0_0/PhaseTapChangerSymmetrical.py new file mode 100644 index 00000000..81ab9773 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PhaseTapChangerSymmetrical.py @@ -0,0 +1,29 @@ +from .PhaseTapChangerNonLinear import PhaseTapChangerNonLinear + + +class PhaseTapChangerSymmetrical(PhaseTapChangerNonLinear): + ''' + Describes a symmetrical phase shifting transformer tap model in which the voltage magnitude of both sides is the same. The difference voltage magnitude is the base in an equal-sided triangle where the sides corresponds to the primary and secondary voltages. The phase angle difference corresponds to the top angle and can be expressed as twice the arctangent of half the total difference voltage. + + ''' + + cgmesProfile = PhaseTapChangerNonLinear.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PhaseTapChangerNonLinear: \n' + PhaseTapChangerNonLinear.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=PhaseTapChangerSymmetrical\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PhaseTapChangerTable.py b/cimpy/cgmes_v3_0_0/PhaseTapChangerTable.py new file mode 100644 index 00000000..a017461c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PhaseTapChangerTable.py @@ -0,0 +1,34 @@ +from .IdentifiedObject import IdentifiedObject + + +class PhaseTapChangerTable(IdentifiedObject): + ''' + Describes a tabular curve for how the phase angle difference and impedance varies with the tap step. + + :PhaseTapChangerTablePoint: The points of this table. Default: "list" + :PhaseTapChangerTabular: The phase tap changers to which this phase tap table applies. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'PhaseTapChangerTablePoint': [cgmesProfile.EQ.value, ], + 'PhaseTapChangerTabular': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, PhaseTapChangerTablePoint = "list", PhaseTapChangerTabular = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.PhaseTapChangerTablePoint = PhaseTapChangerTablePoint + self.PhaseTapChangerTabular = PhaseTapChangerTabular + + def __str__(self): + str = 'class=PhaseTapChangerTable\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PhaseTapChangerTablePoint.py b/cimpy/cgmes_v3_0_0/PhaseTapChangerTablePoint.py new file mode 100644 index 00000000..f14c613c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PhaseTapChangerTablePoint.py @@ -0,0 +1,34 @@ +from .TapChangerTablePoint import TapChangerTablePoint + + +class PhaseTapChangerTablePoint(TapChangerTablePoint): + ''' + Describes each tap step in the phase tap changer tabular curve. + + :PhaseTapChangerTable: The table of this point. Default: None + :angle: The angle difference in degrees. A positive value indicates a positive angle variation from the Terminal at the PowerTransformerEnd, where the TapChanger is located, into the transformer. Default: 0.0 + ''' + + cgmesProfile = TapChangerTablePoint.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'PhaseTapChangerTable': [cgmesProfile.EQ.value, ], + 'angle': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TapChangerTablePoint: \n' + TapChangerTablePoint.__doc__ + + def __init__(self, PhaseTapChangerTable = None, angle = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.PhaseTapChangerTable = PhaseTapChangerTable + self.angle = angle + + def __str__(self): + str = 'class=PhaseTapChangerTablePoint\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PhaseTapChangerTabular.py b/cimpy/cgmes_v3_0_0/PhaseTapChangerTabular.py new file mode 100644 index 00000000..d886cd16 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PhaseTapChangerTabular.py @@ -0,0 +1,31 @@ +from .PhaseTapChanger import PhaseTapChanger + + +class PhaseTapChangerTabular(PhaseTapChanger): + ''' + Describes a tap changer with a table defining the relation between the tap step and the phase angle difference across the transformer. + + :PhaseTapChangerTable: The phase tap changer table for this phase tap changer. Default: None + ''' + + cgmesProfile = PhaseTapChanger.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'PhaseTapChangerTable': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PhaseTapChanger: \n' + PhaseTapChanger.__doc__ + + def __init__(self, PhaseTapChangerTable = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.PhaseTapChangerTable = PhaseTapChangerTable + + def __str__(self): + str = 'class=PhaseTapChangerTabular\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PhotoVoltaicUnit.py b/cimpy/cgmes_v3_0_0/PhotoVoltaicUnit.py new file mode 100644 index 00000000..d80dd98c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PhotoVoltaicUnit.py @@ -0,0 +1,29 @@ +from .PowerElectronicsUnit import PowerElectronicsUnit + + +class PhotoVoltaicUnit(PowerElectronicsUnit): + ''' + A photovoltaic device or an aggregation of such devices. + + ''' + + cgmesProfile = PowerElectronicsUnit.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerElectronicsUnit: \n' + PowerElectronicsUnit.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=PhotoVoltaicUnit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PositionPoint.py b/cimpy/cgmes_v3_0_0/PositionPoint.py new file mode 100644 index 00000000..1c358123 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PositionPoint.py @@ -0,0 +1,42 @@ +from .Base import Base + + +class PositionPoint(Base): + ''' + Set of spatial coordinates that determine a point, defined in the coordinate system specified in 'Location.CoordinateSystem'. Use a single position point instance to describe a point-oriented location. Use a sequence of position points to describe a line-oriented object (physical location of non-point oriented objects like cables or lines), or area of an object (like a substation or a geographical zone - in this case, have first and last position point with the same values). + + :Location: Location described by this position point. Default: None + :sequenceNumber: Zero-relative sequence number of this point within a series of points. Default: 0 + :xPosition: X axis position. Default: '' + :yPosition: Y axis position. Default: '' + :zPosition: (if applicable) Z axis position. Default: '' + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.GL.value, ], + 'Location': [cgmesProfile.GL.value, ], + 'sequenceNumber': [cgmesProfile.GL.value, ], + 'xPosition': [cgmesProfile.GL.value, ], + 'yPosition': [cgmesProfile.GL.value, ], + 'zPosition': [cgmesProfile.GL.value, ], + } + + serializationProfile = {} + + + + def __init__(self, Location = None, sequenceNumber = 0, xPosition = '', yPosition = '', zPosition = '', ): + + self.Location = Location + self.sequenceNumber = sequenceNumber + self.xPosition = xPosition + self.yPosition = yPosition + self.zPosition = zPosition + + def __str__(self): + str = 'class=PositionPoint\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PostLineSensor.py b/cimpy/cgmes_v3_0_0/PostLineSensor.py new file mode 100644 index 00000000..a7ba581b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PostLineSensor.py @@ -0,0 +1,29 @@ +from .Sensor import Sensor + + +class PostLineSensor(Sensor): + ''' + A sensor used mainly in overhead distribution networks as the source of both current and voltage measurements. + + ''' + + cgmesProfile = Sensor.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Sensor: \n' + Sensor.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=PostLineSensor\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PotentialTransformer.py b/cimpy/cgmes_v3_0_0/PotentialTransformer.py new file mode 100644 index 00000000..58a39d9e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PotentialTransformer.py @@ -0,0 +1,29 @@ +from .Sensor import Sensor + + +class PotentialTransformer(Sensor): + ''' + Instrument transformer (also known as Voltage Transformer) used to measure electrical qualities of the circuit that is being protected and/or monitored. Typically used as voltage transducer for the purpose of metering, protection, or sometimes auxiliary substation supply. A typical secondary voltage rating would be 120V. + + ''' + + cgmesProfile = Sensor.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Sensor: \n' + Sensor.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=PotentialTransformer\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PowerElectronicsConnection.py b/cimpy/cgmes_v3_0_0/PowerElectronicsConnection.py new file mode 100644 index 00000000..c144c4a9 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PowerElectronicsConnection.py @@ -0,0 +1,52 @@ +from .RegulatingCondEq import RegulatingCondEq + + +class PowerElectronicsConnection(RegulatingCondEq): + ''' + A connection to the AC network for energy production or consumption that uses power electronics rather than rotating machines. + + :WindTurbineType3or4Dynamics: The wind turbine type 3 or type 4 dynamics model associated with this power electronics connection. Default: None + :p: Active power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution. Default: 0.0 + :q: Reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution. Default: 0.0 + :maxQ: Maximum reactive power limit. This is the maximum (nameplate) limit for the unit. Default: 0.0 + :minQ: Minimum reactive power limit for the unit. This is the minimum (nameplate) limit for the unit. Default: 0.0 + :ratedS: Nameplate apparent power rating for the unit. The attribute shall have a positive value. Default: 0.0 + :ratedU: Rated voltage (nameplate data, Ur in IEC 60909-0). It is primarily used for short circuit data exchange according to IEC 60909. The attribute shall be a positive value. Default: 0.0 + :PowerElectronicsUnit: An AC network connection may have several power electronics units connecting through it. Default: None + ''' + + cgmesProfile = RegulatingCondEq.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'WindTurbineType3or4Dynamics': [cgmesProfile.DY.value, ], + 'p': [cgmesProfile.SSH.value, ], + 'q': [cgmesProfile.SSH.value, ], + 'maxQ': [cgmesProfile.EQ.value, ], + 'minQ': [cgmesProfile.EQ.value, ], + 'ratedS': [cgmesProfile.EQ.value, ], + 'ratedU': [cgmesProfile.EQ.value, ], + 'PowerElectronicsUnit': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class RegulatingCondEq: \n' + RegulatingCondEq.__doc__ + + def __init__(self, WindTurbineType3or4Dynamics = None, p = 0.0, q = 0.0, maxQ = 0.0, minQ = 0.0, ratedS = 0.0, ratedU = 0.0, PowerElectronicsUnit = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindTurbineType3or4Dynamics = WindTurbineType3or4Dynamics + self.p = p + self.q = q + self.maxQ = maxQ + self.minQ = minQ + self.ratedS = ratedS + self.ratedU = ratedU + self.PowerElectronicsUnit = PowerElectronicsUnit + + def __str__(self): + str = 'class=PowerElectronicsConnection\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PowerElectronicsUnit.py b/cimpy/cgmes_v3_0_0/PowerElectronicsUnit.py new file mode 100644 index 00000000..7c477ce7 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PowerElectronicsUnit.py @@ -0,0 +1,37 @@ +from .Equipment import Equipment + + +class PowerElectronicsUnit(Equipment): + ''' + A generating unit or battery or aggregation that connects to the AC network using power electronics rather than rotating machines. + + :PowerElectronicsConnection: A power electronics unit has a connection to the AC network. Default: None + :maxP: Maximum active power limit. This is the maximum (nameplate) limit for the unit. Default: 0.0 + :minP: Minimum active power limit. This is the minimum (nameplate) limit for the unit. Default: 0.0 + ''' + + cgmesProfile = Equipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'PowerElectronicsConnection': [cgmesProfile.EQ.value, ], + 'maxP': [cgmesProfile.EQ.value, ], + 'minP': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Equipment: \n' + Equipment.__doc__ + + def __init__(self, PowerElectronicsConnection = None, maxP = 0.0, minP = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.PowerElectronicsConnection = PowerElectronicsConnection + self.maxP = maxP + self.minP = minP + + def __str__(self): + str = 'class=PowerElectronicsUnit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PowerElectronicsWindUnit.py b/cimpy/cgmes_v3_0_0/PowerElectronicsWindUnit.py new file mode 100644 index 00000000..6c46c7a0 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PowerElectronicsWindUnit.py @@ -0,0 +1,29 @@ +from .PowerElectronicsUnit import PowerElectronicsUnit + + +class PowerElectronicsWindUnit(PowerElectronicsUnit): + ''' + A wind generating unit that connects to the AC network with power electronics rather than rotating machines or an aggregation of such units. + + ''' + + cgmesProfile = PowerElectronicsUnit.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerElectronicsUnit: \n' + PowerElectronicsUnit.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=PowerElectronicsWindUnit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PowerSystemResource.py b/cimpy/cgmes_v3_0_0/PowerSystemResource.py new file mode 100644 index 00000000..9bbb18d4 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PowerSystemResource.py @@ -0,0 +1,37 @@ +from .IdentifiedObject import IdentifiedObject + + +class PowerSystemResource(IdentifiedObject): + ''' + A power system resource (PSR) can be an item of equipment such as a switch, an equipment container containing many individual items of equipment such as a substation, or an organisational entity such as sub-control area. Power system resources can have measurements associated. + + :Location: Location of this power system resource. Default: None + :Controls: The controller outputs used to actually govern a regulating device, e.g. the magnetization of a synchronous machine or capacitor bank breaker actuator. Default: "list" + :Measurements: The measurements associated with this power system resource. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.GL.value, cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SC.value, ], + 'Location': [cgmesProfile.GL.value, ], + 'Controls': [cgmesProfile.OP.value, ], + 'Measurements': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, Location = None, Controls = "list", Measurements = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Location = Location + self.Controls = Controls + self.Measurements = Measurements + + def __str__(self): + str = 'class=PowerSystemResource\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PowerSystemStabilizerDynamics.py b/cimpy/cgmes_v3_0_0/PowerSystemStabilizerDynamics.py new file mode 100644 index 00000000..74d92424 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PowerSystemStabilizerDynamics.py @@ -0,0 +1,34 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class PowerSystemStabilizerDynamics(DynamicsFunctionBlock): + ''' + Power system stabilizer function block whose behaviour is described by reference to a standard model or by definition of a user-defined model. + + :RemoteInputSignal: Remote input signal used by this power system stabilizer model. Default: "list" + :ExcitationSystemDynamics: Excitation system model with which this power system stabilizer model is associated. Default: None + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'RemoteInputSignal': [cgmesProfile.DY.value, ], + 'ExcitationSystemDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, RemoteInputSignal = "list", ExcitationSystemDynamics = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.RemoteInputSignal = RemoteInputSignal + self.ExcitationSystemDynamics = ExcitationSystemDynamics + + def __str__(self): + str = 'class=PowerSystemStabilizerDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PowerSystemStabilizerUserDefined.py b/cimpy/cgmes_v3_0_0/PowerSystemStabilizerUserDefined.py new file mode 100644 index 00000000..f5a563e2 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PowerSystemStabilizerUserDefined.py @@ -0,0 +1,34 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class PowerSystemStabilizerUserDefined(PowerSystemStabilizerDynamics): + ''' + Power system stabilizer function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=PowerSystemStabilizerUserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PowerTransformer.py b/cimpy/cgmes_v3_0_0/PowerTransformer.py new file mode 100644 index 00000000..ac939825 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PowerTransformer.py @@ -0,0 +1,49 @@ +from .ConductingEquipment import ConductingEquipment + + +class PowerTransformer(ConductingEquipment): + ''' + An electrical device consisting of two or more coupled windings, with or without a magnetic core, for introducing mutual coupling between electric circuits. Transformers can be used to control voltage and phase shift (active power flow). A power transformer may be composed of separate transformer tanks that need not be identical. A power transformer can be modelled with or without tanks and is intended for use in both balanced and unbalanced representations. A power transformer typically has two terminals, but may have one (grounding), three or more terminals. The inherited association ConductingEquipment.BaseVoltage should not be used. The association from TransformerEnd to BaseVoltage should be used instead. + + :PowerTransformerEnd: The ends of this power transformer. Default: "list" + :beforeShCircuitHighestOperatingCurrent: The highest operating current (Ib in IEC 60909-0) before short circuit (depends on network configuration and relevant reliability philosophy). It is used for calculation of the impedance correction factor KT defined in IEC 60909-0. Default: 0.0 + :beforeShCircuitHighestOperatingVoltage: The highest operating voltage (Ub in IEC 60909-0) before short circuit. It is used for calculation of the impedance correction factor KT defined in IEC 60909-0. This is worst case voltage on the low side winding (3.7.1 of IEC 60909:2001). Used to define operating conditions. Default: 0.0 + :beforeShortCircuitAnglePf: The angle of power factor before short circuit (phib in IEC 60909-0). It is used for calculation of the impedance correction factor KT defined in IEC 60909-0. This is the worst case power factor. Used to define operating conditions. Default: 0.0 + :highSideMinOperatingU: The minimum operating voltage (uQmin in IEC 60909-0) at the high voltage side (Q side) of the unit transformer of the power station unit. A value well established from long-term operating experience of the system. It is used for calculation of the impedance correction factor KG defined in IEC 60909-0. Default: 0.0 + :isPartOfGeneratorUnit: Indicates whether the machine is part of a power station unit. Used for short circuit data exchange according to IEC 60909. It has an impact on how the correction factors are calculated for transformers, since the transformer is not necessarily part of a synchronous machine and generating unit. It is not always possible to derive this information from the model. This is why the attribute is necessary. Default: False + :operationalValuesConsidered: It is used to define if the data (other attributes related to short circuit data exchange) defines long term operational conditions or not. Used for short circuit data exchange according to IEC 60909. Default: False + ''' + + cgmesProfile = ConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'PowerTransformerEnd': [cgmesProfile.EQ.value, ], + 'beforeShCircuitHighestOperatingCurrent': [cgmesProfile.SC.value, ], + 'beforeShCircuitHighestOperatingVoltage': [cgmesProfile.SC.value, ], + 'beforeShortCircuitAnglePf': [cgmesProfile.SC.value, ], + 'highSideMinOperatingU': [cgmesProfile.SC.value, ], + 'isPartOfGeneratorUnit': [cgmesProfile.SC.value, ], + 'operationalValuesConsidered': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ConductingEquipment: \n' + ConductingEquipment.__doc__ + + def __init__(self, PowerTransformerEnd = "list", beforeShCircuitHighestOperatingCurrent = 0.0, beforeShCircuitHighestOperatingVoltage = 0.0, beforeShortCircuitAnglePf = 0.0, highSideMinOperatingU = 0.0, isPartOfGeneratorUnit = False, operationalValuesConsidered = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.PowerTransformerEnd = PowerTransformerEnd + self.beforeShCircuitHighestOperatingCurrent = beforeShCircuitHighestOperatingCurrent + self.beforeShCircuitHighestOperatingVoltage = beforeShCircuitHighestOperatingVoltage + self.beforeShortCircuitAnglePf = beforeShortCircuitAnglePf + self.highSideMinOperatingU = highSideMinOperatingU + self.isPartOfGeneratorUnit = isPartOfGeneratorUnit + self.operationalValuesConsidered = operationalValuesConsidered + + def __str__(self): + str = 'class=PowerTransformer\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PowerTransformerEnd.py b/cimpy/cgmes_v3_0_0/PowerTransformerEnd.py new file mode 100644 index 00000000..52cdb73f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PowerTransformerEnd.py @@ -0,0 +1,67 @@ +from .TransformerEnd import TransformerEnd + + +class PowerTransformerEnd(TransformerEnd): + ''' + A PowerTransformerEnd is associated with each Terminal of a PowerTransformer. The impedance values r, r0, x, and x0 of a PowerTransformerEnd represents a star equivalent as follows. 1) for a two Terminal PowerTransformer the high voltage (TransformerEnd.endNumber=1) PowerTransformerEnd has non zero values on r, r0, x, and x0 while the low voltage (TransformerEnd.endNumber=2) PowerTransformerEnd has zero values for r, r0, x, and x0. Parameters are always provided, even if the PowerTransformerEnds have the same rated voltage. In this case, the parameters are provided at the PowerTransformerEnd which has TransformerEnd.endNumber equal to 1. 2) for a three Terminal PowerTransformer the three PowerTransformerEnds represent a star equivalent with each leg in the star represented by r, r0, x, and x0 values. 3) For a three Terminal transformer each PowerTransformerEnd shall have g, g0, b and b0 values corresponding to the no load losses distributed on the three PowerTransformerEnds. The total no load loss shunt impedances may also be placed at one of the PowerTransformerEnds, preferably the end numbered 1, having the shunt values on end 1. This is the preferred way. 4) for a PowerTransformer with more than three Terminals the PowerTransformerEnd impedance values cannot be used. Instead use the TransformerMeshImpedance or split the transformer into multiple PowerTransformers. Each PowerTransformerEnd must be contained by a PowerTransformer. Because a PowerTransformerEnd (or any other object) can not be contained by more than one parent, a PowerTransformerEnd can not have an association to an EquipmentContainer (Substation, VoltageLevel, etc). + + :PowerTransformer: The power transformer of this power transformer end. Default: None + :b: Magnetizing branch susceptance (B mag). The value can be positive or negative. Default: 0.0 + :connectionKind: Kind of connection. Default: None + :ratedS: Normal apparent power rating. The attribute shall be a positive value. For a two-winding transformer the values for the high and low voltage sides shall be identical. Default: 0.0 + :g: Magnetizing branch conductance. Default: 0.0 + :ratedU: Rated voltage: phase-phase for three-phase windings, and either phase-phase or phase-neutral for single-phase windings. A high voltage side, as given by TransformerEnd.endNumber, shall have a ratedU that is greater than or equal to ratedU for the lower voltage sides. The attribute shall be a positive value. Default: 0.0 + :r: Resistance (star-model) of the transformer end. The attribute shall be equal to or greater than zero for non-equivalent transformers. Default: 0.0 + :x: Positive sequence series reactance (star-model) of the transformer end. Default: 0.0 + :b0: Zero sequence magnetizing branch susceptance. Default: 0.0 + :phaseAngleClock: Terminal voltage phase angle displacement where 360 degrees are represented with clock hours. The valid values are 0 to 11. For example, for the secondary side end of a transformer with vector group code of `Dyn11`, specify the connection kind as wye with neutral and specify the phase angle of the clock as 11. The clock value of the transformer end number specified as 1, is assumed to be zero. Note the transformer end number is not assumed to be the same as the terminal sequence number. Default: 0 + :g0: Zero sequence magnetizing branch conductance (star-model). Default: 0.0 + :r0: Zero sequence series resistance (star-model) of the transformer end. Default: 0.0 + :x0: Zero sequence series reactance of the transformer end. Default: 0.0 + ''' + + cgmesProfile = TransformerEnd.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'PowerTransformer': [cgmesProfile.EQ.value, ], + 'b': [cgmesProfile.EQ.value, ], + 'connectionKind': [cgmesProfile.EQ.value, ], + 'ratedS': [cgmesProfile.EQ.value, ], + 'g': [cgmesProfile.EQ.value, ], + 'ratedU': [cgmesProfile.EQ.value, ], + 'r': [cgmesProfile.EQ.value, ], + 'x': [cgmesProfile.EQ.value, ], + 'b0': [cgmesProfile.SC.value, ], + 'phaseAngleClock': [cgmesProfile.SC.value, ], + 'g0': [cgmesProfile.SC.value, ], + 'r0': [cgmesProfile.SC.value, ], + 'x0': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TransformerEnd: \n' + TransformerEnd.__doc__ + + def __init__(self, PowerTransformer = None, b = 0.0, connectionKind = None, ratedS = 0.0, g = 0.0, ratedU = 0.0, r = 0.0, x = 0.0, b0 = 0.0, phaseAngleClock = 0, g0 = 0.0, r0 = 0.0, x0 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.PowerTransformer = PowerTransformer + self.b = b + self.connectionKind = connectionKind + self.ratedS = ratedS + self.g = g + self.ratedU = ratedU + self.r = r + self.x = x + self.b0 = b0 + self.phaseAngleClock = phaseAngleClock + self.g0 = g0 + self.r0 = r0 + self.x0 = x0 + + def __str__(self): + str = 'class=PowerTransformerEnd\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ProprietaryParameterDynamics.py b/cimpy/cgmes_v3_0_0/ProprietaryParameterDynamics.py new file mode 100644 index 00000000..bf18208b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ProprietaryParameterDynamics.py @@ -0,0 +1,102 @@ +from .Base import Base + + +class ProprietaryParameterDynamics(Base): + ''' + Supports definition of one or more parameters of several different datatypes for use by proprietary user-defined models. This class does not inherit from IdentifiedObject since it is not intended that a single instance of it be referenced by more than one proprietary user-defined model instance. + + :CSCUserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :SVCUserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :VSCUserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :WindPlantUserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :WindType1or2UserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :WindType3or4UserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :SynchronousMachineUserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :AsynchronousMachineUserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :TurbineGovernorUserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :TurbineLoadControllerUserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :MechanicalLoadUserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :ExcitationSystemUserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :OverexcitationLimiterUserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :UnderexcitationLimiterUserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :PowerSystemStabilizerUserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :DiscontinuousExcitationControlUserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :PFVArControllerType1UserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :VoltageAdjusterUserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :PFVArControllerType2UserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :VoltageCompensatorUserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :LoadUserDefined: Proprietary user-defined model with which this parameter is associated. Default: None + :parameterNumber: Sequence number of the parameter among the set of parameters associated with the related proprietary user-defined model. Default: 0 + :booleanParameterValue: Boolean parameter value. If this attribute is populated, integerParameterValue and floatParameterValue will not be. Default: False + :integerParameterValue: Integer parameter value. If this attribute is populated, booleanParameterValue and floatParameterValue will not be. Default: 0 + :floatParameterValue: Floating point parameter value. If this attribute is populated, booleanParameterValue and integerParameterValue will not be. Default: 0.0 + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'CSCUserDefined': [cgmesProfile.DY.value, ], + 'SVCUserDefined': [cgmesProfile.DY.value, ], + 'VSCUserDefined': [cgmesProfile.DY.value, ], + 'WindPlantUserDefined': [cgmesProfile.DY.value, ], + 'WindType1or2UserDefined': [cgmesProfile.DY.value, ], + 'WindType3or4UserDefined': [cgmesProfile.DY.value, ], + 'SynchronousMachineUserDefined': [cgmesProfile.DY.value, ], + 'AsynchronousMachineUserDefined': [cgmesProfile.DY.value, ], + 'TurbineGovernorUserDefined': [cgmesProfile.DY.value, ], + 'TurbineLoadControllerUserDefined': [cgmesProfile.DY.value, ], + 'MechanicalLoadUserDefined': [cgmesProfile.DY.value, ], + 'ExcitationSystemUserDefined': [cgmesProfile.DY.value, ], + 'OverexcitationLimiterUserDefined': [cgmesProfile.DY.value, ], + 'UnderexcitationLimiterUserDefined': [cgmesProfile.DY.value, ], + 'PowerSystemStabilizerUserDefined': [cgmesProfile.DY.value, ], + 'DiscontinuousExcitationControlUserDefined': [cgmesProfile.DY.value, ], + 'PFVArControllerType1UserDefined': [cgmesProfile.DY.value, ], + 'VoltageAdjusterUserDefined': [cgmesProfile.DY.value, ], + 'PFVArControllerType2UserDefined': [cgmesProfile.DY.value, ], + 'VoltageCompensatorUserDefined': [cgmesProfile.DY.value, ], + 'LoadUserDefined': [cgmesProfile.DY.value, ], + 'parameterNumber': [cgmesProfile.DY.value, ], + 'booleanParameterValue': [cgmesProfile.DY.value, ], + 'integerParameterValue': [cgmesProfile.DY.value, ], + 'floatParameterValue': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, CSCUserDefined = None, SVCUserDefined = None, VSCUserDefined = None, WindPlantUserDefined = None, WindType1or2UserDefined = None, WindType3or4UserDefined = None, SynchronousMachineUserDefined = None, AsynchronousMachineUserDefined = None, TurbineGovernorUserDefined = None, TurbineLoadControllerUserDefined = None, MechanicalLoadUserDefined = None, ExcitationSystemUserDefined = None, OverexcitationLimiterUserDefined = None, UnderexcitationLimiterUserDefined = None, PowerSystemStabilizerUserDefined = None, DiscontinuousExcitationControlUserDefined = None, PFVArControllerType1UserDefined = None, VoltageAdjusterUserDefined = None, PFVArControllerType2UserDefined = None, VoltageCompensatorUserDefined = None, LoadUserDefined = None, parameterNumber = 0, booleanParameterValue = False, integerParameterValue = 0, floatParameterValue = 0.0, ): + + self.CSCUserDefined = CSCUserDefined + self.SVCUserDefined = SVCUserDefined + self.VSCUserDefined = VSCUserDefined + self.WindPlantUserDefined = WindPlantUserDefined + self.WindType1or2UserDefined = WindType1or2UserDefined + self.WindType3or4UserDefined = WindType3or4UserDefined + self.SynchronousMachineUserDefined = SynchronousMachineUserDefined + self.AsynchronousMachineUserDefined = AsynchronousMachineUserDefined + self.TurbineGovernorUserDefined = TurbineGovernorUserDefined + self.TurbineLoadControllerUserDefined = TurbineLoadControllerUserDefined + self.MechanicalLoadUserDefined = MechanicalLoadUserDefined + self.ExcitationSystemUserDefined = ExcitationSystemUserDefined + self.OverexcitationLimiterUserDefined = OverexcitationLimiterUserDefined + self.UnderexcitationLimiterUserDefined = UnderexcitationLimiterUserDefined + self.PowerSystemStabilizerUserDefined = PowerSystemStabilizerUserDefined + self.DiscontinuousExcitationControlUserDefined = DiscontinuousExcitationControlUserDefined + self.PFVArControllerType1UserDefined = PFVArControllerType1UserDefined + self.VoltageAdjusterUserDefined = VoltageAdjusterUserDefined + self.PFVArControllerType2UserDefined = PFVArControllerType2UserDefined + self.VoltageCompensatorUserDefined = VoltageCompensatorUserDefined + self.LoadUserDefined = LoadUserDefined + self.parameterNumber = parameterNumber + self.booleanParameterValue = booleanParameterValue + self.integerParameterValue = integerParameterValue + self.floatParameterValue = floatParameterValue + + def __str__(self): + str = 'class=ProprietaryParameterDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ProtectedSwitch.py b/cimpy/cgmes_v3_0_0/ProtectedSwitch.py new file mode 100644 index 00000000..754f4a80 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ProtectedSwitch.py @@ -0,0 +1,29 @@ +from .Switch import Switch + + +class ProtectedSwitch(Switch): + ''' + A ProtectedSwitch is a switching device that can be operated by ProtectionEquipment. + + ''' + + cgmesProfile = Switch.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Switch: \n' + Switch.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=ProtectedSwitch\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Pss1.py b/cimpy/cgmes_v3_0_0/Pss1.py new file mode 100644 index 00000000..52698289 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Pss1.py @@ -0,0 +1,73 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class Pss1(PowerSystemStabilizerDynamics): + ''' + Italian PSS with three inputs (speed, frequency, power). + + :komega: Shaft speed power input gain (Komega). Typical value = 0. Default: 0.0 + :kf: Frequency power input gain (KF). Typical value = 5. Default: 0.0 + :kpe: Electric power input gain (KPE). Typical value = 0,3. Default: 0.0 + :pmin: Minimum power PSS enabling (Pmin). Typical value = 0,25. Default: 0.0 + :ks: PSS gain (Ks). Typical value = 1. Default: 0.0 + :vsmn: Stabilizer output maximum limit (VSMN). Typical value = -0,06. Default: 0.0 + :vsmx: Stabilizer output minimum limit (VSMX). Typical value = 0,06. Default: 0.0 + :tpe: Electric power filter time constant (TPE) (>= 0). Typical value = 0,05. Default: 0 + :t5: Washout (T5) (>= 0). Typical value = 3,5. Default: 0 + :t6: Filter time constant (T6) (>= 0). Typical value = 0. Default: 0 + :t7: Lead/lag time constant (T7) (>= 0). If = 0, both blocks are bypassed. Typical value = 0. Default: 0 + :t8: Lead/lag time constant (T8) (>= 0). Typical value = 0. Default: 0 + :t9: Lead/lag time constant (T9) (>= 0). If = 0, both blocks are bypassed. Typical value = 0. Default: 0 + :t10: Lead/lag time constant (T10) (>= 0). Typical value = 0. Default: 0 + :vadat: Signal selector (VADAT). true = closed (generator power is greater than Pmin) false = open (Pe is smaller than Pmin). Typical value = true. Default: False + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'komega': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'kpe': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + 'ks': [cgmesProfile.DY.value, ], + 'vsmn': [cgmesProfile.DY.value, ], + 'vsmx': [cgmesProfile.DY.value, ], + 'tpe': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 't6': [cgmesProfile.DY.value, ], + 't7': [cgmesProfile.DY.value, ], + 't8': [cgmesProfile.DY.value, ], + 't9': [cgmesProfile.DY.value, ], + 't10': [cgmesProfile.DY.value, ], + 'vadat': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, komega = 0.0, kf = 0.0, kpe = 0.0, pmin = 0.0, ks = 0.0, vsmn = 0.0, vsmx = 0.0, tpe = 0, t5 = 0, t6 = 0, t7 = 0, t8 = 0, t9 = 0, t10 = 0, vadat = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.komega = komega + self.kf = kf + self.kpe = kpe + self.pmin = pmin + self.ks = ks + self.vsmn = vsmn + self.vsmx = vsmx + self.tpe = tpe + self.t5 = t5 + self.t6 = t6 + self.t7 = t7 + self.t8 = t8 + self.t9 = t9 + self.t10 = t10 + self.vadat = vadat + + def __str__(self): + str = 'class=Pss1\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Pss1A.py b/cimpy/cgmes_v3_0_0/Pss1A.py new file mode 100644 index 00000000..4acd00f6 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Pss1A.py @@ -0,0 +1,94 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class Pss1A(PowerSystemStabilizerDynamics): + ''' + Single input power system stabilizer. It is a modified version in order to allow representation of various vendors' implementations on PSS type 1A. + + :inputSignalType: Type of input signal (rotorAngularFrequencyDeviation, busFrequencyDeviation, generatorElectricalPower, generatorAcceleratingPower, busVoltage, or busVoltageDerivative). Default: None + :a1: Notch filter parameter (A1). Default: 0.0 + :a2: Notch filter parameter (A2). Default: 0.0 + :t1: Lead/lag time constant (T1) (>= 0). Default: 0 + :t2: Lead/lag time constant (T2) (>= 0). Default: 0 + :t3: Lead/lag time constant (T3) (>= 0). Default: 0 + :t4: Lead/lag time constant (T4) (>= 0). Default: 0 + :t5: Washout time constant (T5) (>= 0). Default: 0 + :t6: Transducer time constant (T6) (>= 0). Default: 0 + :ks: Stabilizer gain (Ks). Default: 0.0 + :vrmax: Maximum stabilizer output (Vrmax) (> Pss1A.vrmin). Default: 0.0 + :vrmin: Minimum stabilizer output (Vrmin) (< Pss1A.vrmax). Default: 0.0 + :vcu: Stabilizer input cutoff threshold (Vcu). Default: 0.0 + :vcl: Stabilizer input cutoff threshold (Vcl). Default: 0.0 + :a3: Notch filter parameter (A3). Default: 0.0 + :a4: Notch filter parameter (A4). Default: 0.0 + :a5: Notch filter parameter (A5). Default: 0.0 + :a6: Notch filter parameter (A6). Default: 0.0 + :a7: Notch filter parameter (A7). Default: 0.0 + :a8: Notch filter parameter (A8). Default: 0.0 + :kd: Selector (Kd). true = e-sTdelay used false = e-sTdelay not used. Default: False + :tdelay: Time constant (Tdelay) (>= 0). Default: 0 + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'inputSignalType': [cgmesProfile.DY.value, ], + 'a1': [cgmesProfile.DY.value, ], + 'a2': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 't6': [cgmesProfile.DY.value, ], + 'ks': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + 'vcu': [cgmesProfile.DY.value, ], + 'vcl': [cgmesProfile.DY.value, ], + 'a3': [cgmesProfile.DY.value, ], + 'a4': [cgmesProfile.DY.value, ], + 'a5': [cgmesProfile.DY.value, ], + 'a6': [cgmesProfile.DY.value, ], + 'a7': [cgmesProfile.DY.value, ], + 'a8': [cgmesProfile.DY.value, ], + 'kd': [cgmesProfile.DY.value, ], + 'tdelay': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, inputSignalType = None, a1 = 0.0, a2 = 0.0, t1 = 0, t2 = 0, t3 = 0, t4 = 0, t5 = 0, t6 = 0, ks = 0.0, vrmax = 0.0, vrmin = 0.0, vcu = 0.0, vcl = 0.0, a3 = 0.0, a4 = 0.0, a5 = 0.0, a6 = 0.0, a7 = 0.0, a8 = 0.0, kd = False, tdelay = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.inputSignalType = inputSignalType + self.a1 = a1 + self.a2 = a2 + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.t4 = t4 + self.t5 = t5 + self.t6 = t6 + self.ks = ks + self.vrmax = vrmax + self.vrmin = vrmin + self.vcu = vcu + self.vcl = vcl + self.a3 = a3 + self.a4 = a4 + self.a5 = a5 + self.a6 = a6 + self.a7 = a7 + self.a8 = a8 + self.kd = kd + self.tdelay = tdelay + + def __str__(self): + str = 'class=Pss1A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Pss2B.py b/cimpy/cgmes_v3_0_0/Pss2B.py new file mode 100644 index 00000000..34459844 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Pss2B.py @@ -0,0 +1,115 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class Pss2B(PowerSystemStabilizerDynamics): + ''' + Modified IEEE PSS2B. Extra lead/lag (or rate) block added at end (up to 4 lead/lags total). + + :vsi1max: Input signal #1 maximum limit (Vsi1max) (> Pss2B.vsi1min). Typical value = 2. Default: 0.0 + :vsi1min: Input signal #1 minimum limit (Vsi1min) (< Pss2B.vsi1max). Typical value = -2. Default: 0.0 + :tw1: First washout on signal #1 (Tw1) (>= 0). Typical value = 2. Default: 0 + :tw2: Second washout on signal #1 (Tw2) (>= 0). Typical value = 2. Default: 0 + :vsi2max: Input signal #2 maximum limit (Vsi2max) (> Pss2B.vsi2min). Typical value = 2. Default: 0.0 + :vsi2min: Input signal #2 minimum limit (Vsi2min) (< Pss2B.vsi2max). Typical value = -2. Default: 0.0 + :tw3: First washout on signal #2 (Tw3) (>= 0). Typical value = 2. Default: 0 + :tw4: Second washout on signal #2 (Tw4) (>= 0). Typical value = 0. Default: 0 + :t1: Lead/lag time constant (T1) (>= 0). Typical value = 0,12. Default: 0 + :t2: Lead/lag time constant (T2) (>= 0). Typical value = 0,02. Default: 0 + :t3: Lead/lag time constant (T3) (>= 0). Typical value = 0,3. Default: 0 + :t4: Lead/lag time constant (T4) (>= 0). Typical value = 0,02. Default: 0 + :t6: Time constant on signal #1 (T6) (>= 0). Typical value = 0. Default: 0 + :t7: Time constant on signal #2 (T7) (>= 0). Typical value = 2. Default: 0 + :t8: Lead of ramp tracking filter (T8) (>= 0). Typical value = 0,2. Default: 0 + :t9: Lag of ramp tracking filter (T9) (>= 0). Typical value = 0,1. Default: 0 + :t10: Lead/lag time constant (T10) (>= 0). Typical value = 0. Default: 0 + :t11: Lead/lag time constant (T11) (>= 0). Typical value = 0. Default: 0 + :ks1: Stabilizer gain (Ks1). Typical value = 12. Default: 0.0 + :ks2: Gain on signal #2 (Ks2). Typical value = 0,2. Default: 0.0 + :ks3: Gain on signal #2 input before ramp-tracking filter (Ks3). Typical value = 1. Default: 0.0 + :ks4: Gain on signal #2 input after ramp-tracking filter (Ks4). Typical value = 1. Default: 0.0 + :n: Order of ramp tracking filter (n). Typical value = 1. Default: 0 + :m: Denominator order of ramp tracking filter (m). Typical value = 5. Default: 0 + :vstmax: Stabilizer output maximum limit (Vstmax) (> Pss2B.vstmin). Typical value = 0,1. Default: 0.0 + :vstmin: Stabilizer output minimum limit (Vstmin) (< Pss2B.vstmax). Typical value = -0,1. Default: 0.0 + :a: Numerator constant (a). Typical value = 1. Default: 0.0 + :ta: Lead constant (Ta) (>= 0). Typical value = 0. Default: 0 + :tb: Lag time constant (Tb) (>= 0). Typical value = 0. Default: 0 + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'vsi1max': [cgmesProfile.DY.value, ], + 'vsi1min': [cgmesProfile.DY.value, ], + 'tw1': [cgmesProfile.DY.value, ], + 'tw2': [cgmesProfile.DY.value, ], + 'vsi2max': [cgmesProfile.DY.value, ], + 'vsi2min': [cgmesProfile.DY.value, ], + 'tw3': [cgmesProfile.DY.value, ], + 'tw4': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 't6': [cgmesProfile.DY.value, ], + 't7': [cgmesProfile.DY.value, ], + 't8': [cgmesProfile.DY.value, ], + 't9': [cgmesProfile.DY.value, ], + 't10': [cgmesProfile.DY.value, ], + 't11': [cgmesProfile.DY.value, ], + 'ks1': [cgmesProfile.DY.value, ], + 'ks2': [cgmesProfile.DY.value, ], + 'ks3': [cgmesProfile.DY.value, ], + 'ks4': [cgmesProfile.DY.value, ], + 'n': [cgmesProfile.DY.value, ], + 'm': [cgmesProfile.DY.value, ], + 'vstmax': [cgmesProfile.DY.value, ], + 'vstmin': [cgmesProfile.DY.value, ], + 'a': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, vsi1max = 0.0, vsi1min = 0.0, tw1 = 0, tw2 = 0, vsi2max = 0.0, vsi2min = 0.0, tw3 = 0, tw4 = 0, t1 = 0, t2 = 0, t3 = 0, t4 = 0, t6 = 0, t7 = 0, t8 = 0, t9 = 0, t10 = 0, t11 = 0, ks1 = 0.0, ks2 = 0.0, ks3 = 0.0, ks4 = 0.0, n = 0, m = 0, vstmax = 0.0, vstmin = 0.0, a = 0.0, ta = 0, tb = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.vsi1max = vsi1max + self.vsi1min = vsi1min + self.tw1 = tw1 + self.tw2 = tw2 + self.vsi2max = vsi2max + self.vsi2min = vsi2min + self.tw3 = tw3 + self.tw4 = tw4 + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.t4 = t4 + self.t6 = t6 + self.t7 = t7 + self.t8 = t8 + self.t9 = t9 + self.t10 = t10 + self.t11 = t11 + self.ks1 = ks1 + self.ks2 = ks2 + self.ks3 = ks3 + self.ks4 = ks4 + self.n = n + self.m = m + self.vstmax = vstmax + self.vstmin = vstmin + self.a = a + self.ta = ta + self.tb = tb + + def __str__(self): + str = 'class=Pss2B\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Pss2ST.py b/cimpy/cgmes_v3_0_0/Pss2ST.py new file mode 100644 index 00000000..b401dd39 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Pss2ST.py @@ -0,0 +1,82 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class Pss2ST(PowerSystemStabilizerDynamics): + ''' + PTI microprocessor-based stabilizer type 1. + + :inputSignal1Type: Type of input signal #1 (rotorAngularFrequencyDeviation, busFrequencyDeviation, generatorElectricalPower, generatorAcceleratingPower, busVoltage, or busVoltageDerivative - shall be different than Pss2ST.inputSignal2Type). Typical value = rotorAngularFrequencyDeviation. Default: None + :inputSignal2Type: Type of input signal #2 (rotorAngularFrequencyDeviation, busFrequencyDeviation, generatorElectricalPower, generatorAcceleratingPower, busVoltage, or busVoltageDerivative - shall be different than Pss2ST.inputSignal1Type). Typical value = busVoltageDerivative. Default: None + :k1: Gain (K1). Default: 0.0 + :k2: Gain (K2). Default: 0.0 + :t1: Time constant (T1) (>= 0). Default: 0 + :t2: Time constant (T2) (>= 0). Default: 0 + :t3: Time constant (T3) (>= 0). Default: 0 + :t4: Time constant (T4) (>= 0). Default: 0 + :t5: Time constant (T5) (>= 0). Default: 0 + :t6: Time constant (T6) (>= 0). Default: 0 + :t7: Time constant (T7) (>= 0). Default: 0 + :t8: Time constant (T8) (>= 0). Default: 0 + :t9: Time constant (T9) (>= 0). Default: 0 + :t10: Time constant (T10) (>= 0). Default: 0 + :lsmax: Limiter (LSMAX) (> Pss2ST.lsmin). Default: 0.0 + :lsmin: Limiter (LSMIN) (< Pss2ST.lsmax). Default: 0.0 + :vcu: Cutoff limiter (VCU). Default: 0.0 + :vcl: Cutoff limiter (VCL). Default: 0.0 + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'inputSignal1Type': [cgmesProfile.DY.value, ], + 'inputSignal2Type': [cgmesProfile.DY.value, ], + 'k1': [cgmesProfile.DY.value, ], + 'k2': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 't6': [cgmesProfile.DY.value, ], + 't7': [cgmesProfile.DY.value, ], + 't8': [cgmesProfile.DY.value, ], + 't9': [cgmesProfile.DY.value, ], + 't10': [cgmesProfile.DY.value, ], + 'lsmax': [cgmesProfile.DY.value, ], + 'lsmin': [cgmesProfile.DY.value, ], + 'vcu': [cgmesProfile.DY.value, ], + 'vcl': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, inputSignal1Type = None, inputSignal2Type = None, k1 = 0.0, k2 = 0.0, t1 = 0, t2 = 0, t3 = 0, t4 = 0, t5 = 0, t6 = 0, t7 = 0, t8 = 0, t9 = 0, t10 = 0, lsmax = 0.0, lsmin = 0.0, vcu = 0.0, vcl = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.inputSignal1Type = inputSignal1Type + self.inputSignal2Type = inputSignal2Type + self.k1 = k1 + self.k2 = k2 + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.t4 = t4 + self.t5 = t5 + self.t6 = t6 + self.t7 = t7 + self.t8 = t8 + self.t9 = t9 + self.t10 = t10 + self.lsmax = lsmax + self.lsmin = lsmin + self.vcu = vcu + self.vcl = vcl + + def __str__(self): + str = 'class=Pss2ST\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Pss5.py b/cimpy/cgmes_v3_0_0/Pss5.py new file mode 100644 index 00000000..a03ef7b4 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Pss5.py @@ -0,0 +1,79 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class Pss5(PowerSystemStabilizerDynamics): + ''' + Detailed Italian PSS. + + :kpe: Electric power input gain (KPE). Typical value = 0,3. Default: 0.0 + :kf: Frequency/shaft speed input gain (KF). Typical value = 5. Default: 0.0 + :isfreq: Selector for frequency/shaft speed input (isFreq). true = speed (same meaning as InputSignaKind.rotorSpeed) false = frequency (same meaning as InputSignalKind.busFrequency). Typical value = true (same meaning as InputSignalKind.rotorSpeed). Default: False + :kpss: PSS gain (KPSS). Typical value = 1. Default: 0.0 + :ctw2: Selector for second washout enabling (CTW2). true = second washout filter is bypassed false = second washout filter in use. Typical value = true. Default: False + :tw1: First washout (TW1) (>= 0). Typical value = 3,5. Default: 0 + :tw2: Second washout (TW2) (>= 0). Typical value = 0. Default: 0 + :tl1: Lead/lag time constant (TL1) (>= 0). Typical value = 0. Default: 0 + :tl2: Lead/lag time constant (TL2) (>= 0). If = 0, both blocks are bypassed. Typical value = 0. Default: 0 + :tl3: Lead/lag time constant (TL3) (>= 0). Typical value = 0. Default: 0 + :tl4: Lead/lag time constant (TL4) (>= 0). If = 0, both blocks are bypassed. Typical value = 0. Default: 0 + :vsmn: Stabilizer output maximum limit (VSMN). Typical value = -0,1. Default: 0.0 + :vsmx: Stabilizer output minimum limit (VSMX). Typical value = 0,1. Default: 0.0 + :tpe: Electric power filter time constant (TPE) (>= 0). Typical value = 0,05. Default: 0 + :pmin: Minimum power PSS enabling (Pmin). Typical value = 0,25. Default: 0.0 + :deadband: Stabilizer output deadband (DEADBAND). Typical value = 0. Default: 0.0 + :vadat: Signal selector (VadAtt). true = closed (generator power is greater than Pmin) false = open (Pe is smaller than Pmin). Typical value = true. Default: False + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'kpe': [cgmesProfile.DY.value, ], + 'kf': [cgmesProfile.DY.value, ], + 'isfreq': [cgmesProfile.DY.value, ], + 'kpss': [cgmesProfile.DY.value, ], + 'ctw2': [cgmesProfile.DY.value, ], + 'tw1': [cgmesProfile.DY.value, ], + 'tw2': [cgmesProfile.DY.value, ], + 'tl1': [cgmesProfile.DY.value, ], + 'tl2': [cgmesProfile.DY.value, ], + 'tl3': [cgmesProfile.DY.value, ], + 'tl4': [cgmesProfile.DY.value, ], + 'vsmn': [cgmesProfile.DY.value, ], + 'vsmx': [cgmesProfile.DY.value, ], + 'tpe': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + 'deadband': [cgmesProfile.DY.value, ], + 'vadat': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, kpe = 0.0, kf = 0.0, isfreq = False, kpss = 0.0, ctw2 = False, tw1 = 0, tw2 = 0, tl1 = 0, tl2 = 0, tl3 = 0, tl4 = 0, vsmn = 0.0, vsmx = 0.0, tpe = 0, pmin = 0.0, deadband = 0.0, vadat = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.kpe = kpe + self.kf = kf + self.isfreq = isfreq + self.kpss = kpss + self.ctw2 = ctw2 + self.tw1 = tw1 + self.tw2 = tw2 + self.tl1 = tl1 + self.tl2 = tl2 + self.tl3 = tl3 + self.tl4 = tl4 + self.vsmn = vsmn + self.vsmx = vsmx + self.tpe = tpe + self.pmin = pmin + self.deadband = deadband + self.vadat = vadat + + def __str__(self): + str = 'class=Pss5\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PssELIN2.py b/cimpy/cgmes_v3_0_0/PssELIN2.py new file mode 100644 index 00000000..8d64c77f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PssELIN2.py @@ -0,0 +1,61 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class PssELIN2(PowerSystemStabilizerDynamics): + ''' + Power system stabilizer typically associated with ExcELIN2 (though PssIEEE2B or Pss2B can also be used). + + :ts1: Time constant (Ts1) (>= 0). Typical value = 0. Default: 0 + :ts2: Time constant (Ts2) (>= 0). Typical value = 1. Default: 0 + :ts3: Time constant (Ts3) (>= 0). Typical value = 1. Default: 0 + :ts4: Time constant (Ts4) (>= 0). Typical value = 0,1. Default: 0 + :ts5: Time constant (Ts5) (>= 0). Typical value = 0. Default: 0 + :ts6: Time constant (Ts6) (>= 0). Typical value = 1. Default: 0 + :ks1: Gain (Ks1). Typical value = 1. Default: 0.0 + :ks2: Gain (Ks2). Typical value = 0,1. Default: 0.0 + :ppss: Coefficient (p_PSS) (>= 0 and <= 4). Typical value = 0,1. Default: 0.0 + :apss: Coefficient (a_PSS). Typical value = 0,1. Default: 0.0 + :psslim: PSS limiter (psslim). Typical value = 0,1. Default: 0.0 + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ts1': [cgmesProfile.DY.value, ], + 'ts2': [cgmesProfile.DY.value, ], + 'ts3': [cgmesProfile.DY.value, ], + 'ts4': [cgmesProfile.DY.value, ], + 'ts5': [cgmesProfile.DY.value, ], + 'ts6': [cgmesProfile.DY.value, ], + 'ks1': [cgmesProfile.DY.value, ], + 'ks2': [cgmesProfile.DY.value, ], + 'ppss': [cgmesProfile.DY.value, ], + 'apss': [cgmesProfile.DY.value, ], + 'psslim': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, ts1 = 0, ts2 = 0, ts3 = 0, ts4 = 0, ts5 = 0, ts6 = 0, ks1 = 0.0, ks2 = 0.0, ppss = 0.0, apss = 0.0, psslim = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ts1 = ts1 + self.ts2 = ts2 + self.ts3 = ts3 + self.ts4 = ts4 + self.ts5 = ts5 + self.ts6 = ts6 + self.ks1 = ks1 + self.ks2 = ks2 + self.ppss = ppss + self.apss = apss + self.psslim = psslim + + def __str__(self): + str = 'class=PssELIN2\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PssIEEE1A.py b/cimpy/cgmes_v3_0_0/PssIEEE1A.py new file mode 100644 index 00000000..ae887e07 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PssIEEE1A.py @@ -0,0 +1,64 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class PssIEEE1A(PowerSystemStabilizerDynamics): + ''' + IEEE 421.5-2005 type PSS1A power system stabilizer model. PSS1A is the generalized form of a PSS with a single input signal. Reference: IEEE 1A 421.5-2005, 8.1. + + :inputSignalType: Type of input signal (rotorAngularFrequencyDeviation, generatorElectricalPower, or busFrequencyDeviation). Typical value = rotorAngularFrequencyDeviation. Default: None + :a1: PSS signal conditioning frequency filter constant (A1). Typical value = 0,061. Default: 0.0 + :a2: PSS signal conditioning frequency filter constant (A2). Typical value = 0,0017. Default: 0.0 + :t1: Lead/lag time constant (T1) (>= 0). Typical value = 0,3. Default: 0 + :t2: Lead/lag time constant (T2) (>= 0). Typical value = 0,03. Default: 0 + :t3: Lead/lag time constant (T3) (>= 0). Typical value = 0,3. Default: 0 + :t4: Lead/lag time constant (T4) (>= 0). Typical value = 0,03. Default: 0 + :t5: Washout time constant (T5) (>= 0). Typical value = 10. Default: 0 + :t6: Transducer time constant (T6) (>= 0). Typical value = 0,01. Default: 0 + :ks: Stabilizer gain (Ks). Typical value = 5. Default: 0.0 + :vrmax: Maximum stabilizer output (Vrmax) (> PssIEEE1A.vrmin). Typical value = 0,05. Default: 0.0 + :vrmin: Minimum stabilizer output (Vrmin) (< PssIEEE1A.vrmax). Typical value = -0,05. Default: 0.0 + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'inputSignalType': [cgmesProfile.DY.value, ], + 'a1': [cgmesProfile.DY.value, ], + 'a2': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 't6': [cgmesProfile.DY.value, ], + 'ks': [cgmesProfile.DY.value, ], + 'vrmax': [cgmesProfile.DY.value, ], + 'vrmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, inputSignalType = None, a1 = 0.0, a2 = 0.0, t1 = 0, t2 = 0, t3 = 0, t4 = 0, t5 = 0, t6 = 0, ks = 0.0, vrmax = 0.0, vrmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.inputSignalType = inputSignalType + self.a1 = a1 + self.a2 = a2 + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.t4 = t4 + self.t5 = t5 + self.t6 = t6 + self.ks = ks + self.vrmax = vrmax + self.vrmin = vrmin + + def __str__(self): + str = 'class=PssIEEE1A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PssIEEE2B.py b/cimpy/cgmes_v3_0_0/PssIEEE2B.py new file mode 100644 index 00000000..fee21e0f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PssIEEE2B.py @@ -0,0 +1,109 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class PssIEEE2B(PowerSystemStabilizerDynamics): + ''' + IEEE 421.5-2005 type PSS2B power system stabilizer model. This stabilizer model is designed to represent a variety of dual-input stabilizers, which normally use combinations of power and speed or frequency to derive the stabilizing signal. Reference: IEEE 2B 421.5-2005, 8.2. + + :inputSignal1Type: Type of input signal #1 (rotorAngularFrequencyDeviation, busFrequencyDeviation). Typical value = rotorAngularFrequencyDeviation. Default: None + :inputSignal2Type: Type of input signal #2 (generatorElectricalPower). Typical value = generatorElectricalPower. Default: None + :vsi1max: Input signal #1 maximum limit (Vsi1max) (> PssIEEE2B.vsi1min). Typical value = 2. Default: 0.0 + :vsi1min: Input signal #1 minimum limit (Vsi1min) (< PssIEEE2B.vsi1max). Typical value = -2. Default: 0.0 + :tw1: First washout on signal #1 (Tw1) (>= 0). Typical value = 2. Default: 0 + :tw2: Second washout on signal #1 (Tw2) (>= 0). Typical value = 2. Default: 0 + :vsi2max: Input signal #2 maximum limit (Vsi2max) (> PssIEEE2B.vsi2min). Typical value = 2. Default: 0.0 + :vsi2min: Input signal #2 minimum limit (Vsi2min) (< PssIEEE2B.vsi2max). Typical value = -2. Default: 0.0 + :tw3: First washout on signal #2 (Tw3) (>= 0). Typical value = 2. Default: 0 + :tw4: Second washout on signal #2 (Tw4) (>= 0). Typical value = 0. Default: 0 + :t1: Lead/lag time constant (T1) (>= 0). Typical value = 0,12. Default: 0 + :t2: Lead/lag time constant (T2) (>= 0). Typical value = 0,02. Default: 0 + :t3: Lead/lag time constant (T3) (>= 0). Typical value = 0,3. Default: 0 + :t4: Lead/lag time constant (T4) (>= 0). Typical value = 0,02. Default: 0 + :t6: Time constant on signal #1 (T6) (>= 0). Typical value = 0. Default: 0 + :t7: Time constant on signal #2 (T7) (>= 0). Typical value = 2. Default: 0 + :t8: Lead of ramp tracking filter (T8) (>= 0). Typical value = 0,2. Default: 0 + :t9: Lag of ramp tracking filter (T9) (>= 0). Typical value = 0,1. Default: 0 + :t10: Lead/lag time constant (T10) (>= 0). Typical value = 0. Default: 0 + :t11: Lead/lag time constant (T11) (>= 0). Typical value = 0. Default: 0 + :ks1: Stabilizer gain (Ks1). Typical value = 12. Default: 0.0 + :ks2: Gain on signal #2 (Ks2). Typical value = 0,2. Default: 0.0 + :ks3: Gain on signal #2 input before ramp-tracking filter (Ks3). Typical value = 1. Default: 0.0 + :n: Order of ramp tracking filter (N). Typical value = 1. Default: 0 + :m: Denominator order of ramp tracking filter (M). Typical value = 5. Default: 0 + :vstmax: Stabilizer output maximum limit (Vstmax) (> PssIEEE2B.vstmin). Typical value = 0,1. Default: 0.0 + :vstmin: Stabilizer output minimum limit (Vstmin) (< PssIEEE2B.vstmax). Typical value = -0,1. Default: 0.0 + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'inputSignal1Type': [cgmesProfile.DY.value, ], + 'inputSignal2Type': [cgmesProfile.DY.value, ], + 'vsi1max': [cgmesProfile.DY.value, ], + 'vsi1min': [cgmesProfile.DY.value, ], + 'tw1': [cgmesProfile.DY.value, ], + 'tw2': [cgmesProfile.DY.value, ], + 'vsi2max': [cgmesProfile.DY.value, ], + 'vsi2min': [cgmesProfile.DY.value, ], + 'tw3': [cgmesProfile.DY.value, ], + 'tw4': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 't6': [cgmesProfile.DY.value, ], + 't7': [cgmesProfile.DY.value, ], + 't8': [cgmesProfile.DY.value, ], + 't9': [cgmesProfile.DY.value, ], + 't10': [cgmesProfile.DY.value, ], + 't11': [cgmesProfile.DY.value, ], + 'ks1': [cgmesProfile.DY.value, ], + 'ks2': [cgmesProfile.DY.value, ], + 'ks3': [cgmesProfile.DY.value, ], + 'n': [cgmesProfile.DY.value, ], + 'm': [cgmesProfile.DY.value, ], + 'vstmax': [cgmesProfile.DY.value, ], + 'vstmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, inputSignal1Type = None, inputSignal2Type = None, vsi1max = 0.0, vsi1min = 0.0, tw1 = 0, tw2 = 0, vsi2max = 0.0, vsi2min = 0.0, tw3 = 0, tw4 = 0, t1 = 0, t2 = 0, t3 = 0, t4 = 0, t6 = 0, t7 = 0, t8 = 0, t9 = 0, t10 = 0, t11 = 0, ks1 = 0.0, ks2 = 0.0, ks3 = 0.0, n = 0, m = 0, vstmax = 0.0, vstmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.inputSignal1Type = inputSignal1Type + self.inputSignal2Type = inputSignal2Type + self.vsi1max = vsi1max + self.vsi1min = vsi1min + self.tw1 = tw1 + self.tw2 = tw2 + self.vsi2max = vsi2max + self.vsi2min = vsi2min + self.tw3 = tw3 + self.tw4 = tw4 + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.t4 = t4 + self.t6 = t6 + self.t7 = t7 + self.t8 = t8 + self.t9 = t9 + self.t10 = t10 + self.t11 = t11 + self.ks1 = ks1 + self.ks2 = ks2 + self.ks3 = ks3 + self.n = n + self.m = m + self.vstmax = vstmax + self.vstmin = vstmin + + def __str__(self): + str = 'class=PssIEEE2B\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PssIEEE3B.py b/cimpy/cgmes_v3_0_0/PssIEEE3B.py new file mode 100644 index 00000000..43866a80 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PssIEEE3B.py @@ -0,0 +1,79 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class PssIEEE3B(PowerSystemStabilizerDynamics): + ''' + IEEE 421.5-2005 type PSS3B power system stabilizer model. The PSS model PSS3B has dual inputs of electrical power and rotor angular frequency deviation. The signals are used to derive an equivalent mechanical power signal. This model has 2 input signals. They have the following fixed types (expressed in terms of InputSignalKind values): the first one is of rotorAngleFrequencyDeviation type and the second one is of generatorElectricalPower type. Reference: IEEE 3B 421.5-2005, 8.3. + + :t1: Transducer time constant (T1) (>= 0). Typical value = 0,012. Default: 0 + :t2: Transducer time constant (T2) (>= 0). Typical value = 0,012. Default: 0 + :tw1: Washout time constant (Tw1) (>= 0). Typical value = 0,3. Default: 0 + :tw2: Washout time constant (Tw2) (>= 0). Typical value = 0,3. Default: 0 + :tw3: Washout time constant (Tw3) (>= 0). Typical value = 0,6. Default: 0 + :ks1: Gain on signal # 1 (Ks1). Typical value = -0,602. Default: 0.0 + :ks2: Gain on signal # 2 (Ks2). Typical value = 30,12. Default: 0.0 + :a1: Notch filter parameter (A1). Typical value = 0,359. Default: 0.0 + :a2: Notch filter parameter (A2). Typical value = 0,586. Default: 0.0 + :a3: Notch filter parameter (A3). Typical value = 0,429. Default: 0.0 + :a4: Notch filter parameter (A4). Typical value = 0,564. Default: 0.0 + :a5: Notch filter parameter (A5). Typical value = 0,001. Default: 0.0 + :a6: Notch filter parameter (A6). Typical value = 0. Default: 0.0 + :a7: Notch filter parameter (A7). Typical value = 0,031. Default: 0.0 + :a8: Notch filter parameter (A8). Typical value = 0. Default: 0.0 + :vstmax: Stabilizer output maximum limit (Vstmax) (> PssIEEE3B.vstmin). Typical value = 0,1. Default: 0.0 + :vstmin: Stabilizer output minimum limit (Vstmin) (< PssIEEE3B.vstmax). Typical value = -0,1. Default: 0.0 + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 'tw1': [cgmesProfile.DY.value, ], + 'tw2': [cgmesProfile.DY.value, ], + 'tw3': [cgmesProfile.DY.value, ], + 'ks1': [cgmesProfile.DY.value, ], + 'ks2': [cgmesProfile.DY.value, ], + 'a1': [cgmesProfile.DY.value, ], + 'a2': [cgmesProfile.DY.value, ], + 'a3': [cgmesProfile.DY.value, ], + 'a4': [cgmesProfile.DY.value, ], + 'a5': [cgmesProfile.DY.value, ], + 'a6': [cgmesProfile.DY.value, ], + 'a7': [cgmesProfile.DY.value, ], + 'a8': [cgmesProfile.DY.value, ], + 'vstmax': [cgmesProfile.DY.value, ], + 'vstmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, t1 = 0, t2 = 0, tw1 = 0, tw2 = 0, tw3 = 0, ks1 = 0.0, ks2 = 0.0, a1 = 0.0, a2 = 0.0, a3 = 0.0, a4 = 0.0, a5 = 0.0, a6 = 0.0, a7 = 0.0, a8 = 0.0, vstmax = 0.0, vstmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.t1 = t1 + self.t2 = t2 + self.tw1 = tw1 + self.tw2 = tw2 + self.tw3 = tw3 + self.ks1 = ks1 + self.ks2 = ks2 + self.a1 = a1 + self.a2 = a2 + self.a3 = a3 + self.a4 = a4 + self.a5 = a5 + self.a6 = a6 + self.a7 = a7 + self.a8 = a8 + self.vstmax = vstmax + self.vstmin = vstmin + + def __str__(self): + str = 'class=PssIEEE3B\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PssIEEE4B.py b/cimpy/cgmes_v3_0_0/PssIEEE4B.py new file mode 100644 index 00000000..87ff27dd --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PssIEEE4B.py @@ -0,0 +1,229 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class PssIEEE4B(PowerSystemStabilizerDynamics): + ''' + IEEE 421.5-2005 type PSS4B power system stabilizer. The PSS4B model represents a structure based on multiple working frequency bands. Three separate bands, respectively dedicated to the low-, intermediate- and high-frequency modes of oscillations, are used in this delta omega (speed input) PSS. There is an error in the in IEEE 421.5-2005 PSS4B model: the Pe input should read -Pe. This implies that the input Pe needs to be multiplied by -1. Reference: IEEE 4B 421.5-2005, 8.4. Parameter details: This model has 2 input signals. They have the following fixed types (expressed in terms of InputSignalKind values): the first one is of rotorAngleFrequencyDeviation type and the second one is of generatorElectricalPower type. + + :bwh1: Notch filter 1 (high-frequency band): three dB bandwidth (Bwi). Default: 0.0 + :bwh2: Notch filter 2 (high-frequency band): three dB bandwidth (Bwi). Default: 0.0 + :bwl1: Notch filter 1 (low-frequency band): three dB bandwidth (Bwi). Default: 0.0 + :bwl2: Notch filter 2 (low-frequency band): three dB bandwidth (Bwi). Default: 0.0 + :kh: High band gain (KH). Typical value = 120. Default: 0.0 + :kh1: High band differential filter gain (KH1). Typical value = 66. Default: 0.0 + :kh11: High band first lead-lag blocks coefficient (KH11). Typical value = 1. Default: 0.0 + :kh17: High band first lead-lag blocks coefficient (KH17). Typical value = 1. Default: 0.0 + :kh2: High band differential filter gain (KH2). Typical value = 66. Default: 0.0 + :ki: Intermediate band gain (KI). Typical value = 30. Default: 0.0 + :ki1: Intermediate band differential filter gain (KI1). Typical value = 66. Default: 0.0 + :ki11: Intermediate band first lead-lag blocks coefficient (KI11). Typical value = 1. Default: 0.0 + :ki17: Intermediate band first lead-lag blocks coefficient (KI17). Typical value = 1. Default: 0.0 + :ki2: Intermediate band differential filter gain (KI2). Typical value = 66. Default: 0.0 + :kl: Low band gain (KL). Typical value = 7.5. Default: 0.0 + :kl1: Low band differential filter gain (KL1). Typical value = 66. Default: 0.0 + :kl11: Low band first lead-lag blocks coefficient (KL11). Typical value = 1. Default: 0.0 + :kl17: Low band first lead-lag blocks coefficient (KL17). Typical value = 1. Default: 0.0 + :kl2: Low band differential filter gain (KL2). Typical value = 66. Default: 0.0 + :omeganh1: Notch filter 1 (high-frequency band): filter frequency (omegani). Default: 0.0 + :omeganh2: Notch filter 2 (high-frequency band): filter frequency (omegani). Default: 0.0 + :omeganl1: Notch filter 1 (low-frequency band): filter frequency (omegani). Default: 0.0 + :omeganl2: Notch filter 2 (low-frequency band): filter frequency (omegani). Default: 0.0 + :th1: High band time constant (TH1) (>= 0). Typical value = 0,01513. Default: 0 + :th10: High band time constant (TH10) (>= 0). Typical value = 0. Default: 0 + :th11: High band time constant (TH11) (>= 0). Typical value = 0. Default: 0 + :th12: High band time constant (TH12) (>= 0). Typical value = 0. Default: 0 + :th2: High band time constant (TH2) (>= 0). Typical value = 0,01816. Default: 0 + :th3: High band time constant (TH3) (>= 0). Typical value = 0. Default: 0 + :th4: High band time constant (TH4) (>= 0). Typical value = 0. Default: 0 + :th5: High band time constant (TH5) (>= 0). Typical value = 0. Default: 0 + :th6: High band time constant (TH6) (>= 0). Typical value = 0. Default: 0 + :th7: High band time constant (TH7) (>= 0). Typical value = 0,01816. Default: 0 + :th8: High band time constant (TH8) (>= 0). Typical value = 0,02179. Default: 0 + :th9: High band time constant (TH9) (>= 0). Typical value = 0. Default: 0 + :ti1: Intermediate band time constant (TI1) (>= 0). Typical value = 0,173. Default: 0 + :ti10: Intermediate band time constant (TI10) (>= 0). Typical value = 0. Default: 0 + :ti11: Intermediate band time constant (TI11) (>= 0). Typical value = 0. Default: 0 + :ti12: Intermediate band time constant (TI12) (>= 0). Typical value = 0. Default: 0 + :ti2: Intermediate band time constant (TI2) (>= 0). Typical value = 0,2075. Default: 0 + :ti3: Intermediate band time constant (TI3) (>= 0). Typical value = 0. Default: 0 + :ti4: Intermediate band time constant (TI4) (>= 0). Typical value = 0. Default: 0 + :ti5: Intermediate band time constant (TI5) (>= 0). Typical value = 0. Default: 0 + :ti6: Intermediate band time constant (TI6) (>= 0). Typical value = 0. Default: 0 + :ti7: Intermediate band time constant (TI7) (>= 0). Typical value = 0,2075. Default: 0 + :ti8: Intermediate band time constant (TI8) (>= 0). Typical value = 0,2491. Default: 0 + :ti9: Intermediate band time constant (TI9) (>= 0). Typical value = 0. Default: 0 + :tl1: Low band time constant (TL1) (>= 0). Typical value = 1,73. Default: 0 + :tl10: Low band time constant (TL10) (>= 0). Typical value = 0. Default: 0 + :tl11: Low band time constant (TL11) (>= 0). Typical value = 0. Default: 0 + :tl12: Low band time constant (TL12) (>= 0). Typical value = 0. Default: 0 + :tl2: Low band time constant (TL2) (>= 0). Typical value = 2,075. Default: 0 + :tl3: Low band time constant (TL3) (>= 0). Typical value = 0. Default: 0 + :tl4: Low band time constant (TL4) (>= 0). Typical value = 0. Default: 0 + :tl5: Low band time constant (TL5) (>= 0). Typical value = 0. Default: 0 + :tl6: Low band time constant (TL6) (>= 0). Typical value = 0. Default: 0 + :tl7: Low band time constant (TL7) (>= 0). Typical value = 2,075. Default: 0 + :tl8: Low band time constant (TL8) (>= 0). Typical value = 2,491. Default: 0 + :tl9: Low band time constant (TL9) (>= 0). Typical value = 0. Default: 0 + :vhmax: High band output maximum limit (VHmax) (> PssIEEE4B.vhmin). Typical value = 0,6. Default: 0.0 + :vhmin: High band output minimum limit (VHmin) (< PssIEEE4V.vhmax). Typical value = -0,6. Default: 0.0 + :vimax: Intermediate band output maximum limit (VImax) (> PssIEEE4B.vimin). Typical value = 0,6. Default: 0.0 + :vimin: Intermediate band output minimum limit (VImin) (< PssIEEE4B.vimax). Typical value = -0,6. Default: 0.0 + :vlmax: Low band output maximum limit (VLmax) (> PssIEEE4B.vlmin). Typical value = 0,075. Default: 0.0 + :vlmin: Low band output minimum limit (VLmin) (< PssIEEE4B.vlmax). Typical value = -0,075. Default: 0.0 + :vstmax: PSS output maximum limit (VSTmax) (> PssIEEE4B.vstmin). Typical value = 0,15. Default: 0.0 + :vstmin: PSS output minimum limit (VSTmin) (< PssIEEE4B.vstmax). Typical value = -0,15. Default: 0.0 + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'bwh1': [cgmesProfile.DY.value, ], + 'bwh2': [cgmesProfile.DY.value, ], + 'bwl1': [cgmesProfile.DY.value, ], + 'bwl2': [cgmesProfile.DY.value, ], + 'kh': [cgmesProfile.DY.value, ], + 'kh1': [cgmesProfile.DY.value, ], + 'kh11': [cgmesProfile.DY.value, ], + 'kh17': [cgmesProfile.DY.value, ], + 'kh2': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'ki1': [cgmesProfile.DY.value, ], + 'ki11': [cgmesProfile.DY.value, ], + 'ki17': [cgmesProfile.DY.value, ], + 'ki2': [cgmesProfile.DY.value, ], + 'kl': [cgmesProfile.DY.value, ], + 'kl1': [cgmesProfile.DY.value, ], + 'kl11': [cgmesProfile.DY.value, ], + 'kl17': [cgmesProfile.DY.value, ], + 'kl2': [cgmesProfile.DY.value, ], + 'omeganh1': [cgmesProfile.DY.value, ], + 'omeganh2': [cgmesProfile.DY.value, ], + 'omeganl1': [cgmesProfile.DY.value, ], + 'omeganl2': [cgmesProfile.DY.value, ], + 'th1': [cgmesProfile.DY.value, ], + 'th10': [cgmesProfile.DY.value, ], + 'th11': [cgmesProfile.DY.value, ], + 'th12': [cgmesProfile.DY.value, ], + 'th2': [cgmesProfile.DY.value, ], + 'th3': [cgmesProfile.DY.value, ], + 'th4': [cgmesProfile.DY.value, ], + 'th5': [cgmesProfile.DY.value, ], + 'th6': [cgmesProfile.DY.value, ], + 'th7': [cgmesProfile.DY.value, ], + 'th8': [cgmesProfile.DY.value, ], + 'th9': [cgmesProfile.DY.value, ], + 'ti1': [cgmesProfile.DY.value, ], + 'ti10': [cgmesProfile.DY.value, ], + 'ti11': [cgmesProfile.DY.value, ], + 'ti12': [cgmesProfile.DY.value, ], + 'ti2': [cgmesProfile.DY.value, ], + 'ti3': [cgmesProfile.DY.value, ], + 'ti4': [cgmesProfile.DY.value, ], + 'ti5': [cgmesProfile.DY.value, ], + 'ti6': [cgmesProfile.DY.value, ], + 'ti7': [cgmesProfile.DY.value, ], + 'ti8': [cgmesProfile.DY.value, ], + 'ti9': [cgmesProfile.DY.value, ], + 'tl1': [cgmesProfile.DY.value, ], + 'tl10': [cgmesProfile.DY.value, ], + 'tl11': [cgmesProfile.DY.value, ], + 'tl12': [cgmesProfile.DY.value, ], + 'tl2': [cgmesProfile.DY.value, ], + 'tl3': [cgmesProfile.DY.value, ], + 'tl4': [cgmesProfile.DY.value, ], + 'tl5': [cgmesProfile.DY.value, ], + 'tl6': [cgmesProfile.DY.value, ], + 'tl7': [cgmesProfile.DY.value, ], + 'tl8': [cgmesProfile.DY.value, ], + 'tl9': [cgmesProfile.DY.value, ], + 'vhmax': [cgmesProfile.DY.value, ], + 'vhmin': [cgmesProfile.DY.value, ], + 'vimax': [cgmesProfile.DY.value, ], + 'vimin': [cgmesProfile.DY.value, ], + 'vlmax': [cgmesProfile.DY.value, ], + 'vlmin': [cgmesProfile.DY.value, ], + 'vstmax': [cgmesProfile.DY.value, ], + 'vstmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, bwh1 = 0.0, bwh2 = 0.0, bwl1 = 0.0, bwl2 = 0.0, kh = 0.0, kh1 = 0.0, kh11 = 0.0, kh17 = 0.0, kh2 = 0.0, ki = 0.0, ki1 = 0.0, ki11 = 0.0, ki17 = 0.0, ki2 = 0.0, kl = 0.0, kl1 = 0.0, kl11 = 0.0, kl17 = 0.0, kl2 = 0.0, omeganh1 = 0.0, omeganh2 = 0.0, omeganl1 = 0.0, omeganl2 = 0.0, th1 = 0, th10 = 0, th11 = 0, th12 = 0, th2 = 0, th3 = 0, th4 = 0, th5 = 0, th6 = 0, th7 = 0, th8 = 0, th9 = 0, ti1 = 0, ti10 = 0, ti11 = 0, ti12 = 0, ti2 = 0, ti3 = 0, ti4 = 0, ti5 = 0, ti6 = 0, ti7 = 0, ti8 = 0, ti9 = 0, tl1 = 0, tl10 = 0, tl11 = 0, tl12 = 0, tl2 = 0, tl3 = 0, tl4 = 0, tl5 = 0, tl6 = 0, tl7 = 0, tl8 = 0, tl9 = 0, vhmax = 0.0, vhmin = 0.0, vimax = 0.0, vimin = 0.0, vlmax = 0.0, vlmin = 0.0, vstmax = 0.0, vstmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.bwh1 = bwh1 + self.bwh2 = bwh2 + self.bwl1 = bwl1 + self.bwl2 = bwl2 + self.kh = kh + self.kh1 = kh1 + self.kh11 = kh11 + self.kh17 = kh17 + self.kh2 = kh2 + self.ki = ki + self.ki1 = ki1 + self.ki11 = ki11 + self.ki17 = ki17 + self.ki2 = ki2 + self.kl = kl + self.kl1 = kl1 + self.kl11 = kl11 + self.kl17 = kl17 + self.kl2 = kl2 + self.omeganh1 = omeganh1 + self.omeganh2 = omeganh2 + self.omeganl1 = omeganl1 + self.omeganl2 = omeganl2 + self.th1 = th1 + self.th10 = th10 + self.th11 = th11 + self.th12 = th12 + self.th2 = th2 + self.th3 = th3 + self.th4 = th4 + self.th5 = th5 + self.th6 = th6 + self.th7 = th7 + self.th8 = th8 + self.th9 = th9 + self.ti1 = ti1 + self.ti10 = ti10 + self.ti11 = ti11 + self.ti12 = ti12 + self.ti2 = ti2 + self.ti3 = ti3 + self.ti4 = ti4 + self.ti5 = ti5 + self.ti6 = ti6 + self.ti7 = ti7 + self.ti8 = ti8 + self.ti9 = ti9 + self.tl1 = tl1 + self.tl10 = tl10 + self.tl11 = tl11 + self.tl12 = tl12 + self.tl2 = tl2 + self.tl3 = tl3 + self.tl4 = tl4 + self.tl5 = tl5 + self.tl6 = tl6 + self.tl7 = tl7 + self.tl8 = tl8 + self.tl9 = tl9 + self.vhmax = vhmax + self.vhmin = vhmin + self.vimax = vimax + self.vimin = vimin + self.vlmax = vlmax + self.vlmin = vlmin + self.vstmax = vstmax + self.vstmin = vstmin + + def __str__(self): + str = 'class=PssIEEE4B\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PssPTIST1.py b/cimpy/cgmes_v3_0_0/PssPTIST1.py new file mode 100644 index 00000000..2be40e73 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PssPTIST1.py @@ -0,0 +1,61 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class PssPTIST1(PowerSystemStabilizerDynamics): + ''' + PTI microprocessor-based stabilizer type 1. + + :m: (M). M = 2 x H. Typical value = 5. Default: 0.0 + :tf: Time constant (Tf) (>= 0). Typical value = 0,2. Default: 0 + :tp: Time constant (Tp) (>= 0). Typical value = 0,2. Default: 0 + :t1: Time constant (T1) (>= 0). Typical value = 0,3. Default: 0 + :t2: Time constant (T2) (>= 0). Typical value = 1. Default: 0 + :t3: Time constant (T3) (>= 0). Typical value = 0,2. Default: 0 + :t4: Time constant (T4) (>= 0). Typical value = 0,05. Default: 0 + :k: Gain (K). Typical value = 9. Default: 0.0 + :dtf: Time step frequency calculation (deltatf) (>= 0). Typical value = 0,025. Default: 0 + :dtc: Time step related to activation of controls (deltatc) (>= 0). Typical value = 0,025. Default: 0 + :dtp: Time step active power calculation (deltatp) (>= 0). Typical value = 0,0125. Default: 0 + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'm': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'tp': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 'k': [cgmesProfile.DY.value, ], + 'dtf': [cgmesProfile.DY.value, ], + 'dtc': [cgmesProfile.DY.value, ], + 'dtp': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, m = 0.0, tf = 0, tp = 0, t1 = 0, t2 = 0, t3 = 0, t4 = 0, k = 0.0, dtf = 0, dtc = 0, dtp = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.m = m + self.tf = tf + self.tp = tp + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.t4 = t4 + self.k = k + self.dtf = dtf + self.dtc = dtc + self.dtp = dtp + + def __str__(self): + str = 'class=PssPTIST1\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PssPTIST3.py b/cimpy/cgmes_v3_0_0/PssPTIST3.py new file mode 100644 index 00000000..1067c5d9 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PssPTIST3.py @@ -0,0 +1,130 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class PssPTIST3(PowerSystemStabilizerDynamics): + ''' + PTI microprocessor-based stabilizer type 3. + + :m: (M). M = 2 x H. Typical value = 5. Default: 0.0 + :tf: Time constant (Tf) (>= 0). Typical value = 0,2. Default: 0 + :tp: Time constant (Tp) (>= 0). Typical value = 0,2. Default: 0 + :t1: Time constant (T1) (>= 0). Typical value = 0,3. Default: 0 + :t2: Time constant (T2) (>= 0). Typical value = 1. Default: 0 + :t3: Time constant (T3) (>= 0). Typical value = 0,2. Default: 0 + :t4: Time constant (T4) (>= 0). Typical value = 0,05. Default: 0 + :k: Gain (K). Typical value = 9. Default: 0.0 + :dtf: Time step frequency calculation (deltatf) (>= 0). Typical value = 0,025 (0,03 for 50 Hz). Default: 0 + :dtc: Time step related to activation of controls (deltatc) (>= 0). Typical value = 0,025 (0,03 for 50 Hz). Default: 0 + :dtp: Time step active power calculation (deltatp) (>= 0). Typical value = 0,0125 (0,015 for 50 Hz). Default: 0 + :t5: Time constant (T5) (>= 0). Default: 0 + :t6: Time constant (T6) (>= 0). Default: 0 + :a0: Filter coefficient (A0). Default: 0.0 + :a1: Limiter (Al). Default: 0.0 + :a2: Filter coefficient (A2). Default: 0.0 + :b0: Filter coefficient (B0). Default: 0.0 + :b1: Filter coefficient (B1). Default: 0.0 + :b2: Filter coefficient (B2). Default: 0.0 + :a3: Filter coefficient (A3). Default: 0.0 + :a4: Filter coefficient (A4). Default: 0.0 + :a5: Filter coefficient (A5). Default: 0.0 + :b3: Filter coefficient (B3). Default: 0.0 + :b4: Filter coefficient (B4). Default: 0.0 + :b5: Filter coefficient (B5). Default: 0.0 + :athres: Threshold value above which output averaging will be bypassed (Athres). Typical value = 0,005. Default: 0.0 + :dl: Limiter (Dl). Default: 0.0 + :al: Limiter (Al). Default: 0.0 + :lthres: Threshold value (Lthres). Default: 0.0 + :pmin: (Pmin). Default: 0.0 + :isw: Digital/analogue output switch (Isw). true = produce analogue output false = convert to digital output, using tap selection table. Default: False + :nav: Number of control outputs to average (NAV) (1 <= NAV <= 16). Typical value = 4. Default: 0.0 + :ncl: Number of counts at limit to active limit function (NCL) (> 0). Default: 0.0 + :ncr: Number of counts until reset after limit function is triggered (NCR). Default: 0.0 + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'm': [cgmesProfile.DY.value, ], + 'tf': [cgmesProfile.DY.value, ], + 'tp': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 'k': [cgmesProfile.DY.value, ], + 'dtf': [cgmesProfile.DY.value, ], + 'dtc': [cgmesProfile.DY.value, ], + 'dtp': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 't6': [cgmesProfile.DY.value, ], + 'a0': [cgmesProfile.DY.value, ], + 'a1': [cgmesProfile.DY.value, ], + 'a2': [cgmesProfile.DY.value, ], + 'b0': [cgmesProfile.DY.value, ], + 'b1': [cgmesProfile.DY.value, ], + 'b2': [cgmesProfile.DY.value, ], + 'a3': [cgmesProfile.DY.value, ], + 'a4': [cgmesProfile.DY.value, ], + 'a5': [cgmesProfile.DY.value, ], + 'b3': [cgmesProfile.DY.value, ], + 'b4': [cgmesProfile.DY.value, ], + 'b5': [cgmesProfile.DY.value, ], + 'athres': [cgmesProfile.DY.value, ], + 'dl': [cgmesProfile.DY.value, ], + 'al': [cgmesProfile.DY.value, ], + 'lthres': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + 'isw': [cgmesProfile.DY.value, ], + 'nav': [cgmesProfile.DY.value, ], + 'ncl': [cgmesProfile.DY.value, ], + 'ncr': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, m = 0.0, tf = 0, tp = 0, t1 = 0, t2 = 0, t3 = 0, t4 = 0, k = 0.0, dtf = 0, dtc = 0, dtp = 0, t5 = 0, t6 = 0, a0 = 0.0, a1 = 0.0, a2 = 0.0, b0 = 0.0, b1 = 0.0, b2 = 0.0, a3 = 0.0, a4 = 0.0, a5 = 0.0, b3 = 0.0, b4 = 0.0, b5 = 0.0, athres = 0.0, dl = 0.0, al = 0.0, lthres = 0.0, pmin = 0.0, isw = False, nav = 0.0, ncl = 0.0, ncr = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.m = m + self.tf = tf + self.tp = tp + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.t4 = t4 + self.k = k + self.dtf = dtf + self.dtc = dtc + self.dtp = dtp + self.t5 = t5 + self.t6 = t6 + self.a0 = a0 + self.a1 = a1 + self.a2 = a2 + self.b0 = b0 + self.b1 = b1 + self.b2 = b2 + self.a3 = a3 + self.a4 = a4 + self.a5 = a5 + self.b3 = b3 + self.b4 = b4 + self.b5 = b5 + self.athres = athres + self.dl = dl + self.al = al + self.lthres = lthres + self.pmin = pmin + self.isw = isw + self.nav = nav + self.ncl = ncl + self.ncr = ncr + + def __str__(self): + str = 'class=PssPTIST3\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PssRQB.py b/cimpy/cgmes_v3_0_0/PssRQB.py new file mode 100644 index 00000000..17e6b66f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PssRQB.py @@ -0,0 +1,58 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class PssRQB(PowerSystemStabilizerDynamics): + ''' + Power system stabilizer type RQB. This power system stabilizer is intended to be used together with excitation system type ExcRQB, which is primarily used in nuclear or thermal generating units. + + :ki2: Speed input gain (Ki2). Typical value = 3,43. Default: 0.0 + :ki3: Electrical power input gain (Ki3). Typical value = -11,45. Default: 0.0 + :ki4: Mechanical power input gain (Ki4). Typical value = 11,86. Default: 0.0 + :t4m: Input time constant (T4M) (>= 0). Typical value = 5. Default: 0 + :tomd: Speed delay (TOMD) (>= 0). Typical value = 0,02. Default: 0 + :tomsl: Speed time constant (TOMSL) (>= 0). Typical value = 0,04. Default: 0 + :t4mom: Speed time constant (T4MOM) (>= 0). Typical value = 1,27. Default: 0 + :sibv: Speed deadband (SIBV). Typical value = 0,006. Default: 0.0 + :kdpm: Lead lag gain (KDPM). Typical value = 0,185. Default: 0.0 + :t4f: Lead lag time constant (T4F) (>= 0). Typical value = 0,045. Default: 0 + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ki2': [cgmesProfile.DY.value, ], + 'ki3': [cgmesProfile.DY.value, ], + 'ki4': [cgmesProfile.DY.value, ], + 't4m': [cgmesProfile.DY.value, ], + 'tomd': [cgmesProfile.DY.value, ], + 'tomsl': [cgmesProfile.DY.value, ], + 't4mom': [cgmesProfile.DY.value, ], + 'sibv': [cgmesProfile.DY.value, ], + 'kdpm': [cgmesProfile.DY.value, ], + 't4f': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, ki2 = 0.0, ki3 = 0.0, ki4 = 0.0, t4m = 0, tomd = 0, tomsl = 0, t4mom = 0, sibv = 0.0, kdpm = 0.0, t4f = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ki2 = ki2 + self.ki3 = ki3 + self.ki4 = ki4 + self.t4m = t4m + self.tomd = tomd + self.tomsl = tomsl + self.t4mom = t4mom + self.sibv = sibv + self.kdpm = kdpm + self.t4f = t4f + + def __str__(self): + str = 'class=PssRQB\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PssSB4.py b/cimpy/cgmes_v3_0_0/PssSB4.py new file mode 100644 index 00000000..e95b617a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PssSB4.py @@ -0,0 +1,61 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class PssSB4(PowerSystemStabilizerDynamics): + ''' + Power sensitive stabilizer model. + + :tt: Time constant (Tt) (>= 0). Typical value = 0,18. Default: 0 + :kx: Gain (Kx). Typical value = 2,7. Default: 0.0 + :tx2: Time constant (Tx2) (>= 0). Typical value = 5,0. Default: 0 + :ta: Time constant (Ta) (>= 0). Typical value = 0,37. Default: 0 + :tx1: Reset time constant (Tx1) (>= 0). Typical value = 0,035. Default: 0 + :tb: Time constant (Tb) (>= 0). Typical value = 0,37. Default: 0 + :tc: Time constant (Tc) (>= 0). Typical value = 0,035. Default: 0 + :td: Time constant (Td) (>= 0). Typical value = 0,0. Default: 0 + :te: Time constant (Te) (>= 0). Typical value = 0,0169. Default: 0 + :vsmax: Limiter (Vsmax) (> PssSB4.vsmin). Typical value = 0,062. Default: 0.0 + :vsmin: Limiter (Vsmin) (< PssSB4.vsmax). Typical value = -0,062. Default: 0.0 + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'tt': [cgmesProfile.DY.value, ], + 'kx': [cgmesProfile.DY.value, ], + 'tx2': [cgmesProfile.DY.value, ], + 'ta': [cgmesProfile.DY.value, ], + 'tx1': [cgmesProfile.DY.value, ], + 'tb': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + 'td': [cgmesProfile.DY.value, ], + 'te': [cgmesProfile.DY.value, ], + 'vsmax': [cgmesProfile.DY.value, ], + 'vsmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, tt = 0, kx = 0.0, tx2 = 0, ta = 0, tx1 = 0, tb = 0, tc = 0, td = 0, te = 0, vsmax = 0.0, vsmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.tt = tt + self.kx = kx + self.tx2 = tx2 + self.ta = ta + self.tx1 = tx1 + self.tb = tb + self.tc = tc + self.td = td + self.te = te + self.vsmax = vsmax + self.vsmin = vsmin + + def __str__(self): + str = 'class=PssSB4\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PssSH.py b/cimpy/cgmes_v3_0_0/PssSH.py new file mode 100644 index 00000000..d5dc2d90 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PssSH.py @@ -0,0 +1,67 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class PssSH(PowerSystemStabilizerDynamics): + ''' + SiemensTM "H infinity" power system stabilizer with generator electrical power input. [Footnote: Siemens "H infinity" power system stabilizers are an example of suitable products available commercially. This information is given for the convenience of users of this document and does not constitute an endorsement by IEC of these products.] + + :k: Main gain (K). Typical value = 1. Default: 0.0 + :k0: Gain 0 (K0). Typical value = 0,012. Default: 0.0 + :k1: Gain 1 (K1). Typical value = 0,488. Default: 0.0 + :k2: Gain 2 (K2). Typical value = 0,064. Default: 0.0 + :k3: Gain 3 (K3). Typical value = 0,224. Default: 0.0 + :k4: Gain 4 (K4). Typical value = 0,1. Default: 0.0 + :td: Input time constant (Td) (>= 0). Typical value = 10. Default: 0 + :t1: Time constant 1 (T1) (> 0). Typical value = 0,076. Default: 0 + :t2: Time constant 2 (T2) (> 0). Typical value = 0,086. Default: 0 + :t3: Time constant 3 (T3) (> 0). Typical value = 1,068. Default: 0 + :t4: Time constant 4 (T4) (> 0). Typical value = 1,913. Default: 0 + :vsmax: Output maximum limit (Vsmax) (> PssSH.vsmin). Typical value = 0,1. Default: 0.0 + :vsmin: Output minimum limit (Vsmin) (< PssSH.vsmax). Typical value = -0,1. Default: 0.0 + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'k': [cgmesProfile.DY.value, ], + 'k0': [cgmesProfile.DY.value, ], + 'k1': [cgmesProfile.DY.value, ], + 'k2': [cgmesProfile.DY.value, ], + 'k3': [cgmesProfile.DY.value, ], + 'k4': [cgmesProfile.DY.value, ], + 'td': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 'vsmax': [cgmesProfile.DY.value, ], + 'vsmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, k = 0.0, k0 = 0.0, k1 = 0.0, k2 = 0.0, k3 = 0.0, k4 = 0.0, td = 0, t1 = 0, t2 = 0, t3 = 0, t4 = 0, vsmax = 0.0, vsmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.k = k + self.k0 = k0 + self.k1 = k1 + self.k2 = k2 + self.k3 = k3 + self.k4 = k4 + self.td = td + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.t4 = t4 + self.vsmax = vsmax + self.vsmin = vsmin + + def __str__(self): + str = 'class=PssSH\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PssSK.py b/cimpy/cgmes_v3_0_0/PssSK.py new file mode 100644 index 00000000..0df128c0 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PssSK.py @@ -0,0 +1,61 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class PssSK(PowerSystemStabilizerDynamics): + ''' + Slovakian PSS with three inputs. + + :k1: Gain P (K1). Typical value = -0,3. Default: 0.0 + :k2: Gain fE (K2). Typical value = -0,15. Default: 0.0 + :k3: Gain If (K3). Typical value = 10. Default: 0.0 + :t1: Denominator time constant (T1) (> 0,005). Typical value = 0,3. Default: 0 + :t2: Filter time constant (T2) (> 0,005). Typical value = 0,35. Default: 0 + :t3: Denominator time constant (T3) (> 0,005). Typical value = 0,22. Default: 0 + :t4: Filter time constant (T4) (> 0,005). Typical value = 0,02. Default: 0 + :t5: Denominator time constant (T5) (> 0,005). Typical value = 0,02. Default: 0 + :t6: Filter time constant (T6) (> 0,005). Typical value = 0,02. Default: 0 + :vsmax: Stabilizer output maximum limit (VSMAX) (> PssSK.vsmin). Typical value = 0,4. Default: 0.0 + :vsmin: Stabilizer output minimum limit (VSMIN) (< PssSK.vsmax). Typical value = -0.4. Default: 0.0 + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'k1': [cgmesProfile.DY.value, ], + 'k2': [cgmesProfile.DY.value, ], + 'k3': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 't6': [cgmesProfile.DY.value, ], + 'vsmax': [cgmesProfile.DY.value, ], + 'vsmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, k1 = 0.0, k2 = 0.0, k3 = 0.0, t1 = 0, t2 = 0, t3 = 0, t4 = 0, t5 = 0, t6 = 0, vsmax = 0.0, vsmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.k1 = k1 + self.k2 = k2 + self.k3 = k3 + self.t1 = t1 + self.t2 = t2 + self.t3 = t3 + self.t4 = t4 + self.t5 = t5 + self.t6 = t6 + self.vsmax = vsmax + self.vsmin = vsmin + + def __str__(self): + str = 'class=PssSK\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PssSTAB2A.py b/cimpy/cgmes_v3_0_0/PssSTAB2A.py new file mode 100644 index 00000000..30b37265 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PssSTAB2A.py @@ -0,0 +1,52 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class PssSTAB2A(PowerSystemStabilizerDynamics): + ''' + Power system stabilizer part of an ABB excitation system. [Footnote: ABB excitation systems are an example of suitable products available commercially. This information is given for the convenience of users of this document and does not constitute an endorsement by IEC of these products.] + + :k2: Gain (K2). Typical value = 1,0. Default: 0.0 + :k3: Gain (K3). Typical value = 0,25. Default: 0.0 + :k4: Gain (K4). Typical value = 0,075. Default: 0.0 + :k5: Gain (K5). Typical value = 2,5. Default: 0.0 + :t2: Time constant (T2). Typical value = 4,0. Default: 0 + :t3: Time constant (T3). Typical value = 2,0. Default: 0 + :t5: Time constant (T5). Typical value = 4,5. Default: 0 + :hlim: Stabilizer output limiter (HLIM). Typical value = 0,5. Default: 0.0 + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'k2': [cgmesProfile.DY.value, ], + 'k3': [cgmesProfile.DY.value, ], + 'k4': [cgmesProfile.DY.value, ], + 'k5': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 'hlim': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, k2 = 0.0, k3 = 0.0, k4 = 0.0, k5 = 0.0, t2 = 0, t3 = 0, t5 = 0, hlim = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.k2 = k2 + self.k3 = k3 + self.k4 = k4 + self.k5 = k5 + self.t2 = t2 + self.t3 = t3 + self.t5 = t5 + self.hlim = hlim + + def __str__(self): + str = 'class=PssSTAB2A\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/PssWECC.py b/cimpy/cgmes_v3_0_0/PssWECC.py new file mode 100644 index 00000000..d3416c6b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/PssWECC.py @@ -0,0 +1,82 @@ +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics + + +class PssWECC(PowerSystemStabilizerDynamics): + ''' + Dual input power system stabilizer, based on IEEE type 2, with modified output limiter defined by WECC (Western Electricity Coordinating Council, USA). + + :inputSignal1Type: Type of input signal #1 (rotorAngularFrequencyDeviation, busFrequencyDeviation, generatorElectricalPower, generatorAcceleratingPower, busVoltage, or busVoltageDerivative - shall be different than PssWECC.inputSignal2Type). Typical value = rotorAngularFrequencyDeviation. Default: None + :inputSignal2Type: Type of input signal #2 (rotorAngularFrequencyDeviation, busFrequencyDeviation, generatorElectricalPower, generatorAcceleratingPower, busVoltage, busVoltageDerivative - shall be different than PssWECC.inputSignal1Type). Typical value = busVoltageDerivative. Default: None + :k1: Input signal 1 gain (K1). Typical value = 1,13. Default: 0.0 + :t1: Input signal 1 transducer time constant (T1) (>= 0). Typical value = 0,037. Default: 0 + :k2: Input signal 2 gain (K2). Typical value = 0,0. Default: 0.0 + :t2: Input signal 2 transducer time constant (T2) (>= 0). Typical value = 0,0. Default: 0 + :t3: Stabilizer washout time constant (T3) (>= 0). Typical value = 9,5. Default: 0 + :t4: Stabilizer washout time lag constant (T4) (>= 0). Typical value = 9,5. Default: 0 + :t5: Lead time constant (T5) (>= 0). Typical value = 1,7. Default: 0 + :t6: Lag time constant (T6) (>= 0). Typical value = 1,5. Default: 0 + :t7: Lead time constant (T7) (>= 0). Typical value = 1,7. Default: 0 + :t8: Lag time constant (T8) (>= 0). Typical value = 1,5. Default: 0 + :t10: Lag time constant (T10) (>= 0). Typical value = 0. Default: 0 + :t9: Lead time constant (T9) (>= 0). Typical value = 0. Default: 0 + :vsmax: Maximum output signal (Vsmax) (> PssWECC.vsmin). Typical value = 0,05. Default: 0.0 + :vsmin: Minimum output signal (Vsmin) (< PssWECC.vsmax). Typical value = -0,05. Default: 0.0 + :vcu: Maximum value for voltage compensator output (VCU). Typical value = 0. Default: 0.0 + :vcl: Minimum value for voltage compensator output (VCL). Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = PowerSystemStabilizerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'inputSignal1Type': [cgmesProfile.DY.value, ], + 'inputSignal2Type': [cgmesProfile.DY.value, ], + 'k1': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 'k2': [cgmesProfile.DY.value, ], + 't2': [cgmesProfile.DY.value, ], + 't3': [cgmesProfile.DY.value, ], + 't4': [cgmesProfile.DY.value, ], + 't5': [cgmesProfile.DY.value, ], + 't6': [cgmesProfile.DY.value, ], + 't7': [cgmesProfile.DY.value, ], + 't8': [cgmesProfile.DY.value, ], + 't10': [cgmesProfile.DY.value, ], + 't9': [cgmesProfile.DY.value, ], + 'vsmax': [cgmesProfile.DY.value, ], + 'vsmin': [cgmesProfile.DY.value, ], + 'vcu': [cgmesProfile.DY.value, ], + 'vcl': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemStabilizerDynamics: \n' + PowerSystemStabilizerDynamics.__doc__ + + def __init__(self, inputSignal1Type = None, inputSignal2Type = None, k1 = 0.0, t1 = 0, k2 = 0.0, t2 = 0, t3 = 0, t4 = 0, t5 = 0, t6 = 0, t7 = 0, t8 = 0, t10 = 0, t9 = 0, vsmax = 0.0, vsmin = 0.0, vcu = 0.0, vcl = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.inputSignal1Type = inputSignal1Type + self.inputSignal2Type = inputSignal2Type + self.k1 = k1 + self.t1 = t1 + self.k2 = k2 + self.t2 = t2 + self.t3 = t3 + self.t4 = t4 + self.t5 = t5 + self.t6 = t6 + self.t7 = t7 + self.t8 = t8 + self.t10 = t10 + self.t9 = t9 + self.vsmax = vsmax + self.vsmin = vsmin + self.vcu = vcu + self.vcl = vcl + + def __str__(self): + str = 'class=PssWECC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Quality61850.py b/cimpy/cgmes_v3_0_0/Quality61850.py new file mode 100644 index 00000000..64ba3130 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Quality61850.py @@ -0,0 +1,63 @@ +from .Base import Base + + +class Quality61850(Base): + ''' + Quality flags in this class are as defined in IEC 61850, except for estimatorReplaced, which has been included in this class for convenience. + + :badReference: Measurement value may be incorrect due to a reference being out of calibration. Default: False + :estimatorReplaced: Value has been replaced by State Estimator. estimatorReplaced is not an IEC61850 quality bit but has been put in this class for convenience. Default: False + :failure: This identifier indicates that a supervision function has detected an internal or external failure, e.g. communication failure. Default: False + :oldData: Measurement value is old and possibly invalid, as it has not been successfully updated during a specified time interval. Default: False + :operatorBlocked: Measurement value is blocked and hence unavailable for transmission. Default: False + :oscillatory: To prevent some overload of the communication it is sensible to detect and suppress oscillating (fast changing) binary inputs. If a signal changes in a defined time twice in the same direction (from 0 to 1 or from 1 to 0) then oscillation is detected and the detail quality identifier `oscillatory` is set. If it is detected a configured numbers of transient changes could be passed by. In this time the validity status `questionable` is set. If after this defined numbers of changes the signal is still in the oscillating state the value shall be set either to the opposite state of the previous stable value or to a defined default value. In this case the validity status `questionable` is reset and `invalid` is set as long as the signal is oscillating. If it is configured such that no transient changes should be passed by then the validity status `invalid` is set immediately in addition to the detail quality identifier `oscillatory` (used for status information only). Default: False + :outOfRange: Measurement value is beyond a predefined range of value. Default: False + :overFlow: Measurement value is beyond the capability of being represented properly. For example, a counter value overflows from maximum count back to a value of zero. Default: False + :source: Source gives information related to the origin of a value. The value may be acquired from the process, defaulted or substituted. Default: None + :suspect: A correlation function has detected that the value is not consistent with other values. Typically set by a network State Estimator. Default: False + :test: Measurement value is transmitted for test purposes. Default: False + :validity: Validity of the measurement value. Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'badReference': [cgmesProfile.OP.value, ], + 'estimatorReplaced': [cgmesProfile.OP.value, ], + 'failure': [cgmesProfile.OP.value, ], + 'oldData': [cgmesProfile.OP.value, ], + 'operatorBlocked': [cgmesProfile.OP.value, ], + 'oscillatory': [cgmesProfile.OP.value, ], + 'outOfRange': [cgmesProfile.OP.value, ], + 'overFlow': [cgmesProfile.OP.value, ], + 'source': [cgmesProfile.OP.value, ], + 'suspect': [cgmesProfile.OP.value, ], + 'test': [cgmesProfile.OP.value, ], + 'validity': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + + + def __init__(self, badReference = False, estimatorReplaced = False, failure = False, oldData = False, operatorBlocked = False, oscillatory = False, outOfRange = False, overFlow = False, source = None, suspect = False, test = False, validity = None, ): + + self.badReference = badReference + self.estimatorReplaced = estimatorReplaced + self.failure = failure + self.oldData = oldData + self.operatorBlocked = operatorBlocked + self.oscillatory = oscillatory + self.outOfRange = outOfRange + self.overFlow = overFlow + self.source = source + self.suspect = suspect + self.test = test + self.validity = validity + + def __str__(self): + str = 'class=Quality61850\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/RaiseLowerCommand.py b/cimpy/cgmes_v3_0_0/RaiseLowerCommand.py new file mode 100644 index 00000000..9cde735b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/RaiseLowerCommand.py @@ -0,0 +1,31 @@ +from .AnalogControl import AnalogControl + + +class RaiseLowerCommand(AnalogControl): + ''' + An analog control that increases or decreases a set point value with pulses. Unless otherwise specified, one pulse moves the set point by one. + + :ValueAliasSet: The ValueAliasSet used for translation of a Control value to a name. Default: None + ''' + + cgmesProfile = AnalogControl.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'ValueAliasSet': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class AnalogControl: \n' + AnalogControl.__doc__ + + def __init__(self, ValueAliasSet = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ValueAliasSet = ValueAliasSet + + def __str__(self): + str = 'class=RaiseLowerCommand\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/RatioTapChanger.py b/cimpy/cgmes_v3_0_0/RatioTapChanger.py new file mode 100644 index 00000000..b8d9aab3 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/RatioTapChanger.py @@ -0,0 +1,37 @@ +from .TapChanger import TapChanger + + +class RatioTapChanger(TapChanger): + ''' + A tap changer that changes the voltage ratio impacting the voltage magnitude but not the phase angle across the transformer. Angle sign convention (general): Positive value indicates a positive phase shift from the winding where the tap is located to the other winding (for a two-winding transformer). + + :stepVoltageIncrement: Tap step increment, in per cent of rated voltage of the power transformer end, per step position. When the increment is negative, the voltage decreases when the tap step increases. Default: 0.0 + :RatioTapChangerTable: The tap ratio table for this ratio tap changer. Default: None + :TransformerEnd: Transformer end to which this ratio tap changer belongs. Default: None + ''' + + cgmesProfile = TapChanger.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'stepVoltageIncrement': [cgmesProfile.EQ.value, ], + 'RatioTapChangerTable': [cgmesProfile.EQ.value, ], + 'TransformerEnd': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TapChanger: \n' + TapChanger.__doc__ + + def __init__(self, stepVoltageIncrement = 0.0, RatioTapChangerTable = None, TransformerEnd = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.stepVoltageIncrement = stepVoltageIncrement + self.RatioTapChangerTable = RatioTapChangerTable + self.TransformerEnd = TransformerEnd + + def __str__(self): + str = 'class=RatioTapChanger\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/RatioTapChangerTable.py b/cimpy/cgmes_v3_0_0/RatioTapChangerTable.py new file mode 100644 index 00000000..f0ba9271 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/RatioTapChangerTable.py @@ -0,0 +1,34 @@ +from .IdentifiedObject import IdentifiedObject + + +class RatioTapChangerTable(IdentifiedObject): + ''' + Describes a curve for how the voltage magnitude and impedance varies with the tap step. + + :RatioTapChanger: The ratio tap changer of this tap ratio table. Default: "list" + :RatioTapChangerTablePoint: Points of this table. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'RatioTapChanger': [cgmesProfile.EQ.value, ], + 'RatioTapChangerTablePoint': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, RatioTapChanger = "list", RatioTapChangerTablePoint = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.RatioTapChanger = RatioTapChanger + self.RatioTapChangerTablePoint = RatioTapChangerTablePoint + + def __str__(self): + str = 'class=RatioTapChangerTable\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/RatioTapChangerTablePoint.py b/cimpy/cgmes_v3_0_0/RatioTapChangerTablePoint.py new file mode 100644 index 00000000..023e2ed2 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/RatioTapChangerTablePoint.py @@ -0,0 +1,31 @@ +from .TapChangerTablePoint import TapChangerTablePoint + + +class RatioTapChangerTablePoint(TapChangerTablePoint): + ''' + Describes each tap step in the ratio tap changer tabular curve. + + :RatioTapChangerTable: Table of this point. Default: None + ''' + + cgmesProfile = TapChangerTablePoint.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'RatioTapChangerTable': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TapChangerTablePoint: \n' + TapChangerTablePoint.__doc__ + + def __init__(self, RatioTapChangerTable = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.RatioTapChangerTable = RatioTapChangerTable + + def __str__(self): + str = 'class=RatioTapChangerTablePoint\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Reactance.py b/cimpy/cgmes_v3_0_0/Reactance.py new file mode 100644 index 00000000..52984c5d --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Reactance.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class Reactance(Base): + ''' + Reactance (imaginary part of impedance), at rated frequency. + + :value: Default: 0.0 + :unit: Default: None + :multiplier: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'value': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'unit': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'multiplier': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, unit = None, multiplier = None, ): + + self.value = value + self.unit = unit + self.multiplier = multiplier + + def __str__(self): + str = 'class=Reactance\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ReactiveCapabilityCurve.py b/cimpy/cgmes_v3_0_0/ReactiveCapabilityCurve.py new file mode 100644 index 00000000..8d4e9050 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ReactiveCapabilityCurve.py @@ -0,0 +1,34 @@ +from .Curve import Curve + + +class ReactiveCapabilityCurve(Curve): + ''' + Reactive power rating envelope versus the synchronous machine's active power, in both the generating and motoring modes. For each active power value there is a corresponding high and low reactive power limit value. Typically there will be a separate curve for each coolant condition, such as hydrogen pressure. The Y1 axis values represent reactive minimum and the Y2 axis values represent reactive maximum. + + :EquivalentInjection: The equivalent injection using this reactive capability curve. Default: "list" + :InitiallyUsedBySynchronousMachines: Synchronous machines using this curve as default. Default: "list" + ''' + + cgmesProfile = Curve.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'EquivalentInjection': [cgmesProfile.EQ.value, ], + 'InitiallyUsedBySynchronousMachines': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Curve: \n' + Curve.__doc__ + + def __init__(self, EquivalentInjection = "list", InitiallyUsedBySynchronousMachines = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.EquivalentInjection = EquivalentInjection + self.InitiallyUsedBySynchronousMachines = InitiallyUsedBySynchronousMachines + + def __str__(self): + str = 'class=ReactiveCapabilityCurve\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ReactivePower.py b/cimpy/cgmes_v3_0_0/ReactivePower.py new file mode 100644 index 00000000..1a793149 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ReactivePower.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class ReactivePower(Base): + ''' + Product of RMS value of the voltage and the RMS value of the quadrature component of the current. + + :value: Default: 0.0 + :unit: Default: None + :multiplier: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SV.value, ], + 'value': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SV.value, ], + 'unit': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SV.value, ], + 'multiplier': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, unit = None, multiplier = None, ): + + self.value = value + self.unit = unit + self.multiplier = multiplier + + def __str__(self): + str = 'class=ReactivePower\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/RealEnergy.py b/cimpy/cgmes_v3_0_0/RealEnergy.py new file mode 100644 index 00000000..59bb1fab --- /dev/null +++ b/cimpy/cgmes_v3_0_0/RealEnergy.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class RealEnergy(Base): + ''' + Real electrical energy. + + :multiplier: Default: None + :unit: Default: None + :value: Default: 0.0 + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'multiplier': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'unit': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'value': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, multiplier = None, unit = None, value = 0.0, ): + + self.multiplier = multiplier + self.unit = unit + self.value = value + + def __str__(self): + str = 'class=RealEnergy\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/RegularIntervalSchedule.py b/cimpy/cgmes_v3_0_0/RegularIntervalSchedule.py new file mode 100644 index 00000000..a6b5deca --- /dev/null +++ b/cimpy/cgmes_v3_0_0/RegularIntervalSchedule.py @@ -0,0 +1,37 @@ +from .BasicIntervalSchedule import BasicIntervalSchedule + + +class RegularIntervalSchedule(BasicIntervalSchedule): + ''' + The schedule has time points where the time between them is constant. + + :TimePoints: The regular interval time point data values that define this schedule. Default: "list" + :timeStep: The time between each pair of subsequent regular time points in sequence order. Default: 0 + :endTime: The time for the last time point. The value can be a time of day, not a specific date. Default: '' + ''' + + cgmesProfile = BasicIntervalSchedule.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'TimePoints': [cgmesProfile.EQ.value, ], + 'timeStep': [cgmesProfile.EQ.value, ], + 'endTime': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class BasicIntervalSchedule: \n' + BasicIntervalSchedule.__doc__ + + def __init__(self, TimePoints = "list", timeStep = 0, endTime = '', *args, **kw_args): + super().__init__(*args, **kw_args) + + self.TimePoints = TimePoints + self.timeStep = timeStep + self.endTime = endTime + + def __str__(self): + str = 'class=RegularIntervalSchedule\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/RegularTimePoint.py b/cimpy/cgmes_v3_0_0/RegularTimePoint.py new file mode 100644 index 00000000..51b122fb --- /dev/null +++ b/cimpy/cgmes_v3_0_0/RegularTimePoint.py @@ -0,0 +1,39 @@ +from .Base import Base + + +class RegularTimePoint(Base): + ''' + Time point for a schedule where the time between the consecutive points is constant. + + :sequenceNumber: The position of the regular time point in the sequence. Note that time points don`t have to be sequential, i.e. time points may be omitted. The actual time for a RegularTimePoint is computed by multiplying the associated regular interval schedule`s time step with the regular time point sequence number and adding the associated schedules start time. To specify values for the start time, use sequence number 0. The sequence number cannot be negative. Default: 0 + :value1: The first value at the time. The meaning of the value is defined by the derived type of the associated schedule. Default: 0.0 + :value2: The second value at the time. The meaning of the value is defined by the derived type of the associated schedule. Default: 0.0 + :IntervalSchedule: Regular interval schedule containing this time point. Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'sequenceNumber': [cgmesProfile.EQ.value, ], + 'value1': [cgmesProfile.EQ.value, ], + 'value2': [cgmesProfile.EQ.value, ], + 'IntervalSchedule': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, sequenceNumber = 0, value1 = 0.0, value2 = 0.0, IntervalSchedule = None, ): + + self.sequenceNumber = sequenceNumber + self.value1 = value1 + self.value2 = value2 + self.IntervalSchedule = IntervalSchedule + + def __str__(self): + str = 'class=RegularTimePoint\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/RegulatingCondEq.py b/cimpy/cgmes_v3_0_0/RegulatingCondEq.py new file mode 100644 index 00000000..9255a645 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/RegulatingCondEq.py @@ -0,0 +1,34 @@ +from .EnergyConnection import EnergyConnection + + +class RegulatingCondEq(EnergyConnection): + ''' + A type of conducting equipment that can regulate a quantity (i.e. voltage or flow) at a specific point in the network. + + :controlEnabled: Specifies the regulation status of the equipment. True is regulating, false is not regulating. Default: False + :RegulatingControl: The regulating control scheme in which this equipment participates. Default: None + ''' + + cgmesProfile = EnergyConnection.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'controlEnabled': [cgmesProfile.SSH.value, ], + 'RegulatingControl': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EnergyConnection: \n' + EnergyConnection.__doc__ + + def __init__(self, controlEnabled = False, RegulatingControl = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.controlEnabled = controlEnabled + self.RegulatingControl = RegulatingControl + + def __str__(self): + str = 'class=RegulatingCondEq\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/RegulatingControl.py b/cimpy/cgmes_v3_0_0/RegulatingControl.py new file mode 100644 index 00000000..c2221c4a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/RegulatingControl.py @@ -0,0 +1,61 @@ +from .PowerSystemResource import PowerSystemResource + + +class RegulatingControl(PowerSystemResource): + ''' + Specifies a set of equipment that works together to control a power system quantity such as voltage or flow. Remote bus voltage control is possible by specifying the controlled terminal located at some place remote from the controlling equipment. The specified terminal shall be associated with the connectivity node of the controlled point. The most specific subtype of RegulatingControl shall be used in case such equipment participate in the control, e.g. TapChangerControl for tap changers. For flow control, load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment. The attribute minAllowedTargetValue and maxAllowedTargetValue are required in the following cases: - For a power generating module operated in power factor control mode to specify maximum and minimum power factor values; - Whenever it is necessary to have an off center target voltage for the tap changer regulator. For instance, due to long cables to off shore wind farms and the need to have a simpler setup at the off shore transformer platform, the voltage is controlled from the land at the connection point for the off shore wind farm. Since there usually is a voltage rise along the cable, there is typical and overvoltage of up 3-4 kV compared to the on shore station. Thus in normal operation the tap changer on the on shore station is operated with a target set point, which is in the lower parts of the dead band. The attributes minAllowedTargetValue and maxAllowedTargetValue are not related to the attribute targetDeadband and thus they are not treated as an alternative of the targetDeadband. They are needed due to limitations in the local substation controller. The attribute targetDeadband is used to prevent the power flow from move the tap position in circles (hunting) that is to be used regardless of the attributes minAllowedTargetValue and maxAllowedTargetValue. + + :discrete: The regulation is performed in a discrete mode. This applies to equipment with discrete controls, e.g. tap changers and shunt compensators. Default: False + :enabled: The flag tells if regulation is enabled. Default: False + :targetDeadband: This is a deadband used with discrete control to avoid excessive update of controls like tap changers and shunt compensator banks while regulating. The units of those appropriate for the mode. The attribute shall be a positive value or zero. If RegulatingControl.discrete is set to `false`, the RegulatingControl.targetDeadband is to be ignored. Note that for instance, if the targetValue is 100 kV and the targetDeadband is 2 kV the range is from 99 to 101 kV. Default: 0.0 + :targetValue: The target value specified for case input. This value can be used for the target value without the use of schedules. The value has the units appropriate to the mode attribute. Default: 0.0 + :targetValueUnitMultiplier: Specify the multiplier for used for the targetValue. Default: None + :maxAllowedTargetValue: Maximum allowed target value (RegulatingControl.targetValue). Default: 0.0 + :minAllowedTargetValue: Minimum allowed target value (RegulatingControl.targetValue). Default: 0.0 + :RegulationSchedule: Schedule for this regulating control. Default: "list" + :RegulatingCondEq: The equipment that participates in this regulating control scheme. Default: "list" + :mode: The regulating control mode presently available. This specification allows for determining the kind of regulation without need for obtaining the units from a schedule. Default: None + :Terminal: The terminal associated with this regulating control. The terminal is associated instead of a node, since the terminal could connect into either a topological node or a connectivity node. Sometimes it is useful to model regulation at a terminal of a bus bar object. Default: None + ''' + + cgmesProfile = PowerSystemResource.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'discrete': [cgmesProfile.SSH.value, ], + 'enabled': [cgmesProfile.SSH.value, ], + 'targetDeadband': [cgmesProfile.SSH.value, ], + 'targetValue': [cgmesProfile.SSH.value, ], + 'targetValueUnitMultiplier': [cgmesProfile.SSH.value, ], + 'maxAllowedTargetValue': [cgmesProfile.SSH.value, ], + 'minAllowedTargetValue': [cgmesProfile.SSH.value, ], + 'RegulationSchedule': [cgmesProfile.EQ.value, ], + 'RegulatingCondEq': [cgmesProfile.EQ.value, ], + 'mode': [cgmesProfile.EQ.value, ], + 'Terminal': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemResource: \n' + PowerSystemResource.__doc__ + + def __init__(self, discrete = False, enabled = False, targetDeadband = 0.0, targetValue = 0.0, targetValueUnitMultiplier = None, maxAllowedTargetValue = 0.0, minAllowedTargetValue = 0.0, RegulationSchedule = "list", RegulatingCondEq = "list", mode = None, Terminal = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.discrete = discrete + self.enabled = enabled + self.targetDeadband = targetDeadband + self.targetValue = targetValue + self.targetValueUnitMultiplier = targetValueUnitMultiplier + self.maxAllowedTargetValue = maxAllowedTargetValue + self.minAllowedTargetValue = minAllowedTargetValue + self.RegulationSchedule = RegulationSchedule + self.RegulatingCondEq = RegulatingCondEq + self.mode = mode + self.Terminal = Terminal + + def __str__(self): + str = 'class=RegulatingControl\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/RegulatingControlModeKind.py b/cimpy/cgmes_v3_0_0/RegulatingControlModeKind.py new file mode 100644 index 00000000..9af4f1cd --- /dev/null +++ b/cimpy/cgmes_v3_0_0/RegulatingControlModeKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class RegulatingControlModeKind(Base): + ''' + The kind of regulation model. For example regulating voltage, reactive power, active power, etc. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=RegulatingControlModeKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/RegulationSchedule.py b/cimpy/cgmes_v3_0_0/RegulationSchedule.py new file mode 100644 index 00000000..0ab30eb7 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/RegulationSchedule.py @@ -0,0 +1,31 @@ +from .SeasonDayTypeSchedule import SeasonDayTypeSchedule + + +class RegulationSchedule(SeasonDayTypeSchedule): + ''' + A pre-established pattern over time for a controlled variable, e.g., busbar voltage. + + :RegulatingControl: Regulating controls that have this schedule. Default: None + ''' + + cgmesProfile = SeasonDayTypeSchedule.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'RegulatingControl': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class SeasonDayTypeSchedule: \n' + SeasonDayTypeSchedule.__doc__ + + def __init__(self, RegulatingControl = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.RegulatingControl = RegulatingControl + + def __str__(self): + str = 'class=RegulationSchedule\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/RemoteInputSignal.py b/cimpy/cgmes_v3_0_0/RemoteInputSignal.py new file mode 100644 index 00000000..bb4bd041 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/RemoteInputSignal.py @@ -0,0 +1,58 @@ +from .IdentifiedObject import IdentifiedObject + + +class RemoteInputSignal(IdentifiedObject): + ''' + Supports connection to a terminal associated with a remote bus from which an input signal of a specific type is coming. + + :Terminal: Remote terminal with which this input signal is associated. Default: None + :remoteSignalType: Type of input signal. Default: None + :DiscontinuousExcitationControlDynamics: Discontinuous excitation control model using this remote input signal. Default: None + :WindTurbineType1or2Dynamics: Wind generator type 1 or type 2 model using this remote input signal. Default: None + :PowerSystemStabilizerDynamics: Power system stabilizer model using this remote input signal. Default: None + :UnderexcitationLimiterDynamics: Underexcitation limiter model using this remote input signal. Default: None + :PFVArControllerType1Dynamics: Power factor or VAr controller type 1 model using this remote input signal. Default: None + :VoltageCompensatorDynamics: Voltage compensator model using this remote input signal. Default: None + :WindPlantDynamics: The wind plant using the remote signal. Default: None + :WindTurbineType3or4Dynamics: Wind turbine type 3 or type 4 models using this remote input signal. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'Terminal': [cgmesProfile.DY.value, ], + 'remoteSignalType': [cgmesProfile.DY.value, ], + 'DiscontinuousExcitationControlDynamics': [cgmesProfile.DY.value, ], + 'WindTurbineType1or2Dynamics': [cgmesProfile.DY.value, ], + 'PowerSystemStabilizerDynamics': [cgmesProfile.DY.value, ], + 'UnderexcitationLimiterDynamics': [cgmesProfile.DY.value, ], + 'PFVArControllerType1Dynamics': [cgmesProfile.DY.value, ], + 'VoltageCompensatorDynamics': [cgmesProfile.DY.value, ], + 'WindPlantDynamics': [cgmesProfile.DY.value, ], + 'WindTurbineType3or4Dynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, Terminal = None, remoteSignalType = None, DiscontinuousExcitationControlDynamics = None, WindTurbineType1or2Dynamics = None, PowerSystemStabilizerDynamics = None, UnderexcitationLimiterDynamics = None, PFVArControllerType1Dynamics = None, VoltageCompensatorDynamics = None, WindPlantDynamics = None, WindTurbineType3or4Dynamics = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Terminal = Terminal + self.remoteSignalType = remoteSignalType + self.DiscontinuousExcitationControlDynamics = DiscontinuousExcitationControlDynamics + self.WindTurbineType1or2Dynamics = WindTurbineType1or2Dynamics + self.PowerSystemStabilizerDynamics = PowerSystemStabilizerDynamics + self.UnderexcitationLimiterDynamics = UnderexcitationLimiterDynamics + self.PFVArControllerType1Dynamics = PFVArControllerType1Dynamics + self.VoltageCompensatorDynamics = VoltageCompensatorDynamics + self.WindPlantDynamics = WindPlantDynamics + self.WindTurbineType3or4Dynamics = WindTurbineType3or4Dynamics + + def __str__(self): + str = 'class=RemoteInputSignal\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/RemoteSignalKind.py b/cimpy/cgmes_v3_0_0/RemoteSignalKind.py new file mode 100644 index 00000000..8e5d229c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/RemoteSignalKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class RemoteSignalKind(Base): + ''' + Type of input signal coming from remote bus. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=RemoteSignalKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ReportingGroup.py b/cimpy/cgmes_v3_0_0/ReportingGroup.py new file mode 100644 index 00000000..a48d014e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ReportingGroup.py @@ -0,0 +1,34 @@ +from .IdentifiedObject import IdentifiedObject + + +class ReportingGroup(IdentifiedObject): + ''' + A reporting group is used for various ad-hoc groupings used for reporting. + + :TopologicalNode: The topological nodes that belong to the reporting group. Default: "list" + :BusNameMarker: The bus name markers that belong to this reporting group. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.TP.value, cgmesProfile.EQ.value, ], + 'TopologicalNode': [cgmesProfile.TP.value, ], + 'BusNameMarker': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, TopologicalNode = "list", BusNameMarker = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.TopologicalNode = TopologicalNode + self.BusNameMarker = BusNameMarker + + def __str__(self): + str = 'class=ReportingGroup\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Resistance.py b/cimpy/cgmes_v3_0_0/Resistance.py new file mode 100644 index 00000000..2ff7420a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Resistance.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class Resistance(Base): + ''' + Resistance (real part of impedance). + + :value: Default: 0.0 + :unit: Default: None + :multiplier: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'value': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'unit': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'multiplier': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, unit = None, multiplier = None, ): + + self.value = value + self.unit = unit + self.multiplier = multiplier + + def __str__(self): + str = 'class=Resistance\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/RotatingMachine.py b/cimpy/cgmes_v3_0_0/RotatingMachine.py new file mode 100644 index 00000000..096be93a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/RotatingMachine.py @@ -0,0 +1,49 @@ +from .RegulatingCondEq import RegulatingCondEq + + +class RotatingMachine(RegulatingCondEq): + ''' + A rotating machine which may be used as a generator or motor. + + :p: Active power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution. Default: 0.0 + :q: Reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution. Default: 0.0 + :GeneratingUnit: A synchronous machine may operate as a generator and as such becomes a member of a generating unit. Default: None + :HydroPump: The synchronous machine drives the turbine which moves the water from a low elevation to a higher elevation. The direction of machine rotation for pumping may or may not be the same as for generating. Default: None + :ratedPowerFactor: Power factor (nameplate data). It is primarily used for short circuit data exchange according to IEC 60909. The attribute cannot be a negative value. Default: 0.0 + :ratedS: Nameplate apparent power rating for the unit. The attribute shall have a positive value. Default: 0.0 + :ratedU: Rated voltage (nameplate data, Ur in IEC 60909-0). It is primarily used for short circuit data exchange according to IEC 60909. The attribute shall be a positive value. Default: 0.0 + ''' + + cgmesProfile = RegulatingCondEq.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'p': [cgmesProfile.SSH.value, ], + 'q': [cgmesProfile.SSH.value, ], + 'GeneratingUnit': [cgmesProfile.EQ.value, ], + 'HydroPump': [cgmesProfile.EQ.value, ], + 'ratedPowerFactor': [cgmesProfile.EQ.value, ], + 'ratedS': [cgmesProfile.EQ.value, ], + 'ratedU': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class RegulatingCondEq: \n' + RegulatingCondEq.__doc__ + + def __init__(self, p = 0.0, q = 0.0, GeneratingUnit = None, HydroPump = None, ratedPowerFactor = 0.0, ratedS = 0.0, ratedU = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.p = p + self.q = q + self.GeneratingUnit = GeneratingUnit + self.HydroPump = HydroPump + self.ratedPowerFactor = ratedPowerFactor + self.ratedS = ratedS + self.ratedU = ratedU + + def __str__(self): + str = 'class=RotatingMachine\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/RotatingMachineDynamics.py b/cimpy/cgmes_v3_0_0/RotatingMachineDynamics.py new file mode 100644 index 00000000..886040d7 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/RotatingMachineDynamics.py @@ -0,0 +1,46 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class RotatingMachineDynamics(DynamicsFunctionBlock): + ''' + Abstract parent class for all synchronous and asynchronous machine standard models. + + :damping: Damping torque coefficient (D) (>= 0). A proportionality constant that, when multiplied by the angular velocity of the rotor poles with respect to the magnetic field (frequency), results in the damping torque. This value is often zero when the sources of damping torques (generator damper windings, load damping effects, etc.) are modelled in detail. Typical value = 0. Default: 0.0 + :inertia: Inertia constant of generator or motor and mechanical load (H) (> 0). This is the specification for the stored energy in the rotating mass when operating at rated speed. For a generator, this includes the generator plus all other elements (turbine, exciter) on the same shaft and has units of MW x s. For a motor, it includes the motor plus its mechanical load. Conventional units are PU on the generator MVA base, usually expressed as MW x s / MVA or just s. This value is used in the accelerating power reference frame for operator training simulator solutions. Typical value = 3. Default: 0 + :saturationFactor: Saturation factor at rated terminal voltage (S1) (>= 0). Not used by simplified model. Defined by defined by S(E1) in the SynchronousMachineSaturationParameters diagram. Typical value = 0,02. Default: 0.0 + :saturationFactor120: Saturation factor at 120% of rated terminal voltage (S12) (>= RotatingMachineDynamics.saturationFactor). Not used by the simplified model, defined by S(E2) in the SynchronousMachineSaturationParameters diagram. Typical value = 0,12. Default: 0.0 + :statorLeakageReactance: Stator leakage reactance (Xl) (>= 0). Typical value = 0,15. Default: 0.0 + :statorResistance: Stator (armature) resistance (Rs) (>= 0). Typical value = 0,005. Default: 0.0 + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'damping': [cgmesProfile.DY.value, ], + 'inertia': [cgmesProfile.DY.value, ], + 'saturationFactor': [cgmesProfile.DY.value, ], + 'saturationFactor120': [cgmesProfile.DY.value, ], + 'statorLeakageReactance': [cgmesProfile.DY.value, ], + 'statorResistance': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, damping = 0.0, inertia = 0, saturationFactor = 0.0, saturationFactor120 = 0.0, statorLeakageReactance = 0.0, statorResistance = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.damping = damping + self.inertia = inertia + self.saturationFactor = saturationFactor + self.saturationFactor120 = saturationFactor120 + self.statorLeakageReactance = statorLeakageReactance + self.statorResistance = statorResistance + + def __str__(self): + str = 'class=RotatingMachineDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/RotationSpeed.py b/cimpy/cgmes_v3_0_0/RotationSpeed.py new file mode 100644 index 00000000..04183149 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/RotationSpeed.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class RotationSpeed(Base): + ''' + Number of revolutions per second. + + :multiplier: Default: None + :unit: Default: None + :value: Default: 0.0 + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'multiplier': [cgmesProfile.EQ.value, ], + 'unit': [cgmesProfile.EQ.value, ], + 'value': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, multiplier = None, unit = None, value = 0.0, ): + + self.multiplier = multiplier + self.unit = unit + self.value = value + + def __str__(self): + str = 'class=RotationSpeed\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/RotorKind.py b/cimpy/cgmes_v3_0_0/RotorKind.py new file mode 100644 index 00000000..9c92393d --- /dev/null +++ b/cimpy/cgmes_v3_0_0/RotorKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class RotorKind(Base): + ''' + Type of rotor on physical machine. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=RotorKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SVCControlMode.py b/cimpy/cgmes_v3_0_0/SVCControlMode.py new file mode 100644 index 00000000..ffa8b5df --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SVCControlMode.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class SVCControlMode(Base): + ''' + Static VAr Compensator control mode. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=SVCControlMode\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SVCUserDefined.py b/cimpy/cgmes_v3_0_0/SVCUserDefined.py new file mode 100644 index 00000000..3bbab36d --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SVCUserDefined.py @@ -0,0 +1,34 @@ +from .StaticVarCompensatorDynamics import StaticVarCompensatorDynamics + + +class SVCUserDefined(StaticVarCompensatorDynamics): + ''' + Static var compensator (SVC) function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = StaticVarCompensatorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class StaticVarCompensatorDynamics: \n' + StaticVarCompensatorDynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=SVCUserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Season.py b/cimpy/cgmes_v3_0_0/Season.py new file mode 100644 index 00000000..e03b449b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Season.py @@ -0,0 +1,37 @@ +from .IdentifiedObject import IdentifiedObject + + +class Season(IdentifiedObject): + ''' + A specified time period of the year. + + :endDate: Date season ends. Default: 0.0 + :startDate: Date season starts. Default: 0.0 + :SeasonDayTypeSchedules: Schedules that use this Season. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'endDate': [cgmesProfile.EQ.value, ], + 'startDate': [cgmesProfile.EQ.value, ], + 'SeasonDayTypeSchedules': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, endDate = 0.0, startDate = 0.0, SeasonDayTypeSchedules = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.endDate = endDate + self.startDate = startDate + self.SeasonDayTypeSchedules = SeasonDayTypeSchedules + + def __str__(self): + str = 'class=Season\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SeasonDayTypeSchedule.py b/cimpy/cgmes_v3_0_0/SeasonDayTypeSchedule.py new file mode 100644 index 00000000..e9e8e28d --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SeasonDayTypeSchedule.py @@ -0,0 +1,34 @@ +from .RegularIntervalSchedule import RegularIntervalSchedule + + +class SeasonDayTypeSchedule(RegularIntervalSchedule): + ''' + A time schedule covering a 24 hour period, with curve data for a specific type of season and day. + + :DayType: DayType for the Schedule. Default: None + :Season: Season for the Schedule. Default: None + ''' + + cgmesProfile = RegularIntervalSchedule.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'DayType': [cgmesProfile.EQ.value, ], + 'Season': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class RegularIntervalSchedule: \n' + RegularIntervalSchedule.__doc__ + + def __init__(self, DayType = None, Season = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.DayType = DayType + self.Season = Season + + def __str__(self): + str = 'class=SeasonDayTypeSchedule\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Seconds.py b/cimpy/cgmes_v3_0_0/Seconds.py new file mode 100644 index 00000000..a11f57d8 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Seconds.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class Seconds(Base): + ''' + Time, in seconds. + + :value: Time, in seconds Default: 0.0 + :unit: Default: None + :multiplier: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.EQ.value, ], + 'value': [cgmesProfile.DY.value, cgmesProfile.EQ.value, ], + 'unit': [cgmesProfile.DY.value, cgmesProfile.EQ.value, ], + 'multiplier': [cgmesProfile.DY.value, cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, unit = None, multiplier = None, ): + + self.value = value + self.unit = unit + self.multiplier = multiplier + + def __str__(self): + str = 'class=Seconds\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Sensor.py b/cimpy/cgmes_v3_0_0/Sensor.py new file mode 100644 index 00000000..0f8568a0 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Sensor.py @@ -0,0 +1,29 @@ +from .AuxiliaryEquipment import AuxiliaryEquipment + + +class Sensor(AuxiliaryEquipment): + ''' + This class describe devices that transform a measured quantity into signals that can be presented at displays, used in control or be recorded. + + ''' + + cgmesProfile = AuxiliaryEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class AuxiliaryEquipment: \n' + AuxiliaryEquipment.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=Sensor\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SeriesCompensator.py b/cimpy/cgmes_v3_0_0/SeriesCompensator.py new file mode 100644 index 00000000..6f7332c6 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SeriesCompensator.py @@ -0,0 +1,49 @@ +from .ConductingEquipment import ConductingEquipment + + +class SeriesCompensator(ConductingEquipment): + ''' + A Series Compensator is a series capacitor or reactor or an AC transmission line without charging susceptance. It is a two terminal device. + + :r: Positive sequence resistance. Default: 0.0 + :x: Positive sequence reactance. Default: 0.0 + :r0: Zero sequence resistance. Default: 0.0 + :x0: Zero sequence reactance. Default: 0.0 + :varistorPresent: Describe if a metal oxide varistor (mov) for over voltage protection is configured in parallel with the series compensator. It is used for short circuit calculations. Default: False + :varistorRatedCurrent: The maximum current the varistor is designed to handle at specified duration. It is used for short circuit calculations and exchanged only if SeriesCompensator.varistorPresent is true. The attribute shall be a positive value. Default: 0.0 + :varistorVoltageThreshold: The dc voltage at which the varistor starts conducting. It is used for short circuit calculations and exchanged only if SeriesCompensator.varistorPresent is true. Default: 0.0 + ''' + + cgmesProfile = ConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'r': [cgmesProfile.EQ.value, ], + 'x': [cgmesProfile.EQ.value, ], + 'r0': [cgmesProfile.SC.value, ], + 'x0': [cgmesProfile.SC.value, ], + 'varistorPresent': [cgmesProfile.SC.value, ], + 'varistorRatedCurrent': [cgmesProfile.SC.value, ], + 'varistorVoltageThreshold': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ConductingEquipment: \n' + ConductingEquipment.__doc__ + + def __init__(self, r = 0.0, x = 0.0, r0 = 0.0, x0 = 0.0, varistorPresent = False, varistorRatedCurrent = 0.0, varistorVoltageThreshold = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.r = r + self.x = x + self.r0 = r0 + self.x0 = x0 + self.varistorPresent = varistorPresent + self.varistorRatedCurrent = varistorRatedCurrent + self.varistorVoltageThreshold = varistorVoltageThreshold + + def __str__(self): + str = 'class=SeriesCompensator\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ServiceLocation.py b/cimpy/cgmes_v3_0_0/ServiceLocation.py new file mode 100644 index 00000000..0bfd6a7a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ServiceLocation.py @@ -0,0 +1,29 @@ +from .WorkLocation import WorkLocation + + +class ServiceLocation(WorkLocation): + ''' + A real estate location, commonly referred to as premises. + + ''' + + cgmesProfile = WorkLocation.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.GL.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class WorkLocation: \n' + WorkLocation.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=ServiceLocation\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SetPoint.py b/cimpy/cgmes_v3_0_0/SetPoint.py new file mode 100644 index 00000000..14f6f41e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SetPoint.py @@ -0,0 +1,34 @@ +from .AnalogControl import AnalogControl + + +class SetPoint(AnalogControl): + ''' + An analog control that issues a set point value. + + :normalValue: Normal value for Control.value e.g. used for percentage scaling. Default: 0.0 + :value: The value representing the actuator output. Default: 0.0 + ''' + + cgmesProfile = AnalogControl.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'normalValue': [cgmesProfile.OP.value, ], + 'value': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class AnalogControl: \n' + AnalogControl.__doc__ + + def __init__(self, normalValue = 0.0, value = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.normalValue = normalValue + self.value = value + + def __str__(self): + str = 'class=SetPoint\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ShortCircuitRotorKind.py b/cimpy/cgmes_v3_0_0/ShortCircuitRotorKind.py new file mode 100644 index 00000000..d8fc847b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ShortCircuitRotorKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class ShortCircuitRotorKind(Base): + ''' + Type of rotor, used by short circuit applications. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=ShortCircuitRotorKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ShuntCompensator.py b/cimpy/cgmes_v3_0_0/ShuntCompensator.py new file mode 100644 index 00000000..30aa0a1b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ShuntCompensator.py @@ -0,0 +1,52 @@ +from .RegulatingCondEq import RegulatingCondEq + + +class ShuntCompensator(RegulatingCondEq): + ''' + A shunt capacitor or reactor or switchable bank of shunt capacitors or reactors. A section of a shunt compensator is an individual capacitor or reactor. A negative value for bPerSection indicates that the compensator is a reactor. ShuntCompensator is a single terminal device. Ground is implied. + + :sections: Shunt compensator sections in use. Starting value for steady state solution. The attribute shall be a positive value or zero. Non integer values are allowed to support continuous variables. The reasons for continuous value are to support study cases where no discrete shunt compensators has yet been designed, a solutions where a narrow voltage band force the sections to oscillate or accommodate for a continuous solution as input. For LinearShuntConpensator the value shall be between zero and ShuntCompensator.maximumSections. At value zero the shunt compensator conductance and admittance is zero. Linear interpolation of conductance and admittance between the previous and next integer section is applied in case of non-integer values. For NonlinearShuntCompensator-s shall only be set to one of the NonlinearShuntCompenstorPoint.sectionNumber. There is no interpolation between NonlinearShuntCompenstorPoint-s. Default: 0.0 + :aVRDelay: An automatic voltage regulation delay (AVRDelay) which is the time delay from a change in voltage to when the capacitor is allowed to change state. This filters out temporary changes in voltage. Default: 0 + :grounded: Used for Yn and Zn connections. True if the neutral is solidly grounded. Default: False + :maximumSections: The maximum number of sections that may be switched in. Default: 0 + :nomU: The voltage at which the nominal reactive power may be calculated. This should normally be within 10% of the voltage at which the capacitor is connected to the network. Default: 0.0 + :normalSections: The normal number of sections switched in. The value shall be between zero and ShuntCompensator.maximumSections. Default: 0 + :voltageSensitivity: Voltage sensitivity required for the device to regulate the bus voltage, in voltage/reactive power. Default: 0.0 + :SvShuntCompensatorSections: The state for the number of shunt compensator sections in service. Default: None + ''' + + cgmesProfile = RegulatingCondEq.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'sections': [cgmesProfile.SSH.value, ], + 'aVRDelay': [cgmesProfile.EQ.value, ], + 'grounded': [cgmesProfile.EQ.value, ], + 'maximumSections': [cgmesProfile.EQ.value, ], + 'nomU': [cgmesProfile.EQ.value, ], + 'normalSections': [cgmesProfile.EQ.value, ], + 'voltageSensitivity': [cgmesProfile.EQ.value, ], + 'SvShuntCompensatorSections': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class RegulatingCondEq: \n' + RegulatingCondEq.__doc__ + + def __init__(self, sections = 0.0, aVRDelay = 0, grounded = False, maximumSections = 0, nomU = 0.0, normalSections = 0, voltageSensitivity = 0.0, SvShuntCompensatorSections = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.sections = sections + self.aVRDelay = aVRDelay + self.grounded = grounded + self.maximumSections = maximumSections + self.nomU = nomU + self.normalSections = normalSections + self.voltageSensitivity = voltageSensitivity + self.SvShuntCompensatorSections = SvShuntCompensatorSections + + def __str__(self): + str = 'class=ShuntCompensator\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SolarGeneratingUnit.py b/cimpy/cgmes_v3_0_0/SolarGeneratingUnit.py new file mode 100644 index 00000000..889a733a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SolarGeneratingUnit.py @@ -0,0 +1,31 @@ +from .GeneratingUnit import GeneratingUnit + + +class SolarGeneratingUnit(GeneratingUnit): + ''' + A solar thermal generating unit, connected to the grid by means of a rotating machine. This class does not represent photovoltaic (PV) generation. + + :SolarPowerPlant: A solar power plant may have solar generating units. Default: None + ''' + + cgmesProfile = GeneratingUnit.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'SolarPowerPlant': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class GeneratingUnit: \n' + GeneratingUnit.__doc__ + + def __init__(self, SolarPowerPlant = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.SolarPowerPlant = SolarPowerPlant + + def __str__(self): + str = 'class=SolarGeneratingUnit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SolarPowerPlant.py b/cimpy/cgmes_v3_0_0/SolarPowerPlant.py new file mode 100644 index 00000000..0559494f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SolarPowerPlant.py @@ -0,0 +1,31 @@ +from .PowerSystemResource import PowerSystemResource + + +class SolarPowerPlant(PowerSystemResource): + ''' + Solar power plant. + + :SolarGeneratingUnits: A solar generating unit or units may be a member of a solar power plant. Default: "list" + ''' + + cgmesProfile = PowerSystemResource.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'SolarGeneratingUnits': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemResource: \n' + PowerSystemResource.__doc__ + + def __init__(self, SolarGeneratingUnits = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.SolarGeneratingUnits = SolarGeneratingUnits + + def __str__(self): + str = 'class=SolarPowerPlant\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Source.py b/cimpy/cgmes_v3_0_0/Source.py new file mode 100644 index 00000000..990fe2d5 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Source.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class Source(Base): + ''' + Source gives information related to the origin of a value. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=Source\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/StaticLoadModelKind.py b/cimpy/cgmes_v3_0_0/StaticLoadModelKind.py new file mode 100644 index 00000000..66cd340d --- /dev/null +++ b/cimpy/cgmes_v3_0_0/StaticLoadModelKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class StaticLoadModelKind(Base): + ''' + Type of static load model. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=StaticLoadModelKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/StaticVarCompensator.py b/cimpy/cgmes_v3_0_0/StaticVarCompensator.py new file mode 100644 index 00000000..1d4e4754 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/StaticVarCompensator.py @@ -0,0 +1,49 @@ +from .RegulatingCondEq import RegulatingCondEq + + +class StaticVarCompensator(RegulatingCondEq): + ''' + A facility for providing variable and controllable shunt reactive power. The SVC typically consists of a stepdown transformer, filter, thyristor-controlled reactor, and thyristor-switched capacitor arms. The SVC may operate in fixed MVar output mode or in voltage control mode. When in voltage control mode, the output of the SVC will be proportional to the deviation of voltage at the controlled bus from the voltage setpoint. The SVC characteristic slope defines the proportion. If the voltage at the controlled bus is equal to the voltage setpoint, the SVC MVar output is zero. + + :StaticVarCompensatorDynamics: Static Var Compensator dynamics model used to describe dynamic behaviour of this Static Var Compensator. Default: None + :q: Reactive power injection. Load sign convention is used, i.e. positive sign means flow out from a node. Starting value for a steady state solution. Default: 0.0 + :capacitiveRating: Capacitive reactance at maximum capacitive reactive power. Shall always be positive. Default: 0.0 + :inductiveRating: Inductive reactance at maximum inductive reactive power. Shall always be negative. Default: 0.0 + :slope: The characteristics slope of an SVC defines how the reactive power output changes in proportion to the difference between the regulated bus voltage and the voltage setpoint. The attribute shall be a positive value or zero. Default: 0.0 + :sVCControlMode: SVC control mode. Default: None + :voltageSetPoint: The reactive power output of the SVC is proportional to the difference between the voltage at the regulated bus and the voltage setpoint. When the regulated bus voltage is equal to the voltage setpoint, the reactive power output is zero. Default: 0.0 + ''' + + cgmesProfile = RegulatingCondEq.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'StaticVarCompensatorDynamics': [cgmesProfile.DY.value, ], + 'q': [cgmesProfile.SSH.value, ], + 'capacitiveRating': [cgmesProfile.EQ.value, ], + 'inductiveRating': [cgmesProfile.EQ.value, ], + 'slope': [cgmesProfile.EQ.value, ], + 'sVCControlMode': [cgmesProfile.EQ.value, ], + 'voltageSetPoint': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class RegulatingCondEq: \n' + RegulatingCondEq.__doc__ + + def __init__(self, StaticVarCompensatorDynamics = None, q = 0.0, capacitiveRating = 0.0, inductiveRating = 0.0, slope = 0.0, sVCControlMode = None, voltageSetPoint = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.StaticVarCompensatorDynamics = StaticVarCompensatorDynamics + self.q = q + self.capacitiveRating = capacitiveRating + self.inductiveRating = inductiveRating + self.slope = slope + self.sVCControlMode = sVCControlMode + self.voltageSetPoint = voltageSetPoint + + def __str__(self): + str = 'class=StaticVarCompensator\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/StaticVarCompensatorDynamics.py b/cimpy/cgmes_v3_0_0/StaticVarCompensatorDynamics.py new file mode 100644 index 00000000..7184f158 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/StaticVarCompensatorDynamics.py @@ -0,0 +1,31 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class StaticVarCompensatorDynamics(DynamicsFunctionBlock): + ''' + Static var compensator whose behaviour is described by reference to a standard model or by definition of a user-defined model. + + :StaticVarCompensator: Static Var Compensator to which Static Var Compensator dynamics model applies. Default: None + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'StaticVarCompensator': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, StaticVarCompensator = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.StaticVarCompensator = StaticVarCompensator + + def __str__(self): + str = 'class=StaticVarCompensatorDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/StationSupply.py b/cimpy/cgmes_v3_0_0/StationSupply.py new file mode 100644 index 00000000..980703e5 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/StationSupply.py @@ -0,0 +1,29 @@ +from .EnergyConsumer import EnergyConsumer + + +class StationSupply(EnergyConsumer): + ''' + Station supply with load derived from the station output. + + ''' + + cgmesProfile = EnergyConsumer.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EnergyConsumer: \n' + EnergyConsumer.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=StationSupply\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Status.py b/cimpy/cgmes_v3_0_0/Status.py new file mode 100644 index 00000000..6fab76b3 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Status.py @@ -0,0 +1,39 @@ +from .Base import Base + + +class Status(Base): + ''' + Current status information relevant to an entity. + + :value: Status value at `dateTime`; prior status changes may have been kept in instances of activity records associated with the object to which this status applies. Default: '' + :dateTime: Date and time for which status `value` applies. Default: '' + :remark: Pertinent information regarding the current `value`, as free form text. Default: '' + :reason: Reason code or explanation for why an object went to the current status `value`. Default: '' + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.GL.value, ], + 'value': [cgmesProfile.GL.value, ], + 'dateTime': [cgmesProfile.GL.value, ], + 'remark': [cgmesProfile.GL.value, ], + 'reason': [cgmesProfile.GL.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = '', dateTime = '', remark = '', reason = '', ): + + self.value = value + self.dateTime = dateTime + self.remark = remark + self.reason = reason + + def __str__(self): + str = 'class=Status\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/StreetAddress.py b/cimpy/cgmes_v3_0_0/StreetAddress.py new file mode 100644 index 00000000..1fac6578 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/StreetAddress.py @@ -0,0 +1,45 @@ +from .Base import Base + + +class StreetAddress(Base): + ''' + General purpose street and postal address information. + + :streetDetail: Street detail. Default: 0.0 + :townDetail: Town detail. Default: 0.0 + :status: Status of this address. Default: 0.0 + :postalCode: Postal code for the address. Default: '' + :poBox: Post office box. Default: '' + :language: The language in which the address is specified, using ISO 639-1 two digit language code. Default: '' + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.GL.value, ], + 'streetDetail': [cgmesProfile.GL.value, ], + 'townDetail': [cgmesProfile.GL.value, ], + 'status': [cgmesProfile.GL.value, ], + 'postalCode': [cgmesProfile.GL.value, ], + 'poBox': [cgmesProfile.GL.value, ], + 'language': [cgmesProfile.GL.value, ], + } + + serializationProfile = {} + + + + def __init__(self, streetDetail = 0.0, townDetail = 0.0, status = 0.0, postalCode = '', poBox = '', language = '', ): + + self.streetDetail = streetDetail + self.townDetail = townDetail + self.status = status + self.postalCode = postalCode + self.poBox = poBox + self.language = language + + def __str__(self): + str = 'class=StreetAddress\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/StreetDetail.py b/cimpy/cgmes_v3_0_0/StreetDetail.py new file mode 100644 index 00000000..5f6cd2da --- /dev/null +++ b/cimpy/cgmes_v3_0_0/StreetDetail.py @@ -0,0 +1,66 @@ +from .Base import Base + + +class StreetDetail(Base): + ''' + Street details, in the context of address. + + :number: Designator of the specific location on the street. Default: '' + :name: Name of the street. Default: '' + :suffix: Suffix to the street name. For example: North, South, East, West. Default: '' + :prefix: Prefix to the street name. For example: North, South, East, West. Default: '' + :type: Type of street. Examples include: street, circle, boulevard, avenue, road, drive, etc. Default: '' + :code: (if applicable) Utilities often make use of external reference systems, such as those of the town-planner`s department or surveyor general`s mapping system, that allocate global reference codes to streets. Default: '' + :buildingName: (if applicable) In certain cases the physical location of the place of interest does not have a direct point of entry from the street, but may be located inside a larger structure such as a building, complex, office block, apartment, etc. Default: '' + :suiteNumber: Number of the apartment or suite. Default: '' + :addressGeneral: First line of a free form address or some additional address information (for example a mail stop). Default: '' + :addressGeneral2: (if applicable) Second line of a free form address. Default: '' + :addressGeneral3: (if applicable) Third line of a free form address. Default: '' + :withinTownLimits: True if this street is within the legal geographical boundaries of the specified town (default). Default: False + :floorIdentification: The identification by name or number, expressed as text, of the floor in the building as part of this address. Default: '' + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.GL.value, ], + 'number': [cgmesProfile.GL.value, ], + 'name': [cgmesProfile.GL.value, ], + 'suffix': [cgmesProfile.GL.value, ], + 'prefix': [cgmesProfile.GL.value, ], + 'type': [cgmesProfile.GL.value, ], + 'code': [cgmesProfile.GL.value, ], + 'buildingName': [cgmesProfile.GL.value, ], + 'suiteNumber': [cgmesProfile.GL.value, ], + 'addressGeneral': [cgmesProfile.GL.value, ], + 'addressGeneral2': [cgmesProfile.GL.value, ], + 'addressGeneral3': [cgmesProfile.GL.value, ], + 'withinTownLimits': [cgmesProfile.GL.value, ], + 'floorIdentification': [cgmesProfile.GL.value, ], + } + + serializationProfile = {} + + + + def __init__(self, number = '', name = '', suffix = '', prefix = '', type = '', code = '', buildingName = '', suiteNumber = '', addressGeneral = '', addressGeneral2 = '', addressGeneral3 = '', withinTownLimits = False, floorIdentification = '', ): + + self.number = number + self.name = name + self.suffix = suffix + self.prefix = prefix + self.type = type + self.code = code + self.buildingName = buildingName + self.suiteNumber = suiteNumber + self.addressGeneral = addressGeneral + self.addressGeneral2 = addressGeneral2 + self.addressGeneral3 = addressGeneral3 + self.withinTownLimits = withinTownLimits + self.floorIdentification = floorIdentification + + def __str__(self): + str = 'class=StreetDetail\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/StringMeasurement.py b/cimpy/cgmes_v3_0_0/StringMeasurement.py new file mode 100644 index 00000000..d198f461 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/StringMeasurement.py @@ -0,0 +1,31 @@ +from .Measurement import Measurement + + +class StringMeasurement(Measurement): + ''' + StringMeasurement represents a measurement with values of type string. + + :StringMeasurementValues: The values connected to this measurement. Default: "list" + ''' + + cgmesProfile = Measurement.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'StringMeasurementValues': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Measurement: \n' + Measurement.__doc__ + + def __init__(self, StringMeasurementValues = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.StringMeasurementValues = StringMeasurementValues + + def __str__(self): + str = 'class=StringMeasurement\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/StringMeasurementValue.py b/cimpy/cgmes_v3_0_0/StringMeasurementValue.py new file mode 100644 index 00000000..2b5d3221 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/StringMeasurementValue.py @@ -0,0 +1,31 @@ +from .MeasurementValue import MeasurementValue + + +class StringMeasurementValue(MeasurementValue): + ''' + StringMeasurementValue represents a measurement value of type string. + + :StringMeasurement: Measurement to which this value is connected. Default: None + ''' + + cgmesProfile = MeasurementValue.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'StringMeasurement': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class MeasurementValue: \n' + MeasurementValue.__doc__ + + def __init__(self, StringMeasurement = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.StringMeasurement = StringMeasurement + + def __str__(self): + str = 'class=StringMeasurementValue\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SubGeographicalRegion.py b/cimpy/cgmes_v3_0_0/SubGeographicalRegion.py new file mode 100644 index 00000000..8a164f8f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SubGeographicalRegion.py @@ -0,0 +1,40 @@ +from .IdentifiedObject import IdentifiedObject + + +class SubGeographicalRegion(IdentifiedObject): + ''' + A subset of a geographical region of a power system network model. + + :DCLines: The DC lines in this sub-geographical region. Default: "list" + :Region: The geographical region which this sub-geographical region is within. Default: None + :Lines: The lines within the sub-geographical region. Default: "list" + :Substations: The substations in this sub-geographical region. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'DCLines': [cgmesProfile.EQ.value, ], + 'Region': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'Lines': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'Substations': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, DCLines = "list", Region = None, Lines = "list", Substations = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.DCLines = DCLines + self.Region = Region + self.Lines = Lines + self.Substations = Substations + + def __str__(self): + str = 'class=SubGeographicalRegion\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SubLoadArea.py b/cimpy/cgmes_v3_0_0/SubLoadArea.py new file mode 100644 index 00000000..4f211e8a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SubLoadArea.py @@ -0,0 +1,34 @@ +from .EnergyArea import EnergyArea + + +class SubLoadArea(EnergyArea): + ''' + The class is the second level in a hierarchical structure for grouping of loads for the purpose of load flow load scaling. + + :LoadArea: The LoadArea where the SubLoadArea belongs. Default: None + :LoadGroups: The Loadgroups in the SubLoadArea. Default: "list" + ''' + + cgmesProfile = EnergyArea.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'LoadArea': [cgmesProfile.EQ.value, ], + 'LoadGroups': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EnergyArea: \n' + EnergyArea.__doc__ + + def __init__(self, LoadArea = None, LoadGroups = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.LoadArea = LoadArea + self.LoadGroups = LoadGroups + + def __str__(self): + str = 'class=SubLoadArea\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Substation.py b/cimpy/cgmes_v3_0_0/Substation.py new file mode 100644 index 00000000..3722bcba --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Substation.py @@ -0,0 +1,37 @@ +from .EquipmentContainer import EquipmentContainer + + +class Substation(EquipmentContainer): + ''' + A collection of equipment for purposes other than generation or utilization, through which electric energy in bulk is passed for the purposes of switching or modifying its characteristics. + + :DCConverterUnit: The DC converter unit belonging of the substation. Default: "list" + :Region: The SubGeographicalRegion containing the substation. Default: None + :VoltageLevels: The voltage levels within this substation. Default: "list" + ''' + + cgmesProfile = EquipmentContainer.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], +# 'DCConverterUnit': [cgmesProfile.EQ.value, ], + 'Region': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], +# 'VoltageLevels': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EquipmentContainer: \n' + EquipmentContainer.__doc__ + + def __init__(self, DCConverterUnit = "list", Region = None, VoltageLevels = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.DCConverterUnit = DCConverterUnit + self.Region = Region + self.VoltageLevels = VoltageLevels + + def __str__(self): + str = 'class=Substation\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SurgeArrester.py b/cimpy/cgmes_v3_0_0/SurgeArrester.py new file mode 100644 index 00000000..19fb5bbb --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SurgeArrester.py @@ -0,0 +1,29 @@ +from .AuxiliaryEquipment import AuxiliaryEquipment + + +class SurgeArrester(AuxiliaryEquipment): + ''' + Shunt device, installed on the network, usually in the proximity of electrical equipment in order to protect the said equipment against transient voltage transients caused by lightning or switching activity. + + ''' + + cgmesProfile = AuxiliaryEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class AuxiliaryEquipment: \n' + AuxiliaryEquipment.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=SurgeArrester\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Susceptance.py b/cimpy/cgmes_v3_0_0/Susceptance.py new file mode 100644 index 00000000..180b1df7 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Susceptance.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class Susceptance(Base): + ''' + Imaginary part of admittance. + + :value: Default: 0.0 + :unit: Default: None + :multiplier: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'value': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'unit': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'multiplier': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, unit = None, multiplier = None, ): + + self.value = value + self.unit = unit + self.multiplier = multiplier + + def __str__(self): + str = 'class=Susceptance\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SvInjection.py b/cimpy/cgmes_v3_0_0/SvInjection.py new file mode 100644 index 00000000..7869314e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SvInjection.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class SvInjection(Base): + ''' + The SvInjection reports the calculated bus injection minus the sum of the terminal flows. The terminal flow is positive out from the bus (load sign convention) and bus injection has positive flow into the bus. SvInjection may have the remainder after state estimation or slack after power flow calculation. + + :pInjection: The active power mismatch between calculated injection and initial injection. Positive sign means injection into the TopologicalNode (bus). Default: 0.0 + :qInjection: The reactive power mismatch between calculated injection and initial injection. Positive sign means injection into the TopologicalNode (bus). Default: 0.0 + :TopologicalNode: The topological node associated with the flow injection state variable. Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SV.value, ], + 'pInjection': [cgmesProfile.SV.value, ], + 'qInjection': [cgmesProfile.SV.value, ], + 'TopologicalNode': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + + + def __init__(self, pInjection = 0.0, qInjection = 0.0, TopologicalNode = None, ): + + self.pInjection = pInjection + self.qInjection = qInjection + self.TopologicalNode = TopologicalNode + + def __str__(self): + str = 'class=SvInjection\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SvPowerFlow.py b/cimpy/cgmes_v3_0_0/SvPowerFlow.py new file mode 100644 index 00000000..66af6422 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SvPowerFlow.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class SvPowerFlow(Base): + ''' + State variable for power flow. Load convention is used for flow direction. This means flow out from the TopologicalNode into the equipment is positive. + + :p: The active power flow. Load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment. Default: 0.0 + :q: The reactive power flow. Load sign convention is used, i.e. positive sign means flow out from a TopologicalNode (bus) into the conducting equipment. Default: 0.0 + :Terminal: The terminal associated with the power flow state variable. Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SV.value, ], + 'p': [cgmesProfile.SV.value, ], + 'q': [cgmesProfile.SV.value, ], + 'Terminal': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + + + def __init__(self, p = 0.0, q = 0.0, Terminal = None, ): + + self.p = p + self.q = q + self.Terminal = Terminal + + def __str__(self): + str = 'class=SvPowerFlow\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SvShuntCompensatorSections.py b/cimpy/cgmes_v3_0_0/SvShuntCompensatorSections.py new file mode 100644 index 00000000..7eff7bed --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SvShuntCompensatorSections.py @@ -0,0 +1,33 @@ +from .Base import Base + + +class SvShuntCompensatorSections(Base): + ''' + State variable for the number of sections in service for a shunt compensator. + + :ShuntCompensator: The shunt compensator for which the state applies. Default: None + :sections: The number of sections in service as a continuous variable. The attribute shall be a positive value or zero. To get integer value scale with ShuntCompensator.bPerSection. Default: 0.0 + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SV.value, ], + 'ShuntCompensator': [cgmesProfile.SV.value, ], + 'sections': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ShuntCompensator = None, sections = 0.0, ): + + self.ShuntCompensator = ShuntCompensator + self.sections = sections + + def __str__(self): + str = 'class=SvShuntCompensatorSections\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SvStatus.py b/cimpy/cgmes_v3_0_0/SvStatus.py new file mode 100644 index 00000000..c64cd58b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SvStatus.py @@ -0,0 +1,33 @@ +from .Base import Base + + +class SvStatus(Base): + ''' + State variable for status. + + :ConductingEquipment: The conducting equipment associated with the status state variable. Default: None + :inService: The in service status as a result of topology processing. It indicates if the equipment is considered as energized by the power flow. It reflects if the equipment is connected within a solvable island. It does not necessarily reflect whether or not the island was solved by the power flow. Default: False + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SV.value, ], + 'ConductingEquipment': [cgmesProfile.SV.value, ], + 'inService': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ConductingEquipment = None, inService = False, ): + + self.ConductingEquipment = ConductingEquipment + self.inService = inService + + def __str__(self): + str = 'class=SvStatus\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SvSwitch.py b/cimpy/cgmes_v3_0_0/SvSwitch.py new file mode 100644 index 00000000..1dd69406 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SvSwitch.py @@ -0,0 +1,33 @@ +from .Base import Base + + +class SvSwitch(Base): + ''' + State variable for switch. + + :open: The attribute tells if the computed state of the switch is considered open. Default: False + :Switch: The switch associated with the switch state. Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SV.value, ], + 'open': [cgmesProfile.SV.value, ], + 'Switch': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + + + def __init__(self, open = False, Switch = None, ): + + self.open = open + self.Switch = Switch + + def __str__(self): + str = 'class=SvSwitch\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SvTapStep.py b/cimpy/cgmes_v3_0_0/SvTapStep.py new file mode 100644 index 00000000..a664bb17 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SvTapStep.py @@ -0,0 +1,33 @@ +from .Base import Base + + +class SvTapStep(Base): + ''' + State variable for transformer tap step. + + :position: The floating point tap position. This is not the tap ratio, but rather the tap step position as defined by the related tap changer model and normally is constrained to be within the range of minimum and maximum tap positions. Default: 0.0 + :TapChanger: The tap changer associated with the tap step state. Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SV.value, ], + 'position': [cgmesProfile.SV.value, ], + 'TapChanger': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + + + def __init__(self, position = 0.0, TapChanger = None, ): + + self.position = position + self.TapChanger = TapChanger + + def __str__(self): + str = 'class=SvTapStep\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SvVoltage.py b/cimpy/cgmes_v3_0_0/SvVoltage.py new file mode 100644 index 00000000..84b9d158 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SvVoltage.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class SvVoltage(Base): + ''' + State variable for voltage. + + :angle: The voltage angle of the topological node complex voltage with respect to system reference. Default: 0.0 + :v: The voltage magnitude at the topological node. The attribute shall be a positive value. Default: 0.0 + :TopologicalNode: The topological node associated with the voltage state. Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SV.value, ], + 'angle': [cgmesProfile.SV.value, ], + 'v': [cgmesProfile.SV.value, ], + 'TopologicalNode': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + + + def __init__(self, angle = 0.0, v = 0.0, TopologicalNode = None, ): + + self.angle = angle + self.v = v + self.TopologicalNode = TopologicalNode + + def __str__(self): + str = 'class=SvVoltage\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Switch.py b/cimpy/cgmes_v3_0_0/Switch.py new file mode 100644 index 00000000..634ede88 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Switch.py @@ -0,0 +1,49 @@ +from .ConductingEquipment import ConductingEquipment + + +class Switch(ConductingEquipment): + ''' + A generic device designed to close, or open, or both, one or more electric circuits. All switches are two terminal devices including grounding switches. The ACDCTerminal.connected at the two sides of the switch shall not be considered for assessing switch connectivity, i.e. only Switch.open, .normalOpen and .locked are relevant. + + :open: The attribute tells if the switch is considered open when used as input to topology processing. Default: False + :locked: If true, the switch is locked. The resulting switch state is a combination of locked and Switch.open attributes as follows: Default: False + :normalOpen: The attribute is used in cases when no Measurement for the status value is present. If the Switch has a status measurement the Discrete.normalValue is expected to match with the Switch.normalOpen. Default: False + :ratedCurrent: The maximum continuous current carrying capacity in amps governed by the device material and construction. The attribute shall be a positive value. Default: 0.0 + :retained: Branch is retained in the topological solution. The flow through retained switches will normally be calculated in power flow. Default: False + :SwitchSchedules: A Switch can be associated with SwitchSchedules. Default: "list" + :SvSwitch: The switch state associated with the switch. Default: "list" + ''' + + cgmesProfile = ConductingEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SV.value, ], + 'open': [cgmesProfile.SSH.value, ], + 'locked': [cgmesProfile.SSH.value, ], + 'normalOpen': [cgmesProfile.EQ.value, ], + 'ratedCurrent': [cgmesProfile.EQ.value, ], + 'retained': [cgmesProfile.EQ.value, ], + 'SwitchSchedules': [cgmesProfile.EQ.value, ], + 'SvSwitch': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ConductingEquipment: \n' + ConductingEquipment.__doc__ + + def __init__(self, open = False, locked = False, normalOpen = False, ratedCurrent = 0.0, retained = False, SwitchSchedules = "list", SvSwitch = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.open = open + self.locked = locked + self.normalOpen = normalOpen + self.ratedCurrent = ratedCurrent + self.retained = retained + self.SwitchSchedules = SwitchSchedules + self.SvSwitch = SvSwitch + + def __str__(self): + str = 'class=Switch\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SwitchSchedule.py b/cimpy/cgmes_v3_0_0/SwitchSchedule.py new file mode 100644 index 00000000..259c0776 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SwitchSchedule.py @@ -0,0 +1,31 @@ +from .SeasonDayTypeSchedule import SeasonDayTypeSchedule + + +class SwitchSchedule(SeasonDayTypeSchedule): + ''' + A schedule of switch positions. If RegularTimePoint.value1 is 0, the switch is open. If 1, the switch is closed. + + :Switch: A SwitchSchedule is associated with a Switch. Default: None + ''' + + cgmesProfile = SeasonDayTypeSchedule.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'Switch': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class SeasonDayTypeSchedule: \n' + SeasonDayTypeSchedule.__doc__ + + def __init__(self, Switch = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Switch = Switch + + def __str__(self): + str = 'class=SwitchSchedule\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SynchronousMachine.py b/cimpy/cgmes_v3_0_0/SynchronousMachine.py new file mode 100644 index 00000000..95d4233f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SynchronousMachine.py @@ -0,0 +1,97 @@ +from .RotatingMachine import RotatingMachine + + +class SynchronousMachine(RotatingMachine): + ''' + An electromechanical device that operates with shaft rotating synchronously with the network. It is a single machine operating either as a generator or synchronous condenser or pump. + + :SynchronousMachineDynamics: Synchronous machine dynamics model used to describe dynamic behaviour of this synchronous machine. Default: None + :operatingMode: Current mode of operation. Default: None + :referencePriority: Priority of unit for use as powerflow voltage phase angle reference bus selection. 0 = don t care (default) 1 = highest priority. 2 is less than 1 and so on. Default: 0 + :InitialReactiveCapabilityCurve: The default reactive capability curve for use by a synchronous machine. Default: None + :maxQ: Maximum reactive power limit. This is the maximum (nameplate) limit for the unit. Default: 0.0 + :minQ: Minimum reactive power limit for the unit. Default: 0.0 + :qPercent: Part of the coordinated reactive control that comes from this machine. The attribute is used as a participation factor not necessarily summing up to 100% for the participating devices in the control. Default: 0.0 + :type: Modes that this synchronous machine can operate in. Default: None + :earthing: Indicates whether or not the generator is earthed. Used for short circuit data exchange according to IEC 60909. Default: False + :earthingStarPointR: Generator star point earthing resistance (Re). Used for short circuit data exchange according to IEC 60909. Default: 0.0 + :earthingStarPointX: Generator star point earthing reactance (Xe). Used for short circuit data exchange according to IEC 60909. Default: 0.0 + :ikk: Steady-state short-circuit current (in A for the profile) of generator with compound excitation during 3-phase short circuit. - Ikk=0: Generator with no compound excitation. - Ikk<>0: Generator with compound excitation. Ikk is used to calculate the minimum steady-state short-circuit current for generators with compound excitation. (4.6.1.2 in IEC 60909-0:2001). Used only for single fed short circuit on a generator. (4.3.4.2. in IEC 60909-0:2001). Default: 0.0 + :mu: Factor to calculate the breaking current (Section 4.5.2.1 in IEC 60909-0). Used only for single fed short circuit on a generator (Section 4.3.4.2. in IEC 60909-0). Default: 0.0 + :x0: Zero sequence reactance of the synchronous machine. Default: 0.0 + :r0: Zero sequence resistance of the synchronous machine. Default: 0.0 + :x2: Negative sequence reactance. Default: 0.0 + :r2: Negative sequence resistance. Default: 0.0 + :r: Equivalent resistance (RG) of generator. RG is considered for the calculation of all currents, except for the calculation of the peak current ip. Used for short circuit data exchange according to IEC 60909. Default: 0.0 + :satDirectSubtransX: Direct-axis subtransient reactance saturated, also known as Xd`sat. Default: 0.0 + :satDirectSyncX: Direct-axes saturated synchronous reactance (xdsat); reciprocal of short-circuit ration. Used for short circuit data exchange, only for single fed short circuit on a generator. (4.3.4.2. in IEC 60909-0:2001). Default: 0.0 + :satDirectTransX: Saturated Direct-axis transient reactance. The attribute is primarily used for short circuit calculations according to ANSI. Default: 0.0 + :shortCircuitRotorType: Type of rotor, used by short circuit applications, only for single fed short circuit according to IEC 60909. Default: None + :voltageRegulationRange: Range of generator voltage regulation (PG in IEC 60909-0) used for calculation of the impedance correction factor KG defined in IEC 60909-0. This attribute is used to describe the operating voltage of the generating unit. Default: 0.0 + ''' + + cgmesProfile = RotatingMachine.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'SynchronousMachineDynamics': [cgmesProfile.DY.value, ], + 'operatingMode': [cgmesProfile.SSH.value, ], + 'referencePriority': [cgmesProfile.SSH.value, ], + 'InitialReactiveCapabilityCurve': [cgmesProfile.EQ.value, ], + 'maxQ': [cgmesProfile.EQ.value, ], + 'minQ': [cgmesProfile.EQ.value, ], + 'qPercent': [cgmesProfile.EQ.value, ], + 'type': [cgmesProfile.EQ.value, ], + 'earthing': [cgmesProfile.SC.value, ], + 'earthingStarPointR': [cgmesProfile.SC.value, ], + 'earthingStarPointX': [cgmesProfile.SC.value, ], + 'ikk': [cgmesProfile.SC.value, ], + 'mu': [cgmesProfile.SC.value, ], + 'x0': [cgmesProfile.SC.value, ], + 'r0': [cgmesProfile.SC.value, ], + 'x2': [cgmesProfile.SC.value, ], + 'r2': [cgmesProfile.SC.value, ], + 'r': [cgmesProfile.SC.value, ], + 'satDirectSubtransX': [cgmesProfile.SC.value, ], + 'satDirectSyncX': [cgmesProfile.SC.value, ], + 'satDirectTransX': [cgmesProfile.SC.value, ], + 'shortCircuitRotorType': [cgmesProfile.SC.value, ], + 'voltageRegulationRange': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class RotatingMachine: \n' + RotatingMachine.__doc__ + + def __init__(self, SynchronousMachineDynamics = None, operatingMode = None, referencePriority = 0, InitialReactiveCapabilityCurve = None, maxQ = 0.0, minQ = 0.0, qPercent = 0.0, type = None, earthing = False, earthingStarPointR = 0.0, earthingStarPointX = 0.0, ikk = 0.0, mu = 0.0, x0 = 0.0, r0 = 0.0, x2 = 0.0, r2 = 0.0, r = 0.0, satDirectSubtransX = 0.0, satDirectSyncX = 0.0, satDirectTransX = 0.0, shortCircuitRotorType = None, voltageRegulationRange = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.SynchronousMachineDynamics = SynchronousMachineDynamics + self.operatingMode = operatingMode + self.referencePriority = referencePriority + self.InitialReactiveCapabilityCurve = InitialReactiveCapabilityCurve + self.maxQ = maxQ + self.minQ = minQ + self.qPercent = qPercent + self.type = type + self.earthing = earthing + self.earthingStarPointR = earthingStarPointR + self.earthingStarPointX = earthingStarPointX + self.ikk = ikk + self.mu = mu + self.x0 = x0 + self.r0 = r0 + self.x2 = x2 + self.r2 = r2 + self.r = r + self.satDirectSubtransX = satDirectSubtransX + self.satDirectSyncX = satDirectSyncX + self.satDirectTransX = satDirectTransX + self.shortCircuitRotorType = shortCircuitRotorType + self.voltageRegulationRange = voltageRegulationRange + + def __str__(self): + str = 'class=SynchronousMachine\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SynchronousMachineDetailed.py b/cimpy/cgmes_v3_0_0/SynchronousMachineDetailed.py new file mode 100644 index 00000000..228e1f4a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SynchronousMachineDetailed.py @@ -0,0 +1,40 @@ +from .SynchronousMachineDynamics import SynchronousMachineDynamics + + +class SynchronousMachineDetailed(SynchronousMachineDynamics): + ''' + All synchronous machine detailed types use a subset of the same data parameters and input/output variables. The several variations differ in the following ways: - the number of equivalent windings that are included; - the way in which saturation is incorporated into the model; - whether or not "subtransient saliency" (X''q not = X''d) is represented. It is not necessary for each simulation tool to have separate models for each of the model types. The same model can often be used for several types by alternative logic within the model. Also, differences in saturation representation might not result in significant model performance differences so model substitutions are often acceptable. + + :saturationFactorQAxis: Quadrature-axis saturation factor at rated terminal voltage (S1q) (>= 0). Typical value = 0,02. Default: 0.0 + :saturationFactor120QAxis: Quadrature-axis saturation factor at 120% of rated terminal voltage (S12q) (>= SynchonousMachineDetailed.saturationFactorQAxis). Typical value = 0,12. Default: 0.0 + :efdBaseRatio: Ratio (exciter voltage/generator voltage) of Efd bases of exciter and generator models (> 0). Typical value = 1. Default: 0.0 + :ifdBaseType: Excitation base system mode. It should be equal to the value of WLMDV given by the user. WLMDV is the PU ratio between the field voltage and the excitation current: Efd = WLMDV x Ifd. Typical value = ifag. Default: None + ''' + + cgmesProfile = SynchronousMachineDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'saturationFactorQAxis': [cgmesProfile.DY.value, ], + 'saturationFactor120QAxis': [cgmesProfile.DY.value, ], + 'efdBaseRatio': [cgmesProfile.DY.value, ], + 'ifdBaseType': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class SynchronousMachineDynamics: \n' + SynchronousMachineDynamics.__doc__ + + def __init__(self, saturationFactorQAxis = 0.0, saturationFactor120QAxis = 0.0, efdBaseRatio = 0.0, ifdBaseType = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.saturationFactorQAxis = saturationFactorQAxis + self.saturationFactor120QAxis = saturationFactor120QAxis + self.efdBaseRatio = efdBaseRatio + self.ifdBaseType = ifdBaseType + + def __str__(self): + str = 'class=SynchronousMachineDetailed\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SynchronousMachineDynamics.py b/cimpy/cgmes_v3_0_0/SynchronousMachineDynamics.py new file mode 100644 index 00000000..83e1fece --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SynchronousMachineDynamics.py @@ -0,0 +1,49 @@ +from .RotatingMachineDynamics import RotatingMachineDynamics + + +class SynchronousMachineDynamics(RotatingMachineDynamics): + ''' + Synchronous machine whose behaviour is described by reference to a standard model expressed in one of the following forms: - simplified (or classical), where a group of generators or motors is not modelled in detail; - detailed, in equivalent circuit form; - detailed, in time constant reactance form; or - by definition of a user-defined model. It is a common practice to represent small generators by a negative load rather than by a dynamic generator model when performing dynamics simulations. In this case, a SynchronousMachine in the static model is not represented by anything in the dynamics model, instead it is treated as an ordinary load. Parameter details:
  1. Synchronous machine parameters such as Xl, Xd, Xp etc. are actually used as inductances in the models, but are commonly referred to as reactances since, at nominal frequency, the PU values are the same. However, some references use the symbol L instead of X.
+ + :SynchronousMachine: Synchronous machine to which synchronous machine dynamics model applies. Default: None + :CrossCompoundTurbineGovernorDyanmics: The cross-compound turbine governor with which this high-pressure synchronous machine is associated. Default: None + :CrossCompoundTurbineGovernorDynamics: The cross-compound turbine governor with which this low-pressure synchronous machine is associated. Default: None + :MechanicalLoadDynamics: Mechanical load model associated with this synchronous machine model. Default: None + :ExcitationSystemDynamics: Excitation system model associated with this synchronous machine model. Default: None + :TurbineGovernorDynamics: Turbine-governor model associated with this synchronous machine model. Multiplicity of greater than one is intended to support hydro units that have multiple turbines on one generator. Default: "list" + :GenICompensationForGenJ: Compensation of voltage compensator`s generator for current flow out of this generator. Default: "list" + ''' + + cgmesProfile = RotatingMachineDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'SynchronousMachine': [cgmesProfile.DY.value, ], + 'CrossCompoundTurbineGovernorDyanmics': [cgmesProfile.DY.value, ], + 'CrossCompoundTurbineGovernorDynamics': [cgmesProfile.DY.value, ], + 'MechanicalLoadDynamics': [cgmesProfile.DY.value, ], + 'ExcitationSystemDynamics': [cgmesProfile.DY.value, ], + 'TurbineGovernorDynamics': [cgmesProfile.DY.value, ], + 'GenICompensationForGenJ': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class RotatingMachineDynamics: \n' + RotatingMachineDynamics.__doc__ + + def __init__(self, SynchronousMachine = None, CrossCompoundTurbineGovernorDyanmics = None, CrossCompoundTurbineGovernorDynamics = None, MechanicalLoadDynamics = None, ExcitationSystemDynamics = None, TurbineGovernorDynamics = "list", GenICompensationForGenJ = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.SynchronousMachine = SynchronousMachine + self.CrossCompoundTurbineGovernorDyanmics = CrossCompoundTurbineGovernorDyanmics + self.CrossCompoundTurbineGovernorDynamics = CrossCompoundTurbineGovernorDynamics + self.MechanicalLoadDynamics = MechanicalLoadDynamics + self.ExcitationSystemDynamics = ExcitationSystemDynamics + self.TurbineGovernorDynamics = TurbineGovernorDynamics + self.GenICompensationForGenJ = GenICompensationForGenJ + + def __str__(self): + str = 'class=SynchronousMachineDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SynchronousMachineEquivalentCircuit.py b/cimpy/cgmes_v3_0_0/SynchronousMachineEquivalentCircuit.py new file mode 100644 index 00000000..2c5f5b77 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SynchronousMachineEquivalentCircuit.py @@ -0,0 +1,61 @@ +from .SynchronousMachineDetailed import SynchronousMachineDetailed + + +class SynchronousMachineEquivalentCircuit(SynchronousMachineDetailed): + ''' + The electrical equations for all variations of the synchronous models are based on the SynchronousEquivalentCircuit diagram for the direct- and quadrature- axes. Equations for conversion between equivalent circuit and time constant reactance forms: Xd = Xad + Xl X'd = Xl + Xad x Xfd / (Xad + Xfd) X"d = Xl + Xad x Xfd x X1d / (Xad x Xfd + Xad x X1d + Xfd x X1d) Xq = Xaq + Xl X'q = Xl + Xaq x X1q / (Xaq + X1q) X"q = Xl + Xaq x X1q x X2q / (Xaq x X1q + Xaq x X2q + X1q x X2q) T'do = (Xad + Xfd) / (omega0 x Rfd) T"do = (Xad x Xfd + Xad x X1d + Xfd x X1d) / (omega0 x R1d x (Xad + Xfd) T'qo = (Xaq + X1q) / (omega0 x R1q) T"qo = (Xaq x X1q + Xaq x X2q + X1q x X2q) / (omega0 x R2q x (Xaq + X1q) Same equations using CIM attributes from SynchronousMachineTimeConstantReactance class on left of "=" and SynchronousMachineEquivalentCircuit class on right (except as noted): xDirectSync = xad + RotatingMachineDynamics.statorLeakageReactance xDirectTrans = RotatingMachineDynamics.statorLeakageReactance + xad x xfd / (xad + xfd) xDirectSubtrans = RotatingMachineDynamics.statorLeakageReactance + xad x xfd x x1d / (xad x xfd + xad x x1d + xfd x x1d) xQuadSync = xaq + RotatingMachineDynamics.statorLeakageReactance xQuadTrans = RotatingMachineDynamics.statorLeakageReactance + xaq x x1q / (xaq+ x1q) xQuadSubtrans = RotatingMachineDynamics.statorLeakageReactance + xaq x x1q x x2q / (xaq x x1q + xaq x x2q + x1q x x2q) tpdo = (xad + xfd) / (2 x pi x nominal frequency x rfd) tppdo = (xad x xfd + xad x x1d + xfd x x1d) / (2 x pi x nominal frequency x r1d x (xad + xfd) tpqo = (xaq + x1q) / (2 x pi x nominal frequency x r1q) tppqo = (xaq x x1q + xaq x x2q + x1q x x2q) / (2 x pi x nominal frequency x r2q x (xaq + x1q) These are only valid for a simplified model where "Canay" reactance is zero. + + :xad: Direct-axis mutual reactance. Default: 0.0 + :rfd: Field winding resistance. Default: 0.0 + :xfd: Field winding leakage reactance. Default: 0.0 + :r1d: Direct-axis damper 1 winding resistance. Default: 0.0 + :x1d: Direct-axis damper 1 winding leakage reactance. Default: 0.0 + :xf1d: Differential mutual (`Canay`) reactance. Default: 0.0 + :xaq: Quadrature-axis mutual reactance. Default: 0.0 + :r1q: Quadrature-axis damper 1 winding resistance. Default: 0.0 + :x1q: Quadrature-axis damper 1 winding leakage reactance. Default: 0.0 + :r2q: Quadrature-axis damper 2 winding resistance. Default: 0.0 + :x2q: Quadrature-axis damper 2 winding leakage reactance. Default: 0.0 + ''' + + cgmesProfile = SynchronousMachineDetailed.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'xad': [cgmesProfile.DY.value, ], + 'rfd': [cgmesProfile.DY.value, ], + 'xfd': [cgmesProfile.DY.value, ], + 'r1d': [cgmesProfile.DY.value, ], + 'x1d': [cgmesProfile.DY.value, ], + 'xf1d': [cgmesProfile.DY.value, ], + 'xaq': [cgmesProfile.DY.value, ], + 'r1q': [cgmesProfile.DY.value, ], + 'x1q': [cgmesProfile.DY.value, ], + 'r2q': [cgmesProfile.DY.value, ], + 'x2q': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class SynchronousMachineDetailed: \n' + SynchronousMachineDetailed.__doc__ + + def __init__(self, xad = 0.0, rfd = 0.0, xfd = 0.0, r1d = 0.0, x1d = 0.0, xf1d = 0.0, xaq = 0.0, r1q = 0.0, x1q = 0.0, r2q = 0.0, x2q = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.xad = xad + self.rfd = rfd + self.xfd = xfd + self.r1d = r1d + self.x1d = x1d + self.xf1d = xf1d + self.xaq = xaq + self.r1q = r1q + self.x1q = x1q + self.r2q = r2q + self.x2q = x2q + + def __str__(self): + str = 'class=SynchronousMachineEquivalentCircuit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SynchronousMachineKind.py b/cimpy/cgmes_v3_0_0/SynchronousMachineKind.py new file mode 100644 index 00000000..bb3b09c0 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SynchronousMachineKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class SynchronousMachineKind(Base): + ''' + Synchronous machine type. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=SynchronousMachineKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SynchronousMachineModelKind.py b/cimpy/cgmes_v3_0_0/SynchronousMachineModelKind.py new file mode 100644 index 00000000..f5de55a6 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SynchronousMachineModelKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class SynchronousMachineModelKind(Base): + ''' + Type of synchronous machine model used in dynamic simulation applications. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=SynchronousMachineModelKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SynchronousMachineOperatingMode.py b/cimpy/cgmes_v3_0_0/SynchronousMachineOperatingMode.py new file mode 100644 index 00000000..bf125a97 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SynchronousMachineOperatingMode.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class SynchronousMachineOperatingMode(Base): + ''' + Synchronous machine operating mode. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=SynchronousMachineOperatingMode\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SynchronousMachineSimplified.py b/cimpy/cgmes_v3_0_0/SynchronousMachineSimplified.py new file mode 100644 index 00000000..d02e31b1 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SynchronousMachineSimplified.py @@ -0,0 +1,29 @@ +from .SynchronousMachineDynamics import SynchronousMachineDynamics + + +class SynchronousMachineSimplified(SynchronousMachineDynamics): + ''' + The simplified model represents a synchronous generator as a constant internal voltage behind an impedance (Rs + jXp) as shown in the Simplified diagram. Since internal voltage is held constant, there is no Efd input and any excitation system model will be ignored. There is also no Ifd output. This model should not be used for representing a real generator except, perhaps, small generators whose response is insignificant. The parameters used for the simplified model include: - RotatingMachineDynamics.damping (D); - RotatingMachineDynamics.inertia (H); - RotatingMachineDynamics.statorLeakageReactance (used to exchange jXp for SynchronousMachineSimplified); - RotatingMachineDynamics.statorResistance (Rs). + + ''' + + cgmesProfile = SynchronousMachineDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class SynchronousMachineDynamics: \n' + SynchronousMachineDynamics.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=SynchronousMachineSimplified\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SynchronousMachineTimeConstantReactance.py b/cimpy/cgmes_v3_0_0/SynchronousMachineTimeConstantReactance.py new file mode 100644 index 00000000..91894a43 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SynchronousMachineTimeConstantReactance.py @@ -0,0 +1,70 @@ +from .SynchronousMachineDetailed import SynchronousMachineDetailed + + +class SynchronousMachineTimeConstantReactance(SynchronousMachineDetailed): + ''' + Synchronous machine detailed modelling types are defined by the combination of the attributes SynchronousMachineTimeConstantReactance.modelType and SynchronousMachineTimeConstantReactance.rotorType. Parameter details:
  1. The "p" in the time-related attribute names is a substitution for a "prime" in the usual parameter notation, e.g. tpdo refers to T'do.
  2. The parameters used for models expressed in time constant reactance form include:
- RotatingMachine.ratedS (MVAbase); - RotatingMachineDynamics.damping (D); - RotatingMachineDynamics.inertia (H); - RotatingMachineDynamics.saturationFactor (S1); - RotatingMachineDynamics.saturationFactor120 (S12); - RotatingMachineDynamics.statorLeakageReactance (Xl); - RotatingMachineDynamics.statorResistance (Rs); - SynchronousMachineTimeConstantReactance.ks (Ks); - SynchronousMachineDetailed.saturationFactorQAxis (S1q); - SynchronousMachineDetailed.saturationFactor120QAxis (S12q); - SynchronousMachineDetailed.efdBaseRatio; - SynchronousMachineDetailed.ifdBaseType; - .xDirectSync (Xd); - .xDirectTrans (X'd); - .xDirectSubtrans (X''d); - .xQuadSync (Xq); - .xQuadTrans (X'q); - .xQuadSubtrans (X''q); - .tpdo (T'do); - .tppdo (T''do); - .tpqo (T'qo); - .tppqo (T''qo); - .tc. + + :rotorType: Type of rotor on physical machine. Default: None + :modelType: Type of synchronous machine model used in dynamic simulation applications. Default: None + :ks: Saturation loading correction factor (Ks) (>= 0). Used only by type J model. Typical value = 0. Default: 0.0 + :xDirectSync: Direct-axis synchronous reactance (Xd) (>= SynchronousMachineTimeConstantReactance.xDirectTrans). The quotient of a sustained value of that AC component of armature voltage that is produced by the total direct-axis flux due to direct-axis armature current and the value of the AC component of this current, the machine running at rated speed. Typical value = 1,8. Default: 0.0 + :xDirectTrans: Direct-axis transient reactance (unsaturated) (X`d) (>= SynchronousMachineTimeConstantReactance.xDirectSubtrans). Typical value = 0,5. Default: 0.0 + :xDirectSubtrans: Direct-axis subtransient reactance (unsaturated) (X``d) (> RotatingMachineDynamics.statorLeakageReactance). Typical value = 0,2. Default: 0.0 + :xQuadSync: Quadrature-axis synchronous reactance (Xq) (>= SynchronousMachineTimeConstantReactance.xQuadTrans). The ratio of the component of reactive armature voltage, due to the quadrature-axis component of armature current, to this component of current, under steady state conditions and at rated frequency. Typical value = 1,6. Default: 0.0 + :xQuadTrans: Quadrature-axis transient reactance (X`q) (>= SynchronousMachineTimeConstantReactance.xQuadSubtrans). Typical value = 0,3. Default: 0.0 + :xQuadSubtrans: Quadrature-axis subtransient reactance (X``q) (> RotatingMachineDynamics.statorLeakageReactance). Typical value = 0,2. Default: 0.0 + :tpdo: Direct-axis transient rotor time constant (T`do) (> SynchronousMachineTimeConstantReactance.tppdo). Typical value = 5. Default: 0 + :tppdo: Direct-axis subtransient rotor time constant (T``do) (> 0). Typical value = 0,03. Default: 0 + :tpqo: Quadrature-axis transient rotor time constant (T`qo) (> SynchronousMachineTimeConstantReactance.tppqo). Typical value = 0,5. Default: 0 + :tppqo: Quadrature-axis subtransient rotor time constant (T``qo) (> 0). Typical value = 0,03. Default: 0 + :tc: Damping time constant for `Canay` reactance (>= 0). Typical value = 0. Default: 0 + ''' + + cgmesProfile = SynchronousMachineDetailed.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'rotorType': [cgmesProfile.DY.value, ], + 'modelType': [cgmesProfile.DY.value, ], + 'ks': [cgmesProfile.DY.value, ], + 'xDirectSync': [cgmesProfile.DY.value, ], + 'xDirectTrans': [cgmesProfile.DY.value, ], + 'xDirectSubtrans': [cgmesProfile.DY.value, ], + 'xQuadSync': [cgmesProfile.DY.value, ], + 'xQuadTrans': [cgmesProfile.DY.value, ], + 'xQuadSubtrans': [cgmesProfile.DY.value, ], + 'tpdo': [cgmesProfile.DY.value, ], + 'tppdo': [cgmesProfile.DY.value, ], + 'tpqo': [cgmesProfile.DY.value, ], + 'tppqo': [cgmesProfile.DY.value, ], + 'tc': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class SynchronousMachineDetailed: \n' + SynchronousMachineDetailed.__doc__ + + def __init__(self, rotorType = None, modelType = None, ks = 0.0, xDirectSync = 0.0, xDirectTrans = 0.0, xDirectSubtrans = 0.0, xQuadSync = 0.0, xQuadTrans = 0.0, xQuadSubtrans = 0.0, tpdo = 0, tppdo = 0, tpqo = 0, tppqo = 0, tc = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.rotorType = rotorType + self.modelType = modelType + self.ks = ks + self.xDirectSync = xDirectSync + self.xDirectTrans = xDirectTrans + self.xDirectSubtrans = xDirectSubtrans + self.xQuadSync = xQuadSync + self.xQuadTrans = xQuadTrans + self.xQuadSubtrans = xQuadSubtrans + self.tpdo = tpdo + self.tppdo = tppdo + self.tpqo = tpqo + self.tppqo = tppqo + self.tc = tc + + def __str__(self): + str = 'class=SynchronousMachineTimeConstantReactance\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/SynchronousMachineUserDefined.py b/cimpy/cgmes_v3_0_0/SynchronousMachineUserDefined.py new file mode 100644 index 00000000..a45eeb7c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/SynchronousMachineUserDefined.py @@ -0,0 +1,34 @@ +from .SynchronousMachineDynamics import SynchronousMachineDynamics + + +class SynchronousMachineUserDefined(SynchronousMachineDynamics): + ''' + Synchronous machine whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = SynchronousMachineDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class SynchronousMachineDynamics: \n' + SynchronousMachineDynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=SynchronousMachineUserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/TapChanger.py b/cimpy/cgmes_v3_0_0/TapChanger.py new file mode 100644 index 00000000..47e865da --- /dev/null +++ b/cimpy/cgmes_v3_0_0/TapChanger.py @@ -0,0 +1,61 @@ +from .PowerSystemResource import PowerSystemResource + + +class TapChanger(PowerSystemResource): + ''' + Mechanism for changing transformer winding tap positions. + + :controlEnabled: Specifies the regulation status of the equipment. True is regulating, false is not regulating. Default: False + :step: Tap changer position. Starting step for a steady state solution. Non integer values are allowed to support continuous tap variables. The reasons for continuous value are to support study cases where no discrete tap changer has yet been designed, a solution where a narrow voltage band forces the tap step to oscillate or to accommodate for a continuous solution as input. The attribute shall be equal to or greater than lowStep and equal to or less than highStep. Default: 0.0 + :TapSchedules: A TapChanger can have TapSchedules. Default: "list" + :highStep: Highest possible tap step position, advance from neutral. The attribute shall be greater than lowStep. Default: 0 + :lowStep: Lowest possible tap step position, retard from neutral. Default: 0 + :ltcFlag: Specifies whether or not a TapChanger has load tap changing capabilities. Default: False + :neutralStep: The neutral tap step position for this winding. The attribute shall be equal to or greater than lowStep and equal or less than highStep. It is the step position where the voltage is neutralU when the other terminals of the transformer are at the ratedU. If there are other tap changers on the transformer those taps are kept constant at their neutralStep. Default: 0 + :neutralU: Voltage at which the winding operates at the neutral tap setting. It is the voltage at the terminal of the PowerTransformerEnd associated with the tap changer when all tap changers on the transformer are at their neutralStep position. Normally neutralU of the tap changer is the same as ratedU of the PowerTransformerEnd, but it can differ in special cases such as when the tapping mechanism is separate from the winding more common on lower voltage transformers. This attribute is not relevant for PhaseTapChangerAsymmetrical, PhaseTapChangerSymmetrical and PhaseTapChangerLinear. Default: 0.0 + :normalStep: The tap step position used in `normal` network operation for this winding. For a `Fixed` tap changer indicates the current physical tap setting. The attribute shall be equal to or greater than lowStep and equal to or less than highStep. Default: 0 + :TapChangerControl: The regulating control scheme in which this tap changer participates. Default: None + :SvTapStep: The tap step state associated with the tap changer. Default: None + ''' + + cgmesProfile = PowerSystemResource.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SV.value, ], + 'controlEnabled': [cgmesProfile.SSH.value, ], + 'step': [cgmesProfile.SSH.value, ], + 'TapSchedules': [cgmesProfile.EQ.value, ], + 'highStep': [cgmesProfile.EQ.value, ], + 'lowStep': [cgmesProfile.EQ.value, ], + 'ltcFlag': [cgmesProfile.EQ.value, ], + 'neutralStep': [cgmesProfile.EQ.value, ], + 'neutralU': [cgmesProfile.EQ.value, ], + 'normalStep': [cgmesProfile.EQ.value, ], + 'TapChangerControl': [cgmesProfile.EQ.value, ], + 'SvTapStep': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemResource: \n' + PowerSystemResource.__doc__ + + def __init__(self, controlEnabled = False, step = 0.0, TapSchedules = "list", highStep = 0, lowStep = 0, ltcFlag = False, neutralStep = 0, neutralU = 0.0, normalStep = 0, TapChangerControl = None, SvTapStep = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.controlEnabled = controlEnabled + self.step = step + self.TapSchedules = TapSchedules + self.highStep = highStep + self.lowStep = lowStep + self.ltcFlag = ltcFlag + self.neutralStep = neutralStep + self.neutralU = neutralU + self.normalStep = normalStep + self.TapChangerControl = TapChangerControl + self.SvTapStep = SvTapStep + + def __str__(self): + str = 'class=TapChanger\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/TapChangerControl.py b/cimpy/cgmes_v3_0_0/TapChangerControl.py new file mode 100644 index 00000000..896f0fa6 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/TapChangerControl.py @@ -0,0 +1,31 @@ +from .RegulatingControl import RegulatingControl + + +class TapChangerControl(RegulatingControl): + ''' + Describes behaviour specific to tap changers, e.g. how the voltage at the end of a line varies with the load level and compensation of the voltage drop by tap adjustment. + + :TapChanger: The tap changers that participates in this regulating tap control scheme. Default: "list" + ''' + + cgmesProfile = RegulatingControl.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'TapChanger': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class RegulatingControl: \n' + RegulatingControl.__doc__ + + def __init__(self, TapChanger = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.TapChanger = TapChanger + + def __str__(self): + str = 'class=TapChangerControl\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/TapChangerTablePoint.py b/cimpy/cgmes_v3_0_0/TapChangerTablePoint.py new file mode 100644 index 00000000..28f4e6de --- /dev/null +++ b/cimpy/cgmes_v3_0_0/TapChangerTablePoint.py @@ -0,0 +1,45 @@ +from .Base import Base + + +class TapChangerTablePoint(Base): + ''' + Describes each tap step in the tabular curve. + + :b: The magnetizing branch susceptance deviation as a percentage of nominal value. The actual susceptance is calculated as follows: calculated magnetizing susceptance = b(nominal) * (1 + b(from this class)/100). The b(nominal) is defined as the static magnetizing susceptance on the associated power transformer end or ends. This model assumes the star impedance (pi model) form. Default: 0.0 + :g: The magnetizing branch conductance deviation as a percentage of nominal value. The actual conductance is calculated as follows: calculated magnetizing conductance = g(nominal) * (1 + g(from this class)/100). The g(nominal) is defined as the static magnetizing conductance on the associated power transformer end or ends. This model assumes the star impedance (pi model) form. Default: 0.0 + :r: The resistance deviation as a percentage of nominal value. The actual reactance is calculated as follows: calculated resistance = r(nominal) * (1 + r(from this class)/100). The r(nominal) is defined as the static resistance on the associated power transformer end or ends. This model assumes the star impedance (pi model) form. Default: 0.0 + :ratio: The voltage at the tap step divided by rated voltage of the transformer end having the tap changer. Hence this is a value close to one. For example, if the ratio at step 1 is 1.01, and the rated voltage of the transformer end is 110kV, then the voltage obtained by setting the tap changer to step 1 to is 111.1kV. Default: 0.0 + :step: The tap step. Default: 0 + :x: The series reactance deviation as a percentage of nominal value. The actual reactance is calculated as follows: calculated reactance = x(nominal) * (1 + x(from this class)/100). The x(nominal) is defined as the static series reactance on the associated power transformer end or ends. This model assumes the star impedance (pi model) form. Default: 0.0 + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'b': [cgmesProfile.EQ.value, ], + 'g': [cgmesProfile.EQ.value, ], + 'r': [cgmesProfile.EQ.value, ], + 'ratio': [cgmesProfile.EQ.value, ], + 'step': [cgmesProfile.EQ.value, ], + 'x': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, b = 0.0, g = 0.0, r = 0.0, ratio = 0.0, step = 0, x = 0.0, ): + + self.b = b + self.g = g + self.r = r + self.ratio = ratio + self.step = step + self.x = x + + def __str__(self): + str = 'class=TapChangerTablePoint\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/TapSchedule.py b/cimpy/cgmes_v3_0_0/TapSchedule.py new file mode 100644 index 00000000..43162e72 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/TapSchedule.py @@ -0,0 +1,31 @@ +from .SeasonDayTypeSchedule import SeasonDayTypeSchedule + + +class TapSchedule(SeasonDayTypeSchedule): + ''' + A pre-established pattern over time for a tap step. + + :TapChanger: A TapSchedule is associated with a TapChanger. Default: None + ''' + + cgmesProfile = SeasonDayTypeSchedule.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'TapChanger': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class SeasonDayTypeSchedule: \n' + SeasonDayTypeSchedule.__doc__ + + def __init__(self, TapChanger = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.TapChanger = TapChanger + + def __str__(self): + str = 'class=TapSchedule\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Temperature.py b/cimpy/cgmes_v3_0_0/Temperature.py new file mode 100644 index 00000000..e5502839 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Temperature.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class Temperature(Base): + ''' + Value of temperature in degrees Celsius. + + :multiplier: Default: None + :unit: Default: None + :value: Default: 0.0 + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SC.value, ], + 'multiplier': [cgmesProfile.DY.value, cgmesProfile.SC.value, ], + 'unit': [cgmesProfile.DY.value, cgmesProfile.SC.value, ], + 'value': [cgmesProfile.DY.value, cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + + + def __init__(self, multiplier = None, unit = None, value = 0.0, ): + + self.multiplier = multiplier + self.unit = unit + self.value = value + + def __str__(self): + str = 'class=Temperature\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Terminal.py b/cimpy/cgmes_v3_0_0/Terminal.py new file mode 100644 index 00000000..227f0d70 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Terminal.py @@ -0,0 +1,67 @@ +from .ACDCTerminal import ACDCTerminal + + +class Terminal(ACDCTerminal): + ''' + An AC electrical connection point to a piece of conducting equipment. Terminals are connected at physical connection points called connectivity nodes. + + :ConductingEquipment: The conducting equipment of the terminal. Conducting equipment have terminals that may be connected to other conducting equipment terminals via connectivity nodes or topological nodes. Default: None + :RemoteInputSignal: Input signal coming from this terminal. Default: "list" + :TopologicalNode: The topological node associated with the terminal. This can be used as an alternative to the connectivity node path to topological node, thus making it unnecessary to model connectivity nodes in some cases. Note that the if connectivity nodes are in the model, this association would probably not be used as an input specification. Default: None + :ConverterDCSides: All converters` DC sides linked to this point of common coupling terminal. Default: "list" + :AuxiliaryEquipment: The auxiliary equipment connected to the terminal. Default: "list" + :ConnectivityNode: The connectivity node to which this terminal connects with zero impedance. Default: None + :RegulatingControl: The controls regulating this terminal. Default: "list" + :phases: Represents the normal network phasing condition. If the attribute is missing, three phases (ABC) shall be assumed, except for terminals of grounding classes (specializations of EarthFaultCompensator, GroundDisconnector, and Ground) which will be assumed to be N. Therefore, phase code ABCN is explicitly declared when needed, e.g. for star point grounding equipment. The phase code on terminals connecting same ConnectivityNode or same TopologicalNode as well as for equipment between two terminals shall be consistent. Default: None + :TransformerEnd: All transformer ends connected at this terminal. Default: "list" + :TieFlow: The control area tie flows to which this terminal associates. Default: "list" + :HasSecondMutualCoupling: Mutual couplings with the branch associated as the first branch. Default: "list" + :HasFirstMutualCoupling: Mutual couplings associated with the branch as the first branch. Default: "list" + :SvPowerFlow: The power flow state variable associated with the terminal. Default: None + ''' + + cgmesProfile = ACDCTerminal.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.TP.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'ConductingEquipment': [cgmesProfile.DY.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'RemoteInputSignal': [cgmesProfile.DY.value, ], + 'TopologicalNode': [cgmesProfile.TP.value, ], + 'ConverterDCSides': [cgmesProfile.EQ.value, ], + 'AuxiliaryEquipment': [cgmesProfile.EQ.value, ], + 'ConnectivityNode': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'RegulatingControl': [cgmesProfile.EQ.value, ], + 'phases': [cgmesProfile.EQ.value, ], + 'TransformerEnd': [cgmesProfile.EQ.value, ], + 'TieFlow': [cgmesProfile.EQ.value, ], + 'HasSecondMutualCoupling': [cgmesProfile.SC.value, ], + 'HasFirstMutualCoupling': [cgmesProfile.SC.value, ], + 'SvPowerFlow': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ACDCTerminal: \n' + ACDCTerminal.__doc__ + + def __init__(self, ConductingEquipment = None, RemoteInputSignal = "list", TopologicalNode = None, ConverterDCSides = "list", AuxiliaryEquipment = "list", ConnectivityNode = None, RegulatingControl = "list", phases = None, TransformerEnd = "list", TieFlow = "list", HasSecondMutualCoupling = "list", HasFirstMutualCoupling = "list", SvPowerFlow = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ConductingEquipment = ConductingEquipment + self.RemoteInputSignal = RemoteInputSignal + self.TopologicalNode = TopologicalNode + self.ConverterDCSides = ConverterDCSides + self.AuxiliaryEquipment = AuxiliaryEquipment + self.ConnectivityNode = ConnectivityNode + self.RegulatingControl = RegulatingControl + self.phases = phases + self.TransformerEnd = TransformerEnd + self.TieFlow = TieFlow + self.HasSecondMutualCoupling = HasSecondMutualCoupling + self.HasFirstMutualCoupling = HasFirstMutualCoupling + self.SvPowerFlow = SvPowerFlow + + def __str__(self): + str = 'class=Terminal\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/TextDiagramObject.py b/cimpy/cgmes_v3_0_0/TextDiagramObject.py new file mode 100644 index 00000000..af268ac1 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/TextDiagramObject.py @@ -0,0 +1,31 @@ +from .DiagramObject import DiagramObject + + +class TextDiagramObject(DiagramObject): + ''' + A diagram object for placing free-text or text derived from an associated domain object. + + :text: The text that is displayed by this text diagram object. Default: '' + ''' + + cgmesProfile = DiagramObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DL.value, ], + 'text': [cgmesProfile.DL.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DiagramObject: \n' + DiagramObject.__doc__ + + def __init__(self, text = '', *args, **kw_args): + super().__init__(*args, **kw_args) + + self.text = text + + def __str__(self): + str = 'class=TextDiagramObject\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ThermalGeneratingUnit.py b/cimpy/cgmes_v3_0_0/ThermalGeneratingUnit.py new file mode 100644 index 00000000..5a7aca11 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ThermalGeneratingUnit.py @@ -0,0 +1,40 @@ +from .GeneratingUnit import GeneratingUnit + + +class ThermalGeneratingUnit(GeneratingUnit): + ''' + A generating unit whose prime mover could be a steam turbine, combustion turbine, or diesel engine. + + :CAESPlant: A thermal generating unit may be a member of a compressed air energy storage plant. Default: None + :CogenerationPlant: A thermal generating unit may be a member of a cogeneration plant. Default: None + :CombinedCyclePlant: A thermal generating unit may be a member of a combined cycle plant. Default: None + :FossilFuels: A thermal generating unit may have one or more fossil fuels. Default: "list" + ''' + + cgmesProfile = GeneratingUnit.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'CAESPlant': [cgmesProfile.EQ.value, ], + 'CogenerationPlant': [cgmesProfile.EQ.value, ], + 'CombinedCyclePlant': [cgmesProfile.EQ.value, ], + 'FossilFuels': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class GeneratingUnit: \n' + GeneratingUnit.__doc__ + + def __init__(self, CAESPlant = None, CogenerationPlant = None, CombinedCyclePlant = None, FossilFuels = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.CAESPlant = CAESPlant + self.CogenerationPlant = CogenerationPlant + self.CombinedCyclePlant = CombinedCyclePlant + self.FossilFuels = FossilFuels + + def __str__(self): + str = 'class=ThermalGeneratingUnit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/TieFlow.py b/cimpy/cgmes_v3_0_0/TieFlow.py new file mode 100644 index 00000000..8a6e1915 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/TieFlow.py @@ -0,0 +1,37 @@ +from .IdentifiedObject import IdentifiedObject + + +class TieFlow(IdentifiedObject): + ''' + Defines the structure (in terms of location and direction) of the net interchange constraint for a control area. This constraint may be used by either AGC or power flow. + + :ControlArea: The control area of the tie flows. Default: None + :Terminal: The terminal to which this tie flow belongs. Default: None + :positiveFlowIn: Specifies the sign of the tie flow associated with a control area. True if positive flow into the terminal (load convention) is also positive flow into the control area. See the description of ControlArea for further explanation of how TieFlow.positiveFlowIn is used. Default: False + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'ControlArea': [cgmesProfile.EQ.value, ], + 'Terminal': [cgmesProfile.EQ.value, ], + 'positiveFlowIn': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, ControlArea = None, Terminal = None, positiveFlowIn = False, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ControlArea = ControlArea + self.Terminal = Terminal + self.positiveFlowIn = positiveFlowIn + + def __str__(self): + str = 'class=TieFlow\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/TopologicalIsland.py b/cimpy/cgmes_v3_0_0/TopologicalIsland.py new file mode 100644 index 00000000..d36ff5b3 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/TopologicalIsland.py @@ -0,0 +1,34 @@ +from .IdentifiedObject import IdentifiedObject + + +class TopologicalIsland(IdentifiedObject): + ''' + An electrically connected subset of the network. Topological islands can change as the current network state changes, e.g. due to: - disconnect switches or breakers changing state in a SCADA/EMS. - manual creation, change or deletion of topological nodes in a planning tool. Only energised TopologicalNode-s shall be part of the topological island. + + :AngleRefTopologicalNode: The angle reference for the island. Normally there is one TopologicalNode that is selected as the angle reference for each island. Other reference schemes exist, so the association is typically optional. Default: None + :TopologicalNodes: A topological node belongs to a topological island. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SV.value, ], + 'AngleRefTopologicalNode': [cgmesProfile.SV.value, ], + 'TopologicalNodes': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, AngleRefTopologicalNode = None, TopologicalNodes = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.AngleRefTopologicalNode = AngleRefTopologicalNode + self.TopologicalNodes = TopologicalNodes + + def __str__(self): + str = 'class=TopologicalIsland\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/TopologicalNode.py b/cimpy/cgmes_v3_0_0/TopologicalNode.py new file mode 100644 index 00000000..8a619141 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/TopologicalNode.py @@ -0,0 +1,55 @@ +from .IdentifiedObject import IdentifiedObject + + +class TopologicalNode(IdentifiedObject): + ''' + For a detailed substation model a topological node is a set of connectivity nodes that, in the current network state, are connected together through any type of closed switches, including jumpers. Topological nodes change as the current network state changes (i.e., switches, breakers, etc. change state). For a planning model, switch statuses are not used to form topological nodes. Instead they are manually created or deleted in a model builder tool. Topological nodes maintained this way are also called "busses". + + :BaseVoltage: The base voltage of the topological node. Default: None + :ConnectivityNodes: The connectivity nodes combine together to form this topological node. May depend on the current state of switches in the network. Default: "list" + :ConnectivityNodeContainer: The connectivity node container to which the topological node belongs. Default: None + :Terminal: The terminals associated with the topological node. This can be used as an alternative to the connectivity node path to terminal, thus making it unnecessary to model connectivity nodes in some cases. Note that if connectivity nodes are in the model, this association would probably not be used as an input specification. Default: "list" + :ReportingGroup: The reporting group to which the topological node belongs. Default: None + :SvInjection: The injection flows state variables associated with the topological node. Default: None + :SvVoltage: The state voltage associated with the topological node. Default: None + :AngleRefTopologicalIsland: The island for which the node is an angle reference. Normally there is one angle reference node for each island. Default: None + :TopologicalIsland: A topological node belongs to a topological island. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.TP.value, cgmesProfile.SV.value, ], + 'BaseVoltage': [cgmesProfile.TP.value, ], + 'ConnectivityNodes': [cgmesProfile.TP.value, ], + 'ConnectivityNodeContainer': [cgmesProfile.TP.value, ], + 'Terminal': [cgmesProfile.TP.value, ], + 'ReportingGroup': [cgmesProfile.TP.value, ], + 'SvInjection': [cgmesProfile.SV.value, ], + 'SvVoltage': [cgmesProfile.SV.value, ], + 'AngleRefTopologicalIsland': [cgmesProfile.SV.value, ], + 'TopologicalIsland': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, BaseVoltage = None, ConnectivityNodes = "list", ConnectivityNodeContainer = None, Terminal = "list", ReportingGroup = None, SvInjection = None, SvVoltage = None, AngleRefTopologicalIsland = None, TopologicalIsland = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.BaseVoltage = BaseVoltage + self.ConnectivityNodes = ConnectivityNodes + self.ConnectivityNodeContainer = ConnectivityNodeContainer + self.Terminal = Terminal + self.ReportingGroup = ReportingGroup + self.SvInjection = SvInjection + self.SvVoltage = SvVoltage + self.AngleRefTopologicalIsland = AngleRefTopologicalIsland + self.TopologicalIsland = TopologicalIsland + + def __str__(self): + str = 'class=TopologicalNode\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/TownDetail.py b/cimpy/cgmes_v3_0_0/TownDetail.py new file mode 100644 index 00000000..0697077a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/TownDetail.py @@ -0,0 +1,42 @@ +from .Base import Base + + +class TownDetail(Base): + ''' + Town details, in the context of address. + + :code: Town code. Default: '' + :section: Town section. For example, it is common for there to be 36 sections per township. Default: '' + :name: Town name. Default: '' + :stateOrProvince: Name of the state or province. Default: '' + :country: Name of the country. Default: '' + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.GL.value, ], + 'code': [cgmesProfile.GL.value, ], + 'section': [cgmesProfile.GL.value, ], + 'name': [cgmesProfile.GL.value, ], + 'stateOrProvince': [cgmesProfile.GL.value, ], + 'country': [cgmesProfile.GL.value, ], + } + + serializationProfile = {} + + + + def __init__(self, code = '', section = '', name = '', stateOrProvince = '', country = '', ): + + self.code = code + self.section = section + self.name = name + self.stateOrProvince = stateOrProvince + self.country = country + + def __str__(self): + str = 'class=TownDetail\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/TransformerEnd.py b/cimpy/cgmes_v3_0_0/TransformerEnd.py new file mode 100644 index 00000000..094921a2 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/TransformerEnd.py @@ -0,0 +1,52 @@ +from .IdentifiedObject import IdentifiedObject + + +class TransformerEnd(IdentifiedObject): + ''' + A conducting connection point of a power transformer. It corresponds to a physical transformer winding terminal. In earlier CIM versions, the TransformerWinding class served a similar purpose, but this class is more flexible because it associates to terminal but is not a specialization of ConductingEquipment. + + :BaseVoltage: Base voltage of the transformer end. This is essential for PU calculation. Default: None + :PhaseTapChanger: Phase tap changer associated with this transformer end. Default: None + :RatioTapChanger: Ratio tap changer associated with this transformer end. Default: None + :Terminal: Terminal of the power transformer to which this transformer end belongs. Default: None + :endNumber: Number for this transformer end, corresponding to the end`s order in the power transformer vector group or phase angle clock number. Highest voltage winding should be 1. Each end within a power transformer should have a unique subsequent end number. Note the transformer end number need not match the terminal sequence number. Default: 0 + :rground: (for Yn and Zn connections) Resistance part of neutral impedance where `grounded` is true. Default: 0.0 + :grounded: (for Yn and Zn connections) True if the neutral is solidly grounded. Default: False + :xground: (for Yn and Zn connections) Reactive part of neutral impedance where `grounded` is true. Default: 0.0 + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.SC.value, ], + 'BaseVoltage': [cgmesProfile.EQ.value, ], + 'PhaseTapChanger': [cgmesProfile.EQ.value, ], + 'RatioTapChanger': [cgmesProfile.EQ.value, ], + 'Terminal': [cgmesProfile.EQ.value, ], + 'endNumber': [cgmesProfile.EQ.value, ], + 'rground': [cgmesProfile.SC.value, ], + 'grounded': [cgmesProfile.SC.value, ], + 'xground': [cgmesProfile.SC.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, BaseVoltage = None, PhaseTapChanger = None, RatioTapChanger = None, Terminal = None, endNumber = 0, rground = 0.0, grounded = False, xground = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.BaseVoltage = BaseVoltage + self.PhaseTapChanger = PhaseTapChanger + self.RatioTapChanger = RatioTapChanger + self.Terminal = Terminal + self.endNumber = endNumber + self.rground = rground + self.grounded = grounded + self.xground = xground + + def __str__(self): + str = 'class=TransformerEnd\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/TurbLCFB1.py b/cimpy/cgmes_v3_0_0/TurbLCFB1.py new file mode 100644 index 00000000..c2e4651e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/TurbLCFB1.py @@ -0,0 +1,64 @@ +from .TurbineLoadControllerDynamics import TurbineLoadControllerDynamics + + +class TurbLCFB1(TurbineLoadControllerDynamics): + ''' + Turbine load controller model developed by WECC. This model represents a supervisory turbine load controller that acts to maintain turbine power at a set value by continuous adjustment of the turbine governor speed-load reference. This model is intended to represent slow reset 'outer loop' controllers managing the action of the turbine governor. + + :mwbase: Base for power values (MWbase) (> 0). Unit = MW. Default: 0.0 + :speedReferenceGovernor: Type of turbine governor reference (Type). true = speed reference governor false = load reference governor. Typical value = true. Default: False + :db: Controller deadband (db). Typical value = 0. Default: 0.0 + :emax: Maximum control error (Emax) (see parameter detail 4). Typical value = 0,02. Default: 0.0 + :fb: Frequency bias gain (Fb). Typical value = 0. Default: 0.0 + :kp: Proportional gain (Kp). Typical value = 0. Default: 0.0 + :ki: Integral gain (Ki). Typical value = 0. Default: 0.0 + :fbf: Frequency bias flag (Fbf). true = enable frequency bias false = disable frequency bias. Typical value = false. Default: False + :pbf: Power controller flag (Pbf). true = enable load controller false = disable load controller. Typical value = false. Default: False + :tpelec: Power transducer time constant (Tpelec) (>= 0). Typical value = 0. Default: 0 + :irmax: Maximum turbine speed/load reference bias (Irmax) (see parameter detail 3). Typical value = 0. Default: 0.0 + :pmwset: Power controller setpoint (Pmwset) (see parameter detail 1). Unit = MW. Typical value = 0. Default: 0.0 + ''' + + cgmesProfile = TurbineLoadControllerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'mwbase': [cgmesProfile.DY.value, ], + 'speedReferenceGovernor': [cgmesProfile.DY.value, ], + 'db': [cgmesProfile.DY.value, ], + 'emax': [cgmesProfile.DY.value, ], + 'fb': [cgmesProfile.DY.value, ], + 'kp': [cgmesProfile.DY.value, ], + 'ki': [cgmesProfile.DY.value, ], + 'fbf': [cgmesProfile.DY.value, ], + 'pbf': [cgmesProfile.DY.value, ], + 'tpelec': [cgmesProfile.DY.value, ], + 'irmax': [cgmesProfile.DY.value, ], + 'pmwset': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineLoadControllerDynamics: \n' + TurbineLoadControllerDynamics.__doc__ + + def __init__(self, mwbase = 0.0, speedReferenceGovernor = False, db = 0.0, emax = 0.0, fb = 0.0, kp = 0.0, ki = 0.0, fbf = False, pbf = False, tpelec = 0, irmax = 0.0, pmwset = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.mwbase = mwbase + self.speedReferenceGovernor = speedReferenceGovernor + self.db = db + self.emax = emax + self.fb = fb + self.kp = kp + self.ki = ki + self.fbf = fbf + self.pbf = pbf + self.tpelec = tpelec + self.irmax = irmax + self.pmwset = pmwset + + def __str__(self): + str = 'class=TurbLCFB1\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/TurbineGovernorDynamics.py b/cimpy/cgmes_v3_0_0/TurbineGovernorDynamics.py new file mode 100644 index 00000000..67e1a039 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/TurbineGovernorDynamics.py @@ -0,0 +1,37 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class TurbineGovernorDynamics(DynamicsFunctionBlock): + ''' + Turbine-governor function block whose behaviour is described by reference to a standard model or by definition of a user-defined model. + + :SynchronousMachineDynamics: Synchronous machine model with which this turbine-governor model is associated. TurbineGovernorDynamics shall have either an association to SynchronousMachineDynamics or to AsynchronousMachineDynamics. Default: None + :AsynchronousMachineDynamics: Asynchronous machine model with which this turbine-governor model is associated. TurbineGovernorDynamics shall have either an association to SynchronousMachineDynamics or to AsynchronousMachineDynamics. Default: None + :TurbineLoadControllerDynamics: Turbine load controller providing input to this turbine-governor. Default: None + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'SynchronousMachineDynamics': [cgmesProfile.DY.value, ], + 'AsynchronousMachineDynamics': [cgmesProfile.DY.value, ], + 'TurbineLoadControllerDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, SynchronousMachineDynamics = None, AsynchronousMachineDynamics = None, TurbineLoadControllerDynamics = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.SynchronousMachineDynamics = SynchronousMachineDynamics + self.AsynchronousMachineDynamics = AsynchronousMachineDynamics + self.TurbineLoadControllerDynamics = TurbineLoadControllerDynamics + + def __str__(self): + str = 'class=TurbineGovernorDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/TurbineGovernorUserDefined.py b/cimpy/cgmes_v3_0_0/TurbineGovernorUserDefined.py new file mode 100644 index 00000000..b055be11 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/TurbineGovernorUserDefined.py @@ -0,0 +1,34 @@ +from .TurbineGovernorDynamics import TurbineGovernorDynamics + + +class TurbineGovernorUserDefined(TurbineGovernorDynamics): + ''' + Turbine-governor function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = TurbineGovernorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineGovernorDynamics: \n' + TurbineGovernorDynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=TurbineGovernorUserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/TurbineLoadControllerDynamics.py b/cimpy/cgmes_v3_0_0/TurbineLoadControllerDynamics.py new file mode 100644 index 00000000..6826b214 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/TurbineLoadControllerDynamics.py @@ -0,0 +1,31 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class TurbineLoadControllerDynamics(DynamicsFunctionBlock): + ''' + Turbine load controller function block whose behaviour is described by reference to a standard model or by definition of a user-defined model. + + :TurbineGovernorDynamics: Turbine-governor controlled by this turbine load controller. Default: None + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'TurbineGovernorDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, TurbineGovernorDynamics = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.TurbineGovernorDynamics = TurbineGovernorDynamics + + def __str__(self): + str = 'class=TurbineLoadControllerDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/TurbineLoadControllerUserDefined.py b/cimpy/cgmes_v3_0_0/TurbineLoadControllerUserDefined.py new file mode 100644 index 00000000..af2d4114 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/TurbineLoadControllerUserDefined.py @@ -0,0 +1,34 @@ +from .TurbineLoadControllerDynamics import TurbineLoadControllerDynamics + + +class TurbineLoadControllerUserDefined(TurbineLoadControllerDynamics): + ''' + Turbine load controller function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = TurbineLoadControllerDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class TurbineLoadControllerDynamics: \n' + TurbineLoadControllerDynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=TurbineLoadControllerUserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/UnderexcLim2Simplified.py b/cimpy/cgmes_v3_0_0/UnderexcLim2Simplified.py new file mode 100644 index 00000000..e7da9751 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/UnderexcLim2Simplified.py @@ -0,0 +1,49 @@ +from .UnderexcitationLimiterDynamics import UnderexcitationLimiterDynamics + + +class UnderexcLim2Simplified(UnderexcitationLimiterDynamics): + ''' + Simplified type UEL2 underexcitation limiter. This model can be derived from UnderexcLimIEEE2. The limit characteristic (look -up table) is a single straight-line, the same as UnderexcLimIEEE2 (see Figure 10.4 (p 32), IEEE 421.5-2005 Section 10.2). + + :q0: Segment Q initial point (Q0). Typical value = -0,31. Default: 0.0 + :q1: Segment Q end point (Q1). Typical value = -0,1. Default: 0.0 + :p0: Segment P initial point (P0). Typical value = 0. Default: 0.0 + :p1: Segment P end point (P1). Typical value = 1. Default: 0.0 + :kui: Gain Under excitation limiter (KUI). Typical value = 0,1. Default: 0.0 + :vuimin: Minimum error signal (VUIMIN) (< UnderexcLim2Simplified.vuimax). Typical value = 0. Default: 0.0 + :vuimax: Maximum error signal (VUIMAX) (> UnderexcLim2Simplified.vuimin). Typical value = 1. Default: 0.0 + ''' + + cgmesProfile = UnderexcitationLimiterDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'q0': [cgmesProfile.DY.value, ], + 'q1': [cgmesProfile.DY.value, ], + 'p0': [cgmesProfile.DY.value, ], + 'p1': [cgmesProfile.DY.value, ], + 'kui': [cgmesProfile.DY.value, ], + 'vuimin': [cgmesProfile.DY.value, ], + 'vuimax': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class UnderexcitationLimiterDynamics: \n' + UnderexcitationLimiterDynamics.__doc__ + + def __init__(self, q0 = 0.0, q1 = 0.0, p0 = 0.0, p1 = 0.0, kui = 0.0, vuimin = 0.0, vuimax = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.q0 = q0 + self.q1 = q1 + self.p0 = p0 + self.p1 = p1 + self.kui = kui + self.vuimin = vuimin + self.vuimax = vuimax + + def __str__(self): + str = 'class=UnderexcLim2Simplified\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/UnderexcLimIEEE1.py b/cimpy/cgmes_v3_0_0/UnderexcLimIEEE1.py new file mode 100644 index 00000000..ba6396da --- /dev/null +++ b/cimpy/cgmes_v3_0_0/UnderexcLimIEEE1.py @@ -0,0 +1,73 @@ +from .UnderexcitationLimiterDynamics import UnderexcitationLimiterDynamics + + +class UnderexcLimIEEE1(UnderexcitationLimiterDynamics): + ''' + Type UEL1 model which has a circular limit boundary when plotted in terms of machine reactive power vs. real power output. Reference: IEEE UEL1 421.5-2005, 10.1. + + :kur: UEL radius setting (KUR). Typical value = 1,95. Default: 0.0 + :kuc: UEL centre setting (KUC). Typical value = 1,38. Default: 0.0 + :kuf: UEL excitation system stabilizer gain (KUF). Typical value = 3,3. Default: 0.0 + :vurmax: UEL maximum limit for radius phasor magnitude (VURMAX). Typical value = 5,8. Default: 0.0 + :vucmax: UEL maximum limit for operating point phasor magnitude (VUCMAX). Typical value = 5,8. Default: 0.0 + :kui: UEL integral gain (KUI). Typical value = 0. Default: 0.0 + :kul: UEL proportional gain (KUL). Typical value = 100. Default: 0.0 + :vuimax: UEL integrator output maximum limit (VUIMAX) (> UnderexcLimIEEE1.vuimin). Default: 0.0 + :vuimin: UEL integrator output minimum limit (VUIMIN) (< UnderexcLimIEEE1.vuimax). Default: 0.0 + :tu1: UEL lead time constant (TU1) (>= 0). Typical value = 0. Default: 0 + :tu2: UEL lag time constant (TU2) (>= 0). Typical value = 0,05. Default: 0 + :tu3: UEL lead time constant (TU3) (>= 0). Typical value = 0. Default: 0 + :tu4: UEL lag time constant (TU4) (>= 0). Typical value = 0. Default: 0 + :vulmax: UEL output maximum limit (VULMAX) (> UnderexcLimIEEE1.vulmin). Typical value = 18. Default: 0.0 + :vulmin: UEL output minimum limit (VULMIN) (< UnderexcLimIEEE1.vulmax). Typical value = -18. Default: 0.0 + ''' + + cgmesProfile = UnderexcitationLimiterDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'kur': [cgmesProfile.DY.value, ], + 'kuc': [cgmesProfile.DY.value, ], + 'kuf': [cgmesProfile.DY.value, ], + 'vurmax': [cgmesProfile.DY.value, ], + 'vucmax': [cgmesProfile.DY.value, ], + 'kui': [cgmesProfile.DY.value, ], + 'kul': [cgmesProfile.DY.value, ], + 'vuimax': [cgmesProfile.DY.value, ], + 'vuimin': [cgmesProfile.DY.value, ], + 'tu1': [cgmesProfile.DY.value, ], + 'tu2': [cgmesProfile.DY.value, ], + 'tu3': [cgmesProfile.DY.value, ], + 'tu4': [cgmesProfile.DY.value, ], + 'vulmax': [cgmesProfile.DY.value, ], + 'vulmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class UnderexcitationLimiterDynamics: \n' + UnderexcitationLimiterDynamics.__doc__ + + def __init__(self, kur = 0.0, kuc = 0.0, kuf = 0.0, vurmax = 0.0, vucmax = 0.0, kui = 0.0, kul = 0.0, vuimax = 0.0, vuimin = 0.0, tu1 = 0, tu2 = 0, tu3 = 0, tu4 = 0, vulmax = 0.0, vulmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.kur = kur + self.kuc = kuc + self.kuf = kuf + self.vurmax = vurmax + self.vucmax = vucmax + self.kui = kui + self.kul = kul + self.vuimax = vuimax + self.vuimin = vuimin + self.tu1 = tu1 + self.tu2 = tu2 + self.tu3 = tu3 + self.tu4 = tu4 + self.vulmax = vulmax + self.vulmin = vulmin + + def __str__(self): + str = 'class=UnderexcLimIEEE1\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/UnderexcLimIEEE2.py b/cimpy/cgmes_v3_0_0/UnderexcLimIEEE2.py new file mode 100644 index 00000000..edc0b380 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/UnderexcLimIEEE2.py @@ -0,0 +1,148 @@ +from .UnderexcitationLimiterDynamics import UnderexcitationLimiterDynamics + + +class UnderexcLimIEEE2(UnderexcitationLimiterDynamics): + ''' + Type UEL2 underexcitation limiter which has either a straight-line or multi-segment characteristic when plotted in terms of machine reactive power output vs. real power output. Reference: IEEE UEL2 421.5-2005, 10.2 (limit characteristic lookup table shown in Figure 10.4 (p 32)). + + :tuv: Voltage filter time constant (TUV) (>= 0). Typical value = 5. Default: 0 + :tup: Real power filter time constant (TUP) (>= 0). Typical value = 5. Default: 0 + :tuq: Reactive power filter time constant (TUQ) (>= 0). Typical value = 0. Default: 0 + :kui: UEL integral gain (KUI). Typical value = 0,5. Default: 0.0 + :kul: UEL proportional gain (KUL). Typical value = 0,8. Default: 0.0 + :vuimax: UEL integrator output maximum limit (VUIMAX) (> UnderexcLimIEEE2.vuimin). Typical value = 0,25. Default: 0.0 + :vuimin: UEL integrator output minimum limit (VUIMIN) (< UnderexcLimIEEE2.vuimax). Typical value = 0. Default: 0.0 + :kuf: UEL excitation system stabilizer gain (KUF). Typical value = 0. Default: 0.0 + :kfb: Gain associated with optional integrator feedback input signal to UEL (KFB). Typical value = 0. Default: 0.0 + :tul: Time constant associated with optional integrator feedback input signal to UEL (TUL) (>= 0). Typical value = 0. Default: 0 + :tu1: UEL lead time constant (TU1) (>= 0). Typical value = 0. Default: 0 + :tu2: UEL lag time constant (TU2) (>= 0). Typical value = 0. Default: 0 + :tu3: UEL lead time constant (TU3) (>= 0). Typical value = 0. Default: 0 + :tu4: UEL lag time constant (TU4) (>= 0). Typical value = 0. Default: 0 + :vulmax: UEL output maximum limit (VULMAX) (> UnderexcLimIEEE2.vulmin). Typical value = 0,25. Default: 0.0 + :vulmin: UEL output minimum limit (VULMIN) (< UnderexcLimIEEE2.vulmax). Typical value = 0. Default: 0.0 + :p0: Real power values for endpoints (P0). Typical value = 0. Default: 0.0 + :q0: Reactive power values for endpoints (Q0). Typical value = -0,31. Default: 0.0 + :p1: Real power values for endpoints (P1). Typical value = 0,3. Default: 0.0 + :q1: Reactive power values for endpoints (Q1). Typical value = -0,31. Default: 0.0 + :p2: Real power values for endpoints (P2). Typical value = 0,6. Default: 0.0 + :q2: Reactive power values for endpoints (Q2). Typical value = -0,28. Default: 0.0 + :p3: Real power values for endpoints (P3). Typical value = 0,9. Default: 0.0 + :q3: Reactive power values for endpoints (Q3). Typical value = -0,21. Default: 0.0 + :p4: Real power values for endpoints (P4). Typical value = 1,02. Default: 0.0 + :q4: Reactive power values for endpoints (Q4). Typical value = 0. Default: 0.0 + :p5: Real power values for endpoints (P5). Default: 0.0 + :q5: Reactive power values for endpoints (Q5). Default: 0.0 + :p6: Real power values for endpoints (P6). Default: 0.0 + :q6: Reactive power values for endpoints (Q6). Default: 0.0 + :p7: Real power values for endpoints (P7). Default: 0.0 + :q7: Reactive power values for endpoints (Q7). Default: 0.0 + :p8: Real power values for endpoints (P8). Default: 0.0 + :q8: Reactive power values for endpoints (Q8). Default: 0.0 + :p9: Real power values for endpoints (P9). Default: 0.0 + :q9: Reactive power values for endpoints (Q9). Default: 0.0 + :p10: Real power values for endpoints (P10). Default: 0.0 + :q10: Reactive power values for endpoints (Q10). Default: 0.0 + :k1: UEL terminal voltage exponent applied to real power input to UEL limit look-up table (k1). Typical value = 2. Default: 0.0 + :k2: UEL terminal voltage exponent applied to reactive power output from UEL limit look-up table (k2). Typical value = 2. Default: 0.0 + ''' + + cgmesProfile = UnderexcitationLimiterDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'tuv': [cgmesProfile.DY.value, ], + 'tup': [cgmesProfile.DY.value, ], + 'tuq': [cgmesProfile.DY.value, ], + 'kui': [cgmesProfile.DY.value, ], + 'kul': [cgmesProfile.DY.value, ], + 'vuimax': [cgmesProfile.DY.value, ], + 'vuimin': [cgmesProfile.DY.value, ], + 'kuf': [cgmesProfile.DY.value, ], + 'kfb': [cgmesProfile.DY.value, ], + 'tul': [cgmesProfile.DY.value, ], + 'tu1': [cgmesProfile.DY.value, ], + 'tu2': [cgmesProfile.DY.value, ], + 'tu3': [cgmesProfile.DY.value, ], + 'tu4': [cgmesProfile.DY.value, ], + 'vulmax': [cgmesProfile.DY.value, ], + 'vulmin': [cgmesProfile.DY.value, ], + 'p0': [cgmesProfile.DY.value, ], + 'q0': [cgmesProfile.DY.value, ], + 'p1': [cgmesProfile.DY.value, ], + 'q1': [cgmesProfile.DY.value, ], + 'p2': [cgmesProfile.DY.value, ], + 'q2': [cgmesProfile.DY.value, ], + 'p3': [cgmesProfile.DY.value, ], + 'q3': [cgmesProfile.DY.value, ], + 'p4': [cgmesProfile.DY.value, ], + 'q4': [cgmesProfile.DY.value, ], + 'p5': [cgmesProfile.DY.value, ], + 'q5': [cgmesProfile.DY.value, ], + 'p6': [cgmesProfile.DY.value, ], + 'q6': [cgmesProfile.DY.value, ], + 'p7': [cgmesProfile.DY.value, ], + 'q7': [cgmesProfile.DY.value, ], + 'p8': [cgmesProfile.DY.value, ], + 'q8': [cgmesProfile.DY.value, ], + 'p9': [cgmesProfile.DY.value, ], + 'q9': [cgmesProfile.DY.value, ], + 'p10': [cgmesProfile.DY.value, ], + 'q10': [cgmesProfile.DY.value, ], + 'k1': [cgmesProfile.DY.value, ], + 'k2': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class UnderexcitationLimiterDynamics: \n' + UnderexcitationLimiterDynamics.__doc__ + + def __init__(self, tuv = 0, tup = 0, tuq = 0, kui = 0.0, kul = 0.0, vuimax = 0.0, vuimin = 0.0, kuf = 0.0, kfb = 0.0, tul = 0, tu1 = 0, tu2 = 0, tu3 = 0, tu4 = 0, vulmax = 0.0, vulmin = 0.0, p0 = 0.0, q0 = 0.0, p1 = 0.0, q1 = 0.0, p2 = 0.0, q2 = 0.0, p3 = 0.0, q3 = 0.0, p4 = 0.0, q4 = 0.0, p5 = 0.0, q5 = 0.0, p6 = 0.0, q6 = 0.0, p7 = 0.0, q7 = 0.0, p8 = 0.0, q8 = 0.0, p9 = 0.0, q9 = 0.0, p10 = 0.0, q10 = 0.0, k1 = 0.0, k2 = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.tuv = tuv + self.tup = tup + self.tuq = tuq + self.kui = kui + self.kul = kul + self.vuimax = vuimax + self.vuimin = vuimin + self.kuf = kuf + self.kfb = kfb + self.tul = tul + self.tu1 = tu1 + self.tu2 = tu2 + self.tu3 = tu3 + self.tu4 = tu4 + self.vulmax = vulmax + self.vulmin = vulmin + self.p0 = p0 + self.q0 = q0 + self.p1 = p1 + self.q1 = q1 + self.p2 = p2 + self.q2 = q2 + self.p3 = p3 + self.q3 = q3 + self.p4 = p4 + self.q4 = q4 + self.p5 = p5 + self.q5 = q5 + self.p6 = p6 + self.q6 = q6 + self.p7 = p7 + self.q7 = q7 + self.p8 = p8 + self.q8 = q8 + self.p9 = p9 + self.q9 = q9 + self.p10 = p10 + self.q10 = q10 + self.k1 = k1 + self.k2 = k2 + + def __str__(self): + str = 'class=UnderexcLimIEEE2\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/UnderexcLimX1.py b/cimpy/cgmes_v3_0_0/UnderexcLimX1.py new file mode 100644 index 00000000..b729b738 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/UnderexcLimX1.py @@ -0,0 +1,46 @@ +from .UnderexcitationLimiterDynamics import UnderexcitationLimiterDynamics + + +class UnderexcLimX1(UnderexcitationLimiterDynamics): + ''' + Allis-Chalmers minimum excitation limiter. + + :kf2: Differential gain (KF2). Default: 0.0 + :tf2: Differential time constant (TF2) (>= 0). Default: 0 + :km: Minimum excitation limit gain (KM). Default: 0.0 + :tm: Minimum excitation limit time constant (TM) (>= 0). Default: 0 + :melmax: Minimum excitation limit value (MELMAX). Default: 0.0 + :k: Minimum excitation limit slope (K) (> 0). Default: 0.0 + ''' + + cgmesProfile = UnderexcitationLimiterDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'kf2': [cgmesProfile.DY.value, ], + 'tf2': [cgmesProfile.DY.value, ], + 'km': [cgmesProfile.DY.value, ], + 'tm': [cgmesProfile.DY.value, ], + 'melmax': [cgmesProfile.DY.value, ], + 'k': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class UnderexcitationLimiterDynamics: \n' + UnderexcitationLimiterDynamics.__doc__ + + def __init__(self, kf2 = 0.0, tf2 = 0, km = 0.0, tm = 0, melmax = 0.0, k = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.kf2 = kf2 + self.tf2 = tf2 + self.km = km + self.tm = tm + self.melmax = melmax + self.k = k + + def __str__(self): + str = 'class=UnderexcLimX1\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/UnderexcLimX2.py b/cimpy/cgmes_v3_0_0/UnderexcLimX2.py new file mode 100644 index 00000000..15e9d486 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/UnderexcLimX2.py @@ -0,0 +1,49 @@ +from .UnderexcitationLimiterDynamics import UnderexcitationLimiterDynamics + + +class UnderexcLimX2(UnderexcitationLimiterDynamics): + ''' + Westinghouse minimum excitation limiter. + + :kf2: Differential gain (KF2). Default: 0.0 + :tf2: Differential time constant (TF2) (>= 0). Default: 0 + :km: Minimum excitation limit gain (KM). Default: 0.0 + :tm: Minimum excitation limit time constant (TM) (>= 0). Default: 0 + :melmax: Minimum excitation limit value (MELMAX). Default: 0.0 + :qo: Excitation centre setting (QO). Default: 0.0 + :r: Excitation radius (R). Default: 0.0 + ''' + + cgmesProfile = UnderexcitationLimiterDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'kf2': [cgmesProfile.DY.value, ], + 'tf2': [cgmesProfile.DY.value, ], + 'km': [cgmesProfile.DY.value, ], + 'tm': [cgmesProfile.DY.value, ], + 'melmax': [cgmesProfile.DY.value, ], + 'qo': [cgmesProfile.DY.value, ], + 'r': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class UnderexcitationLimiterDynamics: \n' + UnderexcitationLimiterDynamics.__doc__ + + def __init__(self, kf2 = 0.0, tf2 = 0, km = 0.0, tm = 0, melmax = 0.0, qo = 0.0, r = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.kf2 = kf2 + self.tf2 = tf2 + self.km = km + self.tm = tm + self.melmax = melmax + self.qo = qo + self.r = r + + def __str__(self): + str = 'class=UnderexcLimX2\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/UnderexcitationLimiterDynamics.py b/cimpy/cgmes_v3_0_0/UnderexcitationLimiterDynamics.py new file mode 100644 index 00000000..d5abf6fa --- /dev/null +++ b/cimpy/cgmes_v3_0_0/UnderexcitationLimiterDynamics.py @@ -0,0 +1,34 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class UnderexcitationLimiterDynamics(DynamicsFunctionBlock): + ''' + Underexcitation limiter function block whose behaviour is described by reference to a standard model or by definition of a user-defined model. + + :RemoteInputSignal: Remote input signal used by this underexcitation limiter model. Default: None + :ExcitationSystemDynamics: Excitation system model with which this underexcitation limiter model is associated. Default: None + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'RemoteInputSignal': [cgmesProfile.DY.value, ], + 'ExcitationSystemDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, RemoteInputSignal = None, ExcitationSystemDynamics = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.RemoteInputSignal = RemoteInputSignal + self.ExcitationSystemDynamics = ExcitationSystemDynamics + + def __str__(self): + str = 'class=UnderexcitationLimiterDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/UnderexcitationLimiterUserDefined.py b/cimpy/cgmes_v3_0_0/UnderexcitationLimiterUserDefined.py new file mode 100644 index 00000000..7d64b1df --- /dev/null +++ b/cimpy/cgmes_v3_0_0/UnderexcitationLimiterUserDefined.py @@ -0,0 +1,34 @@ +from .UnderexcitationLimiterDynamics import UnderexcitationLimiterDynamics + + +class UnderexcitationLimiterUserDefined(UnderexcitationLimiterDynamics): + ''' + Underexcitation limiter function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = UnderexcitationLimiterDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class UnderexcitationLimiterDynamics: \n' + UnderexcitationLimiterDynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=UnderexcitationLimiterUserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/UnitMultiplier.py b/cimpy/cgmes_v3_0_0/UnitMultiplier.py new file mode 100644 index 00000000..39bb0279 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/UnitMultiplier.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class UnitMultiplier(Base): + ''' + The unit multipliers defined for the CIM. When applied to unit symbols, the unit symbol is treated as a derived unit. Regardless of the contents of the unit symbol text, the unit symbol shall be treated as if it were a single-character unit symbol. Unit symbols should not contain multipliers, and it should be left to the multiplier to define the multiple for an entire data type. For example, if a unit symbol is "m2Pers" and the multiplier is "k", then the value is k(m**2/s), and the multiplier applies to the entire final value, not to any individual part of the value. This can be conceptualized by substituting a derived unit symbol for the unit type. If one imagines that the symbol "Þ" represents the derived unit "m2Pers", then applying the multiplier "k" can be conceptualized simply as "kÞ". For example, the SI unit for mass is "kg" and not "g". If the unit symbol is defined as "kg", then the multiplier is applied to "kg" as a whole and does not replace the "k" in front of the "g". In this case, the multiplier of "m" would be used with the unit symbol of "kg" to represent one gram. As a text string, this violates the instructions in IEC 80000-1. However, because the unit symbol in CIM is treated as a derived unit instead of as an SI unit, it makes more sense to conceptualize the "kg" as if it were replaced by one of the proposed replacements for the SI mass symbol. If one imagines that the "kg" were replaced by a symbol "Þ", then it is easier to conceptualize the multiplier "m" as creating the proper unit "mÞ", and not the forbidden unit "mkg". + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.DL.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=UnitMultiplier\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/UnitSymbol.py b/cimpy/cgmes_v3_0_0/UnitSymbol.py new file mode 100644 index 00000000..b1a265e1 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/UnitSymbol.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class UnitSymbol(Base): + ''' + The derived units defined for usage in the CIM. In some cases, the derived unit is equal to an SI unit. Whenever possible, the standard derived symbol is used instead of the formula for the derived unit. For example, the unit symbol Farad is defined as "F" instead of "CPerV". In cases where a standard symbol does not exist for a derived unit, the formula for the unit is used as the unit symbol. For example, density does not have a standard symbol and so it is represented as "kgPerm3". With the exception of the "kg", which is an SI unit, the unit symbols do not contain multipliers and therefore represent the base derived unit to which a multiplier can be applied as a whole. Every unit symbol is treated as an unparseable text as if it were a single-letter symbol. The meaning of each unit symbol is defined by the accompanying descriptive text and not by the text contents of the unit symbol. To allow the widest possible range of serializations without requiring special character handling, several substitutions are made which deviate from the format described in IEC 80000-1. The division symbol "/" is replaced by the letters "Per". Exponents are written in plain text after the unit as "m3" instead of being formatted as "m" with a superscript of 3 or introducing a symbol as in "m^3". The degree symbol "[SYMBOL REMOVED]" is replaced with the letters "deg". Any clarification of the meaning for a substitution is included in the description for the unit symbol. Non-SI units are included in list of unit symbols to allow sources of data to be correctly labelled with their non-SI units (for example, a GPS sensor that is reporting numbers that represent feet instead of meters). This allows software to use the unit symbol information correctly convert and scale the raw data of those sources into SI-based units. The integer values are used for harmonization with IEC 61850. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.DL.value, cgmesProfile.OP.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=UnitSymbol\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VAdjIEEE.py b/cimpy/cgmes_v3_0_0/VAdjIEEE.py new file mode 100644 index 00000000..4baa170b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VAdjIEEE.py @@ -0,0 +1,46 @@ +from .VoltageAdjusterDynamics import VoltageAdjusterDynamics + + +class VAdjIEEE(VoltageAdjusterDynamics): + ''' + IEEE voltage adjuster which is used to represent the voltage adjuster in either a power factor or VAr control system. Reference: IEEE 421.5-2005, 11.1. + + :vadjf: Set high to provide a continuous raise or lower (VADJF). Default: 0.0 + :adjslew: Rate at which output of adjuster changes (ADJ_SLEW). Unit = s / PU. Typical value = 300. Default: 0.0 + :vadjmax: Maximum output of the adjuster (VADJMAX) (> VAdjIEEE.vadjmin). Typical value = 1,1. Default: 0.0 + :vadjmin: Minimum output of the adjuster (VADJMIN) (< VAdjIEEE.vadjmax). Typical value = 0,9. Default: 0.0 + :taon: Time that adjuster pulses are on (TAON) (>= 0). Typical value = 0,1. Default: 0 + :taoff: Time that adjuster pulses are off (TAOFF) (>= 0). Typical value = 0,5. Default: 0 + ''' + + cgmesProfile = VoltageAdjusterDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'vadjf': [cgmesProfile.DY.value, ], + 'adjslew': [cgmesProfile.DY.value, ], + 'vadjmax': [cgmesProfile.DY.value, ], + 'vadjmin': [cgmesProfile.DY.value, ], + 'taon': [cgmesProfile.DY.value, ], + 'taoff': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class VoltageAdjusterDynamics: \n' + VoltageAdjusterDynamics.__doc__ + + def __init__(self, vadjf = 0.0, adjslew = 0.0, vadjmax = 0.0, vadjmin = 0.0, taon = 0, taoff = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.vadjf = vadjf + self.adjslew = adjslew + self.vadjmax = vadjmax + self.vadjmin = vadjmin + self.taon = taon + self.taoff = taoff + + def __str__(self): + str = 'class=VAdjIEEE\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VCompIEEEType1.py b/cimpy/cgmes_v3_0_0/VCompIEEEType1.py new file mode 100644 index 00000000..014ad8dd --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VCompIEEEType1.py @@ -0,0 +1,37 @@ +from .VoltageCompensatorDynamics import VoltageCompensatorDynamics + + +class VCompIEEEType1(VoltageCompensatorDynamics): + ''' + Terminal voltage transducer and load compensator as defined in IEEE 421.5-2005, 4. This model is common to all excitation system models described in the IEEE Standard. Parameter details:
  1. If Rc and Xc are set to zero, the load compensation is not employed and the behaviour is as a simple sensing circuit.
  1. If all parameters (Rc, Xc and Tr) are set to zero, the standard model VCompIEEEType1 is bypassed.
Reference: IEEE 421.5-2005 4. + + :rc: Resistive component of compensation of a generator (Rc) (>= 0). Default: 0.0 + :xc: Reactive component of compensation of a generator (Xc) (>= 0). Default: 0.0 + :tr: Time constant which is used for the combined voltage sensing and compensation signal (Tr) (>= 0). Default: 0 + ''' + + cgmesProfile = VoltageCompensatorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'rc': [cgmesProfile.DY.value, ], + 'xc': [cgmesProfile.DY.value, ], + 'tr': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class VoltageCompensatorDynamics: \n' + VoltageCompensatorDynamics.__doc__ + + def __init__(self, rc = 0.0, xc = 0.0, tr = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.rc = rc + self.xc = xc + self.tr = tr + + def __str__(self): + str = 'class=VCompIEEEType1\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VCompIEEEType2.py b/cimpy/cgmes_v3_0_0/VCompIEEEType2.py new file mode 100644 index 00000000..ab92bf55 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VCompIEEEType2.py @@ -0,0 +1,34 @@ +from .VoltageCompensatorDynamics import VoltageCompensatorDynamics + + +class VCompIEEEType2(VoltageCompensatorDynamics): + ''' + Terminal voltage transducer and load compensator as defined in IEEE 421.5-2005, 4. This model is designed to cover the following types of compensation: Reference: IEEE 421.5-2005, 4. + + :tr: Time constant which is used for the combined voltage sensing and compensation signal (Tr) (>= 0). Default: 0 + :GenICompensationForGenJ: Compensation of this voltage compensator`s generator for current flow out of another generator. Default: "list" + ''' + + cgmesProfile = VoltageCompensatorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'tr': [cgmesProfile.DY.value, ], + 'GenICompensationForGenJ': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class VoltageCompensatorDynamics: \n' + VoltageCompensatorDynamics.__doc__ + + def __init__(self, tr = 0, GenICompensationForGenJ = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.tr = tr + self.GenICompensationForGenJ = GenICompensationForGenJ + + def __str__(self): + str = 'class=VCompIEEEType2\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VSCDynamics.py b/cimpy/cgmes_v3_0_0/VSCDynamics.py new file mode 100644 index 00000000..c9567967 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VSCDynamics.py @@ -0,0 +1,31 @@ +from .HVDCDynamics import HVDCDynamics + + +class VSCDynamics(HVDCDynamics): + ''' + VSC function block whose behaviour is described by reference to a standard model or by definition of a user-defined model. + + :VsConverter: Voltage source converter to which voltage source converter dynamics model applies. Default: None + ''' + + cgmesProfile = HVDCDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'VsConverter': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class HVDCDynamics: \n' + HVDCDynamics.__doc__ + + def __init__(self, VsConverter = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.VsConverter = VsConverter + + def __str__(self): + str = 'class=VSCDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VSCUserDefined.py b/cimpy/cgmes_v3_0_0/VSCUserDefined.py new file mode 100644 index 00000000..a0c869ef --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VSCUserDefined.py @@ -0,0 +1,34 @@ +from .VSCDynamics import VSCDynamics + + +class VSCUserDefined(VSCDynamics): + ''' + Voltage source converter (VSC) function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = VSCDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class VSCDynamics: \n' + VSCDynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=VSCUserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Validity.py b/cimpy/cgmes_v3_0_0/Validity.py new file mode 100644 index 00000000..63d6ada3 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Validity.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class Validity(Base): + ''' + Validity for MeasurementValue. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=Validity\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ValueAliasSet.py b/cimpy/cgmes_v3_0_0/ValueAliasSet.py new file mode 100644 index 00000000..1dfc7f00 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ValueAliasSet.py @@ -0,0 +1,40 @@ +from .IdentifiedObject import IdentifiedObject + + +class ValueAliasSet(IdentifiedObject): + ''' + Describes the translation of a set of values into a name and is intendend to facilitate custom translations. Each ValueAliasSet has a name, description etc. A specific Measurement may represent a discrete state like Open, Closed, Intermediate etc. This requires a translation from the MeasurementValue.value number to a string, e.g. 0->"Invalid", 1->"Open", 2->"Closed", 3->"Intermediate". Each ValueToAlias member in ValueAliasSet.Value describe a mapping for one particular value to a name. + + :Commands: The Commands using the set for translation. Default: "list" + :Discretes: The Measurements using the set for translation. Default: "list" + :RaiseLowerCommands: The Commands using the set for translation. Default: "list" + :Values: The ValueToAlias mappings included in the set. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'Commands': [cgmesProfile.OP.value, ], + 'Discretes': [cgmesProfile.OP.value, ], + 'RaiseLowerCommands': [cgmesProfile.OP.value, ], + 'Values': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, Commands = "list", Discretes = "list", RaiseLowerCommands = "list", Values = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.Commands = Commands + self.Discretes = Discretes + self.RaiseLowerCommands = RaiseLowerCommands + self.Values = Values + + def __str__(self): + str = 'class=ValueAliasSet\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/ValueToAlias.py b/cimpy/cgmes_v3_0_0/ValueToAlias.py new file mode 100644 index 00000000..87ba6ed4 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/ValueToAlias.py @@ -0,0 +1,34 @@ +from .IdentifiedObject import IdentifiedObject + + +class ValueToAlias(IdentifiedObject): + ''' + Describes the translation of one particular value into a name, e.g. 1 as "Open". + + :ValueAliasSet: The ValueAliasSet having the ValueToAlias mappings. Default: None + :value: The value that is mapped. Default: 0 + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.OP.value, ], + 'ValueAliasSet': [cgmesProfile.OP.value, ], + 'value': [cgmesProfile.OP.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, ValueAliasSet = None, value = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ValueAliasSet = ValueAliasSet + self.value = value + + def __str__(self): + str = 'class=ValueToAlias\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VisibilityLayer.py b/cimpy/cgmes_v3_0_0/VisibilityLayer.py new file mode 100644 index 00000000..9c2d5866 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VisibilityLayer.py @@ -0,0 +1,34 @@ +from .IdentifiedObject import IdentifiedObject + + +class VisibilityLayer(IdentifiedObject): + ''' + Layers are typically used for grouping diagram objects according to themes and scales. Themes are used to display or hide certain information (e.g., lakes, borders), while scales are used for hiding or displaying information depending on the current zoom level (hide text when it is too small to be read, or when it exceeds the screen size). This is also called de-cluttering. CIM based graphics exchange supports an m:n relationship between diagram objects and layers. The importing system shall convert an m:n case into an appropriate 1:n representation if the importing system does not support m:n. + + :VisibleObjects: A visibility layer can contain one or more diagram objects. Default: "list" + :drawingOrder: The drawing order for this layer. The higher the number, the later the layer and the objects within it are rendered. Default: 0 + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DL.value, ], + 'VisibleObjects': [cgmesProfile.DL.value, ], + 'drawingOrder': [cgmesProfile.DL.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, VisibleObjects = "list", drawingOrder = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.VisibleObjects = VisibleObjects + self.drawingOrder = drawingOrder + + def __str__(self): + str = 'class=VisibilityLayer\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/Voltage.py b/cimpy/cgmes_v3_0_0/Voltage.py new file mode 100644 index 00000000..19e56e21 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/Voltage.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class Voltage(Base): + ''' + Electrical voltage, can be both AC and DC. + + :value: Default: 0.0 + :multiplier: Default: None + :unit: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'value': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'multiplier': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + 'unit': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.EQBD.value, cgmesProfile.SC.value, cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, multiplier = None, unit = None, ): + + self.value = value + self.multiplier = multiplier + self.unit = unit + + def __str__(self): + str = 'class=Voltage\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VoltageAdjusterDynamics.py b/cimpy/cgmes_v3_0_0/VoltageAdjusterDynamics.py new file mode 100644 index 00000000..fde73953 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VoltageAdjusterDynamics.py @@ -0,0 +1,31 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class VoltageAdjusterDynamics(DynamicsFunctionBlock): + ''' + Voltage adjuster function block whose behaviour is described by reference to a standard model or by definition of a user-defined model. + + :PFVArControllerType1Dynamics: Power factor or VAr controller type 1 model with which this voltage adjuster is associated. Default: None + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'PFVArControllerType1Dynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, PFVArControllerType1Dynamics = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.PFVArControllerType1Dynamics = PFVArControllerType1Dynamics + + def __str__(self): + str = 'class=VoltageAdjusterDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VoltageAdjusterUserDefined.py b/cimpy/cgmes_v3_0_0/VoltageAdjusterUserDefined.py new file mode 100644 index 00000000..51d7e1c7 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VoltageAdjusterUserDefined.py @@ -0,0 +1,34 @@ +from .VoltageAdjusterDynamics import VoltageAdjusterDynamics + + +class VoltageAdjusterUserDefined(VoltageAdjusterDynamics): + ''' + Voltage adjuster function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = VoltageAdjusterDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class VoltageAdjusterDynamics: \n' + VoltageAdjusterDynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=VoltageAdjusterUserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VoltageCompensatorDynamics.py b/cimpy/cgmes_v3_0_0/VoltageCompensatorDynamics.py new file mode 100644 index 00000000..3a8aefc0 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VoltageCompensatorDynamics.py @@ -0,0 +1,34 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class VoltageCompensatorDynamics(DynamicsFunctionBlock): + ''' + Voltage compensator function block whose behaviour is described by reference to a standard model or by definition of a user-defined model. + + :RemoteInputSignal: Remote input signal used by this voltage compensator model. Default: None + :ExcitationSystemDynamics: Excitation system model with which this voltage compensator is associated. Default: None + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'RemoteInputSignal': [cgmesProfile.DY.value, ], + 'ExcitationSystemDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, RemoteInputSignal = None, ExcitationSystemDynamics = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.RemoteInputSignal = RemoteInputSignal + self.ExcitationSystemDynamics = ExcitationSystemDynamics + + def __str__(self): + str = 'class=VoltageCompensatorDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VoltageCompensatorUserDefined.py b/cimpy/cgmes_v3_0_0/VoltageCompensatorUserDefined.py new file mode 100644 index 00000000..3cf1584c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VoltageCompensatorUserDefined.py @@ -0,0 +1,34 @@ +from .VoltageCompensatorDynamics import VoltageCompensatorDynamics + + +class VoltageCompensatorUserDefined(VoltageCompensatorDynamics): + ''' + Voltage compensator function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = VoltageCompensatorDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class VoltageCompensatorDynamics: \n' + VoltageCompensatorDynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=VoltageCompensatorUserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VoltageLevel.py b/cimpy/cgmes_v3_0_0/VoltageLevel.py new file mode 100644 index 00000000..e375f9a3 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VoltageLevel.py @@ -0,0 +1,43 @@ +from .EquipmentContainer import EquipmentContainer + + +class VoltageLevel(EquipmentContainer): + ''' + A collection of equipment at one common system voltage forming a switchgear. The equipment typically consists of breakers, busbars, instrumentation, control, regulation and protection devices as well as assemblies of all these. + + :BaseVoltage: The base voltage used for all equipment within the voltage level. Default: None + :Bays: The bays within this voltage level. Default: "list" + :Substation: The substation of the voltage level. Default: None + :highVoltageLimit: The bus bar`s high voltage limit. The limit applies to all equipment and nodes contained in a given VoltageLevel. It is not required that it is exchanged in pair with lowVoltageLimit. It is preferable to use operational VoltageLimit, which prevails, if present. Default: 0.0 + :lowVoltageLimit: The bus bar`s low voltage limit. The limit applies to all equipment and nodes contained in a given VoltageLevel. It is not required that it is exchanged in pair with highVoltageLimit. It is preferable to use operational VoltageLimit, which prevails, if present. Default: 0.0 + ''' + + cgmesProfile = EquipmentContainer.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'BaseVoltage': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'Bays': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'Substation': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'highVoltageLimit': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + 'lowVoltageLimit': [cgmesProfile.EQ.value, cgmesProfile.EQBD.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class EquipmentContainer: \n' + EquipmentContainer.__doc__ + + def __init__(self, BaseVoltage = None, Bays = "list", Substation = None, highVoltageLimit = 0.0, lowVoltageLimit = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.BaseVoltage = BaseVoltage + self.Bays = Bays + self.Substation = Substation + self.highVoltageLimit = highVoltageLimit + self.lowVoltageLimit = lowVoltageLimit + + def __str__(self): + str = 'class=VoltageLevel\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VoltageLimit.py b/cimpy/cgmes_v3_0_0/VoltageLimit.py new file mode 100644 index 00000000..d9cc4a44 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VoltageLimit.py @@ -0,0 +1,34 @@ +from .OperationalLimit import OperationalLimit + + +class VoltageLimit(OperationalLimit): + ''' + Operational limit applied to voltage. The use of operational VoltageLimit is preferred instead of limits defined at VoltageLevel. The operational VoltageLimits are used, if present. + + :value: Limit on voltage. High or low limit nature of the limit depends upon the properties of the operational limit type. The attribute shall be a positive value or zero. Default: 0.0 + :normalValue: The normal limit on voltage. High or low limit nature of the limit depends upon the properties of the operational limit type. The attribute shall be a positive value or zero. Default: 0.0 + ''' + + cgmesProfile = OperationalLimit.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'value': [cgmesProfile.SSH.value, ], + 'normalValue': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class OperationalLimit: \n' + OperationalLimit.__doc__ + + def __init__(self, value = 0.0, normalValue = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.value = value + self.normalValue = normalValue + + def __str__(self): + str = 'class=VoltageLimit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VoltagePerReactivePower.py b/cimpy/cgmes_v3_0_0/VoltagePerReactivePower.py new file mode 100644 index 00000000..46fec72e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VoltagePerReactivePower.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class VoltagePerReactivePower(Base): + ''' + Voltage variation with reactive power. + + :value: Default: 0.0 + :unit: Default: None + :multiplier: Default: None + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'value': [cgmesProfile.EQ.value, ], + 'unit': [cgmesProfile.EQ.value, ], + 'multiplier': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, value = 0.0, unit = None, multiplier = None, ): + + self.value = value + self.unit = unit + self.multiplier = multiplier + + def __str__(self): + str = 'class=VoltagePerReactivePower\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VolumeFlowRate.py b/cimpy/cgmes_v3_0_0/VolumeFlowRate.py new file mode 100644 index 00000000..27b38f0f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VolumeFlowRate.py @@ -0,0 +1,36 @@ +from .Base import Base + + +class VolumeFlowRate(Base): + ''' + Volume per time. + + :multiplier: Default: None + :unit: Default: None + :value: Default: 0.0 + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'multiplier': [cgmesProfile.DY.value, ], + 'unit': [cgmesProfile.DY.value, ], + 'value': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, multiplier = None, unit = None, value = 0.0, ): + + self.multiplier = multiplier + self.unit = unit + self.value = value + + def __str__(self): + str = 'class=VolumeFlowRate\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VsCapabilityCurve.py b/cimpy/cgmes_v3_0_0/VsCapabilityCurve.py new file mode 100644 index 00000000..6f40eaab --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VsCapabilityCurve.py @@ -0,0 +1,31 @@ +from .Curve import Curve + + +class VsCapabilityCurve(Curve): + ''' + The P-Q capability curve for a voltage source converter, with P on X-axis and Qmin and Qmax on Y1-axis and Y2-axis. + + :VsConverterDCSides: All converters with this capability curve. Default: "list" + ''' + + cgmesProfile = Curve.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'VsConverterDCSides': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Curve: \n' + Curve.__doc__ + + def __init__(self, VsConverterDCSides = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.VsConverterDCSides = VsConverterDCSides + + def __str__(self): + str = 'class=VsCapabilityCurve\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VsConverter.py b/cimpy/cgmes_v3_0_0/VsConverter.py new file mode 100644 index 00000000..b78efe6a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VsConverter.py @@ -0,0 +1,73 @@ +from .ACDCConverter import ACDCConverter + + +class VsConverter(ACDCConverter): + ''' + DC side of the voltage source converter (VSC). + + :VSCDynamics: Voltage source converter dynamics model used to describe dynamic behaviour of this converter. Default: None + :droop: Droop constant. The pu value is obtained as D [kV/MW] x Sb / Ubdc. The attribute shall be a positive value. Default: 0.0 + :droopCompensation: Compensation constant. Used to compensate for voltage drop when controlling voltage at a distant bus. The attribute shall be a positive value. Default: 0.0 + :pPccControl: Kind of control of real power and/or DC voltage. Default: None + :qPccControl: Kind of reactive power control. Default: None + :qShare: Reactive power sharing factor among parallel converters on Uac control. The attribute shall be a positive value or zero. Default: 0.0 + :targetQpcc: Reactive power injection target in AC grid, at point of common coupling. Load sign convention is used, i.e. positive sign means flow out from a node. Default: 0.0 + :targetUpcc: Voltage target in AC grid, at point of common coupling. The attribute shall be a positive value. Default: 0.0 + :targetPowerFactorPcc: Power factor target at the AC side, at point of common coupling. The attribute shall be a positive value. Default: 0.0 + :targetPhasePcc: Phase target at AC side, at point of common coupling. The attribute shall be a positive value. Default: 0.0 + :targetPWMfactor: Magnitude of pulse-modulation factor. The attribute shall be a positive value. Default: 0.0 + :CapabilityCurve: Capability curve of this converter. Default: None + :maxModulationIndex: The maximum quotient between the AC converter voltage (Uc) and DC voltage (Ud). A factor typically less than 1. It is converter`s configuration data used in power flow. Default: 0.0 + :delta: Angle between VsConverter.uv and ACDCConverter.uc. It is converter`s state variable used in power flow. The attribute shall be a positive value or zero. Default: 0.0 + :uv: Line-to-line voltage on the valve side of the converter transformer. It is converter`s state variable, result from power flow. The attribute shall be a positive value. Default: 0.0 + ''' + + cgmesProfile = ACDCConverter.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, cgmesProfile.SSH.value, cgmesProfile.EQ.value, cgmesProfile.SV.value, ], + 'VSCDynamics': [cgmesProfile.DY.value, ], + 'droop': [cgmesProfile.SSH.value, ], + 'droopCompensation': [cgmesProfile.SSH.value, ], + 'pPccControl': [cgmesProfile.SSH.value, ], + 'qPccControl': [cgmesProfile.SSH.value, ], + 'qShare': [cgmesProfile.SSH.value, ], + 'targetQpcc': [cgmesProfile.SSH.value, ], + 'targetUpcc': [cgmesProfile.SSH.value, ], + 'targetPowerFactorPcc': [cgmesProfile.SSH.value, ], + 'targetPhasePcc': [cgmesProfile.SSH.value, ], + 'targetPWMfactor': [cgmesProfile.SSH.value, ], + 'CapabilityCurve': [cgmesProfile.EQ.value, ], + 'maxModulationIndex': [cgmesProfile.EQ.value, ], + 'delta': [cgmesProfile.SV.value, ], + 'uv': [cgmesProfile.SV.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class ACDCConverter: \n' + ACDCConverter.__doc__ + + def __init__(self, VSCDynamics = None, droop = 0.0, droopCompensation = 0.0, pPccControl = None, qPccControl = None, qShare = 0.0, targetQpcc = 0.0, targetUpcc = 0.0, targetPowerFactorPcc = 0.0, targetPhasePcc = 0.0, targetPWMfactor = 0.0, CapabilityCurve = None, maxModulationIndex = 0.0, delta = 0.0, uv = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.VSCDynamics = VSCDynamics + self.droop = droop + self.droopCompensation = droopCompensation + self.pPccControl = pPccControl + self.qPccControl = qPccControl + self.qShare = qShare + self.targetQpcc = targetQpcc + self.targetUpcc = targetUpcc + self.targetPowerFactorPcc = targetPowerFactorPcc + self.targetPhasePcc = targetPhasePcc + self.targetPWMfactor = targetPWMfactor + self.CapabilityCurve = CapabilityCurve + self.maxModulationIndex = maxModulationIndex + self.delta = delta + self.uv = uv + + def __str__(self): + str = 'class=VsConverter\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VsPpccControlKind.py b/cimpy/cgmes_v3_0_0/VsPpccControlKind.py new file mode 100644 index 00000000..b5798535 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VsPpccControlKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class VsPpccControlKind(Base): + ''' + Types applicable to the control of real power and/or DC voltage by voltage source converter. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=VsPpccControlKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/VsQpccControlKind.py b/cimpy/cgmes_v3_0_0/VsQpccControlKind.py new file mode 100644 index 00000000..4b25c345 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/VsQpccControlKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class VsQpccControlKind(Base): + ''' + Kind of reactive power control at point of common coupling for a voltage source converter. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=VsQpccControlKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WaveTrap.py b/cimpy/cgmes_v3_0_0/WaveTrap.py new file mode 100644 index 00000000..aaf48ccd --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WaveTrap.py @@ -0,0 +1,29 @@ +from .AuxiliaryEquipment import AuxiliaryEquipment + + +class WaveTrap(AuxiliaryEquipment): + ''' + Line traps are devices that impede high frequency power line carrier signals yet present a negligible impedance at the main power frequency. + + ''' + + cgmesProfile = AuxiliaryEquipment.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class AuxiliaryEquipment: \n' + AuxiliaryEquipment.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=WaveTrap\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindAeroConstIEC.py b/cimpy/cgmes_v3_0_0/WindAeroConstIEC.py new file mode 100644 index 00000000..0878c412 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindAeroConstIEC.py @@ -0,0 +1,31 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindAeroConstIEC(IdentifiedObject): + ''' + Constant aerodynamic torque model which assumes that the aerodynamic torque is constant. Reference: IEC 61400-27-1:2015, 5.6.1.1. + + :WindGenTurbineType1aIEC: Wind turbine type 1A model with which this wind aerodynamic model is associated. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'WindGenTurbineType1aIEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, WindGenTurbineType1aIEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindGenTurbineType1aIEC = WindGenTurbineType1aIEC + + def __str__(self): + str = 'class=WindAeroConstIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindAeroOneDimIEC.py b/cimpy/cgmes_v3_0_0/WindAeroOneDimIEC.py new file mode 100644 index 00000000..01e3fc0e --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindAeroOneDimIEC.py @@ -0,0 +1,37 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindAeroOneDimIEC(IdentifiedObject): + ''' + One-dimensional aerodynamic model. Reference: IEC 61400-27-1:2015, 5.6.1.2. + + :ka: Aerodynamic gain (ka). It is a type-dependent parameter. Default: 0.0 + :thetaomega: Initial pitch angle (thetaomega0). It is a case-dependent parameter. Default: 0.0 + :WindTurbineType3IEC: Wind turbine type 3 model with which this wind aerodynamic model is associated. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'ka': [cgmesProfile.DY.value, ], + 'thetaomega': [cgmesProfile.DY.value, ], + 'WindTurbineType3IEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, ka = 0.0, thetaomega = 0.0, WindTurbineType3IEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.ka = ka + self.thetaomega = thetaomega + self.WindTurbineType3IEC = WindTurbineType3IEC + + def __str__(self): + str = 'class=WindAeroOneDimIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindAeroTwoDimIEC.py b/cimpy/cgmes_v3_0_0/WindAeroTwoDimIEC.py new file mode 100644 index 00000000..f3495f47 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindAeroTwoDimIEC.py @@ -0,0 +1,52 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindAeroTwoDimIEC(IdentifiedObject): + ''' + Two-dimensional aerodynamic model. Reference: IEC 61400-27-1:2015, 5.6.1.3. + + :dpomega: Partial derivative of aerodynamic power with respect to changes in WTR speed (dpomega). It is a type-dependent parameter. Default: 0.0 + :dptheta: Partial derivative of aerodynamic power with respect to changes in pitch angle (dptheta). It is a type-dependent parameter. Default: 0.0 + :dpv1: Partial derivative (dpv1). It is a type-dependent parameter. Default: 0.0 + :omegazero: Rotor speed if the wind turbine is not derated (omega0). It is a type-dependent parameter. Default: 0.0 + :pavail: Available aerodynamic power (pavail). It is a case-dependent parameter. Default: 0.0 + :thetazero: Pitch angle if the wind turbine is not derated (theta0). It is a case-dependent parameter. Default: 0.0 + :thetav2: Blade angle at twice rated wind speed (thetav2). It is a type-dependent parameter. Default: 0.0 + :WindTurbineType3IEC: Wind turbine type 3 model with which this wind aerodynamic model is associated. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'dpomega': [cgmesProfile.DY.value, ], + 'dptheta': [cgmesProfile.DY.value, ], + 'dpv1': [cgmesProfile.DY.value, ], + 'omegazero': [cgmesProfile.DY.value, ], + 'pavail': [cgmesProfile.DY.value, ], + 'thetazero': [cgmesProfile.DY.value, ], + 'thetav2': [cgmesProfile.DY.value, ], + 'WindTurbineType3IEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, dpomega = 0.0, dptheta = 0.0, dpv1 = 0.0, omegazero = 0.0, pavail = 0.0, thetazero = 0.0, thetav2 = 0.0, WindTurbineType3IEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.dpomega = dpomega + self.dptheta = dptheta + self.dpv1 = dpv1 + self.omegazero = omegazero + self.pavail = pavail + self.thetazero = thetazero + self.thetav2 = thetav2 + self.WindTurbineType3IEC = WindTurbineType3IEC + + def __str__(self): + str = 'class=WindAeroTwoDimIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindContCurrLimIEC.py b/cimpy/cgmes_v3_0_0/WindContCurrLimIEC.py new file mode 100644 index 00000000..9fff2bdd --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindContCurrLimIEC.py @@ -0,0 +1,55 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindContCurrLimIEC(IdentifiedObject): + ''' + Current limitation model. The current limitation model combines the physical limits and the control limits. Reference: IEC 61400-27-1:2015, 5.6.5.8. + + :imax: Maximum continuous current at the wind turbine terminals (imax). It is a type-dependent parameter. Default: 0.0 + :imaxdip: Maximum current during voltage dip at the wind turbine terminals (imaxdip). It is a project-dependent parameter. Default: 0.0 + :kpqu: Partial derivative of reactive current limit (Kpqu) versus voltage. It is a type-dependent parameter. Default: 0.0 + :mdfslim: Limitation of type 3 stator current (MDFSLim). MDFSLim = 1 for wind turbines type 4. It is a type-dependent parameter. false= total current limitation (0 in the IEC model) true=stator current limitation (1 in the IEC model). Default: False + :mqpri: Prioritisation of Q control during UVRT (Mqpri). It is a project-dependent parameter. true = reactive power priority (1 in the IEC model) false = active power priority (0 in the IEC model). Default: False + :tufiltcl: Voltage measurement filter time constant (Tufiltcl) (>= 0). It is a type-dependent parameter. Default: 0 + :upqumax: Wind turbine voltage in the operation point where zero reactive current can be delivered (upqumax). It is a type-dependent parameter. Default: 0.0 + :WindTurbineType3or4IEC: Wind turbine type 3 or type 4 model with which this wind control current limitation model is associated. Default: None + :WindDynamicsLookupTable: The wind dynamics lookup table associated with this current control limitation model. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'imax': [cgmesProfile.DY.value, ], + 'imaxdip': [cgmesProfile.DY.value, ], + 'kpqu': [cgmesProfile.DY.value, ], + 'mdfslim': [cgmesProfile.DY.value, ], + 'mqpri': [cgmesProfile.DY.value, ], + 'tufiltcl': [cgmesProfile.DY.value, ], + 'upqumax': [cgmesProfile.DY.value, ], + 'WindTurbineType3or4IEC': [cgmesProfile.DY.value, ], + 'WindDynamicsLookupTable': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, imax = 0.0, imaxdip = 0.0, kpqu = 0.0, mdfslim = False, mqpri = False, tufiltcl = 0, upqumax = 0.0, WindTurbineType3or4IEC = None, WindDynamicsLookupTable = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.imax = imax + self.imaxdip = imaxdip + self.kpqu = kpqu + self.mdfslim = mdfslim + self.mqpri = mqpri + self.tufiltcl = tufiltcl + self.upqumax = upqumax + self.WindTurbineType3or4IEC = WindTurbineType3or4IEC + self.WindDynamicsLookupTable = WindDynamicsLookupTable + + def __str__(self): + str = 'class=WindContCurrLimIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindContPType3IEC.py b/cimpy/cgmes_v3_0_0/WindContPType3IEC.py new file mode 100644 index 00000000..0f6de9a5 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindContPType3IEC.py @@ -0,0 +1,103 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindContPType3IEC(IdentifiedObject): + ''' + P control model type 3. Reference: IEC 61400-27-1:2015, 5.6.5.4. + + :dpmax: Maximum wind turbine power ramp rate (dpmax). It is a type-dependent parameter. Default: 0.0 + :dprefmax: Maximum ramp rate of wind turbine reference power (dprefmax). It is a project-dependent parameter. Default: 0.0 + :dprefmin: Minimum ramp rate of wind turbine reference power (dprefmin). It is a project-dependent parameter. Default: 0.0 + :dthetamax: Ramp limitation of torque, required in some grid codes (dtmax). It is a project-dependent parameter. Default: 0.0 + :dthetamaxuvrt: Limitation of torque rise rate during UVRT (dthetamaxUVRT). It is a project-dependent parameter. Default: 0.0 + :kdtd: Gain for active drive train damping (KDTD). It is a type-dependent parameter. Default: 0.0 + :kip: PI controller integration parameter (KIp). It is a type-dependent parameter. Default: 0.0 + :kpp: PI controller proportional gain (KPp). It is a type-dependent parameter. Default: 0.0 + :mpuvrt: Enable UVRT power control mode (MpUVRT). It is a project-dependent parameter. true = voltage control (1 in the IEC model) false = reactive power control (0 in the IEC model). Default: False + :omegaoffset: Offset to reference value that limits controller action during rotor speed changes (omegaoffset). It is a case-dependent parameter. Default: 0.0 + :pdtdmax: Maximum active drive train damping power (pDTDmax). It is a type-dependent parameter. Default: 0.0 + :tdvs: Time delay after deep voltage sags (TDVS) (>= 0). It is a project-dependent parameter. Default: 0 + :thetaemin: Minimum electrical generator torque (temin). It is a type-dependent parameter. Default: 0.0 + :thetauscale: Voltage scaling factor of reset-torque (tuscale). It is a project-dependent parameter. Default: 0.0 + :tomegafiltp3: Filter time constant for generator speed measurement (Tomegafiltp3) (>= 0). It is a type-dependent parameter. Default: 0 + :tpfiltp3: Filter time constant for power measurement (Tpfiltp3) (>= 0). It is a type-dependent parameter. Default: 0 + :tpord: Time constant in power order lag (Tpord). It is a type-dependent parameter. Default: 0.0 + :tufiltp3: Filter time constant for voltage measurement (Tufiltp3) (>= 0). It is a type-dependent parameter. Default: 0 + :tomegaref: Time constant in speed reference filter (Tomega,ref) (>= 0). It is a type-dependent parameter. Default: 0 + :udvs: Voltage limit for hold UVRT status after deep voltage sags (uDVS). It is a project-dependent parameter. Default: 0.0 + :updip: Voltage dip threshold for P-control (uPdip). Part of turbine control, often different (e.g 0.8) from converter thresholds. It is a project-dependent parameter. Default: 0.0 + :omegadtd: Active drive train damping frequency (omegaDTD). It can be calculated from two mass model parameters. It is a type-dependent parameter. Default: 0.0 + :zeta: Coefficient for active drive train damping (zeta). It is a type-dependent parameter. Default: 0.0 + :WindTurbineType3IEC: Wind turbine type 3 model with which this wind control P type 3 model is associated. Default: None + :WindDynamicsLookupTable: The wind dynamics lookup table associated with this P control type 3 model. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'dpmax': [cgmesProfile.DY.value, ], + 'dprefmax': [cgmesProfile.DY.value, ], + 'dprefmin': [cgmesProfile.DY.value, ], + 'dthetamax': [cgmesProfile.DY.value, ], + 'dthetamaxuvrt': [cgmesProfile.DY.value, ], + 'kdtd': [cgmesProfile.DY.value, ], + 'kip': [cgmesProfile.DY.value, ], + 'kpp': [cgmesProfile.DY.value, ], + 'mpuvrt': [cgmesProfile.DY.value, ], + 'omegaoffset': [cgmesProfile.DY.value, ], + 'pdtdmax': [cgmesProfile.DY.value, ], + 'tdvs': [cgmesProfile.DY.value, ], + 'thetaemin': [cgmesProfile.DY.value, ], + 'thetauscale': [cgmesProfile.DY.value, ], + 'tomegafiltp3': [cgmesProfile.DY.value, ], + 'tpfiltp3': [cgmesProfile.DY.value, ], + 'tpord': [cgmesProfile.DY.value, ], + 'tufiltp3': [cgmesProfile.DY.value, ], + 'tomegaref': [cgmesProfile.DY.value, ], + 'udvs': [cgmesProfile.DY.value, ], + 'updip': [cgmesProfile.DY.value, ], + 'omegadtd': [cgmesProfile.DY.value, ], + 'zeta': [cgmesProfile.DY.value, ], + 'WindTurbineType3IEC': [cgmesProfile.DY.value, ], + 'WindDynamicsLookupTable': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, dpmax = 0.0, dprefmax = 0.0, dprefmin = 0.0, dthetamax = 0.0, dthetamaxuvrt = 0.0, kdtd = 0.0, kip = 0.0, kpp = 0.0, mpuvrt = False, omegaoffset = 0.0, pdtdmax = 0.0, tdvs = 0, thetaemin = 0.0, thetauscale = 0.0, tomegafiltp3 = 0, tpfiltp3 = 0, tpord = 0.0, tufiltp3 = 0, tomegaref = 0, udvs = 0.0, updip = 0.0, omegadtd = 0.0, zeta = 0.0, WindTurbineType3IEC = None, WindDynamicsLookupTable = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.dpmax = dpmax + self.dprefmax = dprefmax + self.dprefmin = dprefmin + self.dthetamax = dthetamax + self.dthetamaxuvrt = dthetamaxuvrt + self.kdtd = kdtd + self.kip = kip + self.kpp = kpp + self.mpuvrt = mpuvrt + self.omegaoffset = omegaoffset + self.pdtdmax = pdtdmax + self.tdvs = tdvs + self.thetaemin = thetaemin + self.thetauscale = thetauscale + self.tomegafiltp3 = tomegafiltp3 + self.tpfiltp3 = tpfiltp3 + self.tpord = tpord + self.tufiltp3 = tufiltp3 + self.tomegaref = tomegaref + self.udvs = udvs + self.updip = updip + self.omegadtd = omegadtd + self.zeta = zeta + self.WindTurbineType3IEC = WindTurbineType3IEC + self.WindDynamicsLookupTable = WindDynamicsLookupTable + + def __str__(self): + str = 'class=WindContPType3IEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindContPType4aIEC.py b/cimpy/cgmes_v3_0_0/WindContPType4aIEC.py new file mode 100644 index 00000000..2a28d48c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindContPType4aIEC.py @@ -0,0 +1,40 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindContPType4aIEC(IdentifiedObject): + ''' + P control model type 4A. Reference: IEC 61400-27-1:2015, 5.6.5.5. + + :dpmaxp4a: Maximum wind turbine power ramp rate (dpmaxp4A). It is a project-dependent parameter. Default: 0.0 + :tpordp4a: Time constant in power order lag (Tpordp4A) (>= 0). It is a type-dependent parameter. Default: 0 + :tufiltp4a: Voltage measurement filter time constant (Tufiltp4A) (>= 0). It is a type-dependent parameter. Default: 0 + :WindTurbineType4aIEC: Wind turbine type 4A model with which this wind control P type 4A model is associated. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'dpmaxp4a': [cgmesProfile.DY.value, ], + 'tpordp4a': [cgmesProfile.DY.value, ], + 'tufiltp4a': [cgmesProfile.DY.value, ], + 'WindTurbineType4aIEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, dpmaxp4a = 0.0, tpordp4a = 0, tufiltp4a = 0, WindTurbineType4aIEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.dpmaxp4a = dpmaxp4a + self.tpordp4a = tpordp4a + self.tufiltp4a = tufiltp4a + self.WindTurbineType4aIEC = WindTurbineType4aIEC + + def __str__(self): + str = 'class=WindContPType4aIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindContPType4bIEC.py b/cimpy/cgmes_v3_0_0/WindContPType4bIEC.py new file mode 100644 index 00000000..b3f45d04 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindContPType4bIEC.py @@ -0,0 +1,43 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindContPType4bIEC(IdentifiedObject): + ''' + P control model type 4B. Reference: IEC 61400-27-1:2015, 5.6.5.6. + + :dpmaxp4b: Maximum wind turbine power ramp rate (dpmaxp4B). It is a project-dependent parameter. Default: 0.0 + :tpaero: Time constant in aerodynamic power response (Tpaero) (>= 0). It is a type-dependent parameter. Default: 0 + :tpordp4b: Time constant in power order lag (Tpordp4B) (>= 0). It is a type-dependent parameter. Default: 0 + :tufiltp4b: Voltage measurement filter time constant (Tufiltp4B) (>= 0). It is a type-dependent parameter. Default: 0 + :WindTurbineType4bIEC: Wind turbine type 4B model with which this wind control P type 4B model is associated. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'dpmaxp4b': [cgmesProfile.DY.value, ], + 'tpaero': [cgmesProfile.DY.value, ], + 'tpordp4b': [cgmesProfile.DY.value, ], + 'tufiltp4b': [cgmesProfile.DY.value, ], + 'WindTurbineType4bIEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, dpmaxp4b = 0.0, tpaero = 0, tpordp4b = 0, tufiltp4b = 0, WindTurbineType4bIEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.dpmaxp4b = dpmaxp4b + self.tpaero = tpaero + self.tpordp4b = tpordp4b + self.tufiltp4b = tufiltp4b + self.WindTurbineType4bIEC = WindTurbineType4bIEC + + def __str__(self): + str = 'class=WindContPType4bIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindContPitchAngleIEC.py b/cimpy/cgmes_v3_0_0/WindContPitchAngleIEC.py new file mode 100644 index 00000000..ed45f4a6 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindContPitchAngleIEC.py @@ -0,0 +1,61 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindContPitchAngleIEC(IdentifiedObject): + ''' + Pitch angle control model. Reference: IEC 61400-27-1:2015, 5.6.5.2. + + :dthetamax: Maximum pitch positive ramp rate (dthetamax) (> WindContPitchAngleIEC.dthetamin). It is a type-dependent parameter. Unit = degrees / s. Default: 0.0 + :dthetamin: Maximum pitch negative ramp rate (dthetamin) (< WindContPitchAngleIEC.dthetamax). It is a type-dependent parameter. Unit = degrees / s. Default: 0.0 + :kic: Power PI controller integration gain (KIc). It is a type-dependent parameter. Default: 0.0 + :kiomega: Speed PI controller integration gain (KIomega). It is a type-dependent parameter. Default: 0.0 + :kpc: Power PI controller proportional gain (KPc). It is a type-dependent parameter. Default: 0.0 + :kpomega: Speed PI controller proportional gain (KPomega). It is a type-dependent parameter. Default: 0.0 + :kpx: Pitch cross coupling gain (KPX). It is a type-dependent parameter. Default: 0.0 + :thetamax: Maximum pitch angle (thetamax) (> WindContPitchAngleIEC.thetamin). It is a type-dependent parameter. Default: 0.0 + :thetamin: Minimum pitch angle (thetamin) (< WindContPitchAngleIEC.thetamax). It is a type-dependent parameter. Default: 0.0 + :ttheta: Pitch time constant (ttheta) (>= 0). It is a type-dependent parameter. Default: 0 + :WindTurbineType3IEC: Wind turbine type 3 model with which this pitch control model is associated. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'dthetamax': [cgmesProfile.DY.value, ], + 'dthetamin': [cgmesProfile.DY.value, ], + 'kic': [cgmesProfile.DY.value, ], + 'kiomega': [cgmesProfile.DY.value, ], + 'kpc': [cgmesProfile.DY.value, ], + 'kpomega': [cgmesProfile.DY.value, ], + 'kpx': [cgmesProfile.DY.value, ], + 'thetamax': [cgmesProfile.DY.value, ], + 'thetamin': [cgmesProfile.DY.value, ], + 'ttheta': [cgmesProfile.DY.value, ], + 'WindTurbineType3IEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, dthetamax = 0.0, dthetamin = 0.0, kic = 0.0, kiomega = 0.0, kpc = 0.0, kpomega = 0.0, kpx = 0.0, thetamax = 0.0, thetamin = 0.0, ttheta = 0, WindTurbineType3IEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.dthetamax = dthetamax + self.dthetamin = dthetamin + self.kic = kic + self.kiomega = kiomega + self.kpc = kpc + self.kpomega = kpomega + self.kpx = kpx + self.thetamax = thetamax + self.thetamin = thetamin + self.ttheta = ttheta + self.WindTurbineType3IEC = WindTurbineType3IEC + + def __str__(self): + str = 'class=WindContPitchAngleIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindContQIEC.py b/cimpy/cgmes_v3_0_0/WindContQIEC.py new file mode 100644 index 00000000..bc7db332 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindContQIEC.py @@ -0,0 +1,100 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindContQIEC(IdentifiedObject): + ''' + Q control model. Reference: IEC 61400-27-1:2015, 5.6.5.7. + + :iqh1: Maximum reactive current injection during dip (iqh1). It is a type-dependent parameter. Default: 0.0 + :iqmax: Maximum reactive current injection (iqmax) (> WindContQIEC.iqmin). It is a type-dependent parameter. Default: 0.0 + :iqmin: Minimum reactive current injection (iqmin) (< WindContQIEC.iqmax). It is a type-dependent parameter. Default: 0.0 + :iqpost: Post fault reactive current injection (iqpost). It is a project-dependent parameter. Default: 0.0 + :kiq: Reactive power PI controller integration gain (KI,q). It is a type-dependent parameter. Default: 0.0 + :kiu: Voltage PI controller integration gain (KI,u). It is a type-dependent parameter. Default: 0.0 + :kpq: Reactive power PI controller proportional gain (KP,q). It is a type-dependent parameter. Default: 0.0 + :kpu: Voltage PI controller proportional gain (KP,u). It is a type-dependent parameter. Default: 0.0 + :kqv: Voltage scaling factor for UVRT current (Kqv). It is a project-dependent parameter. Default: 0.0 + :tpfiltq: Power measurement filter time constant (Tpfiltq) (>= 0). It is a type-dependent parameter. Default: 0 + :rdroop: Resistive component of voltage drop impedance (rdroop) (>= 0). It is a project-dependent parameter. Default: 0.0 + :tufiltq: Voltage measurement filter time constant (Tufiltq) (>= 0). It is a type-dependent parameter. Default: 0 + :tpost: Length of time period where post fault reactive power is injected (Tpost) (>= 0). It is a project-dependent parameter. Default: 0 + :tqord: Time constant in reactive power order lag (Tqord) (>= 0). It is a type-dependent parameter. Default: 0 + :udb1: Voltage deadband lower limit (udb1). It is a type-dependent parameter. Default: 0.0 + :udb2: Voltage deadband upper limit (udb2). It is a type-dependent parameter. Default: 0.0 + :umax: Maximum voltage in voltage PI controller integral term (umax) (> WindContQIEC.umin). It is a type-dependent parameter. Default: 0.0 + :umin: Minimum voltage in voltage PI controller integral term (umin) (< WindContQIEC.umax). It is a type-dependent parameter. Default: 0.0 + :uqdip: Voltage threshold for UVRT detection in Q control (uqdip). It is a type-dependent parameter. Default: 0.0 + :uref0: User-defined bias in voltage reference (uref0). It is a case-dependent parameter. Default: 0.0 + :windQcontrolModesType: Types of general wind turbine Q control modes (MqG). It is a project-dependent parameter. Default: None + :windUVRTQcontrolModesType: Types of UVRT Q control modes (MqUVRT). It is a project-dependent parameter. Default: None + :xdroop: Inductive component of voltage drop impedance (xdroop) (>= 0). It is a project-dependent parameter. Default: 0.0 + :WindTurbineType3or4IEC: Wind turbine type 3 or type 4 model with which this reactive control model is associated. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'iqh1': [cgmesProfile.DY.value, ], + 'iqmax': [cgmesProfile.DY.value, ], + 'iqmin': [cgmesProfile.DY.value, ], + 'iqpost': [cgmesProfile.DY.value, ], + 'kiq': [cgmesProfile.DY.value, ], + 'kiu': [cgmesProfile.DY.value, ], + 'kpq': [cgmesProfile.DY.value, ], + 'kpu': [cgmesProfile.DY.value, ], + 'kqv': [cgmesProfile.DY.value, ], + 'tpfiltq': [cgmesProfile.DY.value, ], + 'rdroop': [cgmesProfile.DY.value, ], + 'tufiltq': [cgmesProfile.DY.value, ], + 'tpost': [cgmesProfile.DY.value, ], + 'tqord': [cgmesProfile.DY.value, ], + 'udb1': [cgmesProfile.DY.value, ], + 'udb2': [cgmesProfile.DY.value, ], + 'umax': [cgmesProfile.DY.value, ], + 'umin': [cgmesProfile.DY.value, ], + 'uqdip': [cgmesProfile.DY.value, ], + 'uref0': [cgmesProfile.DY.value, ], + 'windQcontrolModesType': [cgmesProfile.DY.value, ], + 'windUVRTQcontrolModesType': [cgmesProfile.DY.value, ], + 'xdroop': [cgmesProfile.DY.value, ], + 'WindTurbineType3or4IEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, iqh1 = 0.0, iqmax = 0.0, iqmin = 0.0, iqpost = 0.0, kiq = 0.0, kiu = 0.0, kpq = 0.0, kpu = 0.0, kqv = 0.0, tpfiltq = 0, rdroop = 0.0, tufiltq = 0, tpost = 0, tqord = 0, udb1 = 0.0, udb2 = 0.0, umax = 0.0, umin = 0.0, uqdip = 0.0, uref0 = 0.0, windQcontrolModesType = None, windUVRTQcontrolModesType = None, xdroop = 0.0, WindTurbineType3or4IEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.iqh1 = iqh1 + self.iqmax = iqmax + self.iqmin = iqmin + self.iqpost = iqpost + self.kiq = kiq + self.kiu = kiu + self.kpq = kpq + self.kpu = kpu + self.kqv = kqv + self.tpfiltq = tpfiltq + self.rdroop = rdroop + self.tufiltq = tufiltq + self.tpost = tpost + self.tqord = tqord + self.udb1 = udb1 + self.udb2 = udb2 + self.umax = umax + self.umin = umin + self.uqdip = uqdip + self.uref0 = uref0 + self.windQcontrolModesType = windQcontrolModesType + self.windUVRTQcontrolModesType = windUVRTQcontrolModesType + self.xdroop = xdroop + self.WindTurbineType3or4IEC = WindTurbineType3or4IEC + + def __str__(self): + str = 'class=WindContQIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindContQLimIEC.py b/cimpy/cgmes_v3_0_0/WindContQLimIEC.py new file mode 100644 index 00000000..ac525ce2 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindContQLimIEC.py @@ -0,0 +1,37 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindContQLimIEC(IdentifiedObject): + ''' + Constant Q limitation model. Reference: IEC 61400-27-1:2015, 5.6.5.9. + + :qmax: Maximum reactive power (qmax) (> WindContQLimIEC.qmin). It is a type-dependent parameter. Default: 0.0 + :qmin: Minimum reactive power (qmin) (< WindContQLimIEC.qmax). It is a type-dependent parameter. Default: 0.0 + :WindTurbineType3or4IEC: Wind generator type 3 or type 4 model with which this constant Q limitation model is associated. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'qmax': [cgmesProfile.DY.value, ], + 'qmin': [cgmesProfile.DY.value, ], + 'WindTurbineType3or4IEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, qmax = 0.0, qmin = 0.0, WindTurbineType3or4IEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.qmax = qmax + self.qmin = qmin + self.WindTurbineType3or4IEC = WindTurbineType3or4IEC + + def __str__(self): + str = 'class=WindContQLimIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindContQPQULimIEC.py b/cimpy/cgmes_v3_0_0/WindContQPQULimIEC.py new file mode 100644 index 00000000..9c471a65 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindContQPQULimIEC.py @@ -0,0 +1,40 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindContQPQULimIEC(IdentifiedObject): + ''' + QP and QU limitation model. Reference: IEC 61400-27-1:2015, 5.6.5.10. + + :tpfiltql: Power measurement filter time constant for Q capacity (Tpfiltql) (>= 0). It is a type-dependent parameter. Default: 0 + :tufiltql: Voltage measurement filter time constant for Q capacity (Tufiltql) (>= 0). It is a type-dependent parameter. Default: 0 + :WindTurbineType3or4IEC: Wind generator type 3 or type 4 model with which this QP and QU limitation model is associated. Default: None + :WindDynamicsLookupTable: The wind dynamics lookup table associated with this QP and QU limitation model. Default: "list" + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'tpfiltql': [cgmesProfile.DY.value, ], + 'tufiltql': [cgmesProfile.DY.value, ], + 'WindTurbineType3or4IEC': [cgmesProfile.DY.value, ], + 'WindDynamicsLookupTable': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, tpfiltql = 0, tufiltql = 0, WindTurbineType3or4IEC = None, WindDynamicsLookupTable = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.tpfiltql = tpfiltql + self.tufiltql = tufiltql + self.WindTurbineType3or4IEC = WindTurbineType3or4IEC + self.WindDynamicsLookupTable = WindDynamicsLookupTable + + def __str__(self): + str = 'class=WindContQPQULimIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindContRotorRIEC.py b/cimpy/cgmes_v3_0_0/WindContRotorRIEC.py new file mode 100644 index 00000000..d017199c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindContRotorRIEC.py @@ -0,0 +1,58 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindContRotorRIEC(IdentifiedObject): + ''' + Rotor resistance control model. Reference: IEC 61400-27-1:2015, 5.6.5.3. + + :kirr: Integral gain in rotor resistance PI controller (KIrr). It is a type-dependent parameter. Default: 0.0 + :komegafilt: Filter gain for generator speed measurement (Komegafilt). It is a type-dependent parameter. Default: 0.0 + :kpfilt: Filter gain for power measurement (Kpfilt). It is a type-dependent parameter. Default: 0.0 + :kprr: Proportional gain in rotor resistance PI controller (KPrr). It is a type-dependent parameter. Default: 0.0 + :rmax: Maximum rotor resistance (rmax) (> WindContRotorRIEC.rmin). It is a type-dependent parameter. Default: 0.0 + :rmin: Minimum rotor resistance (rmin) (< WindContRotorRIEC.rmax). It is a type-dependent parameter. Default: 0.0 + :tomegafiltrr: Filter time constant for generator speed measurement (Tomegafiltrr) (>= 0). It is a type-dependent parameter. Default: 0 + :tpfiltrr: Filter time constant for power measurement (Tpfiltrr) (>= 0). It is a type-dependent parameter. Default: 0 + :WindDynamicsLookupTable: The wind dynamics lookup table associated with this rotor resistance control model. Default: "list" + :WindGenTurbineType2IEC: Wind turbine type 2 model with whitch this wind control rotor resistance model is associated. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'kirr': [cgmesProfile.DY.value, ], + 'komegafilt': [cgmesProfile.DY.value, ], + 'kpfilt': [cgmesProfile.DY.value, ], + 'kprr': [cgmesProfile.DY.value, ], + 'rmax': [cgmesProfile.DY.value, ], + 'rmin': [cgmesProfile.DY.value, ], + 'tomegafiltrr': [cgmesProfile.DY.value, ], + 'tpfiltrr': [cgmesProfile.DY.value, ], + 'WindDynamicsLookupTable': [cgmesProfile.DY.value, ], + 'WindGenTurbineType2IEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, kirr = 0.0, komegafilt = 0.0, kpfilt = 0.0, kprr = 0.0, rmax = 0.0, rmin = 0.0, tomegafiltrr = 0, tpfiltrr = 0, WindDynamicsLookupTable = "list", WindGenTurbineType2IEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.kirr = kirr + self.komegafilt = komegafilt + self.kpfilt = kpfilt + self.kprr = kprr + self.rmax = rmax + self.rmin = rmin + self.tomegafiltrr = tomegafiltrr + self.tpfiltrr = tpfiltrr + self.WindDynamicsLookupTable = WindDynamicsLookupTable + self.WindGenTurbineType2IEC = WindGenTurbineType2IEC + + def __str__(self): + str = 'class=WindContRotorRIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindDynamicsLookupTable.py b/cimpy/cgmes_v3_0_0/WindDynamicsLookupTable.py new file mode 100644 index 00000000..3c2342e4 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindDynamicsLookupTable.py @@ -0,0 +1,67 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindDynamicsLookupTable(IdentifiedObject): + ''' + Look up table for the purpose of wind standard models. + + :WindContCurrLimIEC: The current control limitation model with which this wind dynamics lookup table is associated. Default: None + :WindContPType3IEC: The P control type 3 model with which this wind dynamics lookup table is associated. Default: None + :WindContQPQULimIEC: The QP and QU limitation model with which this wind dynamics lookup table is associated. Default: None + :WindContRotorRIEC: The rotor resistance control model with which this wind dynamics lookup table is associated. Default: None + :input: Input value (x) for the lookup table function. Default: 0.0 + :lookupTableFunctionType: Type of the lookup table function. Default: None + :output: Output value (y) for the lookup table function. Default: 0.0 + :sequence: Sequence numbers of the pairs of the input (x) and the output (y) of the lookup table function. Default: 0 + :WindPlantFreqPcontrolIEC: The frequency and active power wind plant control model with which this wind dynamics lookup table is associated. Default: None + :WindProtectionIEC: The grid protection model with which this wind dynamics lookup table is associated. Default: None + :WindPlantReactiveControlIEC: The voltage and reactive power wind plant control model with which this wind dynamics lookup table is associated. Default: None + :WindGenType3bIEC: The generator type 3B model with which this wind dynamics lookup table is associated. Default: None + :WindPitchContPowerIEC: The pitch control power model with which this wind dynamics lookup table is associated. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'WindContCurrLimIEC': [cgmesProfile.DY.value, ], + 'WindContPType3IEC': [cgmesProfile.DY.value, ], + 'WindContQPQULimIEC': [cgmesProfile.DY.value, ], + 'WindContRotorRIEC': [cgmesProfile.DY.value, ], + 'input': [cgmesProfile.DY.value, ], + 'lookupTableFunctionType': [cgmesProfile.DY.value, ], + 'output': [cgmesProfile.DY.value, ], + 'sequence': [cgmesProfile.DY.value, ], + 'WindPlantFreqPcontrolIEC': [cgmesProfile.DY.value, ], + 'WindProtectionIEC': [cgmesProfile.DY.value, ], + 'WindPlantReactiveControlIEC': [cgmesProfile.DY.value, ], + 'WindGenType3bIEC': [cgmesProfile.DY.value, ], + 'WindPitchContPowerIEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, WindContCurrLimIEC = None, WindContPType3IEC = None, WindContQPQULimIEC = None, WindContRotorRIEC = None, input = 0.0, lookupTableFunctionType = None, output = 0.0, sequence = 0, WindPlantFreqPcontrolIEC = None, WindProtectionIEC = None, WindPlantReactiveControlIEC = None, WindGenType3bIEC = None, WindPitchContPowerIEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindContCurrLimIEC = WindContCurrLimIEC + self.WindContPType3IEC = WindContPType3IEC + self.WindContQPQULimIEC = WindContQPQULimIEC + self.WindContRotorRIEC = WindContRotorRIEC + self.input = input + self.lookupTableFunctionType = lookupTableFunctionType + self.output = output + self.sequence = sequence + self.WindPlantFreqPcontrolIEC = WindPlantFreqPcontrolIEC + self.WindProtectionIEC = WindProtectionIEC + self.WindPlantReactiveControlIEC = WindPlantReactiveControlIEC + self.WindGenType3bIEC = WindGenType3bIEC + self.WindPitchContPowerIEC = WindPitchContPowerIEC + + def __str__(self): + str = 'class=WindDynamicsLookupTable\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindGenTurbineType1aIEC.py b/cimpy/cgmes_v3_0_0/WindGenTurbineType1aIEC.py new file mode 100644 index 00000000..09b989d9 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindGenTurbineType1aIEC.py @@ -0,0 +1,31 @@ +from .WindTurbineType1or2IEC import WindTurbineType1or2IEC + + +class WindGenTurbineType1aIEC(WindTurbineType1or2IEC): + ''' + Wind turbine IEC type 1A. Reference: IEC 61400-27-1:2015, 5.5.2.2. + + :WindAeroConstIEC: Wind aerodynamic model associated with this wind turbine type 1A model. Default: None + ''' + + cgmesProfile = WindTurbineType1or2IEC.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'WindAeroConstIEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class WindTurbineType1or2IEC: \n' + WindTurbineType1or2IEC.__doc__ + + def __init__(self, WindAeroConstIEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindAeroConstIEC = WindAeroConstIEC + + def __str__(self): + str = 'class=WindGenTurbineType1aIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindGenTurbineType1bIEC.py b/cimpy/cgmes_v3_0_0/WindGenTurbineType1bIEC.py new file mode 100644 index 00000000..a35902d1 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindGenTurbineType1bIEC.py @@ -0,0 +1,31 @@ +from .WindTurbineType1or2IEC import WindTurbineType1or2IEC + + +class WindGenTurbineType1bIEC(WindTurbineType1or2IEC): + ''' + Wind turbine IEC type 1B. Reference: IEC 61400-27-1:2015, 5.5.2.3. + + :WindPitchContPowerIEC: Pitch control power model associated with this wind turbine type 1B model. Default: None + ''' + + cgmesProfile = WindTurbineType1or2IEC.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'WindPitchContPowerIEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class WindTurbineType1or2IEC: \n' + WindTurbineType1or2IEC.__doc__ + + def __init__(self, WindPitchContPowerIEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindPitchContPowerIEC = WindPitchContPowerIEC + + def __str__(self): + str = 'class=WindGenTurbineType1bIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindGenTurbineType2IEC.py b/cimpy/cgmes_v3_0_0/WindGenTurbineType2IEC.py new file mode 100644 index 00000000..6b50ab6c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindGenTurbineType2IEC.py @@ -0,0 +1,34 @@ +from .WindTurbineType1or2IEC import WindTurbineType1or2IEC + + +class WindGenTurbineType2IEC(WindTurbineType1or2IEC): + ''' + Wind turbine IEC type 2. Reference: IEC 61400-27-1:2015, 5.5.3. + + :WindContRotorRIEC: Wind control rotor resistance model associated with wind turbine type 2 model. Default: None + :WindPitchContPowerIEC: Pitch control power model associated with this wind turbine type 2 model. Default: None + ''' + + cgmesProfile = WindTurbineType1or2IEC.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'WindContRotorRIEC': [cgmesProfile.DY.value, ], + 'WindPitchContPowerIEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class WindTurbineType1or2IEC: \n' + WindTurbineType1or2IEC.__doc__ + + def __init__(self, WindContRotorRIEC = None, WindPitchContPowerIEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindContRotorRIEC = WindContRotorRIEC + self.WindPitchContPowerIEC = WindPitchContPowerIEC + + def __str__(self): + str = 'class=WindGenTurbineType2IEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindGenType3IEC.py b/cimpy/cgmes_v3_0_0/WindGenType3IEC.py new file mode 100644 index 00000000..68addaf0 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindGenType3IEC.py @@ -0,0 +1,40 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindGenType3IEC(IdentifiedObject): + ''' + Parent class supporting relationships to IEC wind turbines type 3 generator models of IEC type 3A and 3B. + + :dipmax: Maximum active current ramp rate (dipmax). It is a project-dependent parameter. Default: 0.0 + :diqmax: Maximum reactive current ramp rate (diqmax). It is a project-dependent parameter. Default: 0.0 + :xs: Electromagnetic transient reactance (xS). It is a type-dependent parameter. Default: 0.0 + :WindTurbineType3IEC: Wind turbine type 3 model with which this wind generator type 3 is associated. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'dipmax': [cgmesProfile.DY.value, ], + 'diqmax': [cgmesProfile.DY.value, ], + 'xs': [cgmesProfile.DY.value, ], + 'WindTurbineType3IEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, dipmax = 0.0, diqmax = 0.0, xs = 0.0, WindTurbineType3IEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.dipmax = dipmax + self.diqmax = diqmax + self.xs = xs + self.WindTurbineType3IEC = WindTurbineType3IEC + + def __str__(self): + str = 'class=WindGenType3IEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindGenType3aIEC.py b/cimpy/cgmes_v3_0_0/WindGenType3aIEC.py new file mode 100644 index 00000000..77b43fa5 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindGenType3aIEC.py @@ -0,0 +1,37 @@ +from .WindGenType3IEC import WindGenType3IEC + + +class WindGenType3aIEC(WindGenType3IEC): + ''' + IEC type 3A generator set model. Reference: IEC 61400-27-1:2015, 5.6.3.2. + + :kpc: Current PI controller proportional gain (KPc). It is a type-dependent parameter. Default: 0.0 + :tic: Current PI controller integration time constant (TIc) (>= 0). It is a type-dependent parameter. Default: 0 + :WindTurbineType4IEC: Wind turbine type 4 model with which this wind generator type 3A model is associated. Default: None + ''' + + cgmesProfile = WindGenType3IEC.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'kpc': [cgmesProfile.DY.value, ], + 'tic': [cgmesProfile.DY.value, ], + 'WindTurbineType4IEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class WindGenType3IEC: \n' + WindGenType3IEC.__doc__ + + def __init__(self, kpc = 0.0, tic = 0, WindTurbineType4IEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.kpc = kpc + self.tic = tic + self.WindTurbineType4IEC = WindTurbineType4IEC + + def __str__(self): + str = 'class=WindGenType3aIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindGenType3bIEC.py b/cimpy/cgmes_v3_0_0/WindGenType3bIEC.py new file mode 100644 index 00000000..38c469a3 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindGenType3bIEC.py @@ -0,0 +1,40 @@ +from .WindGenType3IEC import WindGenType3IEC + + +class WindGenType3bIEC(WindGenType3IEC): + ''' + IEC type 3B generator set model. Reference: IEC 61400-27-1:2015, 5.6.3.3. + + :WindDynamicsLookupTable: The wind dynamics lookup table associated with this generator type 3B model. Default: "list" + :mwtcwp: Crowbar control mode (MWTcwp). It is a case-dependent parameter. true = 1 in the IEC model false = 0 in the IEC model. Default: False + :tg: Current generation time constant (Tg) (>= 0). It is a type-dependent parameter. Default: 0 + :two: Time constant for crowbar washout filter (Two) (>= 0). It is a case-dependent parameter. Default: 0 + ''' + + cgmesProfile = WindGenType3IEC.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'WindDynamicsLookupTable': [cgmesProfile.DY.value, ], + 'mwtcwp': [cgmesProfile.DY.value, ], + 'tg': [cgmesProfile.DY.value, ], + 'two': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class WindGenType3IEC: \n' + WindGenType3IEC.__doc__ + + def __init__(self, WindDynamicsLookupTable = "list", mwtcwp = False, tg = 0, two = 0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindDynamicsLookupTable = WindDynamicsLookupTable + self.mwtcwp = mwtcwp + self.tg = tg + self.two = two + + def __str__(self): + str = 'class=WindGenType3bIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindGenType4IEC.py b/cimpy/cgmes_v3_0_0/WindGenType4IEC.py new file mode 100644 index 00000000..b4feb16b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindGenType4IEC.py @@ -0,0 +1,46 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindGenType4IEC(IdentifiedObject): + ''' + IEC type 4 generator set model. Reference: IEC 61400-27-1:2015, 5.6.3.4. + + :dipmax: Maximum active current ramp rate (dipmax). It is a project-dependent parameter. Default: 0.0 + :diqmin: Minimum reactive current ramp rate (diqmin). It is a project-dependent parameter. Default: 0.0 + :diqmax: Maximum reactive current ramp rate (diqmax). It is a project-dependent parameter. Default: 0.0 + :tg: Time constant (Tg) (>= 0). It is a type-dependent parameter. Default: 0 + :WindTurbineType4aIEC: Wind turbine type 4A model with which this wind generator type 4 model is associated. Default: None + :WindTurbineType4bIEC: Wind turbine type 4B model with which this wind generator type 4 model is associated. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'dipmax': [cgmesProfile.DY.value, ], + 'diqmin': [cgmesProfile.DY.value, ], + 'diqmax': [cgmesProfile.DY.value, ], + 'tg': [cgmesProfile.DY.value, ], + 'WindTurbineType4aIEC': [cgmesProfile.DY.value, ], + 'WindTurbineType4bIEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, dipmax = 0.0, diqmin = 0.0, diqmax = 0.0, tg = 0, WindTurbineType4aIEC = None, WindTurbineType4bIEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.dipmax = dipmax + self.diqmin = diqmin + self.diqmax = diqmax + self.tg = tg + self.WindTurbineType4aIEC = WindTurbineType4aIEC + self.WindTurbineType4bIEC = WindTurbineType4bIEC + + def __str__(self): + str = 'class=WindGenType4IEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindGenUnitKind.py b/cimpy/cgmes_v3_0_0/WindGenUnitKind.py new file mode 100644 index 00000000..d97d352f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindGenUnitKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class WindGenUnitKind(Base): + ''' + Kind of wind generating unit. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=WindGenUnitKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindGeneratingUnit.py b/cimpy/cgmes_v3_0_0/WindGeneratingUnit.py new file mode 100644 index 00000000..47a4ae7c --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindGeneratingUnit.py @@ -0,0 +1,34 @@ +from .GeneratingUnit import GeneratingUnit + + +class WindGeneratingUnit(GeneratingUnit): + ''' + A wind driven generating unit, connected to the grid by means of a rotating machine. May be used to represent a single turbine or an aggregation. + + :windGenUnitType: The kind of wind generating unit. Default: None + :WindPowerPlant: A wind power plant may have wind generating units. Default: None + ''' + + cgmesProfile = GeneratingUnit.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.SSH.value, cgmesProfile.EQ.value, ], + 'windGenUnitType': [cgmesProfile.EQ.value, ], + 'WindPowerPlant': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class GeneratingUnit: \n' + GeneratingUnit.__doc__ + + def __init__(self, windGenUnitType = None, WindPowerPlant = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.windGenUnitType = windGenUnitType + self.WindPowerPlant = WindPowerPlant + + def __str__(self): + str = 'class=WindGeneratingUnit\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindLookupTableFunctionKind.py b/cimpy/cgmes_v3_0_0/WindLookupTableFunctionKind.py new file mode 100644 index 00000000..020c6c1b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindLookupTableFunctionKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class WindLookupTableFunctionKind(Base): + ''' + Function of the lookup table. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=WindLookupTableFunctionKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindMechIEC.py b/cimpy/cgmes_v3_0_0/WindMechIEC.py new file mode 100644 index 00000000..5759863a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindMechIEC.py @@ -0,0 +1,49 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindMechIEC(IdentifiedObject): + ''' + Two mass model. Reference: IEC 61400-27-1:2015, 5.6.2.1. + + :cdrt: Drive train damping (cdrt). It is a type-dependent parameter. Default: 0.0 + :hgen: Inertia constant of generator (Hgen) (>= 0). It is a type-dependent parameter. Default: 0 + :hwtr: Inertia constant of wind turbine rotor (HWTR) (>= 0). It is a type-dependent parameter. Default: 0 + :kdrt: Drive train stiffness (kdrt). It is a type-dependent parameter. Default: 0.0 + :WindTurbineType3IEC: Wind turbine type 3 model with which this wind mechanical model is associated. Default: None + :WindTurbineType1or2IEC: Wind generator type 1 or type 2 model with which this wind mechanical model is associated. Default: None + :WindTurbineType4bIEC: Wind turbine type 4B model with which this wind mechanical model is associated. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'cdrt': [cgmesProfile.DY.value, ], + 'hgen': [cgmesProfile.DY.value, ], + 'hwtr': [cgmesProfile.DY.value, ], + 'kdrt': [cgmesProfile.DY.value, ], + 'WindTurbineType3IEC': [cgmesProfile.DY.value, ], + 'WindTurbineType1or2IEC': [cgmesProfile.DY.value, ], + 'WindTurbineType4bIEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, cdrt = 0.0, hgen = 0, hwtr = 0, kdrt = 0.0, WindTurbineType3IEC = None, WindTurbineType1or2IEC = None, WindTurbineType4bIEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.cdrt = cdrt + self.hgen = hgen + self.hwtr = hwtr + self.kdrt = kdrt + self.WindTurbineType3IEC = WindTurbineType3IEC + self.WindTurbineType1or2IEC = WindTurbineType1or2IEC + self.WindTurbineType4bIEC = WindTurbineType4bIEC + + def __str__(self): + str = 'class=WindMechIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindPitchContPowerIEC.py b/cimpy/cgmes_v3_0_0/WindPitchContPowerIEC.py new file mode 100644 index 00000000..c27e37c4 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindPitchContPowerIEC.py @@ -0,0 +1,58 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindPitchContPowerIEC(IdentifiedObject): + ''' + Pitch control power model. Reference: IEC 61400-27-1:2015, 5.6.5.1. + + :WindDynamicsLookupTable: The wind dynamics lookup table associated with this pitch control power model. Default: "list" + :WindGenTurbineType1bIEC: Wind turbine type 1B model with which this pitch control power model is associated. Default: None + :WindGenTurbineType2IEC: Wind turbine type 2 model with which this pitch control power model is associated. Default: None + :dpmax: Rate limit for increasing power (dpmax) (> WindPitchContPowerIEC.dpmin). It is a type-dependent parameter. Default: 0.0 + :dpmin: Rate limit for decreasing power (dpmin) (< WindPitchContPowerIEC.dpmax). It is a type-dependent parameter. Default: 0.0 + :pmin: Minimum power setting (pmin). It is a type-dependent parameter. Default: 0.0 + :pset: If pinit < pset then power will be ramped down to pmin. It is (pset) in the IEC 61400-27-1:2015. It is a type-dependent parameter. Default: 0.0 + :t1: Lag time constant (T1) (>= 0). It is a type-dependent parameter. Default: 0 + :tr: Voltage measurement time constant (Tr) (>= 0). It is a type-dependent parameter. Default: 0 + :uuvrt: Dip detection threshold (uUVRT). It is a type-dependent parameter. Default: 0.0 + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'WindDynamicsLookupTable': [cgmesProfile.DY.value, ], + 'WindGenTurbineType1bIEC': [cgmesProfile.DY.value, ], + 'WindGenTurbineType2IEC': [cgmesProfile.DY.value, ], + 'dpmax': [cgmesProfile.DY.value, ], + 'dpmin': [cgmesProfile.DY.value, ], + 'pmin': [cgmesProfile.DY.value, ], + 'pset': [cgmesProfile.DY.value, ], + 't1': [cgmesProfile.DY.value, ], + 'tr': [cgmesProfile.DY.value, ], + 'uuvrt': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, WindDynamicsLookupTable = "list", WindGenTurbineType1bIEC = None, WindGenTurbineType2IEC = None, dpmax = 0.0, dpmin = 0.0, pmin = 0.0, pset = 0.0, t1 = 0, tr = 0, uuvrt = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindDynamicsLookupTable = WindDynamicsLookupTable + self.WindGenTurbineType1bIEC = WindGenTurbineType1bIEC + self.WindGenTurbineType2IEC = WindGenTurbineType2IEC + self.dpmax = dpmax + self.dpmin = dpmin + self.pmin = pmin + self.pset = pset + self.t1 = t1 + self.tr = tr + self.uuvrt = uuvrt + + def __str__(self): + str = 'class=WindPitchContPowerIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindPlantDynamics.py b/cimpy/cgmes_v3_0_0/WindPlantDynamics.py new file mode 100644 index 00000000..9ca5dc01 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindPlantDynamics.py @@ -0,0 +1,34 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class WindPlantDynamics(DynamicsFunctionBlock): + ''' + Parent class supporting relationships to wind turbines type 3 and type 4 and wind plant IEC and user-defined wind plants including their control models. + + :RemoteInputSignal: The remote signal with which this power plant is associated. Default: None + :WindTurbineType3or4Dynamics: The wind turbine type 3 or type 4 associated with this wind plant. Default: "list" + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'RemoteInputSignal': [cgmesProfile.DY.value, ], + 'WindTurbineType3or4Dynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, RemoteInputSignal = None, WindTurbineType3or4Dynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.RemoteInputSignal = RemoteInputSignal + self.WindTurbineType3or4Dynamics = WindTurbineType3or4Dynamics + + def __str__(self): + str = 'class=WindPlantDynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindPlantFreqPcontrolIEC.py b/cimpy/cgmes_v3_0_0/WindPlantFreqPcontrolIEC.py new file mode 100644 index 00000000..bd60f93b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindPlantFreqPcontrolIEC.py @@ -0,0 +1,79 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindPlantFreqPcontrolIEC(IdentifiedObject): + ''' + Frequency and active power controller model. Reference: IEC 61400-27-1:2015, Annex D. + + :WindDynamicsLookupTable: The wind dynamics lookup table associated with this frequency and active power wind plant model. Default: "list" + :dprefmax: Maximum ramp rate of pWTref request from the plant controller to the wind turbines (dprefmax) (> WindPlantFreqPcontrolIEC.dprefmin). It is a case-dependent parameter. Default: 0.0 + :dprefmin: Minimum (negative) ramp rate of pWTref request from the plant controller to the wind turbines (dprefmin) (< WindPlantFreqPcontrolIEC.dprefmax). It is a project-dependent parameter. Default: 0.0 + :dpwprefmax: Maximum positive ramp rate for wind plant power reference (dpWPrefmax) (> WindPlantFreqPcontrolIEC.dpwprefmin). It is a project-dependent parameter. Default: 0.0 + :dpwprefmin: Maximum negative ramp rate for wind plant power reference (dpWPrefmin) (< WindPlantFreqPcontrolIEC.dpwprefmax). It is a project-dependent parameter. Default: 0.0 + :prefmax: Maximum pWTref request from the plant controller to the wind turbines (prefmax) (> WindPlantFreqPcontrolIEC.prefmin). It is a project-dependent parameter. Default: 0.0 + :prefmin: Minimum pWTref request from the plant controller to the wind turbines (prefmin) (< WindPlantFreqPcontrolIEC.prefmax). It is a project-dependent parameter. Default: 0.0 + :kiwpp: Plant P controller integral gain (KIWPp). It is a project-dependent parameter. Default: 0.0 + :kiwppmax: Maximum PI integrator term (KIWPpmax) (> WindPlantFreqPcontrolIEC.kiwppmin). It is a project-dependent parameter. Default: 0.0 + :kiwppmin: Minimum PI integrator term (KIWPpmin) (< WindPlantFreqPcontrolIEC.kiwppmax). It is a project-dependent parameter. Default: 0.0 + :kpwpp: Plant P controller proportional gain (KPWPp). It is a project-dependent parameter. Default: 0.0 + :kwppref: Power reference gain (KWPpref). It is a project-dependent parameter. Default: 0.0 + :tpft: Lead time constant in reference value transfer function (Tpft) (>= 0). It is a project-dependent parameter. Default: 0 + :tpfv: Lag time constant in reference value transfer function (Tpfv) (>= 0). It is a project-dependent parameter. Default: 0 + :twpffiltp: Filter time constant for frequency measurement (TWPffiltp) (>= 0). It is a project-dependent parameter. Default: 0 + :twppfiltp: Filter time constant for active power measurement (TWPpfiltp) (>= 0). It is a project-dependent parameter. Default: 0 + :WindPlantIEC: Wind plant model with which this wind plant frequency and active power control is associated. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'WindDynamicsLookupTable': [cgmesProfile.DY.value, ], + 'dprefmax': [cgmesProfile.DY.value, ], + 'dprefmin': [cgmesProfile.DY.value, ], + 'dpwprefmax': [cgmesProfile.DY.value, ], + 'dpwprefmin': [cgmesProfile.DY.value, ], + 'prefmax': [cgmesProfile.DY.value, ], + 'prefmin': [cgmesProfile.DY.value, ], + 'kiwpp': [cgmesProfile.DY.value, ], + 'kiwppmax': [cgmesProfile.DY.value, ], + 'kiwppmin': [cgmesProfile.DY.value, ], + 'kpwpp': [cgmesProfile.DY.value, ], + 'kwppref': [cgmesProfile.DY.value, ], + 'tpft': [cgmesProfile.DY.value, ], + 'tpfv': [cgmesProfile.DY.value, ], + 'twpffiltp': [cgmesProfile.DY.value, ], + 'twppfiltp': [cgmesProfile.DY.value, ], + 'WindPlantIEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, WindDynamicsLookupTable = "list", dprefmax = 0.0, dprefmin = 0.0, dpwprefmax = 0.0, dpwprefmin = 0.0, prefmax = 0.0, prefmin = 0.0, kiwpp = 0.0, kiwppmax = 0.0, kiwppmin = 0.0, kpwpp = 0.0, kwppref = 0.0, tpft = 0, tpfv = 0, twpffiltp = 0, twppfiltp = 0, WindPlantIEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindDynamicsLookupTable = WindDynamicsLookupTable + self.dprefmax = dprefmax + self.dprefmin = dprefmin + self.dpwprefmax = dpwprefmax + self.dpwprefmin = dpwprefmin + self.prefmax = prefmax + self.prefmin = prefmin + self.kiwpp = kiwpp + self.kiwppmax = kiwppmax + self.kiwppmin = kiwppmin + self.kpwpp = kpwpp + self.kwppref = kwppref + self.tpft = tpft + self.tpfv = tpfv + self.twpffiltp = twpffiltp + self.twppfiltp = twppfiltp + self.WindPlantIEC = WindPlantIEC + + def __str__(self): + str = 'class=WindPlantFreqPcontrolIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindPlantIEC.py b/cimpy/cgmes_v3_0_0/WindPlantIEC.py new file mode 100644 index 00000000..1b140f68 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindPlantIEC.py @@ -0,0 +1,34 @@ +from .WindPlantDynamics import WindPlantDynamics + + +class WindPlantIEC(WindPlantDynamics): + ''' + Simplified IEC type plant level model. Reference: IEC 61400-27-1:2015, Annex D. + + :WindPlantFreqPcontrolIEC: Wind plant frequency and active power control model associated with this wind plant. Default: None + :WindPlantReactiveControlIEC: Wind plant model with which this wind reactive control is associated. Default: None + ''' + + cgmesProfile = WindPlantDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'WindPlantFreqPcontrolIEC': [cgmesProfile.DY.value, ], + 'WindPlantReactiveControlIEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class WindPlantDynamics: \n' + WindPlantDynamics.__doc__ + + def __init__(self, WindPlantFreqPcontrolIEC = None, WindPlantReactiveControlIEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindPlantFreqPcontrolIEC = WindPlantFreqPcontrolIEC + self.WindPlantReactiveControlIEC = WindPlantReactiveControlIEC + + def __str__(self): + str = 'class=WindPlantIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindPlantQcontrolModeKind.py b/cimpy/cgmes_v3_0_0/WindPlantQcontrolModeKind.py new file mode 100644 index 00000000..40dcd710 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindPlantQcontrolModeKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class WindPlantQcontrolModeKind(Base): + ''' + Reactive power/voltage controller mode. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=WindPlantQcontrolModeKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindPlantReactiveControlIEC.py b/cimpy/cgmes_v3_0_0/WindPlantReactiveControlIEC.py new file mode 100644 index 00000000..718f4b3a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindPlantReactiveControlIEC.py @@ -0,0 +1,88 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindPlantReactiveControlIEC(IdentifiedObject): + ''' + Simplified plant voltage and reactive power control model for use with type 3 and type 4 wind turbine models. Reference: IEC 61400-27-1:2015, Annex D. + + :WindDynamicsLookupTable: The wind dynamics lookup table associated with this voltage and reactive power wind plant model. Default: "list" + :WindPlantIEC: Wind plant reactive control model associated with this wind plant. Default: None + :dxrefmax: Maximum positive ramp rate for wind turbine reactive power/voltage reference (dxrefmax) (> WindPlantReactiveControlIEC.dxrefmin). It is a project-dependent parameter. Default: 0.0 + :dxrefmin: Maximum negative ramp rate for wind turbine reactive power/voltage reference (dxrefmin) (< WindPlantReactiveControlIEC.dxrefmax). It is a project-dependent parameter. Default: 0.0 + :kiwpx: Plant Q controller integral gain (KIWPx). It is a project-dependent parameter. Default: 0.0 + :kiwpxmax: Maximum reactive power/voltage reference from integration (KIWPxmax) (> WindPlantReactiveControlIEC.kiwpxmin). It is a project-dependent parameter. Default: 0.0 + :kiwpxmin: Minimum reactive power/voltage reference from integration (KIWPxmin) (< WindPlantReactiveControlIEC.kiwpxmax). It is a project-dependent parameter. Default: 0.0 + :kpwpx: Plant Q controller proportional gain (KPWPx). It is a project-dependent parameter. Default: 0.0 + :kwpqref: Reactive power reference gain (KWPqref). It is a project-dependent parameter. Default: 0.0 + :kwpqu: Plant voltage control droop (KWPqu). It is a project-dependent parameter. Default: 0.0 + :tuqfilt: Filter time constant for voltage-dependent reactive power (Tuqfilt) (>= 0). It is a project-dependent parameter. Default: 0 + :twppfiltq: Filter time constant for active power measurement (TWPpfiltq) (>= 0). It is a project-dependent parameter. Default: 0 + :twpqfiltq: Filter time constant for reactive power measurement (TWPqfiltq) (>= 0). It is a project-dependent parameter. Default: 0 + :twpufiltq: Filter time constant for voltage measurement (TWPufiltq) (>= 0). It is a project-dependent parameter. Default: 0 + :txft: Lead time constant in reference value transfer function (Txft) (>= 0). It is a project-dependent parameter. Default: 0 + :txfv: Lag time constant in reference value transfer function (Txfv) (>= 0). It is a project-dependent parameter. Default: 0 + :uwpqdip: Voltage threshold for UVRT detection in Q control (uWPqdip). It is a project-dependent parameter. Default: 0.0 + :windPlantQcontrolModesType: Reactive power/voltage controller mode (MWPqmode). It is a case-dependent parameter. Default: None + :xrefmax: Maximum xWTref (qWTref or delta uWTref) request from the plant controller (xrefmax) (> WindPlantReactiveControlIEC.xrefmin). It is a case-dependent parameter. Default: 0.0 + :xrefmin: Minimum xWTref (qWTref or delta uWTref) request from the plant controller (xrefmin) (< WindPlantReactiveControlIEC.xrefmax). It is a project-dependent parameter. Default: 0.0 + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'WindDynamicsLookupTable': [cgmesProfile.DY.value, ], + 'WindPlantIEC': [cgmesProfile.DY.value, ], + 'dxrefmax': [cgmesProfile.DY.value, ], + 'dxrefmin': [cgmesProfile.DY.value, ], + 'kiwpx': [cgmesProfile.DY.value, ], + 'kiwpxmax': [cgmesProfile.DY.value, ], + 'kiwpxmin': [cgmesProfile.DY.value, ], + 'kpwpx': [cgmesProfile.DY.value, ], + 'kwpqref': [cgmesProfile.DY.value, ], + 'kwpqu': [cgmesProfile.DY.value, ], + 'tuqfilt': [cgmesProfile.DY.value, ], + 'twppfiltq': [cgmesProfile.DY.value, ], + 'twpqfiltq': [cgmesProfile.DY.value, ], + 'twpufiltq': [cgmesProfile.DY.value, ], + 'txft': [cgmesProfile.DY.value, ], + 'txfv': [cgmesProfile.DY.value, ], + 'uwpqdip': [cgmesProfile.DY.value, ], + 'windPlantQcontrolModesType': [cgmesProfile.DY.value, ], + 'xrefmax': [cgmesProfile.DY.value, ], + 'xrefmin': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, WindDynamicsLookupTable = "list", WindPlantIEC = None, dxrefmax = 0.0, dxrefmin = 0.0, kiwpx = 0.0, kiwpxmax = 0.0, kiwpxmin = 0.0, kpwpx = 0.0, kwpqref = 0.0, kwpqu = 0.0, tuqfilt = 0, twppfiltq = 0, twpqfiltq = 0, twpufiltq = 0, txft = 0, txfv = 0, uwpqdip = 0.0, windPlantQcontrolModesType = None, xrefmax = 0.0, xrefmin = 0.0, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindDynamicsLookupTable = WindDynamicsLookupTable + self.WindPlantIEC = WindPlantIEC + self.dxrefmax = dxrefmax + self.dxrefmin = dxrefmin + self.kiwpx = kiwpx + self.kiwpxmax = kiwpxmax + self.kiwpxmin = kiwpxmin + self.kpwpx = kpwpx + self.kwpqref = kwpqref + self.kwpqu = kwpqu + self.tuqfilt = tuqfilt + self.twppfiltq = twppfiltq + self.twpqfiltq = twpqfiltq + self.twpufiltq = twpufiltq + self.txft = txft + self.txfv = txfv + self.uwpqdip = uwpqdip + self.windPlantQcontrolModesType = windPlantQcontrolModesType + self.xrefmax = xrefmax + self.xrefmin = xrefmin + + def __str__(self): + str = 'class=WindPlantReactiveControlIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindPlantUserDefined.py b/cimpy/cgmes_v3_0_0/WindPlantUserDefined.py new file mode 100644 index 00000000..f5a36c02 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindPlantUserDefined.py @@ -0,0 +1,34 @@ +from .WindPlantDynamics import WindPlantDynamics + + +class WindPlantUserDefined(WindPlantDynamics): + ''' + Wind plant function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = WindPlantDynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class WindPlantDynamics: \n' + WindPlantDynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=WindPlantUserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindPowerPlant.py b/cimpy/cgmes_v3_0_0/WindPowerPlant.py new file mode 100644 index 00000000..27860295 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindPowerPlant.py @@ -0,0 +1,31 @@ +from .PowerSystemResource import PowerSystemResource + + +class WindPowerPlant(PowerSystemResource): + ''' + Wind power plant. + + :WindGeneratingUnits: A wind generating unit or units may be a member of a wind power plant. Default: "list" + ''' + + cgmesProfile = PowerSystemResource.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + 'WindGeneratingUnits': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class PowerSystemResource: \n' + PowerSystemResource.__doc__ + + def __init__(self, WindGeneratingUnits = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindGeneratingUnits = WindGeneratingUnits + + def __str__(self): + str = 'class=WindPowerPlant\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindProtectionIEC.py b/cimpy/cgmes_v3_0_0/WindProtectionIEC.py new file mode 100644 index 00000000..1ab71857 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindProtectionIEC.py @@ -0,0 +1,58 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindProtectionIEC(IdentifiedObject): + ''' + The grid protection model includes protection against over- and under-voltage, and against over- and under-frequency. Reference: IEC 61400-27-1:2015, 5.6.6. + + :WindDynamicsLookupTable: The wind dynamics lookup table associated with this grid protection model. Default: "list" + :dfimax: Maximum rate of change of frequency (dFmax). It is a type-dependent parameter. Default: 0.0 + :fover: Wind turbine over frequency protection activation threshold (fover). It is a project-dependent parameter. Default: 0.0 + :funder: Wind turbine under frequency protection activation threshold (funder). It is a project-dependent parameter. Default: 0.0 + :mzc: Zero crossing measurement mode (Mzc). It is a type-dependent parameter. true = WT protection system uses zero crossings to detect frequency (1 in the IEC model) false = WT protection system does not use zero crossings to detect frequency (0 in the IEC model). Default: False + :tfma: Time interval of moving average window (TfMA) (>= 0). It is a type-dependent parameter. Default: 0 + :uover: Wind turbine over voltage protection activation threshold (uover). It is a project-dependent parameter. Default: 0.0 + :uunder: Wind turbine under voltage protection activation threshold (uunder). It is a project-dependent parameter. Default: 0.0 + :WindTurbineType3or4IEC: Wind generator type 3 or type 4 model with which this wind turbine protection model is associated. Default: None + :WindTurbineType1or2IEC: Wind generator type 1 or type 2 model with which this wind turbine protection model is associated. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'WindDynamicsLookupTable': [cgmesProfile.DY.value, ], + 'dfimax': [cgmesProfile.DY.value, ], + 'fover': [cgmesProfile.DY.value, ], + 'funder': [cgmesProfile.DY.value, ], + 'mzc': [cgmesProfile.DY.value, ], + 'tfma': [cgmesProfile.DY.value, ], + 'uover': [cgmesProfile.DY.value, ], + 'uunder': [cgmesProfile.DY.value, ], + 'WindTurbineType3or4IEC': [cgmesProfile.DY.value, ], + 'WindTurbineType1or2IEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, WindDynamicsLookupTable = "list", dfimax = 0.0, fover = 0.0, funder = 0.0, mzc = False, tfma = 0, uover = 0.0, uunder = 0.0, WindTurbineType3or4IEC = None, WindTurbineType1or2IEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindDynamicsLookupTable = WindDynamicsLookupTable + self.dfimax = dfimax + self.fover = fover + self.funder = funder + self.mzc = mzc + self.tfma = tfma + self.uover = uover + self.uunder = uunder + self.WindTurbineType3or4IEC = WindTurbineType3or4IEC + self.WindTurbineType1or2IEC = WindTurbineType1or2IEC + + def __str__(self): + str = 'class=WindProtectionIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindQcontrolModeKind.py b/cimpy/cgmes_v3_0_0/WindQcontrolModeKind.py new file mode 100644 index 00000000..6dc80182 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindQcontrolModeKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class WindQcontrolModeKind(Base): + ''' + General wind turbine Q control modes MqG. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=WindQcontrolModeKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindRefFrameRotIEC.py b/cimpy/cgmes_v3_0_0/WindRefFrameRotIEC.py new file mode 100644 index 00000000..aff6777f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindRefFrameRotIEC.py @@ -0,0 +1,40 @@ +from .IdentifiedObject import IdentifiedObject + + +class WindRefFrameRotIEC(IdentifiedObject): + ''' + Reference frame rotation model. Reference: IEC 61400-27-1:2015, 5.6.3.5. + + :tpll: Time constant for PLL first order filter model (TPLL) (>= 0). It is a type-dependent parameter. Default: 0 + :upll1: Voltage below which the angle of the voltage is filtered and possibly also frozen (uPLL1). It is a type-dependent parameter. Default: 0.0 + :upll2: Voltage (uPLL2) below which the angle of the voltage is frozen if uPLL2 is smaller or equal to uPLL1 . It is a type-dependent parameter. Default: 0.0 + :WindTurbineType3or4IEC: Wind turbine type 3 or type 4 model with which this reference frame rotation model is associated. Default: None + ''' + + cgmesProfile = IdentifiedObject.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'tpll': [cgmesProfile.DY.value, ], + 'upll1': [cgmesProfile.DY.value, ], + 'upll2': [cgmesProfile.DY.value, ], + 'WindTurbineType3or4IEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class IdentifiedObject: \n' + IdentifiedObject.__doc__ + + def __init__(self, tpll = 0, upll1 = 0.0, upll2 = 0.0, WindTurbineType3or4IEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.tpll = tpll + self.upll1 = upll1 + self.upll2 = upll2 + self.WindTurbineType3or4IEC = WindTurbineType3or4IEC + + def __str__(self): + str = 'class=WindRefFrameRotIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindTurbineType1or2Dynamics.py b/cimpy/cgmes_v3_0_0/WindTurbineType1or2Dynamics.py new file mode 100644 index 00000000..a2e26c5f --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindTurbineType1or2Dynamics.py @@ -0,0 +1,34 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class WindTurbineType1or2Dynamics(DynamicsFunctionBlock): + ''' + Parent class supporting relationships to wind turbines type 1 and type 2 and their control models. Generator model for wind turbine of type 1 or type 2 is a standard asynchronous generator model. + + :RemoteInputSignal: Remote input signal used by this wind generator type 1 or type 2 model. Default: None + :AsynchronousMachineDynamics: Asynchronous machine model with which this wind generator type 1 or type 2 model is associated. Default: None + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'RemoteInputSignal': [cgmesProfile.DY.value, ], + 'AsynchronousMachineDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, RemoteInputSignal = None, AsynchronousMachineDynamics = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.RemoteInputSignal = RemoteInputSignal + self.AsynchronousMachineDynamics = AsynchronousMachineDynamics + + def __str__(self): + str = 'class=WindTurbineType1or2Dynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindTurbineType1or2IEC.py b/cimpy/cgmes_v3_0_0/WindTurbineType1or2IEC.py new file mode 100644 index 00000000..fa545aaf --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindTurbineType1or2IEC.py @@ -0,0 +1,34 @@ +from .WindTurbineType1or2Dynamics import WindTurbineType1or2Dynamics + + +class WindTurbineType1or2IEC(WindTurbineType1or2Dynamics): + ''' + Parent class supporting relationships to IEC wind turbines type 1 and type 2 including their control models. Generator model for wind turbine of IEC type 1 or type 2 is a standard asynchronous generator model. Reference: IEC 61400-27-1:2015, 5.5.2 and 5.5.3. + + :WindMechIEC: Wind mechanical model associated with this wind generator type 1 or type 2 model. Default: None + :WindProtectionIEC: Wind turbune protection model associated with this wind generator type 1 or type 2 model. Default: None + ''' + + cgmesProfile = WindTurbineType1or2Dynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'WindMechIEC': [cgmesProfile.DY.value, ], + 'WindProtectionIEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class WindTurbineType1or2Dynamics: \n' + WindTurbineType1or2Dynamics.__doc__ + + def __init__(self, WindMechIEC = None, WindProtectionIEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindMechIEC = WindMechIEC + self.WindProtectionIEC = WindProtectionIEC + + def __str__(self): + str = 'class=WindTurbineType1or2IEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindTurbineType3IEC.py b/cimpy/cgmes_v3_0_0/WindTurbineType3IEC.py new file mode 100644 index 00000000..ad36f16d --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindTurbineType3IEC.py @@ -0,0 +1,46 @@ +from .WindTurbineType3or4IEC import WindTurbineType3or4IEC + + +class WindTurbineType3IEC(WindTurbineType3or4IEC): + ''' + Parent class supporting relationships to IEC wind turbines type 3 including their control models. + + :WindAeroOneDimIEC: Wind aerodynamic model associated with this wind generator type 3 model. Default: None + :WindAeroTwoDimIEC: Wind aerodynamic model associated with this wind turbine type 3 model. Default: None + :WindContPitchAngleIEC: Wind control pitch angle model associated with this wind turbine type 3. Default: None + :WindContPType3IEC: Wind control P type 3 model associated with this wind turbine type 3 model. Default: None + :WindGenType3IEC: Wind generator type 3 model associated with this wind turbine type 3 model. Default: None + :WindMechIEC: Wind mechanical model associated with this wind turbine type 3 model. Default: None + ''' + + cgmesProfile = WindTurbineType3or4IEC.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'WindAeroOneDimIEC': [cgmesProfile.DY.value, ], + 'WindAeroTwoDimIEC': [cgmesProfile.DY.value, ], + 'WindContPitchAngleIEC': [cgmesProfile.DY.value, ], + 'WindContPType3IEC': [cgmesProfile.DY.value, ], + 'WindGenType3IEC': [cgmesProfile.DY.value, ], + 'WindMechIEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class WindTurbineType3or4IEC: \n' + WindTurbineType3or4IEC.__doc__ + + def __init__(self, WindAeroOneDimIEC = None, WindAeroTwoDimIEC = None, WindContPitchAngleIEC = None, WindContPType3IEC = None, WindGenType3IEC = None, WindMechIEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindAeroOneDimIEC = WindAeroOneDimIEC + self.WindAeroTwoDimIEC = WindAeroTwoDimIEC + self.WindContPitchAngleIEC = WindContPitchAngleIEC + self.WindContPType3IEC = WindContPType3IEC + self.WindGenType3IEC = WindGenType3IEC + self.WindMechIEC = WindMechIEC + + def __str__(self): + str = 'class=WindTurbineType3IEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindTurbineType3or4Dynamics.py b/cimpy/cgmes_v3_0_0/WindTurbineType3or4Dynamics.py new file mode 100644 index 00000000..00524a15 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindTurbineType3or4Dynamics.py @@ -0,0 +1,37 @@ +from .DynamicsFunctionBlock import DynamicsFunctionBlock + + +class WindTurbineType3or4Dynamics(DynamicsFunctionBlock): + ''' + Parent class supporting relationships to wind turbines type 3 and type 4 and wind plant including their control models. + + :PowerElectronicsConnection: The power electronics connection associated with this wind turbine type 3 or type 4 dynamics model. Default: None + :RemoteInputSignal: Remote input signal used by these wind turbine type 3 or type 4 models. Default: None + :WindPlantDynamics: The wind plant with which the wind turbines type 3 or type 4 are associated. Default: None + ''' + + cgmesProfile = DynamicsFunctionBlock.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'PowerElectronicsConnection': [cgmesProfile.DY.value, ], + 'RemoteInputSignal': [cgmesProfile.DY.value, ], + 'WindPlantDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class DynamicsFunctionBlock: \n' + DynamicsFunctionBlock.__doc__ + + def __init__(self, PowerElectronicsConnection = None, RemoteInputSignal = None, WindPlantDynamics = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.PowerElectronicsConnection = PowerElectronicsConnection + self.RemoteInputSignal = RemoteInputSignal + self.WindPlantDynamics = WindPlantDynamics + + def __str__(self): + str = 'class=WindTurbineType3or4Dynamics\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindTurbineType3or4IEC.py b/cimpy/cgmes_v3_0_0/WindTurbineType3or4IEC.py new file mode 100644 index 00000000..c6bd7d38 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindTurbineType3or4IEC.py @@ -0,0 +1,46 @@ +from .WindTurbineType3or4Dynamics import WindTurbineType3or4Dynamics + + +class WindTurbineType3or4IEC(WindTurbineType3or4Dynamics): + ''' + Parent class supporting relationships to IEC wind turbines type 3 and type 4 including their control models. + + :WindContCurrLimIEC: Wind control current limitation model associated with this wind turbine type 3 or type 4 model. Default: None + :WIndContQIEC: Wind control Q model associated with this wind turbine type 3 or type 4 model. Default: None + :WindContQLimIEC: Constant Q limitation model associated with this wind generator type 3 or type 4 model. Default: None + :WindContQPQULimIEC: QP and QU limitation model associated with this wind generator type 3 or type 4 model. Default: None + :WindProtectionIEC: Wind turbune protection model associated with this wind generator type 3 or type 4 model. Default: None + :WindRefFrameRotIEC: Reference frame rotation model associated with this wind turbine type 3 or type 4 model. Default: None + ''' + + cgmesProfile = WindTurbineType3or4Dynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'WindContCurrLimIEC': [cgmesProfile.DY.value, ], + 'WIndContQIEC': [cgmesProfile.DY.value, ], + 'WindContQLimIEC': [cgmesProfile.DY.value, ], + 'WindContQPQULimIEC': [cgmesProfile.DY.value, ], + 'WindProtectionIEC': [cgmesProfile.DY.value, ], + 'WindRefFrameRotIEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class WindTurbineType3or4Dynamics: \n' + WindTurbineType3or4Dynamics.__doc__ + + def __init__(self, WindContCurrLimIEC = None, WIndContQIEC = None, WindContQLimIEC = None, WindContQPQULimIEC = None, WindProtectionIEC = None, WindRefFrameRotIEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindContCurrLimIEC = WindContCurrLimIEC + self.WIndContQIEC = WIndContQIEC + self.WindContQLimIEC = WindContQLimIEC + self.WindContQPQULimIEC = WindContQPQULimIEC + self.WindProtectionIEC = WindProtectionIEC + self.WindRefFrameRotIEC = WindRefFrameRotIEC + + def __str__(self): + str = 'class=WindTurbineType3or4IEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindTurbineType4IEC.py b/cimpy/cgmes_v3_0_0/WindTurbineType4IEC.py new file mode 100644 index 00000000..fe62cb63 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindTurbineType4IEC.py @@ -0,0 +1,31 @@ +from .WindTurbineType3or4IEC import WindTurbineType3or4IEC + + +class WindTurbineType4IEC(WindTurbineType3or4IEC): + ''' + Parent class supporting relationships to IEC wind turbines type 4 including their control models. + + :WindGenType3aIEC: Wind generator type 3A model associated with this wind turbine type 4 model. Default: None + ''' + + cgmesProfile = WindTurbineType3or4IEC.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'WindGenType3aIEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class WindTurbineType3or4IEC: \n' + WindTurbineType3or4IEC.__doc__ + + def __init__(self, WindGenType3aIEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindGenType3aIEC = WindGenType3aIEC + + def __str__(self): + str = 'class=WindTurbineType4IEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindTurbineType4aIEC.py b/cimpy/cgmes_v3_0_0/WindTurbineType4aIEC.py new file mode 100644 index 00000000..cc35a062 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindTurbineType4aIEC.py @@ -0,0 +1,34 @@ +from .WindTurbineType4IEC import WindTurbineType4IEC + + +class WindTurbineType4aIEC(WindTurbineType4IEC): + ''' + Wind turbine IEC type 4A. Reference: IEC 61400-27-1:2015, 5.5.5.2. + + :WindContPType4aIEC: Wind control P type 4A model associated with this wind turbine type 4A model. Default: None + :WindGenType4IEC: Wind generator type 4 model associated with this wind turbine type 4A model. Default: None + ''' + + cgmesProfile = WindTurbineType4IEC.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'WindContPType4aIEC': [cgmesProfile.DY.value, ], + 'WindGenType4IEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class WindTurbineType4IEC: \n' + WindTurbineType4IEC.__doc__ + + def __init__(self, WindContPType4aIEC = None, WindGenType4IEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindContPType4aIEC = WindContPType4aIEC + self.WindGenType4IEC = WindGenType4IEC + + def __str__(self): + str = 'class=WindTurbineType4aIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindTurbineType4bIEC.py b/cimpy/cgmes_v3_0_0/WindTurbineType4bIEC.py new file mode 100644 index 00000000..07665a4b --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindTurbineType4bIEC.py @@ -0,0 +1,37 @@ +from .WindTurbineType4IEC import WindTurbineType4IEC + + +class WindTurbineType4bIEC(WindTurbineType4IEC): + ''' + Wind turbine IEC type 4B. Reference: IEC 61400-27-1:2015, 5.5.5.3. + + :WindContPType4bIEC: Wind control P type 4B model associated with this wind turbine type 4B model. Default: None + :WindGenType4IEC: Wind generator type 4 model associated with this wind turbine type 4B model. Default: None + :WindMechIEC: Wind mechanical model associated with this wind turbine type 4B model. Default: None + ''' + + cgmesProfile = WindTurbineType4IEC.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'WindContPType4bIEC': [cgmesProfile.DY.value, ], + 'WindGenType4IEC': [cgmesProfile.DY.value, ], + 'WindMechIEC': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class WindTurbineType4IEC: \n' + WindTurbineType4IEC.__doc__ + + def __init__(self, WindContPType4bIEC = None, WindGenType4IEC = None, WindMechIEC = None, *args, **kw_args): + super().__init__(*args, **kw_args) + + self.WindContPType4bIEC = WindContPType4bIEC + self.WindGenType4IEC = WindGenType4IEC + self.WindMechIEC = WindMechIEC + + def __str__(self): + str = 'class=WindTurbineType4bIEC\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindType1or2UserDefined.py b/cimpy/cgmes_v3_0_0/WindType1or2UserDefined.py new file mode 100644 index 00000000..6eead8d3 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindType1or2UserDefined.py @@ -0,0 +1,34 @@ +from .WindTurbineType1or2Dynamics import WindTurbineType1or2Dynamics + + +class WindType1or2UserDefined(WindTurbineType1or2Dynamics): + ''' + Wind type 1 or type 2 function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = WindTurbineType1or2Dynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class WindTurbineType1or2Dynamics: \n' + WindTurbineType1or2Dynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=WindType1or2UserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindType3or4UserDefined.py b/cimpy/cgmes_v3_0_0/WindType3or4UserDefined.py new file mode 100644 index 00000000..9cf124bb --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindType3or4UserDefined.py @@ -0,0 +1,34 @@ +from .WindTurbineType3or4Dynamics import WindTurbineType3or4Dynamics + + +class WindType3or4UserDefined(WindTurbineType3or4Dynamics): + ''' + Wind type 3 or type 4 function block whose dynamic behaviour is described by a user-defined model. + + :proprietary: Behaviour is based on a proprietary model as opposed to a detailed model. true = user-defined model is proprietary with behaviour mutually understood by sending and receiving applications and parameters passed as general attributes false = user-defined model is explicitly defined in terms of control blocks and their input and output signals. Default: False + :ProprietaryParameterDynamics: Parameter of this proprietary user-defined model. Default: "list" + ''' + + cgmesProfile = WindTurbineType3or4Dynamics.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + 'proprietary': [cgmesProfile.DY.value, ], + 'ProprietaryParameterDynamics': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class WindTurbineType3or4Dynamics: \n' + WindTurbineType3or4Dynamics.__doc__ + + def __init__(self, proprietary = False, ProprietaryParameterDynamics = "list", *args, **kw_args): + super().__init__(*args, **kw_args) + + self.proprietary = proprietary + self.ProprietaryParameterDynamics = ProprietaryParameterDynamics + + def __str__(self): + str = 'class=WindType3or4UserDefined\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindUVRTQcontrolModeKind.py b/cimpy/cgmes_v3_0_0/WindUVRTQcontrolModeKind.py new file mode 100644 index 00000000..d537fb49 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindUVRTQcontrolModeKind.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class WindUVRTQcontrolModeKind(Base): + ''' + UVRT Q control modes MqUVRT. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.DY.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=WindUVRTQcontrolModeKind\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WindingConnection.py b/cimpy/cgmes_v3_0_0/WindingConnection.py new file mode 100644 index 00000000..ca3bb250 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WindingConnection.py @@ -0,0 +1,28 @@ +from .Base import Base + + +class WindingConnection(Base): + ''' + Winding connection type. + + ''' + + cgmesProfile = Base.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.EQ.value, ], + } + + serializationProfile = {} + + + + def __init__(self, ): + + pass + + def __str__(self): + str = 'class=WindingConnection\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/WorkLocation.py b/cimpy/cgmes_v3_0_0/WorkLocation.py new file mode 100644 index 00000000..49a42b3a --- /dev/null +++ b/cimpy/cgmes_v3_0_0/WorkLocation.py @@ -0,0 +1,29 @@ +from .Location import Location + + +class WorkLocation(Location): + ''' + Information about a particular location for various forms of work. + + ''' + + cgmesProfile = Location.cgmesProfile + + possibleProfileList = {'class': [cgmesProfile.GL.value, ], + } + + serializationProfile = {} + + __doc__ += '\n Documentation of parent class Location: \n' + Location.__doc__ + + def __init__(self, *args, **kw_args): + super().__init__(*args, **kw_args) + + pass + + def __str__(self): + str = 'class=WorkLocation\n' + attributes = self.__dict__ + for key in attributes.keys(): + str = str + key + '={}\n'.format(attributes[key]) + return str diff --git a/cimpy/cgmes_v3_0_0/__init__.py b/cimpy/cgmes_v3_0_0/__init__.py new file mode 100644 index 00000000..32c072c5 --- /dev/null +++ b/cimpy/cgmes_v3_0_0/__init__.py @@ -0,0 +1,526 @@ +from .VsPpccControlKind import VsPpccControlKind as VsPpccControlKind +from .EnergyConsumer import EnergyConsumer as EnergyConsumer +from .WindPlantFreqPcontrolIEC import WindPlantFreqPcontrolIEC as WindPlantFreqPcontrolIEC +from .ConformLoadSchedule import ConformLoadSchedule as ConformLoadSchedule +from .Date import Date as Date +from .BasicIntervalSchedule import BasicIntervalSchedule as BasicIntervalSchedule +from .EnergyArea import EnergyArea as EnergyArea +from .SvInjection import SvInjection as SvInjection +from .Discrete import Discrete as Discrete +from .CsPpccControlKind import CsPpccControlKind as CsPpccControlKind +from .DCLineSegment import DCLineSegment as DCLineSegment +from .WindAeroConstIEC import WindAeroConstIEC as WindAeroConstIEC +from .WindPitchContPowerIEC import WindPitchContPowerIEC as WindPitchContPowerIEC +from .PowerSystemStabilizerUserDefined import PowerSystemStabilizerUserDefined as PowerSystemStabilizerUserDefined +from .ServiceLocation import ServiceLocation as ServiceLocation +from .ExcitationSystemDynamics import ExcitationSystemDynamics as ExcitationSystemDynamics +from .ExcST7B import ExcST7B as ExcST7B +from .SynchronousMachineKind import SynchronousMachineKind as SynchronousMachineKind +from .Integer import Integer as Integer +from .VoltagePerReactivePower import VoltagePerReactivePower as VoltagePerReactivePower +from .DiscExcContIEEEDEC2A import DiscExcContIEEEDEC2A as DiscExcContIEEEDEC2A +from .ConnectivityNode import ConnectivityNode as ConnectivityNode +from .WindContCurrLimIEC import WindContCurrLimIEC as WindContCurrLimIEC +from .VoltageLevel import VoltageLevel as VoltageLevel +from .ExcIEEEST6B import ExcIEEEST6B as ExcIEEEST6B +from .ExcAC3A import ExcAC3A as ExcAC3A +from .AuxiliaryEquipment import AuxiliaryEquipment as AuxiliaryEquipment +from .SvStatus import SvStatus as SvStatus +from .GovHydro3 import GovHydro3 as GovHydro3 +from .SvPowerFlow import SvPowerFlow as SvPowerFlow +from .ReportingGroup import ReportingGroup as ReportingGroup +from .ExcSEXS import ExcSEXS as ExcSEXS +from .ExcAC5A import ExcAC5A as ExcAC5A +from .GovHydroDD import GovHydroDD as GovHydroDD +from .SubGeographicalRegion import SubGeographicalRegion as SubGeographicalRegion +from .PssRQB import PssRQB as PssRQB +from .Source import Source as Source +from .ExcHU import ExcHU as ExcHU +from .PetersenCoilModeKind import PetersenCoilModeKind as PetersenCoilModeKind +from .Conductance import Conductance as Conductance +from .LinearShuntCompensator import LinearShuntCompensator as LinearShuntCompensator +from .UnderexcLimX1 import UnderexcLimX1 as UnderexcLimX1 +from .ExcIEEEST4B import ExcIEEEST4B as ExcIEEEST4B +from .GovGAST3 import GovGAST3 as GovGAST3 +from .DiscExcContIEEEDEC1A import DiscExcContIEEEDEC1A as DiscExcContIEEEDEC1A +from .EquivalentEquipment import EquivalentEquipment as EquivalentEquipment +from .InputSignalKind import InputSignalKind as InputSignalKind +from .GovSteamIEEE1 import GovSteamIEEE1 as GovSteamIEEE1 +from .TopologicalNode import TopologicalNode as TopologicalNode +from .LoadUserDefined import LoadUserDefined as LoadUserDefined +from .OverexcLim2 import OverexcLim2 as OverexcLim2 +from .Limit import Limit as Limit +from .HydroPowerPlant import HydroPowerPlant as HydroPowerPlant +from .WindRefFrameRotIEC import WindRefFrameRotIEC as WindRefFrameRotIEC +from .ExcST3A import ExcST3A as ExcST3A +from .Accumulator import Accumulator as Accumulator +from .Base import Base as Base +from .LoadGenericNonLinear import LoadGenericNonLinear as LoadGenericNonLinear +from .PssWECC import PssWECC as PssWECC +from .MeasurementValue import MeasurementValue as MeasurementValue +from .OperationalLimitType import OperationalLimitType as OperationalLimitType +from .LoadComposite import LoadComposite as LoadComposite +from .Clamp import Clamp as Clamp +from .MeasurementValueQuality import MeasurementValueQuality as MeasurementValueQuality +from .GovHydroIEEE0 import GovHydroIEEE0 as GovHydroIEEE0 +from .ControlAreaGeneratingUnit import ControlAreaGeneratingUnit as ControlAreaGeneratingUnit +from .PhaseTapChangerTabular import PhaseTapChangerTabular as PhaseTapChangerTabular +from .PowerTransformerEnd import PowerTransformerEnd as PowerTransformerEnd +from .DCDisconnector import DCDisconnector as DCDisconnector +from .HydroTurbineKind import HydroTurbineKind as HydroTurbineKind +from .PssIEEE4B import PssIEEE4B as PssIEEE4B +from .SvVoltage import SvVoltage as SvVoltage +from .VoltageCompensatorUserDefined import VoltageCompensatorUserDefined as VoltageCompensatorUserDefined +from .ExcDC1A import ExcDC1A as ExcDC1A +from .BaseVoltage import BaseVoltage as BaseVoltage +from .ExcIEEEST3A import ExcIEEEST3A as ExcIEEEST3A +from .DCPolarityKind import DCPolarityKind as DCPolarityKind +from .DiagramObjectStyle import DiagramObjectStyle as DiagramObjectStyle +from .SolarGeneratingUnit import SolarGeneratingUnit as SolarGeneratingUnit +from .DisconnectingCircuitBreaker import DisconnectingCircuitBreaker as DisconnectingCircuitBreaker +from .TurbineGovernorDynamics import TurbineGovernorDynamics as TurbineGovernorDynamics +from .ExcIEEEST1A import ExcIEEEST1A as ExcIEEEST1A +from .WaveTrap import WaveTrap as WaveTrap +from .Pss2B import Pss2B as Pss2B +from .DCSeriesDevice import DCSeriesDevice as DCSeriesDevice +from .Boolean import Boolean as Boolean +from .GovHydroR import GovHydroR as GovHydroR +from .UnderexcLim2Simplified import UnderexcLim2Simplified as UnderexcLim2Simplified +from .Fuse import Fuse as Fuse +from .UnderexcLimIEEE2 import UnderexcLimIEEE2 as UnderexcLimIEEE2 +from .RemoteSignalKind import RemoteSignalKind as RemoteSignalKind +from .VoltageAdjusterUserDefined import VoltageAdjusterUserDefined as VoltageAdjusterUserDefined +from .Area import Area as Area +from .GenICompensationForGenJ import GenICompensationForGenJ as GenICompensationForGenJ +from .Location import Location as Location +from .PotentialTransformer import PotentialTransformer as PotentialTransformer +from .ExcST6BOELselectorKind import ExcST6BOELselectorKind as ExcST6BOELselectorKind +from .SVCControlMode import SVCControlMode as SVCControlMode +from .WindQcontrolModeKind import WindQcontrolModeKind as WindQcontrolModeKind +from .PFVArType2IEEEVArController import PFVArType2IEEEVArController as PFVArType2IEEEVArController +from .WindGenType4IEC import WindGenType4IEC as WindGenType4IEC +from .WindMechIEC import WindMechIEC as WindMechIEC +from .WindContQLimIEC import WindContQLimIEC as WindContQLimIEC +from .AnalogControl import AnalogControl as AnalogControl +from .UnderexcitationLimiterDynamics import UnderexcitationLimiterDynamics as UnderexcitationLimiterDynamics +from .GovSteam2 import GovSteam2 as GovSteam2 +from .NuclearGeneratingUnit import NuclearGeneratingUnit as NuclearGeneratingUnit +from .ExcBBC import ExcBBC as ExcBBC +from .WindContPType3IEC import WindContPType3IEC as WindContPType3IEC +from .PhotoVoltaicUnit import PhotoVoltaicUnit as PhotoVoltaicUnit +from .ExcST7BOELselectorKind import ExcST7BOELselectorKind as ExcST7BOELselectorKind +from .AsynchronousMachineDynamics import AsynchronousMachineDynamics as AsynchronousMachineDynamics +from .ExcIEEEAC4A import ExcIEEEAC4A as ExcIEEEAC4A +from .AccumulatorLimitSet import AccumulatorLimitSet as AccumulatorLimitSet +from .GeographicalRegion import GeographicalRegion as GeographicalRegion +from .DiscontinuousExcitationControlUserDefined import DiscontinuousExcitationControlUserDefined as DiscontinuousExcitationControlUserDefined +from .PowerElectronicsUnit import PowerElectronicsUnit as PowerElectronicsUnit +from .Susceptance import Susceptance as Susceptance +from .RaiseLowerCommand import RaiseLowerCommand as RaiseLowerCommand +from .VoltageCompensatorDynamics import VoltageCompensatorDynamics as VoltageCompensatorDynamics +from .PhaseTapChangerSymmetrical import PhaseTapChangerSymmetrical as PhaseTapChangerSymmetrical +from .ExcST6B import ExcST6B as ExcST6B +from .ActivePowerPerFrequency import ActivePowerPerFrequency as ActivePowerPerFrequency +from .ExcELIN2 import ExcELIN2 as ExcELIN2 +from .DCConverterUnit import DCConverterUnit as DCConverterUnit +from .UnderexcLimX2 import UnderexcLimX2 as UnderexcLimX2 +from .AccumulatorValue import AccumulatorValue as AccumulatorValue +from .UnderexcLimIEEE1 import UnderexcLimIEEE1 as UnderexcLimIEEE1 +from .MonthDay import MonthDay as MonthDay +from .ControlArea import ControlArea as ControlArea +from .AngleDegrees import AngleDegrees as AngleDegrees +from .SurgeArrester import SurgeArrester as SurgeArrester +from .Float import Float as Float +from .DiscreteValue import DiscreteValue as DiscreteValue +from .SeriesCompensator import SeriesCompensator as SeriesCompensator +from .TurbineLoadControllerUserDefined import TurbineLoadControllerUserDefined as TurbineLoadControllerUserDefined +from .ExcIEEEST7B import ExcIEEEST7B as ExcIEEEST7B +from .AnalogLimit import AnalogLimit as AnalogLimit +from .NonlinearShuntCompensatorPoint import NonlinearShuntCompensatorPoint as NonlinearShuntCompensatorPoint +from .ExcIEEEST2A import ExcIEEEST2A as ExcIEEEST2A +from .DCBreaker import DCBreaker as DCBreaker +from .DateTime import DateTime as DateTime +from .ExcRQB import ExcRQB as ExcRQB +from .TurbLCFB1 import TurbLCFB1 as TurbLCFB1 +from .WindProtectionIEC import WindProtectionIEC as WindProtectionIEC +from .GovGAST4 import GovGAST4 as GovGAST4 +from .WindContPitchAngleIEC import WindContPitchAngleIEC as WindContPitchAngleIEC +from .CoordinateSystem import CoordinateSystem as CoordinateSystem +from .ReactivePower import ReactivePower as ReactivePower +from .WindContPType4aIEC import WindContPType4aIEC as WindContPType4aIEC +from .GovSteam0 import GovSteam0 as GovSteam0 +from .PssIEEE3B import PssIEEE3B as PssIEEE3B +from .WindGenUnitKind import WindGenUnitKind as WindGenUnitKind +from .WorkLocation import WorkLocation as WorkLocation +from .ExcIEEEAC7B import ExcIEEEAC7B as ExcIEEEAC7B +from .SynchronousMachine import SynchronousMachine as SynchronousMachine +from .CurveStyle import CurveStyle as CurveStyle +from .ExcAVR5 import ExcAVR5 as ExcAVR5 +from .CSCUserDefined import CSCUserDefined as CSCUserDefined +from .SolarPowerPlant import SolarPowerPlant as SolarPowerPlant +from .ExcIEEEDC3A import ExcIEEEDC3A as ExcIEEEDC3A +from .ExcCZ import ExcCZ as ExcCZ +from .ExcAC2A import ExcAC2A as ExcAC2A +from .EquivalentShunt import EquivalentShunt as EquivalentShunt +from .Reactance import Reactance as Reactance +from .TieFlow import TieFlow as TieFlow +from .FossilFuel import FossilFuel as FossilFuel +from .AsynchronousMachineKind import AsynchronousMachineKind as AsynchronousMachineKind +from .PssIEEE2B import PssIEEE2B as PssIEEE2B +from .GovSteamFV3 import GovSteamFV3 as GovSteamFV3 +from .Resistance import Resistance as Resistance +from .SvShuntCompensatorSections import SvShuntCompensatorSections as SvShuntCompensatorSections +from .Inductance import Inductance as Inductance +from .Quality61850 import Quality61850 as Quality61850 +from .ExcIEEEAC5A import ExcIEEEAC5A as ExcIEEEAC5A +from .CurrentTransformer import CurrentTransformer as CurrentTransformer +from .PFVArControllerType2Dynamics import PFVArControllerType2Dynamics as PFVArControllerType2Dynamics +from .ExcPIC import ExcPIC as ExcPIC +from .GroundDisconnector import GroundDisconnector as GroundDisconnector +from .WindGenTurbineType1aIEC import WindGenTurbineType1aIEC as WindGenTurbineType1aIEC +from .WindAeroOneDimIEC import WindAeroOneDimIEC as WindAeroOneDimIEC +from .ActivePowerPerCurrentFlow import ActivePowerPerCurrentFlow as ActivePowerPerCurrentFlow +from .OverexcLimIEEE import OverexcLimIEEE as OverexcLimIEEE +from .PFVArControllerType1Dynamics import PFVArControllerType1Dynamics as PFVArControllerType1Dynamics +from .WindType1or2UserDefined import WindType1or2UserDefined as WindType1or2UserDefined +from .Pss5 import Pss5 as Pss5 +from .ExcST2A import ExcST2A as ExcST2A +from .EnergySchedulingType import EnergySchedulingType as EnergySchedulingType +from .PssSB4 import PssSB4 as PssSB4 +from .StaticLoadModelKind import StaticLoadModelKind as StaticLoadModelKind +from .WindGeneratingUnit import WindGeneratingUnit as WindGeneratingUnit +from .PssPTIST1 import PssPTIST1 as PssPTIST1 +from .VCompIEEEType2 import VCompIEEEType2 as VCompIEEEType2 +from .SVCUserDefined import SVCUserDefined as SVCUserDefined +from .Curve import Curve as Curve +from .Equipment import Equipment as Equipment +from .ExcAVR7 import ExcAVR7 as ExcAVR7 +from .GovHydro4 import GovHydro4 as GovHydro4 +from .VisibilityLayer import VisibilityLayer as VisibilityLayer +from .PostLineSensor import PostLineSensor as PostLineSensor +from .GeneratingUnit import GeneratingUnit as GeneratingUnit +from .ApparentPower import ApparentPower as ApparentPower +from .AccumulatorLimit import AccumulatorLimit as AccumulatorLimit +from .PFVArControllerType2UserDefined import PFVArControllerType2UserDefined as PFVArControllerType2UserDefined +from .WindTurbineType1or2IEC import WindTurbineType1or2IEC as WindTurbineType1or2IEC +from .GovSteam1 import GovSteam1 as GovSteam1 +from .Disconnector import Disconnector as Disconnector +from .GovSteamSGO import GovSteamSGO as GovSteamSGO +from .RotatingMachine import RotatingMachine as RotatingMachine +from .PhaseCode import PhaseCode as PhaseCode +from .EnergySource import EnergySource as EnergySource +from .Length import Length as Length +from .PhaseTapChangerTable import PhaseTapChangerTable as PhaseTapChangerTable +from .Line import Line as Line +from .GovHydroWEH import GovHydroWEH as GovHydroWEH +from .ExcitationSystemUserDefined import ExcitationSystemUserDefined as ExcitationSystemUserDefined +from .SvSwitch import SvSwitch as SvSwitch +from .StringMeasurementValue import StringMeasurementValue as StringMeasurementValue +from .Breaker import Breaker as Breaker +from .OverexcLimX2 import OverexcLimX2 as OverexcLimX2 +from .DCBaseTerminal import DCBaseTerminal as DCBaseTerminal +from .RotationSpeed import RotationSpeed as RotationSpeed +from .ExcIEEEST1AUELselectorKind import ExcIEEEST1AUELselectorKind as ExcIEEEST1AUELselectorKind +from .PhaseTapChanger import PhaseTapChanger as PhaseTapChanger +from .NonlinearShuntCompensator import NonlinearShuntCompensator as NonlinearShuntCompensator +from .PssIEEE1A import PssIEEE1A as PssIEEE1A +from .WindPlantQcontrolModeKind import WindPlantQcontrolModeKind as WindPlantQcontrolModeKind +from .ConformLoadGroup import ConformLoadGroup as ConformLoadGroup +from .ExcAC4A import ExcAC4A as ExcAC4A +from .RegularTimePoint import RegularTimePoint as RegularTimePoint +from .ExcNI import ExcNI as ExcNI +from .OverexcitationLimiterUserDefined import OverexcitationLimiterUserDefined as OverexcitationLimiterUserDefined +from .WindType3or4UserDefined import WindType3or4UserDefined as WindType3or4UserDefined +from .WindGenType3IEC import WindGenType3IEC as WindGenType3IEC +from .SwitchSchedule import SwitchSchedule as SwitchSchedule +from .SeasonDayTypeSchedule import SeasonDayTypeSchedule as SeasonDayTypeSchedule +from .VSCUserDefined import VSCUserDefined as VSCUserDefined +from .WindPlantReactiveControlIEC import WindPlantReactiveControlIEC as WindPlantReactiveControlIEC +from .ExcSK import ExcSK as ExcSK +from .SubLoadArea import SubLoadArea as SubLoadArea +from .PetersenCoil import PetersenCoil as PetersenCoil +from .LoadMotor import LoadMotor as LoadMotor +from .PFVArControllerType1UserDefined import PFVArControllerType1UserDefined as PFVArControllerType1UserDefined +from .Decimal import Decimal as Decimal +from .EquipmentContainer import EquipmentContainer as EquipmentContainer +from .TapChangerControl import TapChangerControl as TapChangerControl +from .BoundaryPoint import BoundaryPoint as BoundaryPoint +from .ACDCTerminal import ACDCTerminal as ACDCTerminal +from .DCGround import DCGround as DCGround +from .WindTurbineType4bIEC import WindTurbineType4bIEC as WindTurbineType4bIEC +from .SetPoint import SetPoint as SetPoint +from .ControlAreaTypeKind import ControlAreaTypeKind as ControlAreaTypeKind +from .SynchronousMachineModelKind import SynchronousMachineModelKind as SynchronousMachineModelKind +from .HVDCDynamics import HVDCDynamics as HVDCDynamics +from .FrancisGovernorControlKind import FrancisGovernorControlKind as FrancisGovernorControlKind +from .LoadArea import LoadArea as LoadArea +from .PerCent import PerCent as PerCent +from .StaticVarCompensator import StaticVarCompensator as StaticVarCompensator +from .ExcAC6A import ExcAC6A as ExcAC6A +from .ExcIEEEDC1A import ExcIEEEDC1A as ExcIEEEDC1A +from .ExcDC3A1 import ExcDC3A1 as ExcDC3A1 +from .DiagramObject import DiagramObject as DiagramObject +from .BusbarSection import BusbarSection as BusbarSection +from .ExcST1A import ExcST1A as ExcST1A +from .VSCDynamics import VSCDynamics as VSCDynamics +from .DiagramObjectPoint import DiagramObjectPoint as DiagramObjectPoint +from .RemoteInputSignal import RemoteInputSignal as RemoteInputSignal +from .GovHydroPelton import GovHydroPelton as GovHydroPelton +from .GovSteamFV4 import GovSteamFV4 as GovSteamFV4 +from .TownDetail import TownDetail as TownDetail +from .GovHydroPID2 import GovHydroPID2 as GovHydroPID2 +from .EquivalentNetwork import EquivalentNetwork as EquivalentNetwork +from .Voltage import Voltage as Voltage +from .Measurement import Measurement as Measurement +from .StringMeasurement import StringMeasurement as StringMeasurement +from .VsQpccControlKind import VsQpccControlKind as VsQpccControlKind +from .IOPoint import IOPoint as IOPoint +from .OrientationKind import OrientationKind as OrientationKind +from .ProprietaryParameterDynamics import ProprietaryParameterDynamics as ProprietaryParameterDynamics +from .DCConductingEquipment import DCConductingEquipment as DCConductingEquipment +from .CurrentLimit import CurrentLimit as CurrentLimit +from .TopologicalIsland import TopologicalIsland as TopologicalIsland +from .ExcAC8B import ExcAC8B as ExcAC8B +from .Season import Season as Season +from .GovGAST2 import GovGAST2 as GovGAST2 +from .PssPTIST3 import PssPTIST3 as PssPTIST3 +from .ExcIEEEAC2A import ExcIEEEAC2A as ExcIEEEAC2A +from .OperationalLimit import OperationalLimit as OperationalLimit +from .StaticVarCompensatorDynamics import StaticVarCompensatorDynamics as StaticVarCompensatorDynamics +from .MechanicalLoadDynamics import MechanicalLoadDynamics as MechanicalLoadDynamics +from .VAdjIEEE import VAdjIEEE as VAdjIEEE +from .ValueAliasSet import ValueAliasSet as ValueAliasSet +from .RegulatingControl import RegulatingControl as RegulatingControl +from .SynchronousMachineUserDefined import SynchronousMachineUserDefined as SynchronousMachineUserDefined +from .DCChopper import DCChopper as DCChopper +from .WindTurbineType3or4Dynamics import WindTurbineType3or4Dynamics as WindTurbineType3or4Dynamics +from .Junction import Junction as Junction +from .Money import Money as Money +from .RotorKind import RotorKind as RotorKind +from .PFVArType2Common1 import PFVArType2Common1 as PFVArType2Common1 +from .BatteryStateKind import BatteryStateKind as BatteryStateKind +from .AsynchronousMachine import AsynchronousMachine as AsynchronousMachine +from .CogenerationPlant import CogenerationPlant as CogenerationPlant +from .ACLineSegment import ACLineSegment as ACLineSegment +from .AnalogLimitSet import AnalogLimitSet as AnalogLimitSet +from .Seconds import Seconds as Seconds +from .ExcIEEEST5B import ExcIEEEST5B as ExcIEEEST5B +from .LoadStatic import LoadStatic as LoadStatic +from .Currency import Currency as Currency +from .PhaseTapChangerLinear import PhaseTapChangerLinear as PhaseTapChangerLinear +from .WindDynamicsLookupTable import WindDynamicsLookupTable as WindDynamicsLookupTable +from .UnitSymbol import UnitSymbol as UnitSymbol +from .Analog import Analog as Analog +from .ExcELIN1 import ExcELIN1 as ExcELIN1 +from .ExcST4B import ExcST4B as ExcST4B +from .GovHydro2 import GovHydro2 as GovHydro2 +from .SynchronousMachineEquivalentCircuit import SynchronousMachineEquivalentCircuit as SynchronousMachineEquivalentCircuit +from .ExcAVR1 import ExcAVR1 as ExcAVR1 +from .SynchronousMachineTimeConstantReactance import SynchronousMachineTimeConstantReactance as SynchronousMachineTimeConstantReactance +from .OperationalLimitSet import OperationalLimitSet as OperationalLimitSet +from .ExcANS import ExcANS as ExcANS +from .GovGAST import GovGAST as GovGAST +from .Jumper import Jumper as Jumper +from .DroopSignalFeedbackKind import DroopSignalFeedbackKind as DroopSignalFeedbackKind +from .LoadAggregate import LoadAggregate as LoadAggregate +from .GovHydro1 import GovHydro1 as GovHydro1 +from .ExcREXS import ExcREXS as ExcREXS +from .TapChangerTablePoint import TapChangerTablePoint as TapChangerTablePoint +from .LimitKind import LimitKind as LimitKind +from .GovSteamBB import GovSteamBB as GovSteamBB +from .ExcIEEEAC6A import ExcIEEEAC6A as ExcIEEEAC6A +from .Sensor import Sensor as Sensor +from .WindContQIEC import WindContQIEC as WindContQIEC +from .ReactiveCapabilityCurve import ReactiveCapabilityCurve as ReactiveCapabilityCurve +from .DynamicsFunctionBlock import DynamicsFunctionBlock as DynamicsFunctionBlock +from .WindPlantIEC import WindPlantIEC as WindPlantIEC +from .WindPlantUserDefined import WindPlantUserDefined as WindPlantUserDefined +from .OperationalLimitDirectionKind import OperationalLimitDirectionKind as OperationalLimitDirectionKind +from .Substation import Substation as Substation +from .TextDiagramObject import TextDiagramObject as TextDiagramObject +from .PFVArType1IEEEVArController import PFVArType1IEEEVArController as PFVArType1IEEEVArController +from .GovSteamEU import GovSteamEU as GovSteamEU +from .RatioTapChangerTablePoint import RatioTapChangerTablePoint as RatioTapChangerTablePoint +from .Cut import Cut as Cut +from .GovCT2 import GovCT2 as GovCT2 +from .ExcAVR4 import ExcAVR4 as ExcAVR4 +from .WindAeroTwoDimIEC import WindAeroTwoDimIEC as WindAeroTwoDimIEC +from .ConnectivityNodeContainer import ConnectivityNodeContainer as ConnectivityNodeContainer +from .ValueToAlias import ValueToAlias as ValueToAlias +from .FuelType import FuelType as FuelType +from .Bay import Bay as Bay +from .UnderexcitationLimiterUserDefined import UnderexcitationLimiterUserDefined as UnderexcitationLimiterUserDefined +from .IfdBaseKind import IfdBaseKind as IfdBaseKind +from .AsynchronousMachineEquivalentCircuit import AsynchronousMachineEquivalentCircuit as AsynchronousMachineEquivalentCircuit +from .StationSupply import StationSupply as StationSupply +from .LoadGroup import LoadGroup as LoadGroup +from .TransformerEnd import TransformerEnd as TransformerEnd +from .RegulationSchedule import RegulationSchedule as RegulationSchedule +from .WindPowerPlant import WindPowerPlant as WindPowerPlant +from .CsConverter import CsConverter as CsConverter +from .VCompIEEEType1 import VCompIEEEType1 as VCompIEEEType1 +from .WindTurbineType4aIEC import WindTurbineType4aIEC as WindTurbineType4aIEC +from .DCEquipmentContainer import DCEquipmentContainer as DCEquipmentContainer +from .ShortCircuitRotorKind import ShortCircuitRotorKind as ShortCircuitRotorKind +from .GovSteamFV2 import GovSteamFV2 as GovSteamFV2 +from .TurbineGovernorUserDefined import TurbineGovernorUserDefined as TurbineGovernorUserDefined +from .LoadResponseCharacteristic import LoadResponseCharacteristic as LoadResponseCharacteristic +from .GovHydroWPID import GovHydroWPID as GovHydroWPID +from .DiscExcContIEEEDEC3A import DiscExcContIEEEDEC3A as DiscExcContIEEEDEC3A +from .Terminal import Terminal as Terminal +from .Control import Control as Control +from .Connector import Connector as Connector +from .Pss2ST import Pss2ST as Pss2ST +from .ProtectedSwitch import ProtectedSwitch as ProtectedSwitch +from .GovHydroPID import GovHydroPID as GovHydroPID +from .ExcAVR3 import ExcAVR3 as ExcAVR3 +from .NonConformLoad import NonConformLoad as NonConformLoad +from .CurrentFlow import CurrentFlow as CurrentFlow +from .RegularIntervalSchedule import RegularIntervalSchedule as RegularIntervalSchedule +from .EquivalentBranch import EquivalentBranch as EquivalentBranch +from .Pss1 import Pss1 as Pss1 +from .WindContPType4bIEC import WindContPType4bIEC as WindContPType4bIEC +from .CombinedCyclePlant import CombinedCyclePlant as CombinedCyclePlant +from .MechanicalLoadUserDefined import MechanicalLoadUserDefined as MechanicalLoadUserDefined +from .LoadBreakSwitch import LoadBreakSwitch as LoadBreakSwitch +from .LoadDynamics import LoadDynamics as LoadDynamics +from .TapChanger import TapChanger as TapChanger +from .PssSTAB2A import PssSTAB2A as PssSTAB2A +from .SynchronousMachineSimplified import SynchronousMachineSimplified as SynchronousMachineSimplified +from .StreetDetail import StreetDetail as StreetDetail +from .WindTurbineType4IEC import WindTurbineType4IEC as WindTurbineType4IEC +from .VsCapabilityCurve import VsCapabilityCurve as VsCapabilityCurve +from .Switch import Switch as Switch +from .ExternalNetworkInjection import ExternalNetworkInjection as ExternalNetworkInjection +from .ConductingEquipment import ConductingEquipment as ConductingEquipment +from .PFVArType2IEEEPFController import PFVArType2IEEEPFController as PFVArType2IEEEPFController +from .GovSteamCC import GovSteamCC as GovSteamCC +from .AsynchronousMachineUserDefined import AsynchronousMachineUserDefined as AsynchronousMachineUserDefined +from .DiagramStyle import DiagramStyle as DiagramStyle +from .ACDCConverterDCTerminal import ACDCConverterDCTerminal as ACDCConverterDCTerminal +from .PositionPoint import PositionPoint as PositionPoint +from .DiagramObjectGluePoint import DiagramObjectGluePoint as DiagramObjectGluePoint +from .SvTapStep import SvTapStep as SvTapStep +from .WindGenTurbineType2IEC import WindGenTurbineType2IEC as WindGenTurbineType2IEC +from .WindGenType3bIEC import WindGenType3bIEC as WindGenType3bIEC +from .CurveData import CurveData as CurveData +from .SynchronousMachineOperatingMode import SynchronousMachineOperatingMode as SynchronousMachineOperatingMode +from .DiscontinuousExcitationControlDynamics import DiscontinuousExcitationControlDynamics as DiscontinuousExcitationControlDynamics +from .PFVArType1IEEEPFController import PFVArType1IEEEPFController as PFVArType1IEEEPFController +from .ExcOEX3T import ExcOEX3T as ExcOEX3T +from .PowerTransformer import PowerTransformer as PowerTransformer +from .GovHydroIEEE2 import GovHydroIEEE2 as GovHydroIEEE2 +from .PU import PU as PU +from .WindTurbineType3IEC import WindTurbineType3IEC as WindTurbineType3IEC +from .GovGASTWD import GovGASTWD as GovGASTWD +from .ActivePower import ActivePower as ActivePower +from .ExcDC2A import ExcDC2A as ExcDC2A +from .Diagram import Diagram as Diagram +from .Ground import Ground as Ground +from .NonConformLoadSchedule import NonConformLoadSchedule as NonConformLoadSchedule +from .IdentifiedObject import IdentifiedObject as IdentifiedObject +from .DCLine import DCLine as DCLine +from .CrossCompoundTurbineGovernorDynamics import CrossCompoundTurbineGovernorDynamics as CrossCompoundTurbineGovernorDynamics +from .GrossToNetActivePowerCurve import GrossToNetActivePowerCurve as GrossToNetActivePowerCurve +from .EarthFaultCompensator import EarthFaultCompensator as EarthFaultCompensator +from .TapSchedule import TapSchedule as TapSchedule +from .OverexcitationLimiterDynamics import OverexcitationLimiterDynamics as OverexcitationLimiterDynamics +from .GeneratorControlSource import GeneratorControlSource as GeneratorControlSource +from .WindGenTurbineType1bIEC import WindGenTurbineType1bIEC as WindGenTurbineType1bIEC +from .NonConformLoadGroup import NonConformLoadGroup as NonConformLoadGroup +from .HydroEnergyConversionKind import HydroEnergyConversionKind as HydroEnergyConversionKind +from .VsConverter import VsConverter as VsConverter +from .OverexcLimX1 import OverexcLimX1 as OverexcLimX1 +from .ACDCConverter import ACDCConverter as ACDCConverter +from .PowerElectronicsWindUnit import PowerElectronicsWindUnit as PowerElectronicsWindUnit +from .DCTopologicalIsland import DCTopologicalIsland as DCTopologicalIsland +from .ExcAC1A import ExcAC1A as ExcAC1A +from .ExcIEEEDC4B import ExcIEEEDC4B as ExcIEEEDC4B +from .WindTurbineType3or4IEC import WindTurbineType3or4IEC as WindTurbineType3or4IEC +from .WindUVRTQcontrolModeKind import WindUVRTQcontrolModeKind as WindUVRTQcontrolModeKind +from .PssSK import PssSK as PssSK +from .ExcIEEEAC3A import ExcIEEEAC3A as ExcIEEEAC3A +from .BusNameMarker import BusNameMarker as BusNameMarker +from .Capacitance import Capacitance as Capacitance +from .LimitSet import LimitSet as LimitSet +from .CsOperatingModeKind import CsOperatingModeKind as CsOperatingModeKind +from .Temperature import Temperature as Temperature +from .HydroPump import HydroPump as HydroPump +from .DCSwitch import DCSwitch as DCSwitch +from .AccumulatorReset import AccumulatorReset as AccumulatorReset +from .PowerSystemStabilizerDynamics import PowerSystemStabilizerDynamics as PowerSystemStabilizerDynamics +from .AnalogValue import AnalogValue as AnalogValue +from .GovHydroFrancis import GovHydroFrancis as GovHydroFrancis +from .ActivePowerLimit import ActivePowerLimit as ActivePowerLimit +from .Validity import Validity as Validity +from .MeasurementValueSource import MeasurementValueSource as MeasurementValueSource +from .ExcST7BUELselectorKind import ExcST7BUELselectorKind as ExcST7BUELselectorKind +from .DCBusbar import DCBusbar as DCBusbar +from .SynchronousMachineDetailed import SynchronousMachineDetailed as SynchronousMachineDetailed +from .WindGenType3aIEC import WindGenType3aIEC as WindGenType3aIEC +from .GroundingImpedance import GroundingImpedance as GroundingImpedance +from .ExcDC3A import ExcDC3A as ExcDC3A +from .__init__ import __init__ as __init__ +from .PhaseTapChangerNonLinear import PhaseTapChangerNonLinear as PhaseTapChangerNonLinear +from .MechLoad1 import MechLoad1 as MechLoad1 +from .Conductor import Conductor as Conductor +from .DayType import DayType as DayType +from .GovHydro4ModelKind import GovHydro4ModelKind as GovHydro4ModelKind +from .VoltageLimit import VoltageLimit as VoltageLimit +from .ExcSCRX import ExcSCRX as ExcSCRX +from .ShuntCompensator import ShuntCompensator as ShuntCompensator +from .DCTopologicalNode import DCTopologicalNode as DCTopologicalNode +from .GovCT1 import GovCT1 as GovCT1 +from .PhaseTapChangerTablePoint import PhaseTapChangerTablePoint as PhaseTapChangerTablePoint +from .GenericNonLinearLoadModelKind import GenericNonLinearLoadModelKind as GenericNonLinearLoadModelKind +from .RatioTapChangerTable import RatioTapChangerTable as RatioTapChangerTable +from .PowerSystemResource import PowerSystemResource as PowerSystemResource +from .RealEnergy import RealEnergy as RealEnergy +from .ExcIEEEDC2A import ExcIEEEDC2A as ExcIEEEDC2A +from .DCNode import DCNode as DCNode +from .ExcIEEEAC1A import ExcIEEEAC1A as ExcIEEEAC1A +from .EquivalentInjection import EquivalentInjection as EquivalentInjection +from .StreetAddress import StreetAddress as StreetAddress +from .WindTurbineType1or2Dynamics import WindTurbineType1or2Dynamics as WindTurbineType1or2Dynamics +from .Pss1A import Pss1A as Pss1A +from .WindPlantDynamics import WindPlantDynamics as WindPlantDynamics +from .SynchronousMachineDynamics import SynchronousMachineDynamics as SynchronousMachineDynamics +from .CSCDynamics import CSCDynamics as CSCDynamics +from .WindContRotorRIEC import WindContRotorRIEC as WindContRotorRIEC +from .PssELIN2 import PssELIN2 as PssELIN2 +from .ThermalGeneratingUnit import ThermalGeneratingUnit as ThermalGeneratingUnit +from .MutualCoupling import MutualCoupling as MutualCoupling +from .TurbineLoadControllerDynamics import TurbineLoadControllerDynamics as TurbineLoadControllerDynamics +from .ExcREXSFeedbackSignalKind import ExcREXSFeedbackSignalKind as ExcREXSFeedbackSignalKind +from .ApparentPowerLimit import ApparentPowerLimit as ApparentPowerLimit +from .WindLookupTableFunctionKind import WindLookupTableFunctionKind as WindLookupTableFunctionKind +from .ConformLoad import ConformLoad as ConformLoad +from .WindingConnection import WindingConnection as WindingConnection +from .UnitMultiplier import UnitMultiplier as UnitMultiplier +from .ExcIEEEAC8B import ExcIEEEAC8B as ExcIEEEAC8B +from .FaultIndicator import FaultIndicator as FaultIndicator +from .RegulatingControlModeKind import RegulatingControlModeKind as RegulatingControlModeKind +from .RotatingMachineDynamics import RotatingMachineDynamics as RotatingMachineDynamics +from .DCShunt import DCShunt as DCShunt +from .EnergyConnection import EnergyConnection as EnergyConnection +from .RegulatingCondEq import RegulatingCondEq as RegulatingCondEq +from .VoltageAdjusterDynamics import VoltageAdjusterDynamics as VoltageAdjusterDynamics +from .RatioTapChanger import RatioTapChanger as RatioTapChanger +from .CAESPlant import CAESPlant as CAESPlant +from .PowerElectronicsConnection import PowerElectronicsConnection as PowerElectronicsConnection +from .GovGAST1 import GovGAST1 as GovGAST1 +from .Frequency import Frequency as Frequency +from .WindContQPQULimIEC import WindContQPQULimIEC as WindContQPQULimIEC +from .HydroPlantStorageKind import HydroPlantStorageKind as HydroPlantStorageKind +from .HydroGeneratingUnit import HydroGeneratingUnit as HydroGeneratingUnit +from .ExcAVR2 import ExcAVR2 as ExcAVR2 +from .VolumeFlowRate import VolumeFlowRate as VolumeFlowRate +from .AsynchronousMachineTimeConstantReactance import AsynchronousMachineTimeConstantReactance as AsynchronousMachineTimeConstantReactance +from .Command import Command as Command +from .DCConverterOperatingModeKind import DCConverterOperatingModeKind as DCConverterOperatingModeKind +from .PssSH import PssSH as PssSH +from .PhaseTapChangerAsymmetrical import PhaseTapChangerAsymmetrical as PhaseTapChangerAsymmetrical +from .DCTerminal import DCTerminal as DCTerminal +from .Status import Status as Status +from .AngleRadians import AngleRadians as AngleRadians +from .BatteryUnit import BatteryUnit as BatteryUnit diff --git a/cimpy/cimexport.py b/cimpy/cimexport.py index ce0802b7..d48754e8 100644 --- a/cimpy/cimexport.py +++ b/cimpy/cimexport.py @@ -3,11 +3,8 @@ import chevron from datetime import datetime from time import time -from cimpy.cgmes_v2_4_15.Base import Profile import logging import sys -from cimpy.cgmes_v2_4_15.Base import Base -cgmesProfile = Base.cgmesProfile from pathlib import Path import copy @@ -164,7 +161,7 @@ def _create_namespaces_list(namespaces_dict): # possibleProfileList dictionary the possible origins of the class/attributes is stored. All profiles have a different # priority which is stored in the enum cgmesProfile. As default the smallest entry in the dictionary is used to # determine the profile for the class/attributes. -def _sort_classes_to_profile(class_attributes_list, activeProfileList): +def _sort_classes_to_profile(class_attributes_list, activeProfileList, version): export_dict = {} export_about_dict = {} @@ -180,6 +177,11 @@ def _sort_classes_to_profile(class_attributes_list, activeProfileList): class_serializationProfile = '' + if version == 'cgmes_v3_0_0': + from cimpy.cgmes_v3_0_0.Base import Profile + else: + from cimpy.cgmes_v2_4_15.Base import Profile + if 'class' in serializationProfile.keys(): # class was imported if Profile[serializationProfile['class']] in activeProfileList: @@ -314,6 +316,11 @@ def cim_export(import_result, file_name, version, activeProfileList): t0 = time() logger.info('Start export procedure.') + if version == 'cgmes_v3_0_0': + from cimpy.cgmes_v3_0_0.Base import Profile + else: + from cimpy.cgmes_v2_4_15.Base import Profile + profile_list = list(map(lambda a: Profile[a], activeProfileList)) # iterate over all profiles @@ -359,7 +366,7 @@ def generate_xml(cim_data, version, model_name, profile, available_profiles): # the class definition and the attribute definitions are in the same profile. Every entry in about_dict generates # a rdf:about in another profile export_dict, about_dict = _sort_classes_to_profile( - class_attributes_list, available_profiles) + class_attributes_list, available_profiles, version) namespaces_list = _create_namespaces_list( cim_data['meta_info']['namespaces']) diff --git a/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/20151231T2300Z_XX_YYY_DL_.xml b/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/20151231T2300Z_XX_YYY_DL_.xml new file mode 100644 index 00000000..bdf8874a --- /dev/null +++ b/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/20151231T2300Z_XX_YYY_DL_.xml @@ -0,0 +1,2159 @@ + + + + + + + 2023-05-09T13:15:07Z + www.ie3.etit.tu-dortmund.de + http://iec.ch/TC57/ns/CIM/DiagramLayout-EU/3.0 + 2015-12-31T23:00:00Z + + + + 1 + 341.25 + 40.625 + + + + 1 + 56.875 + 163.125 + + + + 1 + 271.25 + 106.25 + + + + 1 + 310.625 + 62.5 + + + + 3 + 220.938 + 237.5 + + + + 1 + 280 + 228.75 + + + + 1 + 166.25 + 237.5 + + + + 2 + 138.633 + -380.039 + + + + 1 + 217.292 + 548.125 + + + + 1 + 280 + 290 + + + + 2 + 138.634 + -380.039 + + + + 1 + 266.875 + 272.5 + + + + 1 + 284.375 + 106.25 + + + + 1 + 297.5 + 123.75 + + + + 2 + 350 + 80 + + + + 1 + 217.292 + 513.125 + + + + 2 + 177.188 + 220 + + + + 1 + 223.125 + 176.25 + + + + 1 + 210 + 473.75 + + + + 1 + 201.25 + 303.125 + + + + 1 + 253.75 + 158.75 + + + + 1 + 201.25 + 416.875 + + + + 1 + 284.375 + 141.25 + + + + 2 + 253.75 + 416.875 + + + + 1 + 239.167 + 456.25 + + + + 1 + 231.875 + 491.25 + + + + 1 + 228.958 + 530.625 + + + + 1 + 239.167 + 237.5 + + + + 1 + 297.5 + 80 + + + + 2 + 350 + 40.625 + + + + 1 + 231.875 + 237.5 + + + + 2 + 240.625 + 530.625 + + + + 2 + 297.5 + 123.75 + + + + 1 + 212.917 + 285.625 + + + + 1 + 323.75 + 97.5 + + + + 1 + 91.875 + 202.5 + + + + 1 + 218.75 + 377.5 + + + + 1 + 238.438 + 158.75 + + + + 2 + 240.625 + 416.875 + + + + 1 + 358.75 + 58.125 + + + + 2 + 253.75 + 237.5 + + + + 1 + 177.188 + 220 + + + + 1 + 56.875 + 198.125 + + + + 2 + 293.125 + 272.5 + + + + 1 + 291.667 + 246.25 + + + + 1 + 358.75 + 23.125 + + + + 2 + 236.25 + 303.125 + + + + 2 + 310.625 + 123.75 + + + + 1 + 323.75 + 62.5 + + + + 1 + 247.625 + 193.75 + + + + 1 + 48.125 + 198.125 + + + + 1 + 242.812 + 491.25 + + + + 2 + 376.25 + 40.625 + + + + 1 + 227.5 + 399.375 + + + + 1 + 227.5 + 430 + + + + 2 + 284.375 + 176.25 + + + + 1 + 210 + 237.5 + + + + 1 + 144.375 + 220 + + + + 2 + 56.875 + 180.625 + + + + 1 + 214.375 + 416.875 + + + + 2 + 188.125 + 220 + + + + 1 + 112.383 + -380.041 + + + + 1 + 269.062 + 176.25 + + + + 1 + 367.5 + 58.125 + + + + 4 + 220.938 + 237.5 + + + + 1 + 112.384 + -380.041 + + + + 1 + 207.812 + 377.5 + + + + 1 + 112.384 + -380.039 + + + + 1 + 112.384 + -380.039 + + + + 2 + 74.375 + 180.625 + + + + 2 + 220.938 + 473.75 + + + + 1 + 112.383 + -380.041 + + + + 1 + 173.542 + 202.5 + + + + 1 + 264.323 + 233.125 + + + + 1 + 239.167 + 460.625 + + + + 1 + 238.438 + 163.125 + + + + 1 + 272.125 + 193.75 + + + + 4 + 310.625 + 80 + + + + 2 + 212.917 + 303.125 + + + + 1 + 240.625 + 399.375 + + + + 1 + 224.583 + 473.75 + + + + 1 + 259.875 + 189.375 + + + + 1 + 115.208 + 202.5 + + + + 1 + 211.458 + 360 + + + + 1 + 207.812 + 373.125 + + + + 1 + 112.384 + -380.04 + + + + 1 + 228.958 + 548.125 + + + + 1 + 336.875 + 80 + + + + 2 + 207.812 + 360 + + + + 1 + 336.875 + 97.5 + + + + 1 + 112.383 + -380.04 + + + + 1 + 112.383 + -380.041 + + + + 2 + 229.688 + 360 + + + + 2 + 358.75 + 40.625 + + + + 1 + 226.042 + 342.5 + + + + 2 + 158.958 + 220 + + + + 3 + 310.625 + 80 + + + + 2 + 138.635 + -380.041 + + + + 1 + 253.75 + 163.125 + + + + 1 + 65.625 + 180.625 + + + + 1 + 112.383 + -380.039 + + + + 2 + 336.875 + 80 + + + + 2 + 275.625 + 272.5 + + + + 2 + 138.633 + -380.041 + + + + 2 + 239.167 + 473.75 + + + + 2 + 226.042 + 360 + + + + 2 + 235.375 + 176.25 + + + + 2 + 253.75 + 473.75 + + + + 1 + 224.583 + 320.625 + + + + 2 + 253.75 + 176.25 + + + + 1 + 56.875 + 167.5 + + + + 1 + 284.375 + 255 + + + + 1 + 258.125 + 123.75 + + + + 1 + 115.208 + 185 + + + + 1 + 358.75 + 27.5 + + + + 2 + 126.875 + 202.5 + + + + 2 + 138.634 + -380.04 + + + + 2 + 138.634 + -380.04 + + + + 1 + 155.312 + 237.5 + + + + 2 + 138.633 + -380.04 + + + + 1 + 224.583 + 303.125 + + + + 1 + 214.375 + 434.375 + + + + 2 + 358.75 + 40.625 + + + + 1 + 297.5 + 141.25 + + + + 1 + 103.542 + 215.625 + + + + 1 + 196.875 + 360 + + + + 2 + 138.634 + -380.04 + + + + 2 + 138.634 + -380.041 + + + + 1 + 39.375 + 180.625 + + + + 2 + 240.625 + 360 + + + + 1 + 112.384 + -380.041 + + + + 1 + 297.5 + 136.875 + + + + 1 + 205.625 + 530.625 + + + + 2 + 173.542 + 220 + + + + 2 + 138.634 + -380.039 + + + + 2 + 138.633 + -380.041 + + + + 1 + 112.385 + -380.041 + + + + 1 + 358.75 + 53.75 + + + + 2 + 297.5 + 228.75 + + + + 2 + 224.583 + 237.5 + + + + 2 + 297.5 + 123.75 + + + + 2 + 138.634 + -380.041 + + + + 1 + 217.292 + 517.5 + + + + 2 + 259.875 + 176.25 + + + + 1 + 155.312 + 233.125 + + + + 1 + 103.542 + 220 + + + + 2 + 227.5 + 416.875 + + + + 1 + 226.042 + 346.875 + + + + 1 + 112.384 + -380.04 + + + + 2 + 227.5 + 416.875 + + + + 1 + 173.542 + 206.875 + + + + 2 + 166.25 + 220 + + + + 2 + 285.833 + 228.75 + + + + 1 + 112.383 + -380.04 + + + + 2 + 103.542 + 202.5 + + + + 1 + 259.875 + 193.75 + + + + 1 + 112.385 + -380.04 + + + + 1 + 247.625 + 189.375 + + + + 1 + 166.25 + 233.125 + + + + 2 + 138.633 + -380.041 + + + + 1 + 227.5 + 434.375 + + + + 2 + 238.438 + 176.25 + + + + 2 + 284.375 + 272.5 + + + + 1 + 218.75 + 373.125 + + + + 2 + 217.292 + 530.625 + + + + 2 + 271.25 + 123.75 + + + + 1 + 271.25 + 110.625 + + + + 2 + 138.635 + -380.04 + + + + 2 + 291.667 + 228.75 + + + + 1 + 336.875 + 93.125 + + + + 2 + 212.917 + 303.125 + + + + 1 + 272.125 + 189.375 + + + + 2 + 271.25 + 123.75 + + + + 1 + 284.375 + 136.875 + + + + 1 + 240.625 + 403.75 + + + + 2 + 310.625 + 80 + + + + 1 + 323.75 + 66.875 + + + + 2 + 240.625 + 416.875 + + + + 1 + 217.292 + 543.75 + + + + 2 + 48.125 + 180.625 + + + + 1 + 231.875 + 486.875 + + + + 1 + 56.875 + 193.75 + + + + 2 + 103.542 + 202.5 + + + + 1 + 112.384 + -380.04 + + + + 1 + 291.667 + 241.875 + + + + 1 + 310.625 + 66.875 + + + + 1 + 280 + 285.625 + + + + 1 + 284.375 + 259.375 + + + + 2 + 228.958 + 530.625 + + + + 1 + 242.812 + 486.875 + + + + 2 + 231.875 + 473.75 + + + + 2 + 138.633 + -380.04 + + + + 1 + 224.583 + 316.25 + + + + 2 + 284.375 + 123.75 + + + + 2 + 242.812 + 237.5 + + + + 1 + 268.644 + 232.441 + + + + 2 + 323.75 + 80 + + + + 2 + 367.5 + 40.625 + + + + 2 + 242.812 + 473.75 + + + + 2 + 115.208 + 202.5 + + + + 1 + 214.375 + 430 + + + + 2 + 218.75 + 360 + + + + 2 + 155.312 + 220 + + + + 1 + 323.75 + 93.125 + + + + 2 + 323.75 + 80 + + + + 2 + 247.625 + 176.25 + + + + 1 + 227.5 + 403.75 + + + + 1 + 260.002 + 233.809 + + + + 2 + 214.375 + 416.875 + + + + 1 + 115.208 + 189.375 + + + + 1 + 212.917 + 290 + + + + 1 + 284.375 + 110.625 + + + + 2 + 284.375 + 123.75 + + + + 1 + 228.958 + 543.75 + + + + 2 + 56.875 + 180.625 + + + + 2 + 280 + 272.5 + + + + 1 + 48.125 + 193.75 + + + + 2 + 224.583 + 303.125 + + + + 2 + 272.125 + 176.25 + + + + 2 + 217.292 + 530.625 + + + + 1 + 367.5 + 53.75 + + + + 46c354aa-e762-479a-a7c9-6db5aca4fd13 + 1-LV-rural1--2-no_sw(1) + + + + c179606b-8f57-48d9-8865-867b3582fe08 + 1-LV-rural1--2-no_sw + + + + + ab274502-2e94-cb5e-ced2-388e1952984c + LV1.101 Bus 10_Graph + + + + + 180 + f24a7ea8-8ea1-c989-0083-34e90dc5fca2 + Grafisches Netzelement58 + + + + + dca77355-1745-b3f7-a9f9-b91f0c467289 + GCO_1 + + + + + 7273b08a-2d7e-d429-e616-0f1cc0a2c317 + GCO_1 + + + + + 561e885b-656e-3cc1-a839-c9e4b93adafd + Grafisches Netzelement36 + + + + + 180 + 9bfcc67e-52c3-cf2e-33e0-884efba75c1f + Grafisches Netzelement33 + + + + + 81992949-5208-d7eb-a6e7-f3c80b8a543c + GCO_1 + + + + + b0d87b0c-8ca8-3b3b-9373-eecd98556c15 + GCO_1 + + + + + 8486d7ee-44b8-356d-1006-954440512c08 + LV1.101 Bus 4 + + + + + de59ae05-a59e-55d3-2bc2-099141090ab0 + Grafisches Netzelement44 + + + + + 6a26d02a-08a7-ec01-ceed-8c2eba8a826f + GCO_1 + + + + + 180 + acc63e73-b9bc-f466-47c2-e125e291fdf8 + Grafisches Netzelement34 + + + + + 6dc43235-35ac-c4a7-b250-051b9f868315 + GCO_1 + + + + + 26b21bd3-cc9c-9255-9b84-43613f782608 + Grafisches Netzelement55 + + + + + 9104b8aa-5d87-38e3-cfcc-b1db04b52eef + Grafisches Netzelement31 + + + + + f2536c2f-20d5-c255-13cf-f5699ac7cfe5 + GCO_1 + + + + + 8aff863b-b189-6594-a788-f504852694b2 + GCO_1 + + + + + b15772d4-6f84-a83a-d66e-29d7b34c72e6 + LV1.101 Bus 9 + + + + + 180 + b493b7e4-491a-247f-a573-2ba549f7781e + Grafisches Netzelement27 + + + + + 180 + ed3bf9cb-5a24-2a26-2f34-23de69ea291f + Grafisches Netzelement54 + + + + + 86ac4f26-fd95-5264-eb62-13c047950dcd + GCO_1 + + + + + e607ef8f-728e-dcd0-84c2-e55c39a8ced4 + GCO_1 + + + + + fcbc10fd-07ef-f8db-4e18-7d052e5fc089 + Grafisches Netzelement29 + + + + + 608d1af4-8f5c-7d36-04df-13c898237352 + GCO_1 + + + + + fe0690bb-3265-f6c4-9521-269ea8c0a34b + Grafisches Netzelement18 + + + + + a6dc502b-4270-3fad-05c4-25f3c4de3729 + GCO_1 + + + + + 4b36ab50-a342-8bc0-bdaf-3bcd7ca796b9 + LV1.101 Bus 3 + + + + + 05844f3e-e7fc-1cd0-9366-0d4d9c8d1544 + GCO_1 + + + + + 4bb34af9-2a77-94b0-4784-84711ac0eef9 + Grafisches Netzelement52 + + + + + fc6a09de-876d-6893-0cac-e0fc2feb67fd + Grafisches Netzelement24 + + + + + 81 + 565025ca-165b-4e47-f119-4a80a9e276fb + Grafisches Netzelement17 + + + + + 2c909e87-317c-2196-84ec-ab46da658091 + GCO_1 + + + + + d19f7458-b957-1a0a-5189-242f2362a340 + GCO_1 + + + + + 820b0c4c-4fd6-5c20-e1ba-3c77af1a503c + Grafisches Netzelement43 + + + + + feb80397-b3b8-d0e1-e501-3d9c69f6be63 + Grafisches Netzelement22 + + + + + 180 + cdc28c57-4f28-aedf-ed0a-8f6aec1c84bf + Grafisches Netzelement48 + + + + + 800d3dab-1081-fb28-1680-c96472225e92 + GCO_1 + + + + + 6789a5b5-e37c-af67-9496-c1d90f499451 + GCO_1 + + + + + 180 + 478d417a-b356-1b91-1744-d3af74e05bd1 + Grafisches Netzelement37 + + + + + b98d0122-9713-29d5-eb0c-71b17f0952f1 + LV1.101 Bus 13 + + + + + 1e3cec73-d213-45c4-3a3e-367397f07c67 + GCO_1 + + + + + f8d2fcb2-961b-bf93-50bb-7dcca1cd3728 + GCO_1 + + + + + 0cfbd288-a85a-094c-af1f-dc8a9db514ad + Grafisches Netzelement25 + + + + + 797a7e8a-5f79-6488-b484-84ee2bd99d69 + Grafisches Netzelement30 + + + + + 7b5d92a8-0ae1-f3e5-c309-3f78b1018d49 + GCO_1 + + + + + 95d15384-1111-0472-2217-745fd6e480bb + Grafisches Netzelement21 + + + + + 59de1ef2-621e-7fdf-880c-e1265a5a5aab + GCO_1 + + + + + d16b46b5-724b-c786-304c-845c16e7bc08 + LV1.101 Bus 8 + + + + + 538021ef-e5c0-18a9-87d9-5a17b9e6a84f + GCO_1 + + + + + 8dfcfc2e-b903-7bf2-9569-ecaf81c8ece9 + Grafisches Netzelement49 + + + + + 2c571f97-d21e-b59a-2cb5-56ef16cf5b25 + GCO_1 + + + + + b21c4549-8299-9357-4dc6-27dd7cd6e4a2 + Grafisches Netzelement20 + + + + + 26397ad1-9fb0-5903-75d4-8262e415a1a2 + GCO_1 + + + + + 4fbc2244-57fb-24c3-51d9-cf446e5c83be + Grafisches Netzelement46 + + + + + dcd52969-1912-898b-a99d-6fb32d4297a7 + Grafisches Netzelement53 + + + + + 54b177f8-73d0-0f5c-ccfa-91d66b2da3d2 + GCO_1 + + + + + 80c197d1-4797-9382-3f0d-8c097906e00b + MV1.101 Bus 4_Graph + + + + + 8758f745-290a-3330-ae18-0ba090416eeb + GCO_1 + + + + + 77ccfd7c-c5a9-12f0-c25f-50f8634a8909 + GCO_1 + + + + + 180 + 86d62768-6de7-8bb9-c384-0fb58ee7274d + Grafisches Netzelement40 + + + + + b2fec5a4-8e6d-35df-21b4-de936f87cd85 + LV1.101 Bus 6 + + + + + b6675950-af8f-2257-028e-5b018bdde9b2 + LV1.101 Bus 3_Graph + + + + + edf6da7f-13a1-d8b7-75ee-3507e8395308 + GCO_1 + + + + + 190a4c47-5263-45da-0d11-f0f506afe542 + GCO_1 + + + + + 4f5eb48a-b046-d85a-b807-e9015c3fc884 + Grafisches Netzelement56 + + + + + 86b5f1af-3fc0-cf26-7d07-2a9fc10a6724 + LV1.101 Bus 5 + + + + + 3d5c95e1-9a7e-ccd4-fc96-8e8ab96181dd + GCO_1 + + + + + 79ac68ab-fb12-abb0-0f95-a7880614f245 + LV1.101 Bus 6_Graph + + + + + 1a8c7a1a-fdea-810f-1035-2107328523b9 + GCO_1 + + + + + b9fcc6b7-f396-9aee-52b4-3552451ac998 + LV1.101 Bus 9_Graph + + + + + fed8b2ab-dd7d-27db-6a39-583ce2df7e66 + LV1.101 Bus 11 + + + + + 4f368292-009d-ad64-a577-a2959ee016b3 + Grafisches Netzelement16 + + + + + 180 + 6d07be7b-14db-1b0f-2cb8-270dfb161be4 + Grafisches Netzelement51 + + + + + 804daae9-b5e6-563c-fac0-a38ff978abb8 + GCO_1 + + + + + 42a1c246-4324-6bcc-9619-7a31f214797c + LV1.101 Bus 8_Graph + + + + + 8f0d80b0-0ef9-2632-0515-8ca4c5f99ee1 + LV1.101 Bus 2 + + + + + 293 + 837f2419-127c-a4f2-cd3c-93aae63d801f + Grafisches Netzelement60 + + + + + 29902223-2ba3-423a-6b17-ff959055e891 + GCO_1 + + + + + 6f77e205-00bc-1cb1-3c7f-5c85f5a8786e + LV1.101 Bus 7_Graph + + + + + c0e959ca-812f-02ce-66a9-448ebe3ed0e1 + GCO_1 + + + + + 1d47aacd-c65b-30b8-3d2b-3fd46e6a554b + Grafisches Netzelement19 + + + + + c13677be-c318-b890-5578-ff5081210030 + Grafisches Netzelement35 + + + + + bc2cd99f-6003-5b91-d4d6-ab79e8d05e24 + GCO_1 + + + + + 9dfb1822-1e64-3f2a-7183-a97425f808aa + LV1.101 Bus 14 + + + + + e6b53c37-987a-0b1e-4af9-6447adac6978 + LV1.101 Bus 13_Graph + + + + + 180 + 8df1b81a-338f-4c8b-13aa-b6b2d9996825 + Grafisches Netzelement38 + + + + + edaef163-a5c8-935a-58c0-87b1ff59b7d1 + GCO_1 + + + + + ae9ab461-b242-c8e9-887d-240ed516084e + LV1.101 Bus 1 + + + + + 6a6e83cb-f07b-f499-2931-a3d22d307840 + LV1.101 Bus 5_Graph + + + + + 306 + cffd5032-d32f-0f57-bb12-fae53f7536b7 + Grafisches Netzelement61 + + + + + f6b59b61-2bfb-3353-3489-ab4458c11401 + Grafisches Netzelement50 + + + + + 52d61dea-b86c-de9c-91b0-681557408e95 + GCO_1 + + + + + 14835ed3-4dc9-e111-c0af-9d4ddff423b3 + GCO_1 + + + + + 93f6f758-3a50-6a92-c83e-7466c0622590 + LV1.101 Bus 2_Graph + + + + + 285 + f31c2f08-dd57-54df-8ef6-9a94bc175292 + Grafisches Netzelement69 + + + + + 180 + 9f3880f6-3b17-d578-8d5f-e8c3c0120df3 + Grafisches Netzelement57 + + + + + 91ffc9f2-76ee-9055-05c7-a0d19c0836a4 + GCO_1 + + + + + fdc35cfa-f970-1b2d-997f-4e5ce1e9cc62 + LV1.101 Bus 12_Graph + + + + + f7ac1982-dcc4-7acc-3e66-ae935fe7ff6b + Grafisches Netzelement26 + + + + + ee0b9c55-4f90-f2e1-182f-04ee3af53449 + GCO_1 + + + + + 171 + 9297f9be-a273-2400-f461-79f5250c53a5 + Grafisches Netzelement71 + + + + + 729fb138-684a-8389-ae9a-7fab56781e50 + LV1.101 Bus 11_Graph + + + + + 01413a67-0508-1f75-2cf6-ad64eab41d69 + GCO_1 + + + + + 180 + 0986844f-5fea-a27d-a45a-54fa1e772eb9 + Grafisches Netzelement47 + + + + + 191 + 01c0753d-4ebe-1812-cd53-ec16494520ba + Grafisches Netzelement62 + + + + + 9f7dde2b-f88d-753e-2eb6-29c79cf93746 + GCO_2 + + + + + 6b55ed4a-1147-df6d-df22-d20b3b05bba5 + LV1.101 Bus 4_Graph + + + + + ad263154-91a8-50cf-8f3e-65dce9121379 + GCO_1 + + + + + 222 + 60e704a5-cdba-eca9-72b0-3977681dc854 + Grafisches Netzelement68 + + + + + f42521c8-faf7-8f7f-e515-6e9dfe7bf26f + GCO_1 + + + + + 180 + 4596ac51-531a-5829-9498-03b751b71e04 + Grafisches Netzelement23 + + + + + 189 + 17d6807e-43d0-3e03-be53-a59087d960a2 + Grafisches Netzelement67 + + + + + 5750d2fe-f56f-3f19-b2fd-c9c358df57bf + MV1.101 Bus 4 + + + + + fbd66258-2dc1-cea3-8671-fb24810ce804 + LV1.101 Bus 1_Graph + + + + + 738d2d0b-7f4b-70bc-9f75-fa38b778da5a + LV1.101 Bus 12 + + + + + 180 + 1ad6483c-b844-637a-ec2b-dee2a80406fd + Grafisches Netzelement42 + + + + + 210 + 3a0fa92f-0ae3-24d4-8482-7b3104cb2d3b + Grafisches Netzelement65 + + + + + c64f403b-178f-8157-1e17-1e4db1e42ef5 + LV1.101 Bus 10 + + + + + 180 + 5e44a93d-604e-3683-786a-e289120af29b + Grafisches Netzelement41 + + + + + 25fe2128-33c1-d757-a6a7-7459bbe7b191 + LV1.101 Bus 7 + + + + + 222 + 17a3f49e-68a2-22a7-624f-28e070b1e141 + Grafisches Netzelement70 + + + + + 287 + 15fe282d-b4fa-7de7-1c07-31f02851c923 + Grafisches Netzelement64 + + + + + 180 + 34d81296-8036-7de2-8684-9176c3c54061 + Grafisches Netzelement59 + + + + + 176 + 14bdf164-c9f6-9fd0-35a3-6a73bbe9defa + Grafisches Netzelement66 + + + + + 200 + 25c15dca-19be-d701-bd1e-e0a8074df263 + Grafisches Netzelement63 + + + + + b9a637e3-2a48-af42-a897-33329f0da55d + LV1.101 Bus 14_Graph + + + + + 82b658d9-c29d-e867-7521-254b26844c4d + Grafisches Netzelement45 + + + + + 180 + aeb1b19e-8700-9e69-d70b-aade5b1372db + Grafisches Netzelement32 + + + + + 180 + 737bf3d4-f472-58b0-932d-edb08aeab7c5 + Grafisches Netzelement28 + + + + + ae5b9bea-8ecc-7dee-6d0c-517e5134c84a + Grafisches Netzelement39 + + \ No newline at end of file diff --git a/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/20151231T2300Z_XX_YYY_SSH_.xml b/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/20151231T2300Z_XX_YYY_SSH_.xml new file mode 100644 index 00000000..d956e975 --- /dev/null +++ b/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/20151231T2300Z_XX_YYY_SSH_.xml @@ -0,0 +1,721 @@ + + + + + + 2023-05-09T13:15:07Z + www.ie3.etit.tu-dortmund.de + http://iec.ch/TC57/ns/CIM/SteadyStateHypothesis-EU/3.0 + 2015-12-31T23:00:00Z + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + 0.44 + + + 0.36 + + + 0.36 + + + 0.36 + + + 0.44 + + + 0.44 + + + 0.36 + + + 0.44 + + + 0.44 + + + 0.36 + + + 0.44 + + + 0.44 + + + 0.44 + + + 0.36 + + + 0.44 + + + 21.1 + + + 0.36 + + + 0.36 + + + 0.36 + + + 19.3 + + + 0.36 + + + 0.44 + + + 0.36 + + + 0.44 + + + 0.44 + + + 0.44 + + + 0.44 + + + 0.36 + + + 0.36 + + + 0.36 + + + 0.0137 + 0.0054 + true + + + 0.0059 + 0.0024 + true + + + 0.002 + 0.0008 + true + + + 0.002 + 0.0008 + true + + + 0.0079 + 0.0031 + true + + + 0.003 + 0.0012 + true + + + 0.0109 + 0.0043 + true + + + 0.004 + 0.0016 + true + + + 0.0137 + 0.0054 + true + + + 0.0109 + 0.0043 + true + + + 0.0037 + 0.0014 + true + + + 0.0037 + 0.0014 + true + + + 0.0218 + 0.0086 + true + + + 0.0049 + 0.002 + true + + + 0.0119 + 0.0046 + true + + + 0.0218 + 0.0086 + true + + + 0.002 + 0.0008 + true + + + 0.004 + 0.0016 + true + + + 0.003 + 0.0012 + true + + + 0.003 + 0.0012 + true + + + 0.002 + 0.0008 + true + + + 0.0049 + 0.002 + true + + + 0.0037 + 0.0014 + true + + + 0.002 + 0.0008 + true + + + 0.003 + 0.0012 + true + + + 0.003 + 0.0012 + true + + + 0.0049 + 0.002 + true + + + 0.004 + 0.0016 + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + + 0 + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + true + + + + 0 + true + + + + 0 + true + + + + 0 + true + + + + 0 + true + + + true + + + true + + + 4.6188 + + + 270 + + + 270 + + + 230.94 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + 270 + + + true + 0 + 0 + false + + + true + -0.0245 + 0 + false + + + true + -0.0489 + 0 + false + + + true + 0 + 0 + false + + + true + -0.1172 + 0 + false + + + true + -0.019 + 0 + false + + + true + -0.023 + 0 + false + + + true + -0.1172 + 0 + false + + + true + -0.04 + 0 + false + + + true + -0.0784 + 0 + false + + + true + 0 + 0 + false + + + true + 0 + 0 + false + + + true + 0 + 0 + false + + + true + 0 + 0 + 1 + true + + + false + 1 + + + false + true + 20.5 + + + \ No newline at end of file diff --git a/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/20151231T2300Z_XX_YYY_SV_.xml b/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/20151231T2300Z_XX_YYY_SV_.xml new file mode 100644 index 00000000..0233d750 --- /dev/null +++ b/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/20151231T2300Z_XX_YYY_SV_.xml @@ -0,0 +1,685 @@ + + + + + + + 2023-05-09T13:15:07Z + www.ie3.etit.tu-dortmund.de + http://iec.ch/TC57/ns/CIM/StateVariables-EU/3.0 + 2015-12-31T23:00:00Z + + + + 0.003 + 0.0012 + + + + 0.0119 + 0.0046 + + + + 0.003 + 0.0012 + + + + 0.002 + 0 + + + + -0.1172 + 0 + + + + -0.0923119 + 0.00972368 + + + + 0.0059 + 0.0024 + + + + 0.002 + 0 + + + + 0.004 + 0.0016 + + + + -0.0712516 + 0.0181743 + + + + -0.0305517 + 0.00680054 + + + + 0.0137 + 0.0054 + + + + -0.0573452 + 0.0235845 + + + + 0.0109 + 0.0043 + + + + 0.0716172 + -0.0180343 + + + + 0.003 + 0.0012 + + + + 0.0998221 + -0.00673782 + + + + 0 + 0 + + + + 0.002 + 0 + + + + -0.0149728 + 0.00320059 + + + + 0.0937912 + -0.00915412 + + + + -0.037895 + 0.00431958 + + + + -0.0242777 + 0.0097323 + + + + -0.0937438 + 0.0249972 + + + + -0.019 + 0 + + + + -0.0563313 + 0.0354728 + + + + 0.004 + 0.0016 + + + + 0.0379981 + -0.00428186 + + + + 0.0037 + 0.0014 + + + + -0.0189768 + 0.00159778 + + + + 0.003 + 0.0012 + + + + 0 + 0 + + + + 0.0751753 + -0.0205083 + + + + -0.274253 + 0.0928229 + + + + 0.0563604 + -0.0354617 + + + + 0.282423 + -0.0732956 + + + + 0 + 0 + + + + 0.0109 + 0.0043 + + + + 0.0189981 + -0.00159146 + + + + 0.0149781 + -0.00319927 + + + + 0.0079 + 0.0031 + + + + 0.0242993 + -0.00972497 + + + + -0.1172 + 0 + + + + -0.0784 + 0 + + + + -0.101751 + 0.00602376 + + + + 0.004 + 0.0016 + + + + 0.002 + 0 + + + + 0.0049 + 0.002 + + + + 0.0218 + 0.0086 + + + + -0.0245 + 0 + + + + 0.0049 + 0.002 + + + + 0.0049 + 0.002 + + + + 0.0037 + 0.0014 + + + + 0 + 0 + + + + -0.04 + 0 + + + + -0.023 + 0 + + + + 0.0305719 + -0.00679334 + + + + 0.0943421 + -0.0247665 + + + + 0.0137 + 0.0054 + + + + -0.0489 + 0 + + + + 0.103507 + -0.00534601 + + + + 0.002 + 0 + + + + 0 + 0 + + + + 0.0037 + 0.0014 + + + + 0.274253 + -0.0928229 + + + + 0.0218 + 0.0086 + + + + 0.0573556 + -0.0235805 + + + + -0.0750511 + 0.020556 + + + + 0.003 + 0.0012 + + + + -0.0997907 + 0.0067499 + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + true + + + + 1 + + + + -145.019 + 0.412765 + + + + -145.877 + 0.402486 + + + + -145.647 + 0.404691 + + + + -145.442 + 0.409262 + + + + -145.855 + 0.402598 + + + + -145.685 + 0.404448 + + + + 0 + 20.5 + + + + -145.843 + 0.402844 + + + + -145.813 + 0.403278 + + + + -145.762 + 0.403413 + + + + -145.855 + 0.402718 + + + + -145.47 + 0.406449 + + + + -145.028 + 0.412639 + + + + -145.654 + 0.404638 + + + + -145.797 + 0.403152 + + + 925c40ef-32d5-4466-af2d-ec8015bef04b + Island_001 + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/20151231T2300Z_XX_YYY_TP_.xml b/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/20151231T2300Z_XX_YYY_TP_.xml new file mode 100644 index 00000000..15f38464 --- /dev/null +++ b/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/20151231T2300Z_XX_YYY_TP_.xml @@ -0,0 +1,311 @@ + + + + + + 2023-05-09T13:15:07Z + www.ie3.etit.tu-dortmund.de + http://iec.ch/TC57/ns/CIM/Topology-EU/3.0 + 2015-12-31T23:00:00Z + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 45989efa-64b7-26dc-49b2-0d51d32050ee + LV1.101 Bus 4 + + + + + 067bb88f-d14a-aa41-6227-22db1d0dba6d + LV1.101 Bus 13 + + + + + 22346297-cca9-2106-5481-91684ee9642b + LV1.101 Bus 5 + + + + + befdca80-2e62-566c-b76e-cf758c7b13eb + LV1.101 Bus 6 + + + + + cfcce23d-3d52-9fa3-8c24-a2b72f3cf333 + LV1.101 Bus 8 + + + + + 84e160ed-03e1-d277-3815-25b1f17be9ec + LV1.101 Bus 12 + + + + + 0bc6c7b0-3520-9166-8e09-639edf91ede3 + LV1.101 Bus 2 + + + + + 83a2dafc-3f7b-d040-8955-b8762cc5e464 + LV1.101 Bus 9 + + + + + 75c5a0b7-f321-b362-5349-c3cf38a6a962 + LV1.101 Bus 7 + + + + + 331e093a-f298-fb3e-91f6-826695fb3a52 + LV1.101 Bus 3 + + + + + c49d03bf-69f9-5787-6e52-ed81bf8c0bfa + LV1.101 Bus 14 + + + + + daa6b445-c814-e801-b08c-d766391921b6 + LV1.101 Bus 1 + + + + + f057020a-055c-6446-e781-d9ea5d312b7e + LV1.101 Bus 11 + + + + + 9904d0a9-c245-e550-51b7-6445d9ebb38f + LV1.101 Bus 10 + + + + + fea3552a-86e4-a2e8-20be-258faeeaae3d + MV1.101 Bus 4 + + + + \ No newline at end of file diff --git a/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/20151231T2300Z_YYY_EQ_.xml b/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/20151231T2300Z_YYY_EQ_.xml new file mode 100644 index 00000000..42be14a7 --- /dev/null +++ b/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/20151231T2300Z_YYY_EQ_.xml @@ -0,0 +1,1966 @@ + + + + + 2023-05-09T13:15:07Z + www.ie3.etit.tu-dortmund.de + http://iec.ch/TC57/ns/CIM/CoreEquipment-EU/3.0 + 2015-12-31T23:00:00Z + + + 2 + 6573e5b5-63a6-47c9-bb79-fbb5befbda71 + LV1.101 Bus 14_LV1.101 Line 9 + + + + + 1 + b68b3bc6-96bd-4da1-bed1-0da722d55d38 + LV1.101 Bus 12_LV1.101 Line 8 + + + + + 1 + 82235650-a803-185f-9183-5b59c7652b0f + Cubicle_MV1.101 grid at LV1.101 + + + + + 2 + 8d199eb6-eedc-4e8e-8860-66244728c1d5 + LV1.101 Bus 4_MV1.101-LV1.101-Trafo 1 + + + + + 1 + b8fbbb3b-0cd9-4815-9a26-ef6928af84a9 + LV1.101 Bus 2_LV1.101 Line 12 + + + + + 1 + c850c11d-e4a8-47fa-bd82-7505741f29d6 + Cubicle_LV1.101 Load 24 + + + + 1 + 29fa4900-5eb5-462f-949e-022fd07d2422 + Cubicle_LV1.101 Load 23 + + + + 1 + 8940ed9d-4eee-4cf5-8562-a7f575c97068 + LV1.101 Bus 10_LV1.101 Line 1 + + + + + 1 + ca4bb642-61d3-4fc1-b989-d829bdd8efc1 + Cubicle_LV1.101 Load 27 + + + + 2 + be6ed5d8-1553-4061-b969-4cd8316bc0e7 + LV1.101 Bus 8_LV1.101 Line 7 + + + + + 1 + 0b840725-1625-4fcb-9a38-0072153dea72 + LV1.101 Bus 14_LV1.101 Line 2 + + + + + 1 + a6362ded-d192-4afc-bdbf-8378f5aa3788 + LV1.101 Bus 11_LV1.101 Line 6 + + + + + 1 + 5350f46c-711b-4e68-ba8a-fc388966f338 + Cubicle_LV1.101 Load 10 + + + + 2 + 0769f722-ad6a-4704-8ea6-58c87d74c268 + LV1.101 Bus 12_LV1.101 Line 2 + + + + + 1 + 8f1d3257-bd3e-4bc2-88da-71bd76a3d229 + Cubicle_LV1.101 Load 8 + + + + 1 + d39da9d5-0c4b-4b80-9493-70d35d40f96d + Cubicle_LV1.101 Load 11 + + + + 1 + 12d5a636-c5a4-45cb-b182-05d44203ffc5 + Cubicle_LV1.101 Load 16 + + + + 1 + ca94ef42-5dc7-4d35-8ac1-afade54aa86f + Cubicle_LV1.101 SGen 1 + + + + + 1 + 84e15e44-5d09-4242-98d3-9f3ce8a41771 + LV1.101 Bus 7_LV1.101 Line 3 + + + + + 1 + 3c28167d-23b3-487b-bb44-49627bf8e400 + Cubicle_LV1.101 Load 28 + + + + 1 + a6ec6e4b-91c2-446c-8760-a659b6d87e0d + Cubicle_LV1.101 Load 25 + + + + 1 + de8a3074-3be4-4d87-b4bc-43165013d6ec + Cubicle_LV1.101 SGen 3 + + + + + 1 + 606fca89-cee3-4c42-8326-0022e284d314 + LV1.101 Bus 4_LV1.101 Line 7 + + + + + 1 + 1e1af7a8-1e57-48de-b8e0-89518228558b + Cubicle_LV1.101 Load 14 + + + + 1 + 53b49cf4-14f1-447c-a78e-ec7777d81037 + LV1.101 Bus 5_LV1.101 Line 11 + + + + + 1 + 299f0a6a-4575-4fdf-83e1-5016e729521b + MV1.101 Bus 4_MV1.101-LV1.101-Trafo 1 + + + + + 1 + 67759146-f9c1-4f87-86f3-4a72a03f5f6c + Cubicle_LV1.101 Load 18 + + + + 1 + 4446158d-c9d1-483e-b715-958b14af4d0b + Cubicle_LV1.101 Load 1 + + + + 1 + 6e20d229-ba72-438f-b37b-019ee6c4f744 + Cubicle_LV1.101 SGen 6 + + + + + 1 + 7d1c6d1c-9883-4c67-9e07-f2f8c9e6d20c + Cubicle_LV1.101 Load 5 + + + + 1 + 4aa7e131-42e6-45e5-adbb-536251d3adad + Cubicle_LV1.101 Load 6 + + + + 1 + 540da292-02e3-435e-9bf3-d36b78619d01 + LV1.101 Bus 4_LV1.101 Line 10 + + + + + 1 + 5b10f88a-6f2c-4277-9eb8-20c9ec2f9316 + Cubicle_LV1.101 Load 9 + + + + 1 + 1e2ff5b5-fc49-456c-808b-8a995623250e + Cubicle_LV1.101 SGen 4 + + + + + 1 + c14240b4-13a7-44d9-a632-f22b4d2b7a8b + Cubicle_LV1.101 Load 12 + + + + 1 + 8606b7bb-a563-4a91-acaa-f4ccb56f8ead + Cubicle_LV1.101 Load 2 + + + + 1 + d7fc9a2a-990c-4bc3-9785-f0cc1792522c + Cubicle_LV1.101 Load 13 + + + + 1 + 17390844-ac9f-4ba2-be3b-3c304c06b231 + Cubicle_LV1.101 Load 22 + + + + 1 + 0fd5ef0b-d296-417e-8a9c-83f22bd1c426 + LV1.101 Bus 9_LV1.101 Line 4 + + + + + 1 + 2b8a58aa-c6f7-4166-a51f-ddbe3d5655a8 + Cubicle_LV1.101 Load 19 + + + + 1 + 7c5f000a-3f7e-42d9-9cf9-50b1bb35b2d1 + Cubicle_LV1.101 Load 17 + + + + 1 + 29a12e04-ee6f-4c3b-af22-8d8665da16ea + LV1.101 Bus 6_LV1.101 Line 9 + + + + + 1 + 539c5c0d-8769-43a5-9fcf-f6420690e257 + Cubicle_LV1.101 Load 4 + + + + 1 + 11c3da26-b40d-4a4c-bf3e-f638b3d5409a + Cubicle_LV1.101 Load 26 + + + + 2 + 2469aa63-b93c-4ed4-807d-27848aabe7f8 + LV1.101 Bus 4_LV1.101 Line 12 + + + + + 1 + 947facf3-6edd-4091-8e81-9161780b6e32 + Cubicle_LV1.101 Load 21 + + + + 2 + 3247de14-f37b-468e-9598-5661e434cb65 + LV1.101 Bus 3_LV1.101 Line 1 + + + + + 1 + a3037c12-b605-469b-b893-77d9fb1cf234 + Cubicle_LV1.101 Load 3 + + + + 1 + f8fed63a-4225-40b5-b714-e95a26b780b6 + Cubicle_LV1.101 Load 7 + + + + 1 + 38a27c29-5d31-4d8c-adea-8ab386d2665f + Cubicle_LV1.101 Storage 2 + + + + + 1 + d36e1894-656d-4464-94bc-3dbdf16f425d + Cubicle_LV1.101 Load 20 + + + + 1 + 3851b6d3-f52b-4422-a2ef-607d08614587 + Cubicle_LV1.101 SGen 5 + + + + + 2 + 40455e91-082f-42bc-84c2-6a68626094d2 + LV1.101 Bus 7_LV1.101 Line 8 + + + + + 1 + 0e9e5ee5-1b60-44a5-8514-ca68a5c64452 + Cubicle_LV1.101 Load 15 + + + + 2 + e594a44b-3213-47a8-b236-926c3604f457 + LV1.101 Bus 4_LV1.101 Line 3 + + + + + 2 + f07d83e7-0cfc-4dd8-a77a-36571565c348 + LV1.101 Bus 6_LV1.101 Line 11 + + + + + 2 + 09328f3e-72af-433b-992a-e28255abf343 + LV1.101 Bus 2_LV1.101 Line 4 + + + + + 1 + bd0d8979-8b5a-4f79-9b49-1fb4e9e03b11 + Cubicle_LV1.101 Storage 3 + + + + + 2 + 777f7f7a-70ab-4846-99f4-a730617799ff + LV1.101 Bus 11_LV1.101 Line 5 + + + + + 1 + f048e7a4-17f1-4921-80eb-fac7f33d3944 + LV1.101 Bus 8_LV1.101 Line 5 + + + + + 1 + 9a5640bc-25b4-4b99-b6c5-6809d3e3d605 + Cubicle_LV1.101 Storage 5 + + + + + 1 + d295d51f-bb5a-4fa3-89b9-4b28a8844588 + Cubicle_LV1.101 Storage 1 + + + + + 2 + baebb27f-2b06-4534-8821-360f9205f2d6 + LV1.101 Bus 9_LV1.101 Line 13 + + + + + 1 + ad14b24a-1d2f-4705-8843-3dfe6a692b33 + Cubicle_LV1.101 SGen 7 + + + + + 1 + ca003607-a538-4313-ac4f-bd4f3d8b5274 + Cubicle_LV1.101 Storage 4 + + + + + 2 + 821a8698-9161-4ea8-aaa0-e59cdb5e5d07 + LV1.101 Bus 10_LV1.101 Line 6 + + + + + 1 + b0b6cd87-5828-4095-9fa1-034c891af789 + LV1.101 Bus 13_LV1.101 Line 13 + + + + + 1 + d8d0f0c5-cc39-48f5-9517-f315780cdceb + Cubicle_LV1.101 SGen 8 + + + + + 1 + 9bbc7e33-ed61-44a4-9097-a3e3783914d7 + Cubicle_LV1.101 SGen 2 + + + + + 2 + c7e220bf-ca7b-4936-8284-5ffc6ecdd823 + LV1.101 Bus 1_LV1.101 Line 10 + + + + + 7f4965a7-cd01-c39b-6756-0516da8a78b6 + Voltage limits for LV1.101 Bus 14 + + + + 57ac9a3e-0fdf-821a-d90d-1204732c5af6 + Voltage limits for LV1.101 Bus 4 + + + + e1c6ef52-80b5-f334-1100-f3951029b5de + Current rating for MV1.101-LV1.101-Trafo 1 + + + + 1a380a0c-b23f-c30e-01d1-b97f44a43d69 + Current rating for LV1.101 Line 10 + + + + 40abb5f9-502e-5ed9-a83a-8f6c5ad7d55d + Current rating for LV1.101 Line 9 + + + + f5d25d70-0acb-971e-fa19-91be583510fe + Voltage limits for LV1.101 Bus 10 + + + + 05fe5fec-2d10-84da-9094-40155144884e + Current rating for LV1.101 Line 2 + + + + 7e53285b-9e9e-1bd5-66bb-c4bc000c70b7 + Voltage limits for LV1.101 Bus 5 + + + + 27881ba4-70bd-0a73-61a5-c44861c9aeed + Voltage limits for LV1.101 Bus 7 + + + + 55b4a5b5-1244-ae84-8d60-267f27fa26c9 + Current rating for LV1.101 Line 7 + + + + 0225f0fa-d831-5f17-cbfa-f31f089272c2 + Current rating for LV1.101 Line 10 + + + + 0387ecb7-fbf8-6203-ffb2-3aaf274f3c10 + Current rating for LV1.101 Line 2 + + + + 0d8677f6-5b41-fba0-aa32-e8c4cc89b06d + Current rating for LV1.101 Line 11 + + + + d1e64e0e-a1f6-6675-1b7c-283ebe5c6100 + Current rating for LV1.101 Line 11 + + + + 65bd0d9b-681d-64f6-e2bd-c6839b6feaa2 + Current rating for LV1.101 Line 7 + + + + 20415075-032e-9f84-fbd0-37d2e763c569 + Voltage limits for LV1.101 Bus 11 + + + + b6e9f998-9913-72f4-038d-31cb3ba60900 + Current rating for MV1.101-LV1.101-Trafo 1 + + + + 13b25b03-8b16-2782-8b84-6f0252931787 + Current rating for LV1.101 Line 3 + + + + 1b87dd17-77a7-5de0-efc2-4e97e2dd947a + Current rating for LV1.101 Line 9 + + + + e36f2fc2-da24-d65c-c76b-1df0cf26fb73 + Current rating for LV1.101 Line 13 + + + + 5f41d991-03ff-91cf-d8ca-3a373a2a1c48 + Current rating for LV1.101 Line 13 + + + + 785dd895-52a5-3bab-5869-acc2b2eccf7b + Voltage limits for MV1.101 Bus 4 + + + + 58f44a1e-02c5-a801-af18-bd97e019af51 + Current rating for LV1.101 Line 3 + + + + aecbc441-60e3-70f1-285c-d2029f40157f + Current rating for LV1.101 Line 1 + + + + 336b01db-5e24-7c21-b7f9-c5a89fffca69 + Voltage limits for LV1.101 Bus 2 + + + + 51e6f716-d309-b003-e623-290f4c5c4059 + Current rating for LV1.101 Line 1 + + + + 135ddab3-bc26-4cc4-35da-9b2f622ffdc8 + Voltage limits for LV1.101 Bus 12 + + + + edee70d2-25bf-4541-7b7c-24625f27f8e1 + Voltage limits for LV1.101 Bus 13 + + + + 98f16f62-4ed2-b326-5edf-f04f721651f5 + Current rating for LV1.101 Line 8 + + + + 30b4709c-70d2-346e-cff6-74cc5ae1ed68 + Current rating for LV1.101 Line 12 + + + + 112bc0bc-9a6d-c160-c7e1-371630dde06a + Current rating for LV1.101 Line 6 + + + + d120a5af-a38d-3081-5d88-8a884ea22d15 + Voltage limits for LV1.101 Bus 3 + + + + df1e500a-53d6-c241-732e-0c3e00e51faf + Current rating for LV1.101 Line 5 + + + + 281dd5e5-2c5d-b31f-09d4-0a08ad77e35e + Current rating for LV1.101 Line 6 + + + + b5ab0cf0-4e08-664f-5051-e02e997b5abe + Current rating for LV1.101 Line 4 + + + + c3ca9d1a-df0f-b867-86ac-f88cb58af2dd + Current rating for LV1.101 Line 8 + + + + a47b6455-25b9-686b-0f21-b87632053f53 + Voltage limits for LV1.101 Bus 1 + + + + 7076a390-f50e-1f63-9fc7-d3b52e51a30c + Current rating for LV1.101 Line 4 + + + + bbe28838-4144-f77a-0e38-7908a26de802 + Voltage limits for LV1.101 Bus 6 + + + + 4bec8272-6f17-e8e4-1fff-d19c48716240 + Current rating for LV1.101 Line 5 + + + + 6b89f541-e273-6a4d-1f47-9c809a1a2ec4 + Voltage limits for LV1.101 Bus 9 + + + + 0256953b-05e5-9deb-73fb-ff25cfefe3f3 + Voltage limits for LV1.101 Bus 8 + + + + dfc65d76-bc43-948f-3f14-95630663ea1b + Current rating for LV1.101 Line 12 + + + + 969ca142-66c0-1e4a-d69e-daa4615a10a7 + low limit for LV1.101 Bus 1 + + + 0.36 + + + 6f5fbcc9-39c1-2bee-a9e4-26a5dc3f33be + high limit for LV1.101 Bus 12 + + + 0.44 + + + b0e50e5e-1ac3-c74d-476a-8a9ae5748af4 + low limit for LV1.101 Bus 4 + + + 0.36 + + + de7329ce-2e0d-7b91-f723-73f186384cc4 + low limit for LV1.101 Bus 12 + + + 0.36 + + + 3f3869d5-2e5d-fb3b-dd3b-474290fe172c + high limit for LV1.101 Bus 9 + + + 0.44 + + + f6abdcaa-4a30-47fe-4dbe-fbc4fa2bd6f9 + high limit for LV1.101 Bus 6 + + + 0.44 + + + bcad8b03-90a4-56b6-ced0-292f34827152 + low limit for LV1.101 Bus 6 + + + 0.36 + + + 08ae570b-df56-ca1d-250b-344724f6f1c2 + high limit for LV1.101 Bus 7 + + + 0.44 + + + ad198ee8-f8ce-4d92-2074-68e7eaa69e25 + high limit for LV1.101 Bus 10 + + + 0.44 + + + 02c415af-6d26-9d80-c404-85ad418d95eb + high limit for LV1.101 Bus 5 + + + 0.44 + + + 3441b8c1-f377-58e1-4939-51f30b26ae2b + low limit for LV1.101 Bus 7 + + + 0.36 + + + b0f017b9-47eb-3c35-cf9a-065c44d2c159 + low limit for LV1.101 Bus 10 + + + 0.36 + + + 32a86950-4ac4-ce63-d220-a4248d81c116 + high limit for LV1.101 Bus 13 + + + 0.44 + + + fea8a23b-ca2a-12bd-073c-e13f1d7995c7 + high limit for LV1.101 Bus 2 + + + 0.44 + + + 3b9e56b1-e760-89d3-21b2-f4dc684253fe + high limit for LV1.101 Bus 11 + + + 0.44 + + + 404c02f9-a36a-76b1-7393-a76d90d57da3 + high limit for MV1.101 Bus 4 + + + 21.1 + + + 47da7e51-2706-524b-8cef-7924b0e108c4 + low limit for LV1.101 Bus 11 + + + 0.36 + + + c0d4d79f-27d0-b115-363b-06bd55049086 + low limit for LV1.101 Bus 5 + + + 0.36 + + + 46558f4d-4cf3-d242-ec16-b97f1a22b48f + low limit for LV1.101 Bus 13 + + + 0.36 + + + d12fffbc-ceaf-76c8-0507-f700a137bfe3 + low limit for MV1.101 Bus 4 + + + 19.3 + + + 5351d066-ab6c-ef1a-b58f-7c89d2088e13 + low limit for LV1.101 Bus 2 + + + 0.36 + + + ed9ee630-843a-8653-b2f1-5f8f9c392997 + high limit for LV1.101 Bus 8 + + + 0.44 + + + 2dea19ad-8882-c3e6-a625-6635d8402f76 + high limit for LV1.101 Bus 3 + + + 0.44 + + + 7ea409c9-6c92-82f2-2f2a-67157f22eec2 + low limit for LV1.101 Bus 3 + + + 0.36 + + + 1dc5884e-7685-b838-9ad8-fff008637b2b + high limit for LV1.101 Bus 4 + + + 0.44 + + + 3e060efc-ac74-b0f1-e9ea-29208cfea6f7 + high limit for LV1.101 Bus 1 + + + 0.44 + + + 20f68d36-7ca7-6380-b610-b2f78ac209e6 + high limit for LV1.101 Bus 14 + + + 0.44 + + + 206e18b9-11ba-206a-a10c-28acbce6177e + low limit for LV1.101 Bus 14 + + + 0.36 + + + 938c7be4-8dbc-0320-e6e9-ff3ccc9c0f52 + low limit for LV1.101 Bus 9 + + + 0.36 + + + d5e0d68e-1061-a40a-ac09-51aec342f1e8 + low limit for LV1.101 Bus 8 + + + 0.36 + + + 88631a07-15f5-8765-93f6-ffa7df51ea83 + Air_Alternative_2 + true + 2 + 2 + + + 1203f311-e8d2-9a4a-dcea-0ddc4b546977 + Soil_Alternative_2 + true + 2 + 2 + + + 111354f7-3fe8-6110-f1ee-8607b8829349 + H0-A + true + 2 + 2 + + + df8f2ff4-1b47-d8a2-d76b-3fd021f85860 + L1-A + true + 2 + 2 + + + 2b8210e5-06f4-2925-138f-a2a0fce5d802 + HLS_A_3.7 + true + 2 + 2 + + + 611e2046-24ea-4908-536d-f343c1a4c74d + Air_Semi-Parallel_2 + true + 2 + 2 + + + 5003fbba-d615-631b-fc48-8153f703d152 + Air_Parallel_2 + true + 2 + 2 + + + 1b575204-1017-51e9-dba0-c4e986add141 + H0-B + true + 2 + 2 + + + 3748155f-434f-df05-ffa5-6f2739d3f35a + H0-C + true + 2 + 2 + + + cb48a791-95dc-761e-6081-7b7dc2dc9200 + HLS_A_11.0 + true + 2 + 2 + + + 0644daf4-d6c7-89d4-b98b-618db6b0ec91 + HLS_B_3.7 + true + 2 + 2 + + + c8e561b5-d381-ac3e-0394-a7bd9d423bd3 + HLS_A_22.0 + true + 2 + 2 + + + ea1d9ba2-257d-59b2-05c3-747996f2f051 + L2-A + true + 2 + 2 + + + 4.6188 + c9dc56f3-2ca5-d9f1-2689-8b56fa2f2805 + patl for MV1.101-LV1.101-Trafo 1 + + + + + 270 + b3bf284e-bd4d-444c-4bea-226d8a309b00 + patl for LV1.101 Line 9 + + + + + 270 + 0ebd9db2-52be-0eca-964e-85c74c23d848 + patl for LV1.101 Line 9 + + + + + 230.94 + 184413b4-2d63-f06b-97f1-a7d16c1f02aa + patl for MV1.101-LV1.101-Trafo 1 + + + + + 270 + 92745f42-5d07-3b8e-ad59-485e76927b25 + patl for LV1.101 Line 11 + + + + + 270 + 159a24ed-dddd-10bc-2a39-0e5962487a57 + patl for LV1.101 Line 10 + + + + + 270 + e9968c82-831b-b3d3-6f2d-f202d14f2052 + patl for LV1.101 Line 7 + + + + + 270 + 2193eb65-4a47-89e0-f8f2-6c8b61a16787 + patl for LV1.101 Line 10 + + + + + 270 + 4d7ecaf3-f674-8091-3986-7876c3ecca49 + patl for LV1.101 Line 7 + + + + + 270 + 98fb05ad-6731-feb0-27c3-9504981b3349 + patl for LV1.101 Line 2 + + + + + 270 + 78adcf90-efbb-4a73-ee15-0c0fa28315fc + patl for LV1.101 Line 2 + + + + + 270 + 339dff78-d393-d3b3-dd47-19aaed3ccb09 + patl for LV1.101 Line 11 + + + + + 270 + a707d25d-b24c-9836-59f4-b64b71013e00 + patl for LV1.101 Line 1 + + + + + 270 + 5a4e8dd1-c53f-4805-598e-731f1288e7bf + patl for LV1.101 Line 3 + + + + + 270 + cfdae26e-4ece-e318-e400-04f0cbe95066 + patl for LV1.101 Line 3 + + + + + 270 + 0ae152f4-c05b-454b-05e2-7113ac58afbd + patl for LV1.101 Line 13 + + + + + 270 + b519906c-ede2-c5eb-2261-201ad126c086 + patl for LV1.101 Line 1 + + + + + 270 + e655ada6-ca56-8c0b-ed27-3014e796acbb + patl for LV1.101 Line 8 + + + + + 270 + d348593b-44f7-5ccb-18d3-81ee00fc40b3 + patl for LV1.101 Line 8 + + + + + 270 + 97967719-e2f1-bc55-cc36-7ef0cec1160b + patl for LV1.101 Line 13 + + + + + 270 + d8f73325-0e0f-933c-e3bf-c8eb4ed09866 + patl for LV1.101 Line 6 + + + + + 270 + 5a156107-28ee-36de-03e1-dfae5d841527 + patl for LV1.101 Line 12 + + + + + 270 + 7d12df3f-b367-a464-bcd1-ab4942fcb21d + patl for LV1.101 Line 4 + + + + + 270 + 38d6fd28-b32f-8285-3989-91856fca3f25 + patl for LV1.101 Line 5 + + + + + 270 + 4a9aa1e1-f0a1-918d-55a9-0987672cae60 + patl for LV1.101 Line 4 + + + + + 270 + aab219d9-d7e8-2135-d4cb-9427ad18e0dd + patl for LV1.101 Line 5 + + + + + 270 + 15af5265-8a5b-a27f-a9bd-f4db7f332e0f + patl for LV1.101 Line 6 + + + + + 270 + ceb2bbe5-9930-0cff-d0bd-2dc872c6f030 + patl for LV1.101 Line 12 + + + + + + + + e2acf849-2b3b-44bc-8010-1211c3e871d3 + LV1.101 Load 8 + + + + + + e801ea3b-5d0f-4eb6-941d-71b14279b92b + LV1.101 Load 1 + + + + + + 42d4acfc-1e79-4e4f-9973-e096772a15d2 + LV1.101 Load 27 + + + + + + b47d3b85-6f7f-4019-8004-8c381708d248 + LV1.101 Load 15 + + + + + + 0770d814-c98f-4eb1-a378-ab5f4ed4fa1d + LV1.101 Load 7 + + + + + + 180c7e1e-8af1-439b-8efd-7cb62bfba145 + LV1.101 Load 23 + + + + + + 5a04c2ba-503f-441b-aac3-5522810bc963 + LV1.101 Load 16 + + + + + + c4be856a-75cb-437e-b04c-0aba06ed102c + LV1.101 Load 5 + + + + + + fbfed02b-0034-4932-b7f6-4093dd3f8154 + LV1.101 Load 13 + + + + + + 1847794b-1c05-4a3e-89d6-91e0e00d2279 + LV1.101 Load 22 + + + + + + 2b144c40-87f1-439e-ac28-5b3f29872296 + LV1.101 Load 25 + + + + + + 3d573a89-87c9-4f5c-872a-cf5c54c13991 + LV1.101 Load 20 + + + + + + 231c3936-7b75-4ff7-a13d-173d36ea9f48 + LV1.101 Load 24 + + + + + + 875c7d69-1238-4a9b-b582-61e2691b0064 + LV1.101 Load 3 + + + + + + 593806ad-d1fc-47ab-bf7d-8ad2fdaf2da3 + LV1.101 Load 10 + + + + + + 60aedba3-2dab-4eb4-abc7-9394778543a8 + LV1.101 Load 21 + + + + + + c135a594-d644-4d5d-ab88-266be0a47e64 + LV1.101 Load 2 + + + + + + 24dcc7d6-7c93-4e59-bfe7-574a246f9921 + LV1.101 Load 14 + + + + + + 086013f1-c9c6-4fff-8dfc-a27505a3501f + LV1.101 Load 19 + + + + + + 474be48f-7a88-44df-b096-51ac58bf3989 + LV1.101 Load 4 + + + + + + 268cce5e-55a2-40b5-94bc-ec92d9e2c184 + LV1.101 Load 6 + + + + + + 2f0c4dd7-30c1-4b9b-9c5b-c0916d5491fe + LV1.101 Load 26 + + + + + + 805d3be0-a8a9-4571-86ef-bd4e0cbe1ea7 + LV1.101 Load 11 + + + + + + 977f4214-3a9f-4b48-8b0a-b91c51dbffbd + LV1.101 Load 12 + + + + + + b66a0a6e-b1ff-4d71-b2e0-eccf6abf0b92 + LV1.101 Load 17 + + + + + + 7c49b2c2-0d39-4843-8823-14ca241a2d35 + LV1.101 Load 18 + + + + + + 12537c26-0b07-42e2-9260-c778625fd726 + LV1.101 Load 28 + + + + + + 35cfb96f-402f-414a-a674-fe2f69670e60 + LV1.101 Load 9 + + + + Storage_PV8_L2-A + c59d5176-aaec-4b42-b261-19a297495de7 + LV1.101 Storage 5 + + 0.050232 + -0.050232 + 0.0502 + 0.4 + + + + PV6 + 2e4b51aa-b3fa-4422-b68c-a3edb53c1d47 + LV1.101 SGen 7 + + 0 + 0 + 0.0245 + 0.4 + + + + PV5 + 7669242b-6236-41d0-ae71-7068bd9ae545 + LV1.101 SGen 3 + + 0 + 0 + 0.023 + 0.4 + + + + PV8 + 08701210-0615-48a9-a3bf-94120851dc67 + LV1.101 SGen 5 + + 0 + 0 + 0.0489 + 0.4 + + + + PV5 + f182b438-d382-40ba-b119-b7914724cb2d + LV1.101 SGen 1 + + 0 + 0 + 0.04 + 0.4 + + + + Storage_PV5_L2-A + 0cf72316-b123-4919-9b1a-175ab8a6d231 + LV1.101 Storage 2 + + 0.033488 + -0.033488 + 0.0335 + 0.4 + + + + PV8 + 6dd2153f-0d2e-4979-ba7c-6910eba8adea + LV1.101 SGen 6 + + 0 + 0 + 0.1172 + 0.4 + + + + PV6 + 22aa007b-d2c8-4d1a-9a2c-538d93ff73f5 + LV1.101 SGen 4 + + 0 + 0 + 0.019 + 0.4 + + + + PV6 + 75034969-222c-4bcc-b32f-87797e33af70 + LV1.101 SGen 8 + + 0 + 0 + 0.1172 + 0.4 + + + + PV8 + fa42b334-8dd5-409e-b86b-b9c1ee5366ed + LV1.101 SGen 2 + + 0 + 0 + 0.0784 + 0.4 + + + + Storage_PV8_L1-A + b36276eb-a9f7-4e00-9460-b41c6c93356a + LV1.101 Storage 4 + + 0.018338 + -0.018338 + 0.0183 + 0.4 + + + + Storage_PV5_L1-A + e620e7f4-13d3-4748-af49-773c63a5ceea + LV1.101 Storage 3 + + 0.030563 + -0.030563 + 0.0306 + 0.4 + + + + Storage_PV8_L1-A + 90a7bc31-8f77-4e2f-be01-fdda8a81aa4d + LV1.101 Storage 1 + + 0.073352 + -0.073352 + 0.0734 + 0.4 + + + 6.45781e-6 + 0 + 0.00511915 + 0.00199181 + + 0.0247661 + f8927e72-54f7-4b53-9e60-64754ade6abc + LV1.101 Line 6 + + + 3.57791e-5 + 0 + 0.0283623 + 0.0110355 + + 0.137215 + 70ab901e-5d8a-4c8e-a5fb-957a8578789a + LV1.101 Line 9 + + + 3.45494e-5 + 0 + 0.0273875 + 0.0106562 + + 0.132499 + 14274c4c-039e-4f58-8bac-31a5ed528566 + LV1.101 Line 10 + + + 1.45413e-5 + 0 + 0.011527 + 0.00448503 + + 0.0557667 + 92286623-b4fe-48c0-a036-326b5681d11a + LV1.101 Line 1 + + + 4.66384e-6 + 0 + 0.00369706 + 0.00143849 + + 0.0178861 + bff367a0-e660-4964-ab6d-8c7c945ae362 + LV1.101 Line 4 + + + 6.7341e-7 + 0 + 0.000533817 + 0.000207703 + + 0.00258257 + 53ca41a9-2478-4c57-9eb4-c739cd862350 + LV1.101 Line 11 + + + 1.34056e-6 + 0 + 0.00106267 + 0.000413474 + + 0.00514112 + 66239d79-5d3f-471a-951a-904940919237 + LV1.101 Line 7 + + + 1.39701e-5 + 0 + 0.0110742 + 0.00430886 + + 0.0535763 + 19c9660d-c2e0-4d2e-83e2-bfa485f04759 + LV1.101 Line 2 + + + 4.22606e-6 + 0 + 0.00335003 + 0.00130346 + + 0.0162072 + f67b07cc-ddb1-4ba2-bebf-735e9ee84e6f + LV1.101 Line 12 + + + 4.19529e-6 + 0 + 0.00332564 + 0.00129397 + + 0.0160892 + f7ed9c27-2d37-47c2-ad43-bfd95fbde0d6 + LV1.101 Line 5 + + + 5.59822e-7 + 0 + 0.000443775 + 0.000172668 + + 0.00214695 + fb3b7ba0-661c-494a-b8d5-f879ba2c8f91 + LV1.101 Line 8 + + + 1.19986e-5 + 0 + 0.00951136 + 0.00370077 + + 0.0460153 + 8aa76e57-41c0-4823-b80b-c602bdf9276a + LV1.101 Line 13 + + + 1.29892e-5 + 0 + 0.0102967 + 0.00400632 + + 0.0498145 + 7fcc388d-be1c-4e02-af11-63bf7cbd1317 + LV1.101 Line 3 + + + fc8a4012-0310-2869-17a9-a90dd3ec4389 + LV1.101 Load 7 + + + 45495227-e0ec-2752-d552-520a0752c845 + highVoltage + + true + + + + 9d7181c3-8b02-ed53-e2c9-f94e83aa813d + lowVoltage + + true + + + + 47b6609e-6485-5ae2-2a59-eefb1e2ad462 + patl + + true + + + + 9f2c1238-cd31-e2d1-aac9-fd86ab19844d + LV1.101 Load 7 + + + + + 0 + 100000 + 9999 + 0 + -9999 + 2539e00a-e4a6-4c49-8522-10d688e6aafb + MV1.101 grid at LV1.101 + + + + 153e21e1-70e7-52b8-4b0e-29334f376b71 + MV1.101-LV1.101-Trafo 1 + + -9.58077e-9 + + 1.15e-6 + 36.7188 + 0.16 + 20 + 93.0147 + + + 1 + + + 02db410e-2023-422f-b33b-d2053027feb6 + MV1.101-LV1.101-Trafo 1 + + 0 + + 0 + 0 + 0.16 + 0.4 + 0 + + + 2 + + + 6f914c87-3b9b-c780-7f6a-804e1ae269de + LV1.101 Bus 1 + + + + + 7de027f8-cba1-c2ab-5eed-bcfbf1cd7d53 + LV1.101 Bus 14 + + + + + 0727d3e0-35e1-835d-cfef-5ebdae383997 + LV1.101 Bus 10 + + + + + b7ef6fd7-97c6-dff7-637c-6c3f0efdfdaa + LV1.101 Bus 3 + + + + + 7bd84100-ce74-04bb-056c-d27e506411ae + LV1.101 Bus 8 + + + + + 5731d1ec-39b4-a147-1595-46007bf5d920 + LV1.101 Bus 6 + + + + + aed845bc-cb0f-6e64-be3e-be943a45ea8b + LV1.101 Bus 12 + + + + + ee9170b7-8667-b59f-78ed-ecabc5e8f8fc + LV1.101 Bus 5 + + + + + 4ab89a89-4d6e-a5d7-b996-7dda37b83751 + LV1.101 Bus 9 + + + + + 54ed6638-0f70-7d3e-a7fa-757bad861217 + MV1.101 Bus 4 + + + + + 610d536b-c18d-1c16-2207-7054d2bca172 + LV1.101 Bus 2 + + + + + ec3cf56c-e6ca-f10d-04ec-99c4985278fe + LV1.101 Bus 4 + + + + + 8015930e-9cb0-b77e-eee1-9d23810418c7 + LV1.101 Bus 13 + + + + + 72230379-c41c-dc03-f057-7ea2282da073 + LV1.101 Bus 11 + + + + + ed2f6c57-1c0b-eb3c-1e66-31b18d163c8f + LV1.101 Bus 7 + + + + + 036b5bae-3f4a-e452-7c8c-44397299b4d9 + MV1.101-LV1.101-Trafo 1 + + 2.5 + 2 + -2 + false + 0 + 20 + 1 + + + 0.4 + BaseVoltage 0.40 kV + 3bb9f877-99de-e910-f7a7-04c49f08e88e + 0.40 kV + 0.40 kV + + + 20 + BaseVoltage 20.00 kV + d61ecdd0-8e67-2117-ebd9-76ca624396fc + 20.00 kV + 20.00 kV + + + 0 + + 634cc5dc-e7d6-7a65-13be-afe892436589 + LV1.101 Storage 2 + 0 + -0.033488 + + + 0 + + f08d67d3-b0a8-802f-7496-3e7601436089 + LV1.101 Storage 5 + 0 + -0.050232 + + + 0 + + 5a975eab-f292-bf45-a804-fefd2b2ccb5a + LV1.101 Storage 3 + 0 + -0.030563 + + + 0 + + b8020ace-b9d4-5c99-22d6-30da56f386df + LV1.101 Storage 1 + 0 + -0.073352 + + + 0 + + 1a633230-f244-937e-431f-88b284adab40 + LV1.101 Storage 4 + 0 + -0.018338 + + + + bd3b6b8e-46dc-b04f-cd1b-189ee62828a4 + LV1.101 SGen 4 + 0.019 + 0 + + + + 1611b0aa-0980-200b-6fef-f0bf55e2eae7 + LV1.101 SGen 2 + 0.0784 + 0 + + + + c125b5d1-7599-cdb8-3df9-4cafb0784b8c + LV1.101 SGen 8 + 0.1172 + 0 + + + + 5fc6b897-92bb-a2b7-413d-f5e98f26eab0 + LV1.101 SGen 1 + 0.04 + 0 + + + + a30cad0d-67b9-c835-5587-45d354843d85 + LV1.101 SGen 3 + 0.023 + 0 + + + + 59a120a0-f002-91a3-3ebe-f60489c5d04e + LV1.101 SGen 7 + 0.0245 + 0 + + + + 83c8891b-debe-2e54-637e-54a38fad9715 + LV1.101 SGen 6 + 0.1172 + 0 + + + + 8172af27-3b10-0378-7403-b13c635eac93 + LV1.101 SGen 5 + 0.0489 + 0 + + + 8919f6ba-9261-cbbd-2db7-a6e1980aecc7 + MV1.101 grid at LV1.101 + + + + + + 28c4a136-6bb9-4df0-8ac1-8ead38a3f668 + MV1.101-LV1.101-Trafo 1 + + + 16339f15-3388-e3b6-d88d-14997f4270be + LV1.101 Load 7 + + + + da7e23be-ded2-7ae3-bef6-626d6eae63bb + 1-LV-rural1--2-no_sw + + + f3f9331a-2600-943d-3edb-df338c7aab30 + 1-LV-rural1--2-no_sw + + + + b69ccccb-ea19-3e88-c6ea-5f910d6e6bfd + 1-LV-rural1--2-no_sw + + + \ No newline at end of file diff --git a/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/README.md b/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/README.md new file mode 100644 index 00000000..6cdc6c31 --- /dev/null +++ b/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/README.md @@ -0,0 +1,5 @@ +# Information on Data + +- CIM data, CGMES Version 3 +- created with PowerFactory +- provided by Thomas Schwierz from TU Dortmund diff --git a/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/__init__.py b/cimpy/examples/sampledata/CIM_LV_Simbench_Grid/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/tests/CIM_v3_import_reference.p1 b/tests/CIM_v3_import_reference.p1 new file mode 100644 index 00000000..3f3ff009 Binary files /dev/null and b/tests/CIM_v3_import_reference.p1 differ diff --git a/tests/create_pickle_dump_v3.py b/tests/create_pickle_dump_v3.py new file mode 100644 index 00000000..b7780ed0 --- /dev/null +++ b/tests/create_pickle_dump_v3.py @@ -0,0 +1,34 @@ + +import pickle +import sys, os +from pathlib import Path + +sys.path.append(os.getcwd()) + +import cimpy + + +example_path = Path(os.path.join(os.path.dirname(__file__), + '../cimpy/examples/sampledata/CIM_LV_Simbench_Grid')).resolve() + + +print(example_path) +for file in example_path.glob('*.xml'): + print("file: ", file) + + +def create_pickle(): + + test_files = [] + + for file in example_path.glob('*.xml'): + print("file: ", file) + test_files.append(str(file.absolute())) + + imported_result = cimpy.cim_import(test_files, 'cgmes_v3_0_0') + + CGMES_object = cimpy.cimexport._get_class_attributes_with_references(imported_result, 'cgmes_v3_0_0') + + pickle.dump( CGMES_object, open( 'CIM_v3_import_reference.p1', "wb" ) ) + +create_pickle() diff --git a/tests/test_export_v3.py b/tests/test_export_v3.py new file mode 100644 index 00000000..816f2f78 --- /dev/null +++ b/tests/test_export_v3.py @@ -0,0 +1,217 @@ +import logging +import xmltodict +import os, sys +import glob +import pytest_check as check +from pathlib import Path +import pytest + +sys.path.append(os.getcwd()) +import cimpy +from cimpy.cgmes_v3_0_0.Base import short_profile_name + +logging.basicConfig(filename='Test_export_with_exported_files.log', + level=logging.INFO, filemode='w') + + +@pytest.fixture +def sample_cimdata(): + """ Import the sampledata using cimpy + """ + example_dir = Path(os.path.join(os.path.dirname( + __file__), '../cimpy/examples/sampledata/CIM_LV_Simbench_Grid')).resolve() + import_files = [] + for file in example_dir.glob('*.xml'): + import_files.append(str(file.absolute())) + return cimpy.cim_import(import_files, 'cgmes_v3_0_0') + + +def read_ref_xml(): + """ Read the reference xmls into a dict + """ + test_list = [] + + test_dir = Path(os.path.dirname(__file__)).resolve() + + for file in test_dir.glob('CIM_v3_reference*.xml'): + xmlstring = open(file, encoding='utf8').read() + parsed_export_file = xmltodict.parse( + xmlstring, attr_prefix="$", cdata_key="_", dict_constructor=dict) + test_list.append(parsed_export_file['rdf:RDF']) + + test_dict = {} + for elem in test_list: + profile = elem['md:FullModel']['md:Model.profile'] + for key in short_profile_name.keys(): + if key in profile: + test_dict[key] = elem + return test_dict + + +def read_exported_xml(directory): + export_list = [] + + test_dir = Path(directory).resolve() + + for file in test_dir.glob('*EXPORTED*.xml'): + xmlstring = open(file, encoding='utf8').read() + parsed_export_file = xmltodict.parse( + xmlstring, attr_prefix="$", cdata_key="_", dict_constructor=dict) + export_list.append(parsed_export_file['rdf:RDF']) + + export_dict = {} + for export_file in export_list: + profile = export_file['md:FullModel']['md:Model.profile'] + for key in short_profile_name.keys(): + if key in profile: + export_dict[key] = export_file + return export_dict + +# This test tests the export functionality of this package by first importing the CIGRE_MV_Rudion_With_LoadFlow_Results +# example and exporting them. The exported files are compared with previously exported files which were checked manually + + +def test_export_with_exported_files(sample_cimdata, tmpdir): + # activeProfileList = ['DL', 'EQ', 'SV', 'TP'] - DL is not working for some reason + activeProfileList = ['EQ', 'SV', 'TP'] + + cimpy.cim_export(sample_cimdata, tmpdir + '/EXPORTED_Test', + 'cgmes_v3_0_0', activeProfileList) + + test_dict = read_ref_xml() + export_dict = read_exported_xml(tmpdir) + + for profile, current_test_dict in test_dict.items(): + check.is_in(profile, export_dict.keys()) + if profile in export_dict.keys(): + current_export_dict = export_dict[profile] + for class_key in current_test_dict: + if 'cim:' not in class_key: + continue + check.is_in(class_key, current_export_dict.keys()) + if class_key in current_export_dict.keys(): + current_export_class = current_export_dict[class_key] + current_test_class = current_test_dict[class_key] + if isinstance(current_test_class, list): + for item in current_test_class: + check.is_in(item, current_export_class) + else: + check.equal(current_test_class, current_export_class) + + +def test_export_with_imported_files(sample_cimdata, tmpdir): + #activeProfileList = ['DL', 'EQ', 'SSH', 'SV', 'TP'] - DL is not working for some reason + activeProfileList = ['EQ', 'SSH', 'SV', 'TP'] + + cimpy.cim_export(sample_cimdata, tmpdir + '/EXPORTED_Test', + 'cgmes_v3_0_0', activeProfileList) + + test_dict = read_ref_xml() + export_dict = read_exported_xml(tmpdir) + + for profile, current_test_dict in test_dict.items(): + check.is_in(profile, export_dict.keys()) + if profile in export_dict.keys(): + current_export_dict = export_dict[profile] + for class_key in current_test_dict: + if 'cim:' not in class_key or class_key in ['cim:NameType', 'cim:Name']: + continue + check.is_in(class_key, current_export_dict.keys()) + if class_key in current_export_dict.keys(): + current_export_class = current_export_dict[class_key] + current_test_class = current_test_dict[class_key] + test_mRIDs = [] + test_class_dict = {} + if isinstance(current_test_class, list): + for obj in current_test_class: + try: + test_mRIDs.append(obj['$rdf:ID']) + test_class_dict[obj['$rdf:ID']] = obj + except KeyError: + try: + test_mRIDs.append(obj['$rdf:about']) + test_class_dict[obj['$rdf:about']] = obj + except KeyError: + check.is_in('$rdf:about', obj.keys()) + check.is_in('$rdf:ID', obj.keys()) + else: + try: + test_mRIDs.append(current_test_class['$rdf:ID']) + test_class_dict[current_test_class['$rdf:ID'] + ] = current_test_class + except KeyError: + try: + test_mRIDs.append( + current_test_class['$rdf:about']) + test_class_dict[current_test_class['$rdf:about']] = obj + except KeyError: + check.is_in( + '$rdf:about', current_test_class.keys()) + check.is_in( + '$rdf:ID', current_test_class.keys()) + + export_mRIDs = [] + export_class_dict = {} + if isinstance(current_export_class, list): + for obj in current_export_class: + try: + export_mRIDs.append(obj['$rdf:ID']) + export_class_dict[obj['$rdf:ID']] = obj + except KeyError: + try: + export_mRIDs.append(obj['$rdf:about']) + export_class_dict[obj['$rdf:about']] = obj + except KeyError: + check.is_in('$rdf:about', obj.keys()) + check.is_in('$rdf:ID', obj.keys()) + else: + try: + export_mRIDs.append( + current_export_class['$rdf:ID']) + export_class_dict[current_export_class['$rdf:ID'] + ] = current_export_class + except KeyError: + try: + export_mRIDs.append( + current_export_class['$rdf:about']) + export_class_dict[current_export_class['$rdf:about']] = obj + except KeyError: + check.is_in( + '$rdf:about', current_export_class.keys()) + check.is_in( + '$rdf:ID', current_export_class.keys()) + + for mRID in test_mRIDs: + check.is_in(mRID, export_mRIDs) + if mRID in export_mRIDs: + test_attr = test_class_dict[mRID].items() + export_attr = export_class_dict[mRID].items() + for item in test_attr: + if item[0] in ['cim:NameType', 'cim:ExternalNetworkInjection.referencePriority', + 'cim:Terminal.connected']: + continue + elif item[0] == 'cim:Terminal.sequenceNumber': + test_item = 'cim:ACDCTerminal.sequenceNumber' + else: + test_item = item[0] + + if item[1] in ['0', '0e+000', '0.0', '', 'false', 'None', 'list', + {'$rdf:resource': '#_32d6d32e-c3f0-43d4-8103-079a15594fc6'}]: + continue + if isinstance(item[1], dict) or isinstance(item[1], list): + test_item = item + elif len(item[1].split('.')) > 1: + try: + test_item = ( + item[0], str(float(item[1]))) + except ValueError: + continue + except TypeError: + pass + elif item[1] == 'true': + test_item = (test_item, 'True') + else: + test_item = (test_item, item[1]) + + check.is_in(test_item, export_attr) + diff --git a/tests/test_import.py b/tests/test_import.py index 69dff221..a1849ab3 100644 --- a/tests/test_import.py +++ b/tests/test_import.py @@ -33,4 +33,4 @@ def test_import(): check_dict_pickle = pickle.load(open(ref_dict_path, 'rb')) for elem in import_resolved: - check.is_in(elem, check_dict_pickle) + check.is_in(elem, check_dict_pickle) \ No newline at end of file diff --git a/tests/test_import_v3.py b/tests/test_import_v3.py new file mode 100644 index 00000000..ef299966 --- /dev/null +++ b/tests/test_import_v3.py @@ -0,0 +1,38 @@ +import logging +import os, sys +import glob +import pytest_check as check +import pickle +from pathlib import Path + +sys.path.append(os.getcwd()) +import cimpy +from cimpy.cgmes_v3_0_0.Base import short_profile_name + +logging.basicConfig(filename='Test_import.log', + level=logging.INFO, filemode='w') + +example_dir = Path(os.path.join(os.path.dirname(__file__), + '../cimpy/examples/sampledata/CIM_LV_Simbench_Grid')).resolve() + + +def test_import(): + """ This function tests the import functionality by importing files and comparing them to previously imported and pickled files. + """ + + global example_dir + test_files = [] + for file in example_dir.glob('*.xml'): + test_files.append(str(file.absolute())) + + imported_result = cimpy.cim_import(test_files, 'cgmes_v3_0_0') + + import_resolved = cimpy.cimexport._get_class_attributes_with_references( + imported_result, 'cgmes_v3_0_0') + + ref_dict_path = Path(os.path.join(os.path.dirname( + __file__), 'CIM_v3_import_reference.p1')) + check_dict_pickle = pickle.load(open(ref_dict_path, 'rb')) + + for elem in import_resolved: + check.is_in(elem, check_dict_pickle)