Switch Data Type

The Switch is the second of two types of network components that provide a mechanism for electrical separation between two nodes in the network. The Switch behaves identically and is modeled in a similar fashion to the CircuitBreaker. The key difference is that a Switch does not have a mechanism for accepting telemetry from an outside source. The only way to toggle the state of a Switch during program operation is to send it a command and manually override its state. This is typical behavior for this data type as a typical switch in a power system will not have telemetry and system operators toggle the state switch manually so that the state estimator has an accurate representation of the network. The properties of the Switch data type are outlined in the following table:

Switch Property/Attribute Table
Property Name Xml Name Type Description
UniqueId Uid Guid A statistically unique identifier for the instance of the Switch data type. Lazily instantiated.
InternalID ID Integer A non-zero, positive, integer, unique identifier for the instance of the Switch data type.
Number Number Integer A non-zero, positive integer non-unique descriptor for the instance of the Switch data type.
Acronym Acronym String An uppercase, non-unique acronym descriptor for the instance of the Switch data type.
Name Name String A non-unique name descriptor for the instance of the Switch data type.
Description Description String A non-unique description for the instance of the Switch data type.
MeasurementKey Key String A string key used to uniquely identify the output measurement to map the ActualState property value to.
FromNodeID FromNode Integer The InternalID of the Node object which is electrically connected to the From side of the Switch. A Switch is symmetrical in that it does not matter which Node is connected to the From side and which node is connected to the To side.
ToNodeID ToNode Integer The InternalID of the Node object which is electrically connected to the To side of the Switch.
NormalState Normally SwitchingDevice-NormalState The normal state of the Switch. Either Closed or Open
ActualState Actually SwitchingDevice-ActualState The actual state of the Switch. Either Closed or Open. This value is dictated by the prevailing state of the Switch as determined by its manual override, or default value.
ParentSubstationID ParentSubstation Integer The InternalID of the parent Substation object of the instance of the Switch data type. If a Switch does not belong to a Substation, this value can safely be set to zero.
ParentTransmission-LineID ParentTransmission-Line Integer The InternalID of the parent TransmissionLine object of the instance of the Node data type. If a Node does not belong to a TransmissionLine, this value can safely be set to zero. A node which electrically connects a terminal of a TransmissionLine with the rest of the Substation will have a non-zero value for both the ParentSubstationID and the ParentTransmissionLineID.


<Switches>
	<Switch Uid="361d29ac-03a8-4efc-9659-cc951537d50d" ID="59" Number="1" Acronym="SWDV" Name="H165" Description="Bristers 500kV Switch H165" Key="Undefined" FromNode="98" ToNode="107" Normally="Closed" Actually="Closed" ParentSubstation="1" ParentTransmissionLine="0" /> 
	<Switch Uid="263ec85f-ce05-4c9e-9770-90ab3627b0ec" ID="60" Number="2" Acronym="SWDV" Name="54565" Description="Bristers 500kV Switch 54565" Key="Undefined" FromNode="99" ToNode="95" Normally="Closed" Actually="Closed" ParentSubstation="1" 	ParentTransmissionLine="0" /> 
</Switches>

Last edited Sep 15, 2014 at 11:45 PM by kevinjones, version 1