Division Data Type

Similar to the Company data type, the Division data type is simply a data container for network components which share geographic proximity to each other. A Division can only be a child of a Company. It, too, has only the properties required by the INetworkDescribable interface and properties for its children elements. The Division data type has two types of children elements: Substation and TransmissionLine. These properties are outlined in the following table:

Division Property/Attribute Table
Property Name Xml Name Type Description
UniqueId Uid Guid A statistically unique identifier for the instance of the Division data type. Lazily instantiated.
InternalID ID Integer A non-zero, positive, integer, unique identifier for the instance of the Division data type.
Number Number Integer A non-zero, positive integer non-unique descriptor for the instance of the Division data type.
Acronym Acronym String An uppercase, non-unique acronym descriptor for the instance of the Division data type.
Name Name String A non-unique name descriptor for the instance of the Division data type.
Description Description String A non-unique description for the instance of the Division data type.
Substations Substations List<Substation> The children Substations of the instance of the Division. See Substation Data Type Section
TransmissionLines TransmissionLines List<TransmissionLine> The children TransmissionLines of the instance of the Division. See Transmission Line Data Type Section

The following snippet of Xml shows how a Division object is represented in Xml.

<Division Uid="4956c6b5-ea8f-4599-a765-3f3268297165" ID="1" Number="1" Acronym="WEST" Name="West" Description="Western Service Territory">
	<Substations />
	<TransmissionLines />
</Division>

And this snippet of C# code similar shows how to accomplish the same thing programmatically.

using SynchrophasorAnalytics.Modeling; 

//...

// Create a new division with desired properties
Division division = new Division()
{
     InternalID = 2,
     Number = 7,
     Acronym = "WEST",
     Name = "West",
     Description = "Western Service Territory",
     Substations = GetChildrenSubstationsFromSomewhere(),
     TransmissionLines = GetChildrenTransmissionLinesFromSomewhere()
};

To add a new Division to the Company using the Network Model Editor, right-click on the Company item and click Add.

NME - Add New Division.png

Then, this screenshot shows how to model a Division object as it is reflected in the Xml and C# code snippet from above.

NME - Division Detail.png

Last edited Sep 15, 2014 at 12:31 AM by kevinjones, version 2