Package edu.ie3.datamodel.models.input.connector

Class Transformer3WInput

java.lang.Object

edu.ie3.datamodel.models.UniqueEntity

edu.ie3.datamodel.models.input.InputEntity

edu.ie3.datamodel.models.input.AssetInput

edu.ie3.datamodel.models.input.connector.ConnectorInput

edu.ie3.datamodel.models.input.connector.TransformerInput

edu.ie3.datamodel.models.input.connector.Transformer3WInput

All Implemented Interfaces:

HasNodes, HasType, NestedEntity, Operable, Serializable

public class Transformer3WInput
extends TransformerInput
implements HasType

Describes a three winding transformer, that is connected to three NodeInputs

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Transformer3WInput.Transformer3WInputCopyBuilder	A builder pattern based approach to create copies of Transformer3WInput entities with altered field values.

Nested classes/interfaces inherited from class edu.ie3.datamodel.models.input.AssetInput

AssetInput.AssetInputCopyBuilder<T extends AssetInput.AssetInputCopyBuilder<T>>

Nested classes/interfaces inherited from class edu.ie3.datamodel.models.UniqueEntity

UniqueEntity.UniqueEntityBuilder, UniqueEntity.UniqueEntityCopyBuilder<T extends UniqueEntity.UniqueEntityBuilder>

Field Summary

Fields inherited from class edu.ie3.datamodel.models.UniqueEntity

UUID_FIELD_NAME

Constructor Summary

Constructors

Constructor	Description
Transformer3WInput(UUID uuid, String id, NodeInput nodeA, NodeInput nodeB, NodeInput nodeC, int parallelDevices, Transformer3WTypeInput type, int tapPos, boolean autoTap)	Constructor for an operated, always on three winding transformer
Transformer3WInput(UUID uuid, String id, OperatorInput operator, OperationTime operationTime, NodeInput nodeA, NodeInput nodeB, NodeInput nodeC, int parallelDevices, Transformer3WTypeInput type, int tapPos, boolean autoTap)	Constructor for an operated three winding transformer
Transformer3WInput(UUID uuid, String id, OperatorInput operator, OperationTime operationTime, NodeInput nodeA, NodeInput nodeB, NodeInput nodeC, int parallelDevices, Transformer3WTypeInput type, int tapPos, boolean autoTap, boolean internalNodeAsSlack)	Constructor for an operated three winding transformer that allows setting the internal node as slack node.

Method Summary

Modifier and Type	Method	Description
List<NodeInput>	allNodes()
Transformer3WInput.Transformer3WInputCopyBuilder	copy()
boolean	equals(Object o)
NodeInput	getNodeA()
NodeInput	getNodeB()
NodeInput	getNodeC()
NodeInput	getNodeInternal()
Transformer3WTypeInput	getType()
int	hashCode()
String	toString()

Methods inherited from class edu.ie3.datamodel.models.input.connector.TransformerInput

getTapPos, isAutoTap

Methods inherited from class edu.ie3.datamodel.models.input.connector.ConnectorInput

getParallelDevices

Methods inherited from class edu.ie3.datamodel.models.input.AssetInput

getId, getOperationTime, getOperator

Methods inherited from class edu.ie3.datamodel.models.UniqueEntity

getUuid

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface edu.ie3.datamodel.models.Operable

inOperationOn

Constructor Details

Transformer3WInput

public Transformer3WInput(UUID uuid,
 String id,
 OperatorInput operator,
 OperationTime operationTime,
 NodeInput nodeA,
 NodeInput nodeB,
 NodeInput nodeC,
 int parallelDevices,
 Transformer3WTypeInput type,
 int tapPos,
 boolean autoTap)

Constructor for an operated three winding transformer

Parameters:

uuid - of the input entity

id - of the asset

operator - of the asset

operationTime - Time for which the entity is operated

nodeA - The higher voltage node

nodeB - The middle voltage node

nodeC - The lower voltage node

parallelDevices - overall amount of parallel transformers to automatically construct (e.g. parallelDevices = 2 will build a total of two transformers using the specified parameters)

type - of 3W transformer

tapPos - Tap Position of this transformer

autoTap - true, if there is an automated regulation activated for this transformer

Transformer3WInput

public Transformer3WInput(UUID uuid,
 String id,
 OperatorInput operator,
 OperationTime operationTime,
 NodeInput nodeA,
 NodeInput nodeB,
 NodeInput nodeC,
 int parallelDevices,
 Transformer3WTypeInput type,
 int tapPos,
 boolean autoTap,
 boolean internalNodeAsSlack)

Constructor for an operated three winding transformer that allows setting the internal node as slack node. This is normally needed if a larger grid is split up into subgrids and the three winding transformer is located in a subgrid that does not hold the highest voltage side of the transformer (here: that not holds node A in its grid).

Then, the internal node becomes a virtual representation of a slack node for the grid and allows for power flow calculations based on it's 'close-to-T-equivalent' representation

Parameters:

uuid - of the input entity

id - of the asset

operator - of the asset

operationTime - Time for which the entity is operated

nodeA - The higher voltage node

nodeB - The middle voltage node

nodeC - The lower voltage node

parallelDevices - overall amount of parallel transformers to automatically construct (e.g. parallelDevices = 2 will build a total of two transformers using the specified parameters)

type - of 3W transformer

tapPos - Tap Position of this transformer

autoTap - true, if there is an automated regulation activated for this transformer

internalNodeAsSlack - true, if the internal node is a slack node, false otherwise

Transformer3WInput

public Transformer3WInput(UUID uuid,
 String id,
 NodeInput nodeA,
 NodeInput nodeB,
 NodeInput nodeC,
 int parallelDevices,
 Transformer3WTypeInput type,
 int tapPos,
 boolean autoTap)

Constructor for an operated, always on three winding transformer

Parameters:

uuid - of the input entity

id - of the asset

nodeA - The higher voltage node

nodeB - The middle voltage node

nodeC - The lower voltage node

parallelDevices - overall amount of parallel transformers to automatically construct (e.g. parallelDevices = 2 will build a total of two transformers using the specified parameters)

type - of 3W transformer

tapPos - Tap Position of this transformer

autoTap - true, if there is an automated regulation activated for this transformer

Method Details

getType

public Transformer3WTypeInput getType()

Specified by:

getType in interface HasType

getNodeA

public NodeInput getNodeA()

Overrides:

getNodeA in class ConnectorInput

Returns:

the node with the highest voltage level

getNodeB

public NodeInput getNodeB()

Overrides:

getNodeB in class ConnectorInput

Returns:

the node with the "medium" voltage level

getNodeC

public NodeInput getNodeC()

Returns:

the node with the lowest voltage level

getNodeInternal

public NodeInput getNodeInternal()

Returns:

The internal node of the T equivalent circuit

copy

public Transformer3WInput.Transformer3WInputCopyBuilder copy()

Specified by:

copy in class TransformerInput

equals

public boolean equals(Object o)

Overrides:

equals in class TransformerInput

hashCode

public int hashCode()

Overrides:

hashCode in class TransformerInput

toString

public String toString()

Overrides:

toString in class TransformerInput

allNodes

public List<NodeInput> allNodes()

Specified by:

allNodes in interface HasNodes

Overrides:

allNodes in class ConnectorInput