Package com.powsybl.iidm.network

Interface TieLine

All Superinterfaces:

Branch<TieLine>, Extendable<TieLine>, Identifiable<TieLine>, LineCharacteristics

public interface TieLine
extends Branch<TieLine>, LineCharacteristics

A tie line is an AC line sharing power between two neighbouring regional grids. It is constituted of two DanglingLine

The tie line is always oriented in the same way,
The network model node of the danglingLine1 is always at end 1.
The network model node of the danglingLine2 is always at end 2.

As there is no injection at the boundary node, by applying kron reduction, this node can be removed getting an equivalent branch between both network model nodes.

Characteristics

Attribute	Type	Unit	Required	Defaut value	Description
Id	String	-	yes	-	Unique identifier of the tie line
Name	String	-	yes	-	Human-readable name of the tie line
DanglingLine1	DanglingLine	-	yes	-	The first half of the line characteristics
DanglingLine2	DanglingLine	-	yes	-	The second half of the line characteristics

A tie line is created by matching two DanglingLine with the same pairing key.
We have two Dangling Lines within the Tie Line.

In the CGMES import of an assembled model :
A tie line is created by matching two links with the same boundary node.
Each link can be:

• A line.
• A Breaker or Disconnector.
• An equivalent branch.
• A transformer with fixed ratio and zero phase shift angle.

Author:

Geoffroy Jamgotchian <geoffroy.jamgotchian at rte-france.com>, Luma Zamarreño <zamarrenolm at aia.es>, José Antonio Marqués <marquesja at aia.es>

Method Summary

Modifier and Type	Method	Description
DanglingLine	getDanglingLine(TwoSides side)	Get the dangling line of this tie line corresponding to the given side
DanglingLine	getDanglingLine(String voltageLevelId)	Get the dangling line of this tie line corresponding to the given voltage level
DanglingLine	getDanglingLine1()	Get first dangling line of this tie line
DanglingLine	getDanglingLine2()	Get second dangling line of this tie line
Network	getNetwork()	Get the network associated to the object.
String	getPairingKey()	Get the pairing key corresponding to this tie line in the case where the line is a boundary, return null otherwise.
default IdentifiableType	getType()	Get identifiable type.
void	remove()
void	remove(boolean updateDanglingLines)	Remove the tie line with an update of underlying dangling lines to reflect the tie line flows.

Methods inherited from interface com.powsybl.iidm.network.Branch

cancelSelectedOperationalLimitsGroup1, cancelSelectedOperationalLimitsGroup2, checkPermanentLimit, checkPermanentLimit, checkPermanentLimit1, checkPermanentLimit1, checkPermanentLimit2, checkPermanentLimit2, checkTemporaryLimits, checkTemporaryLimits, checkTemporaryLimits1, checkTemporaryLimits1, checkTemporaryLimits2, checkTemporaryLimits2, getActivePowerLimits, getActivePowerLimits1, getActivePowerLimits2, getApparentPowerLimits, getApparentPowerLimits1, getApparentPowerLimits2, getCurrentLimits, getCurrentLimits1, getCurrentLimits2, getLimits, getNullableActivePowerLimits, getNullableActivePowerLimits1, getNullableActivePowerLimits2, getNullableApparentPowerLimits, getNullableApparentPowerLimits1, getNullableApparentPowerLimits2, getNullableCurrentLimits, getNullableCurrentLimits1, getNullableCurrentLimits2, getNullableLimits, getOperationalLimitsGroup1, getOperationalLimitsGroup2, getOperationalLimitsGroups1, getOperationalLimitsGroups2, getOverloadDuration, getSelectedOperationalLimitsGroup1, getSelectedOperationalLimitsGroup2, getSelectedOperationalLimitsGroupId1, getSelectedOperationalLimitsGroupId2, getSide, getTerminal, getTerminal, getTerminal1, getTerminal2, isOverloaded, isOverloaded, newActivePowerLimits1, newActivePowerLimits2, newApparentPowerLimits1, newApparentPowerLimits2, newCurrentLimits1, newCurrentLimits2, newOperationalLimitsGroup1, newOperationalLimitsGroup2, removeOperationalLimitsGroup1, removeOperationalLimitsGroup2, setSelectedOperationalLimitsGroup1, setSelectedOperationalLimitsGroup2

Methods inherited from interface com.powsybl.commons.extensions.Extendable

addExtension, getExtension, getExtensionByName, getExtensions, getImplementationName, newExtension, removeExtension

Methods inherited from interface com.powsybl.iidm.network.Identifiable

addAlias, addAlias, addAlias, addAlias, getAliases, getAliasFromType, getAliasType, getId, getNameOrId, getOptionalName, getParentNetwork, getProperty, getProperty, getPropertyNames, hasAliases, hasProperty, hasProperty, isFictitious, removeAlias, removeProperty, setFictitious, setName, setProperty

Methods inherited from interface com.powsybl.iidm.network.LineCharacteristics

getB1, getB2, getG1, getG2, getR, getX

Method Details

getPairingKey

String getPairingKey()

Get the pairing key corresponding to this tie line in the case where the line is a boundary, return null otherwise.

getDanglingLine1

DanglingLine getDanglingLine1()

Get first dangling line of this tie line

getDanglingLine2

DanglingLine getDanglingLine2()

Get second dangling line of this tie line

getDanglingLine

DanglingLine getDanglingLine(TwoSides side)

Get the dangling line of this tie line corresponding to the given side

getDanglingLine

DanglingLine getDanglingLine(String voltageLevelId)

Get the dangling line of this tie line corresponding to the given voltage level

getType

default IdentifiableType getType()

Description copied from interface: Identifiable

Get identifiable type.

Specified by:

getType in interface Identifiable<TieLine>

Returns:

the identifiable type

remove

void remove()

remove

void remove(boolean updateDanglingLines)

Remove the tie line with an update of underlying dangling lines to reflect the tie line flows.

getNetwork

Network getNetwork()

Description copied from interface: Identifiable

Get the network associated to the object.

Specified by:

getNetwork in interface Identifiable<TieLine>