Substation Data Type

A Substation represents a collection of network components that exist inside an electrical substation or switchyard. A Substation shares similarities with its parent in that its core functionality is also just a data container. However, the Substation level is where there begins to exist a stronger differentiation between what can and cannot be a child. This includes components such as Node, Switch, CircuitBreaker, Transformer, and ShuntCompensator. These component collections are reflected as properties of the Substation data type. The remaining properties of the Substation are those that are required by the INetworkDescribable interface. The properties are outlined in the following table:

Substation Property/Attribute Table
Property Name Xml Name Type Description
UniqueId Uid Guid A statistically unique identifier for the instance of the Substation data type. Lazily instantiated.
InternalID ID Integer A non-zero, positive, integer, unique identifier for the instance of the Substation data type.
Number Number Integer A non-zero, positive integer non-unique descriptor for the instance of the Substation data type.
Acronym Acronym String An uppercase, non-unique acronym descriptor for the instance of the Substation data type.
Name Name String A non-unique name descriptor for the instance of the Substation data type.
Description Description String A non-unique description for the instance of the Substation data type.
Nodes Nodes List<Node> The children Nodes of the Substation. See Node Data Type Section.
Shunts Shunts List<ShuntCompensator> The children ShuntCompensators of the Substation. See Shunt Compensator Data Type Section.
Transformers Transformers List<Transformer> The children Transformers of the Substation. See Transformer Data Type Section.
CircuitBreakers CircuitBreakers List<CircuitBreaker> The children CircuitBreakers of the Substation. See Circuit Breakers Data Type Section.
Switches Switches List<Switch> The children Switches of the Substation. See Switch Data Type Section.


<Substation Uid="8badf64d-8e72-4d07-9e39-aadbce3c4884" ID="6" Number="1" Acronym="SUBSTATION_D" Name="SubstationD" Description="SubstationD Substation">
	 <Nodes />
	 <Shunts /> 
	 <Transformers /> 
	 <CircuitBreakers /> 
	 <Switches /> 
</Substation>

using SynchrophasorAnalytics.Modeling; 

//...


// Create a new substation with desired properties
Substation substation = new Substation()
{
     InternalID = 4,
     Number = 5,
     Acronym = "SHIRE",
     Name = "The Shire",
     Description = "The Shire is where the Hobbits live.",
     Nodes = GetChildrenNodesFromSomewhere(),
     CircuitBreakers = GetChildrenCircuitBreakersFromSomewhere(),
     Switches = GetChildrenSwitchesFromSomewhere(),
     Transformers = GetChildrenTwoWindingTransformersFromSomewhere(),
     Shunts = GetChildrenShuntCompensatorsFromSomewhere()
};

Last edited Sep 14, 2014 at 11:54 PM by kevinjones, version 3