Package com.powsybl.iidm.network

Interface TieLine

  • All Superinterfaces:
    Extendable<TieLine>, Identifiable<TieLine>, LineCharacteristics
    All Known Implementing Classes:
    TieLineAdapter
    public interface TieLine
extends Identifiable<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,
    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.

    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.

    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

    • 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

      • remove

        void remove()