Tap Configuration Data Type

The second data type owned by the Model is the TapConfiguration. The purpose of this record is to define the behavior of two-winding transformer taps in the network model. Since there are many transformers that have taps that will behave similarly, it is beneficial to only model each type of behavior once and have it utilized by each of the corresponding transformers. The TapConfiguration data type contains properties for the INetworkDescribable interface as with previous data types and defines five parameters for describing the behavior of the tap model. These are described in the table below.

Tap Configuration Property/Attribute Table
Property Name Xml Name Type Description
UniqueId Uid Guid A statistically unique identifier for the instance of the TapConfiguration data type. Lazily instantiated.
InternalID ID Integer A non-zero, positive, integer, unique identifier for the instance of the TapConfiguration data type.
Acronym Acronym String An uppercase, non-unique acronym descriptor for the instance of the TapConfiguration data type.
Name Name String A non-unique name descriptor for the instance of the TapConfiguration data type.
Description Description String A non-unique description for the instance of the TapConfiguration data type.
LowerBounds LowerBounds Double Defines the lower limit value of the turns ratio multiplier that can be applied for the given TapConfiguration data type.
UpperBounds UpperBounds Double Defines the upper limit value of the turns ratio multiplier that can be applied for the given TapConfiguration data type.
PositionLowerBounds PositionLowerBounds Integer Defines the lower limit position of the given TapConfiguration data type.
PositionUpperBounds PositionUpperBounds Integer Defines the upper limit position of the given TapConfiguration data type.
PositionNominal PositionNominal Integer Defines the nominal position of the given TapConfiguration data type. This value is only used to set the tap position when there is an absence of information. This is similar to a fixed tap position. However, this would be applied to all transformers with this TapConfiguration. Therefore, the a fixed tap position is set properly as a parameter of the Transformer. data type.

The following snippet of Xml is an example of a single TapConfiguration in the Model’s TapConfigurations list.

<TapConfigurations>
     <TapConfiguration Uid="a14ff471-ae48-47d0-b5fe-7f8061e2de3c" ID="1" Acronym="TAP" Name="Basic Tap Configuration" Description="Basic Tap Configuration" LowerBounds="0.92" UpperBounds="1.08" PositionLowerBounds="-8" PositionUpperBounds="8" PositionNominal="0" /> 
</TapConfigurations>

It is similarly modeled programmatically using the following snippet of C# code.

using SynchrophasorAnalytics.Modeling; 

//...

TapConfiguration tapConfiguration = new TapConfiguration()
{
     InternalID = 1,
     Acronym = "TAP",
     Name = "Basic Tap Configuration",
     Description = "Basic Tap Configuration",
     LowerBounds = 0.92,
     UpperBounds = 1.08,
     PositionLowerBounds = -8,
     PositionUpperBounds = 8,
     PositionNominal = 0
};

// Use object as needed

Its behavior is defined by the last five attributes; but more specifically, the first four of these five are critical. These four numbers define a set of integer-to-turns ratio mappings. This is more easily expressed in a table:

Integer Position Turns Ratio Multiplier Originates From
-8 0.92 Object definition
-7 0.93 Computed
-6 0.94 Computed
-5 0.95 Computed
-4 0.96 Computed
-3 0.97 Computed
-2 0.98 Computed
-1 0.99 Computed
0 1.00 Computed
1 1.01 Computed
2 1.02 Computed
3 1.03 Computed
4 1.04 Computed
5 1.05 Computed
6 1.06 Computed
7 1.07 Computed
8 1.08 Object definition


And these table values then define all of the possible states of the tap described by this example TapConfiguration. In the Network Model Editor, in order to add TapConfiguration objects to the Model, right-click on the Tap Configurations item and then click Add. Then, this snapshot shows how to model a TapConfiguration how it is reflected in the sample Xml and C# code snippets from above.

NME - Tap Configuration Detail.png

Last edited Sep 14, 2014 at 10:17 PM by kevinjones, version 2