Interface TieLine
-
- All Superinterfaces:
Branch<TieLine>
,Extendable<TieLine>
,Identifiable<TieLine>
,LineCharacteristics
- All Known Implementing Classes:
TieLineAdapter
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 [half lines](#half-line).The tie line is always oriented in the same way,
As there is not injection at the boundary node, by applying kron reduction, this node can be removed getting an equivalent branch between both network model nodes.
The network model node of the Half 1 is always at end 1.
The network model node of the Half 2 is always at end 2.
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 HalfLine1 TieLine.HalfLine - yes - The first half of the line characteristics HalfLine2 TieLine.HalfLine - yes - The second half of the line characteristics UcteXnodeCode String - no - The UCTE Xnode code corresponding to this line (only required if the line crosses a boundary) R double Ω yes - The series resistance (resistance of the equivalent branch model) **NB: this attribute is read-only** X double Ω yes - The series reactance (reactance of the equivalent branch model) **NB: this attribute is read-only** G1 double S yes - The first side shunt conductance (shunt conductance of the equivalent branch at end 1) **NB: this attribute is read-only** B1 double S yes - The first side shunt susceptance (shunt susceptance of the equivalent branch at end 1) **NB: this attribute is read-only** G2 double S yes - The second side shunt conductance (shunt conductance of the equivalent branch at end 2) **NB: this attribute is read-only** B2 double S yes - The second side shunt susceptance (shunt susceptance of the equivalent branch at end 2) **NB: this attribute is read-only** In the Merging View:
A tie line is created by matching two [dangling lines](#dangling-line) with the same Xnode code.
We have two Dangling Lines as Half line objects of a Tie Line.
The first dangling line maps directly to the first half line.
The second dangling line must be reoriented before mapping it to the second half line (In dangling lines we assume that the boundary side is always at end 2).In the CGMES import of an assembled model :
A tie line is created by matching two links with the same boundary node.
Depending on the initial orientation of the links, none, only one or maybe both links must be reoriented before mapping them to the half lines.
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
, Luma Zamarreño , José Antonio Marqués
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface com.powsybl.iidm.network.Branch
Branch.Overload, Branch.Side
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description DanglingLine
getDanglingLine(Branch.Side side)
Get the dangling line of this tie line corresponding to the given sideDanglingLine
getDanglingLine(String voltageLevelId)
Get the dangling line of this tie line corresponding to the given voltage levelDanglingLine
getDanglingLine1()
Get first dangling line of this tie lineDanglingLine
getDanglingLine2()
Get second dangling line of this tie lineNetwork
getNetwork()
Get the network associated to the object.default IdentifiableType
getType()
Get identifiable type.String
getUcteXnodeCode()
Get the UCTE Xnode code corresponding to this tie line in the case where the line is a boundary, return null otherwise.void
remove()
-
Methods inherited from interface com.powsybl.iidm.network.Branch
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, getOperationalLimits1, getOperationalLimits2, getOverloadDuration, getSide, getTerminal, getTerminal, getTerminal1, getTerminal2, isOverloaded, isOverloaded, newActivePowerLimits1, newActivePowerLimits2, newApparentPowerLimits1, newApparentPowerLimits2, newCurrentLimits1, newCurrentLimits2
-
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, getName, getNameOrId, getOptionalName, getProperties, getProperty, getProperty, getPropertyNames, hasAliases, hasProperty, hasProperty, isFictitious, removeAlias, removeProperty, setFictitious, setName, setProperty
-
-
-
-
Method Detail
-
getUcteXnodeCode
String getUcteXnodeCode()
Get the UCTE Xnode code 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(Branch.Side 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 interfaceIdentifiable<TieLine>
- Returns:
- the identifiable type
-
remove
void remove()
-
getNetwork
Network getNetwork()
Description copied from interface:Identifiable
Get the network associated to the object.- Specified by:
getNetwork
in interfaceIdentifiable<TieLine>
-
-