schemata/CIM14/IEC61970/Meas/Measurement.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 Measurement(IdentifiedObject):
  20     """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 leafs, 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 (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.  Two possible paths exist: 1) Measurement-Terminal- ConnectivityNode-Terminal-ConductingEquipment 2) Measurement-Terminal-ConductingEquipment Alternative 2 is the only allowed use.  When the sensor location is needed both Measurement-PSR and Measurement-Terminal are used. The Measurement-Terminal association is never used alone.
  21     """
  22
  23     def __init__(self, measurementType='', PowerSystemResource=None, Locations=None, Terminal=None, Unit=None, tieToMeasurement0=None, Asset=None, Documents=None, *args, **kw_args):
  24         """Initialises a new 'Measurement' instance.
  25
  26         @param measurementType: Specifies the type of Measurement, e.g. IndoorTemperature, OutDoorTemperature, BusVoltage, GeneratorVoltage, LineFlow etc.
  27         @param PowerSystemResource: The PowerSystemResource that contains the Measurement in the naming hierarchy
  28         @param Locations:
  29         @param Terminal: One or more measurements may be associated with a terminal in the network
  30         @param Unit: The Unit for the Measurement
  31         @param tieToMeasurement0:
  32         @param Asset:
  33         @param Documents: Measurements are specified in types of documents, such as procedures.
  34         """
  35         #: Specifies the type of Measurement, e.g. IndoorTemperature, OutDoorTemperature, BusVoltage, GeneratorVoltage, LineFlow etc.
  36         self.measurementType = measurementType
  37
  38         self._PowerSystemResource = None
  39         self.PowerSystemResource = PowerSystemResource
  40
  41         self._Locations = []
  42         self.Locations = [] if Locations is None else Locations
  43
  44         self._Terminal = None
  45         self.Terminal = Terminal
  46
  47         self._Unit = None
  48         self.Unit = Unit
  49
  50         self._tieToMeasurement0 = []
  51         self.tieToMeasurement0 = [] if tieToMeasurement0 is None else tieToMeasurement0
  52
  53         self._Asset = None
  54         self.Asset = Asset
  55
  56         self._Documents = []
  57         self.Documents = [] if Documents is None else Documents
  58
  59         super(Measurement, self).__init__(*args, **kw_args)
  60
  61     _attrs = ["measurementType"]
  62     _attr_types = {"measurementType": str}
  63     _defaults = {"measurementType": ''}
  64     _enums = {}
  65     _refs = ["PowerSystemResource", "Locations", "Terminal", "Unit", "tieToMeasurement0", "Asset", "Documents"]
  66     _many_refs = ["Locations", "tieToMeasurement0", "Documents"]
  67
  68     def getPowerSystemResource(self):
  69         """The PowerSystemResource that contains the Measurement in the naming hierarchy
  70         """
  71         return self._PowerSystemResource
  72
  73     def setPowerSystemResource(self, value):
  74         if self._PowerSystemResource is not None:
  75             filtered = [x for x in self.PowerSystemResource.Measurements if x != self]
  76             self._PowerSystemResource._Measurements = filtered
  77
  78         self._PowerSystemResource = value
  79         if self._PowerSystemResource is not None:
  80             self._PowerSystemResource._Measurements.append(self)
  81
  82     PowerSystemResource = property(getPowerSystemResource, setPowerSystemResource)
  83
  84     def getLocations(self):
  85
  86         return self._Locations
  87
  88     def setLocations(self, value):
  89         for p in self._Locations:
  90             filtered = [q for q in p.Measurements if q != self]
  91             self._Locations._Measurements = filtered
  92         for r in value:
  93             if self not in r._Measurements:
  94                 r._Measurements.append(self)
  95         self._Locations = value
  96
  97     Locations = property(getLocations, setLocations)
  98
  99     def addLocations(self, *Locations):
 100         for obj in Locations:
 101             if self not in obj._Measurements:
 102                 obj._Measurements.append(self)
 103             self._Locations.append(obj)
 104
 105     def removeLocations(self, *Locations):
 106         for obj in Locations:
 107             if self in obj._Measurements:
 108                 obj._Measurements.remove(self)
 109             self._Locations.remove(obj)
 110
 111     def getTerminal(self):
 112         """One or more measurements may be associated with a terminal in the network
 113         """
 114         return self._Terminal
 115
 116     def setTerminal(self, value):
 117         if self._Terminal is not None:
 118             filtered = [x for x in self.Terminal.Measurements if x != self]
 119             self._Terminal._Measurements = filtered
 120
 121         self._Terminal = value
 122         if self._Terminal is not None:
 123             self._Terminal._Measurements.append(self)
 124
 125     Terminal = property(getTerminal, setTerminal)
 126
 127     def getUnit(self):
 128         """The Unit for the Measurement
 129         """
 130         return self._Unit
 131
 132     def setUnit(self, value):
 133         if self._Unit is not None:
 134             filtered = [x for x in self.Unit.Measurements if x != self]
 135             self._Unit._Measurements = filtered
 136
 137         self._Unit = value
 138         if self._Unit is not None:
 139             self._Unit._Measurements.append(self)
 140
 141     Unit = property(getUnit, setUnit)
 142
 143     def gettieToMeasurement0(self):
 144
 145         return self._tieToMeasurement0
 146
 147     def settieToMeasurement0(self, value):
 148         for x in self._tieToMeasurement0:
 149             x._measurement0 = None
 150         for y in value:
 151             y._measurement0 = self
 152         self._tieToMeasurement0 = value
 153
 154     tieToMeasurement0 = property(gettieToMeasurement0, settieToMeasurement0)
 155
 156     def addtieToMeasurement0(self, *tieToMeasurement0):
 157         for obj in tieToMeasurement0:
 158             obj._measurement0 = self
 159             self._tieToMeasurement0.append(obj)
 160
 161     def removetieToMeasurement0(self, *tieToMeasurement0):
 162         for obj in tieToMeasurement0:
 163             obj._measurement0 = None
 164             self._tieToMeasurement0.remove(obj)
 165
 166     def getAsset(self):
 167
 168         return self._Asset
 169
 170     def setAsset(self, value):
 171         if self._Asset is not None:
 172             filtered = [x for x in self.Asset.Measurements if x != self]
 173             self._Asset._Measurements = filtered
 174
 175         self._Asset = value
 176         if self._Asset is not None:
 177             self._Asset._Measurements.append(self)
 178
 179     Asset = property(getAsset, setAsset)
 180
 181     def getDocuments(self):
 182         """Measurements are specified in types of documents, such as procedures.
 183         """
 184         return self._Documents
 185
 186     def setDocuments(self, value):
 187         for p in self._Documents:
 188             filtered = [q for q in p.Measurements if q != self]
 189             self._Documents._Measurements = filtered
 190         for r in value:
 191             if self not in r._Measurements:
 192                 r._Measurements.append(self)
 193         self._Documents = value
 194
 195     Documents = property(getDocuments, setDocuments)
 196
 197     def addDocuments(self, *Documents):
 198         for obj in Documents:
 199             if self not in obj._Measurements:
 200                 obj._Measurements.append(self)
 201             self._Documents.append(obj)
 202
 203     def removeDocuments(self, *Documents):
 204         for obj in Documents:
 205             if self in obj._Measurements:
 206                 obj._Measurements.remove(self)
 207             self._Documents.remove(obj)
 208