Package CIM15 :: Package IEC61970 :: Package Meas :: Module Measurement' :: Class Measurement
[hide private]
[frames] | no frames]

Class Measurement

                         object --+        
                                  |        
                   Element'.Element --+    
                                      |    
Core.IdentifiedObject'.IdentifiedObject --+
                                          |
                                         Measurement
Known Subclasses:

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.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.

Instance Methods [hide private]
 
__init__(self, phases='s12N', measurementType='', unitMultiplier='M', unitSymbol='N', Terminal=None, PowerSystemResource=None, Locations=None, Asset=None, Documents=None, *args, **kw_args)
Initialises a new 'Measurement' instance.
 
addDocuments(self, *Documents)
 
addLocations(self, *Locations)
 
getAsset(self)
 
getDocuments(self)
Measurements are specified in types of documents, such as procedures.
 
getLocations(self)
 
getPowerSystemResource(self)
The PowerSystemResource that contains the Measurement in the naming hierarchy
 
getTerminal(self)
One or more measurements may be associated with a terminal in the network
 
removeDocuments(self, *Documents)
 
removeLocations(self, *Locations)
 
setAsset(self, value)
 
setDocuments(self, value)
 
setLocations(self, value)
 
setPowerSystemResource(self, value)
 
setTerminal(self, value)

Inherited from Core.IdentifiedObject'.IdentifiedObject: addDiagramObjects, addNames, getDiagramObjects, getModelingAuthoritySet, getNames, removeDiagramObjects, removeNames, setDiagramObjects, setModelingAuthoritySet, setNames

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __repr__, __setattr__, __sizeof__, __str__, __subclasshook__

Class Variables [hide private]
  _attr_types = {'measurementType': <type 'str'>, 'phases': <typ...
  _attrs = ['phases', 'measurementType', 'unitMultiplier', 'unit...
  _defaults = {'measurementType': '', 'phases': 's12N', 'unitMul...
  _enums = {'phases': 'PhaseCode', 'unitMultiplier': 'UnitMultip...
  _many_refs = ['Locations', 'Documents']
  _refs = ['Terminal', 'PowerSystemResource', 'Locations', 'Asse...
Properties [hide private]
  Asset
  Documents
Measurements are specified in types of documents, such as procedures.
  Locations
  PowerSystemResource
The PowerSystemResource that contains the Measurement in the naming hierarchy
  Terminal
One or more measurements may be associated with a terminal in the network

Inherited from Core.IdentifiedObject'.IdentifiedObject: DiagramObjects, ModelingAuthoritySet, Names

Inherited from object: __class__

Method Details [hide private]

__init__(self, phases='s12N', measurementType='', unitMultiplier='M', unitSymbol='N', Terminal=None, PowerSystemResource=None, Locations=None, Asset=None, Documents=None, *args, **kw_args)
(Constructor)

 

Initialises a new 'Measurement' instance.

Parameters:
  • 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). Since Controls have associations with Measurements, they will have the capability to handle each phase. The phase information in Measurement, along with 'measurementType' and 'phaseConnection' 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. Values are: "s12N", "BN", "BC", "ABN", "s2N", "N", "ACN", "BCN", "ABCN", "AC", "s1N", "AN", "B", "AB", "C", "A", "CN", "ABC"
  • measurementType - Specifies the type of Measurement, e.g. IndoorTemperature, OutDoorTemperature, BusVoltage, GeneratorVoltage, LineFlow etc.
  • unitMultiplier - The unit multiplier of the measured quantity. Values are: "M", "G", "d", "micro", "c", "p", "n", "T", "k", "m", "none"
  • unitSymbol - The unit of measure of the measured quantity. Values are: "N", "A", "rad", "VAh", "Pa", "J", "h", "Hz", "VArh", "ohm", "H", "m3", "deg", "V", "degC", "F", "Wh", "s", "g", "min", "S", "none", "W", "VAr", "m2", "m", "VA"
  • Terminal - One or more measurements may be associated with a terminal in the network
  • PowerSystemResource - The PowerSystemResource that contains the Measurement in the naming hierarchy
  • Locations
  • Asset
  • Documents - Measurements are specified in types of documents, such as procedures.
Overrides: object.__init__

Class Variable Details [hide private]

_attr_types

Value:
{'measurementType': <type 'str'>,
 'phases': <type 'str'>,
 'unitMultiplier': <type 'str'>,
 'unitSymbol': <type 'str'>}

_attrs

Value:
['phases', 'measurementType', 'unitMultiplier', 'unitSymbol']

_defaults

Value:
{'measurementType': '',
 'phases': 's12N',
 'unitMultiplier': 'M',
 'unitSymbol': 'N'}

_enums

Value:
{'phases': 'PhaseCode',
 'unitMultiplier': 'UnitMultiplier',
 'unitSymbol': 'UnitSymbol'}

_refs

Value:
['Terminal', 'PowerSystemResource', 'Locations', 'Asset', 'Documents']

Property Details [hide private]

Asset

Get Method:
getAsset(self)
Set Method:
setAsset(self, value)

Documents

Measurements are specified in types of documents, such as procedures.

Get Method:
getDocuments(self) - Measurements are specified in types of documents, such as procedures.
Set Method:
setDocuments(self, value)

Locations

Get Method:
getLocations(self)
Set Method:
setLocations(self, value)

PowerSystemResource

The PowerSystemResource that contains the Measurement in the naming hierarchy

Get Method:
getPowerSystemResource(self) - The PowerSystemResource that contains the Measurement in the naming hierarchy
Set Method:
setPowerSystemResource(self, value)

Terminal

One or more measurements may be associated with a terminal in the network

Get Method:
getTerminal(self) - One or more measurements may be associated with a terminal in the network
Set Method:
setTerminal(self, value)