Package com.powsybl.iidm.modification.topology

Class AttachNewLineOnLine

  • All Implemented Interfaces:
    NetworkModification
    public class AttachNewLineOnLine
extends Object
implements NetworkModification
    Connect an existing voltage level (in practice a voltage level where we have some loads or generations) to a point of an existing line. This method cuts an existing line in two, creating a fictitious voltage level between them. Then it links an existing voltage level to this fictitious voltage level in creating a new line created from a given line adder.
    Author:
    Miora Vedelago

    • Constructor Detail

      • AttachNewLineOnLine

        public AttachNewLineOnLine​(double percent,
                           String voltageLevelId,
                           String bbsOrBusId,
                           String fictitiousVlId,
                           String fictitiousVlName,
                           boolean createFictSubstation,
                           String fictitiousSubstationId,
                           String fictitiousSubstationName,
                           String line1Id,
                           String line1Name,
                           String line2Id,
                           String line2Name,
                           Line line,
                           LineAdder lineAdder)
        Constructor.
        Parameters:
        percent - When the existing line is cut, percent is equal to the ratio between the parameters of the first line and the parameters of the line that is cut multiplied by 100. 100 minus percent is equal to the ratio between the parameters of the second line and the parameters of the line that is cut multiplied by 100.
        voltageLevelId - The voltage level with the given ID that we want to connect to the initial line.
        bbsOrBusId - The ID of the existing bus or bus bar section of the voltage level voltageLevelId where we want to connect the line that will be between this voltage level and the fictitious voltage level. Please note that there will be switches between this bus or bus bar section and the connection point of the line.
        fictitiousVlId - ID of the created voltage level at the attachment point of the initial line. Please note that this voltage level is fictitious.
        fictitiousVlName - Name of the created voltage level at the attachment point of the initial line. Please note that this voltage level is fictitious.
        createFictSubstation - If true, a fictitious substation at the attachment point will be created. Else, the created voltage level will be contained directly in the network.
        fictitiousSubstationId - If createFictSubstation is true, the fictitious substation is given a non-null given ID.
        fictitiousSubstationName - If createdFictSubstation is true, the fictitious substation is given a given name.
        line1Id - When the initial line is cut, the line segment at side 1 has a non-null given ID.
        line1Name - When the initial line is cut, the line segment at side 1 has a given name.
        line2Id - When the initial line is cut, the line segment at side 2 has a non-null given ID.
        line2Name - When the initial line is cut, the line segment at side 2 has a given name.
        line - The initial line to be cut.
        lineAdder - The line adder from which the line between the fictitious voltage level and the voltage level voltageLevelId is created.