text: # Copyright (C) 2010-2011 Richard Lincoln
  #
  # Permission is hereby granted, free of charge, to any person obtaining a copy
  # of this software and associated documentation files (the "Software"), to
  # deal in the Software without restriction, including without limitation the
  # rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
  # sell copies of the Software, and to permit persons to whom the Software is
  # furnished to do so, subject to the following conditions:
  #
  # The above copyright notice and this permission notice shall be included in
  # all copies or substantial portions of the Software.
  #
  # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  # FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
  # IN THE SOFTWARE.
  
  from CIM14.IEC61970.Core.IdentifiedObject import IdentifiedObject
  
  class WindingTest(IdentifiedObject):
      """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.
      """
  
      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):
          """Initialises a new 'WindingTest' instance.
  
          @param fromTapStep: The tap step number for the 'from' winding of the test pair. 
          @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. 
          @param noLoadLoss: The no load loss kW 'to' winding open-circuited) from the test report. 
          @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. 
          @param excitingCurrent: The exciting current on open-circuit test, expressed as a percentage of rated current, at nominal voltage 
          @param loadLoss: The load loss kW ('to' winding short-circuited) from the test report. 
          @param toTapStep: The tap step number for the 'to' winding of the test pair. 
          @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. 
          @param From_TransformerWinding: The winding from which the test was conducted
          @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.
          """
          #: The tap step number for the 'from' winding of the test pair.
          self.fromTapStep = fromTapStep
  
          #: 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.
          self.leakageImpedance = leakageImpedance
  
          #: The no load loss kW 'to' winding open-circuited) from the test report.
          self.noLoadLoss = noLoadLoss
  
          #: 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.
          self.phaseShift = phaseShift
  
          #: The exciting current on open-circuit test, expressed as a percentage of rated current, at nominal voltage
          self.excitingCurrent = excitingCurrent
  
          #: The load loss kW ('to' winding short-circuited) from the test report.
          self.loadLoss = loadLoss
  
          #: The tap step number for the 'to' winding of the test pair.
          self.toTapStep = toTapStep
  
          #: 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.
          self.voltage = voltage
  
          self._From_TransformerWinding = None
          self.From_TransformerWinding = From_TransformerWinding
  
          self._To_TransformerWinding = None
          self.To_TransformerWinding = To_TransformerWinding
  
          super(WindingTest, self).__init__(*args, **kw_args)
  
      _attrs = ["fromTapStep", "leakageImpedance", "noLoadLoss", "phaseShift", "excitingCurrent", "loadLoss", "toTapStep", "voltage"]
      _attr_types = {"fromTapStep": int, "leakageImpedance": float, "noLoadLoss": float, "phaseShift": float, "excitingCurrent": float, "loadLoss": float, "toTapStep": int, "voltage": float}
      _defaults = {"fromTapStep": 0, "leakageImpedance": 0.0, "noLoadLoss": 0.0, "phaseShift": 0.0, "excitingCurrent": 0.0, "loadLoss": 0.0, "toTapStep": 0, "voltage": 0.0}
      _enums = {}
      _refs = ["From_TransformerWinding", "To_TransformerWinding"]
      _many_refs = []
  
      def getFrom_TransformerWinding(self):
          """The winding from which the test was conducted
          """
          return self._From_TransformerWinding
  
      def setFrom_TransformerWinding(self, value):
          if self._From_TransformerWinding is not None:
              filtered = [x for x in self.From_TransformerWinding.From_WindingTest if x != self]
              self._From_TransformerWinding._From_WindingTest = filtered
  
          self._From_TransformerWinding = value
          if self._From_TransformerWinding is not None:
              if self not in self._From_TransformerWinding._From_WindingTest:
                  self._From_TransformerWinding._From_WindingTest.append(self)
  
      From_TransformerWinding = property(getFrom_TransformerWinding, setFrom_TransformerWinding)
  
      def getTo_TransformerWinding(self):
          """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.
          """
          return self._To_TransformerWinding
  
      def setTo_TransformerWinding(self, value):
          if self._To_TransformerWinding is not None:
              filtered = [x for x in self.To_TransformerWinding.To_WindingTest if x != self]
              self._To_TransformerWinding._To_WindingTest = filtered
  
          self._To_TransformerWinding = value
          if self._To_TransformerWinding is not None:
              if self not in self._To_TransformerWinding._To_WindingTest:
                  self._To_TransformerWinding._To_WindingTest.append(self)
  
      To_TransformerWinding = property(getTo_TransformerWinding, setTo_TransformerWinding)
  
  