Node Data Type

A Node represents a single electrical node or bus in an electric power system. Essentially, the connection between every other single-terminal or two-terminal device is demarcated by a Node object. A Node has a one-to-one relationship with its VoltagePhasorGroup: each Node has a Voltage and each Voltage has a measured Node. The Node is also used to define the Base KV for itself and the terminal of any device connected to it. Nodes are used to connect devices that belong to both Substation objects and TransmissionLine objects. Therefore, a Node can either be a child of a Substation (in which case it would have a non-zero value for the ParentSubstationID) or a child of a TransmissionLine (in which case it would have a non-zero value for the ParentTransmissionLineID). A Node can have a non-zero value for both of these properties if it is either the FromNode or the ToNode of a TransmissionLine. These nodes are owned by both the TransmissionLine and the FromSubstation & ToSubstation, respectively. However, in the XML representation of the network, these Nodes are still elements belonging to the Substation. The only indication in the XML which indicates ownership by the associated TransmissionLine is this ParentTransmissionLineID property and the FromNode or ToNode property of the TransmissionLine. These properties are outlined in the following table:

Node Property/Attribute Table
Property Name Xml Name Type Description
UniqueId Uid Guid A statistically unique identifier for the instance of the Node data type. Lazily instantiated.
InternalID ID Integer A non-zero, positive, integer, unique identifier for the instance of the Node data type.
Number Number Integer A non-zero, positive integer non-unique descriptor for the instance of the Node data type.
Acronym Acronym String An uppercase, non-unique acronym descriptor for the instance of the Node data type.
Name Name String A non-unique name descriptor for the instance of the Node data type.
Description Description String A non-unique description for the instance of the Node data type.
VoltageLevelID BaseKV Integer The InternalID of the VoltageLevel object which defines the base KV of the instance of the Node data type.
ParentSubstationID ParentSubstation Integer The InternalID of the parent Substation object of the instance of the Node data type. If a Node does not belong to a Substation, this value can safely be set to zero.
ParentTransmissionLineID ParentTransmissionLine 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.
Voltage Voltage VoltagePhasorGroup The child data type which describes the measured and estimated values of the voltage of the electrical Node. See Voltage Phasor Group Data Type Section.


<Node Uid="9f3943c6-97d4-4e5b-877c-a60ed2160f8b" ID="1" Number="1" Acronym="Undefined" Name="BusA Node" Description="BusA Node" BaseKV="2" ParentSubstation="1" ParentTransmissionLine="3">
	<Voltage />
</Node>

Theres some code that should go here :P

Last edited Sep 15, 2014 at 12:10 AM by kevinjones, version 1