com.powsybl.contingency.tasks.HvdcLineTripping Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of powsybl-contingency-api Show documentation

An API to describe and trigger contingencies

There is a newer version: 6.6.0

Show newest version

/**
 * Copyright (c) 2017, RTE (http://www.rte-france.com)
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 */
package com.powsybl.contingency.tasks;

import com.powsybl.commons.PowsyblException;
import com.powsybl.computation.ComputationManager;
import com.powsybl.iidm.network.HvdcLine;
import com.powsybl.iidm.network.Network;
import com.powsybl.iidm.network.Switch;
import com.powsybl.iidm.network.Terminal;

import java.util.Objects;
import java.util.Set;

/**
 * @author Mathieu Bague 
 */
public class HvdcLineTripping extends AbstractTrippingTask {

    private final String hvdcLineId;

    private final String voltageLevelId;

    public HvdcLineTripping(String hvdcLineId) {
        this(hvdcLineId, null);
    }

    public HvdcLineTripping(String hvdcLineId, String voltageLevelId) {
        this.hvdcLineId = Objects.requireNonNull(hvdcLineId);
        this.voltageLevelId = voltageLevelId;
    }

    @Override
    public void traverse(Network network, ComputationManager computationManager, Set switchesToOpen, Set terminalsToDisconnect) {
        Objects.requireNonNull(network);

        HvdcLine hvdcLine = network.getHvdcLine(hvdcLineId);
        if (hvdcLine == null) {
            throw new PowsyblException("HVDC line '" + hvdcLine + "' not found");
        }

        Terminal terminal1 = hvdcLine.getConverterStation1().getTerminal();
        Terminal terminal2 = hvdcLine.getConverterStation2().getTerminal();

        if (voltageLevelId != null) {
            if (voltageLevelId.equals(terminal1.getVoltageLevel().getId())) {
                ContingencyTopologyTraverser.traverse(terminal1, switchesToOpen, terminalsToDisconnect);
            } else if (voltageLevelId.equals(terminal2.getVoltageLevel().getId())) {
                ContingencyTopologyTraverser.traverse(terminal2, switchesToOpen, terminalsToDisconnect);
            } else {
                throw new PowsyblException("VoltageLevel '" + voltageLevelId + "' not connected to HVDC line '" + hvdcLineId + "'");
            }
        } else {
            ContingencyTopologyTraverser.traverse(terminal1, switchesToOpen, terminalsToDisconnect);
            ContingencyTopologyTraverser.traverse(terminal2, switchesToOpen, terminalsToDisconnect);
        }
    }
}