CIM14/IEC61970/Wires/WindingTest.py

   1 # Copyright (C) 2010 Richard Lincoln
   2 #
   3 # This library is free software; you can redistribute it and/or
   4 # modify it under the terms of the GNU Lesser General Public
   5 # License as published by the Free Software Foundation; either
   6 # version 2.1 of the License, or (at your option) any later version.
   7 #
   8 # This library is distributed in the hope that it will be useful,
   9 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  10 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  11 # Lesser General Public License for more details.
  12 #
  13 # You should have received a copy of the GNU Lesser General Public
  14 # License along with this library; if not, write to the Free Software
  15 # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA, USA
  16
  17 from CIM14.IEC61970.Core.IdentifiedObject import IdentifiedObject
  18
  19 class WindingTest(IdentifiedObject):
  20     """Physical winding test data for the winding/tap pairs of a transformer (or phase shifter). This test data can be used to derive other attributes of specific transformer or phase shifter models.
  21     """
  22
  23     def __init__(self, fromTapStep=0, leakageImpedance=0.0, noLoadLoss=0.0, phaseShift=0.0, excitingCurrent=0.0, loadLoss=0.0, toTapStep=0, voltage=0.0, From_TransformerWinding=None, To_TransformerWinding=None, *args, **kw_args):
  24         """Initialises a new 'WindingTest' instance.
  25
  26         @param fromTapStep: The tap step number for the 'from' winding of the test pair.
  27         @param leakageImpedance: The leakage impedance measured at the 'from' winding  with the 'to' winding short-circuited and all other windings open-circuited.  Leakage impedance is expressed in units based on the apparent power and voltage ratings of the 'from' winding.
  28         @param noLoadLoss: The no load loss kW 'to' winding open-circuited) from the test report.
  29         @param phaseShift: The phase shift measured at the open-circuited 'to' winding, with the 'from' winding set to the 'from' winding's rated voltage and all other windings open-circuited.
  30         @param excitingCurrent: The exciting current on open-circuit test, expressed as a percentage of rated current, at nominal voltage
  31         @param loadLoss: The load loss kW ('to' winding short-circuited) from the test report.
  32         @param toTapStep: The tap step number for the 'to' winding of the test pair.
  33         @param voltage: The voltage measured at the open-circuited 'to' winding, with the 'from' winding set to the 'from' winding's rated voltage and all other windings open-circuited.
  34         @param From_TransformerWinding: The winding from which the test was conducted
  35         @param To_TransformerWinding: The winding to which the test was conducted.  Note that although the 'from' side of the test is required, the 'to' side of a test is not always required.
  36         """
  37         #: The tap step number for the 'from' winding of the test pair.
  38         self.fromTapStep = fromTapStep
  39
  40         #: The leakage impedance measured at the 'from' winding  with the 'to' winding short-circuited and all other windings open-circuited.  Leakage impedance is expressed in units based on the apparent power and voltage ratings of the 'from' winding.
  41         self.leakageImpedance = leakageImpedance
  42
  43         #: The no load loss kW 'to' winding open-circuited) from the test report.
  44         self.noLoadLoss = noLoadLoss
  45
  46         #: The phase shift measured at the open-circuited 'to' winding, with the 'from' winding set to the 'from' winding's rated voltage and all other windings open-circuited.
  47         self.phaseShift = phaseShift
  48
  49         #: The exciting current on open-circuit test, expressed as a percentage of rated current, at nominal voltage
  50         self.excitingCurrent = excitingCurrent
  51
  52         #: The load loss kW ('to' winding short-circuited) from the test report.
  53         self.loadLoss = loadLoss
  54
  55         #: The tap step number for the 'to' winding of the test pair.
  56         self.toTapStep = toTapStep
  57
  58         #: The voltage measured at the open-circuited 'to' winding, with the 'from' winding set to the 'from' winding's rated voltage and all other windings open-circuited.
  59         self.voltage = voltage
  60
  61         self._From_TransformerWinding = None
  62         self.From_TransformerWinding = From_TransformerWinding
  63
  64         self._To_TransformerWinding = None
  65         self.To_TransformerWinding = To_TransformerWinding
  66
  67         super(WindingTest, self).__init__(*args, **kw_args)
  68
  69     _attrs = ["fromTapStep", "leakageImpedance", "noLoadLoss", "phaseShift", "excitingCurrent", "loadLoss", "toTapStep", "voltage"]
  70     _attr_types = {"fromTapStep": int, "leakageImpedance": float, "noLoadLoss": float, "phaseShift": float, "excitingCurrent": float, "loadLoss": float, "toTapStep": int, "voltage": float}
  71     _defaults = {"fromTapStep": 0, "leakageImpedance": 0.0, "noLoadLoss": 0.0, "phaseShift": 0.0, "excitingCurrent": 0.0, "loadLoss": 0.0, "toTapStep": 0, "voltage": 0.0}
  72     _enums = {}
  73     _refs = ["From_TransformerWinding", "To_TransformerWinding"]
  74     _many_refs = []
  75
  76     def getFrom_TransformerWinding(self):
  77         """The winding from which the test was conducted
  78         """
  79         return self._From_TransformerWinding
  80
  81     def setFrom_TransformerWinding(self, value):
  82         if self._From_TransformerWinding is not None:
  83             filtered = [x for x in self.From_TransformerWinding.From_WindingTest if x != self]
  84             self._From_TransformerWinding._From_WindingTest = filtered
  85
  86         self._From_TransformerWinding = value
  87         if self._From_TransformerWinding is not None:
  88             self._From_TransformerWinding._From_WindingTest.append(self)
  89
  90     From_TransformerWinding = property(getFrom_TransformerWinding, setFrom_TransformerWinding)
  91
  92     def getTo_TransformerWinding(self):
  93         """The winding to which the test was conducted.  Note that although the 'from' side of the test is required, the 'to' side of a test is not always required.
  94         """
  95         return self._To_TransformerWinding
  96
  97     def setTo_TransformerWinding(self, value):
  98         if self._To_TransformerWinding is not None:
  99             filtered = [x for x in self.To_TransformerWinding.To_WindingTest if x != self]
 100             self._To_TransformerWinding._To_WindingTest = filtered
 101
 102         self._To_TransformerWinding = value
 103         if self._To_TransformerWinding is not None:
 104             self._To_TransformerWinding._To_WindingTest.append(self)
 105
 106     To_TransformerWinding = property(getTo_TransformerWinding, setTo_TransformerWinding)
 107