Interface TieLine
-
- All Superinterfaces:
Branch<Line>
,Connectable<Line>
,Extendable<Line>
,Identifiable<Line>
,Line
,LineCharacteristics<Line>
- All Known Implementing Classes:
TieLineAdapter
public interface TieLine extends Line
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 Modifier and Type Interface Description static interface
TieLine.HalfLine
Half line-
Nested classes/interfaces inherited from interface com.powsybl.iidm.network.Branch
Branch.Overload, Branch.Side
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description TieLine.HalfLine
getHalf(Branch.Side side)
Get a given side half of the line characteristicsTieLine.HalfLine
getHalf1()
Get first half of the line characteristicsTieLine.HalfLine
getHalf2()
Get second half of the line characteristicsString
getUcteXnodeCode()
Get the UCTE Xnode code corresponding to this line in the case where the line is a boundary, return null otherwise.-
Methods inherited from interface com.powsybl.iidm.network.Branch
checkPermanentLimit, checkPermanentLimit, checkPermanentLimit, checkPermanentLimit, checkPermanentLimit1, checkPermanentLimit1, checkPermanentLimit1, checkPermanentLimit1, checkPermanentLimit2, checkPermanentLimit2, checkPermanentLimit2, checkPermanentLimit2, checkTemporaryLimits, checkTemporaryLimits, checkTemporaryLimits, checkTemporaryLimits, checkTemporaryLimits1, checkTemporaryLimits1, checkTemporaryLimits1, checkTemporaryLimits1, checkTemporaryLimits2, checkTemporaryLimits2, 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.iidm.network.Connectable
getTerminals, remove
-
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, getNetwork, 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 line in the case where the line is a boundary, return null otherwise.
-
getHalf1
TieLine.HalfLine getHalf1()
Get first half of the line characteristics
-
getHalf2
TieLine.HalfLine getHalf2()
Get second half of the line characteristics
-
getHalf
TieLine.HalfLine getHalf(Branch.Side side)
Get a given side half of the line characteristics
-
-