nme_legacy_dcline_ac.m

classdef (Abstract) nme_legacy_dcline_ac < mp.nme_legacy_dcline
% mp.nme_legacy_dcline_ac - Network model element abstract base class for legacy DC line for AC formulation.
%
% Adds non-voltage state variables ``Pdcf``, ``Qdcf``, ``Pdct``, and ``Qdct``
% to the network model and builds the parameter :math:`\NN`.

%   MATPOWER
%   Copyright (c) 2019-2024, Power Systems Engineering Research Center (PSERC)
%   by Ray Zimmerman, PSERC Cornell
%
%   This file is part of MATPOWER.
%   Covered by the 3-clause BSD License (see LICENSE file for details).
%   See https://matpower.org for more info.

    methods
        function obj = add_zvars(obj, nm, dm, idx)
            %
            ndc = obj.nk;
            dme = obj.data_model_element(dm);
            switch idx{1}
                case 1      % flow at "from"
                    nm.add_var('zr', 'Pdcf', ndc, dme.p_fr_start, dme.p_fr_lb, dme.p_fr_ub);
                    nm.add_var('zi', 'Qdcf', ndc, dme.q_fr_start, dme.q_fr_lb, dme.q_fr_ub);
                case 2      % flow at "to"
                    nm.add_var('zr', 'Pdct', ndc, dme.p_to_start, -Inf, Inf);
                    nm.add_var('zi', 'Qdct', ndc, dme.q_to_start, dme.q_to_lb, dme.q_to_ub);
            end
        end

        function obj = build_params(obj, nm, dm)
            %
            build_params@mp.nme_legacy_dcline(obj, nm, dm); %% call parent
            obj.N = speye(obj.nk * obj.nz);
        end
    end     %% methods
end         %% classdef