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 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.

    • connectDanglingLines

      boolean connectDanglingLines()

    • connectDanglingLines

      boolean connectDanglingLines(Predicate<Switch> isTypeSwitchToOperate)

    • connectDanglingLines

      boolean connectDanglingLines(Predicate<Switch> isTypeSwitchToOperate, TwoSides side)

    • disconnectDanglingLines

      boolean disconnectDanglingLines()

    • disconnectDanglingLines

      boolean disconnectDanglingLines(Predicate<Switch> isSwitchOpenable)

    • disconnectDanglingLines

      boolean disconnectDanglingLines(Predicate<Switch> isSwitchOpenable, TwoSides side)

    • getNetwork

      Network getNetwork()
      Description copied from interface: Identifiable
      Get the network associated to the object.
      Specified by:
      getNetwork in interface Identifiable<TieLine>