Home > matpower7.1 > lib > idx_dcline.m

idx_dcline

PURPOSE ^

IDX_DCLINE Defines constants for named column indices to dcline matrix.

SYNOPSIS ^

function c = idx_dcline

DESCRIPTION ^

IDX_DCLINE   Defines constants for named column indices to dcline matrix.
   Example:

   c = idx_dcline;

   Some examples of usage, after defining the constants using the line above,
   are:

    mpc.dcline(4, c.BR_STATUS) = 0;        % take dcline 4 out of service
 
   The index, name and meaning of each column of the dcline matrix is given
   below:

   columns 1-17 must be included in input matrix (in case file)
    1  F_BUS     f, "from" bus number
    2  T_BUS     t,  "to"  bus number
    3  BR_STATUS initial dcline status, 1 - in service, 0 - out of service
    4  PF        MW flow at "from" bus ("from" -> "to")
    5  PT        MW flow at  "to"  bus ("from" -> "to")
    6  QF        MVAr injection at "from" bus ("from" -> "to")
    7  QT        MVAr injection at  "to"  bus ("from" -> "to")
    8  VF        voltage setpoint at "from" bus (p.u.)
    9  VT        voltage setpoint at  "to"  bus (p.u.)
   10  PMIN      lower limit on PF (MW flow at "from" end)
   11  PMAX      upper limit on PF (MW flow at "from" end)
   12  QMINF     lower limit on MVAr injection at "from" bus
   13  QMAXF     upper limit on MVAr injection at "from" bus
   14  QMINT     lower limit on MVAr injection at  "to"  bus
   15  QMAXT     upper limit on MVAr injection at  "to"  bus
   16  LOSS0     constant term of linear loss function (MW)
   17  LOSS1     linear term of linear loss function (MW/MW)
                 (loss = LOSS0 + LOSS1 * PF)

   columns 18-23 are added to matrix after OPF solution
   they are typically not present in the input matrix
                 (assume OPF objective function has units, u)
   18  MU_PMIN   Kuhn-Tucker multiplier on lower flow lim at "from" bus (u/MW)
   19  MU_PMAX   Kuhn-Tucker multiplier on upper flow lim at "from" bus (u/MW)
   20  MU_QMINF  Kuhn-Tucker multiplier on lower VAr lim at "from" bus (u/MVAr)
   21  MU_QMAXF  Kuhn-Tucker multiplier on upper VAr lim at "from" bus (u/MVAr)
   22  MU_QMINT  Kuhn-Tucker multiplier on lower VAr lim at  "to"  bus (u/MVAr)
   23  MU_QMAXT  Kuhn-Tucker multiplier on upper VAr lim at  "to"  bus (u/MVAr)

   See also TOGGLE_DCLINE.

CROSS-REFERENCE INFORMATION ^

This function calls: This function is called by:

SOURCE CODE ^

0001 function c = idx_dcline
0002 %IDX_DCLINE   Defines constants for named column indices to dcline matrix.
0003 %   Example:
0004 %
0005 %   c = idx_dcline;
0006 %
0007 %   Some examples of usage, after defining the constants using the line above,
0008 %   are:
0009 %
0010 %    mpc.dcline(4, c.BR_STATUS) = 0;        % take dcline 4 out of service
0011 %
0012 %   The index, name and meaning of each column of the dcline matrix is given
0013 %   below:
0014 %
0015 %   columns 1-17 must be included in input matrix (in case file)
0016 %    1  F_BUS     f, "from" bus number
0017 %    2  T_BUS     t,  "to"  bus number
0018 %    3  BR_STATUS initial dcline status, 1 - in service, 0 - out of service
0019 %    4  PF        MW flow at "from" bus ("from" -> "to")
0020 %    5  PT        MW flow at  "to"  bus ("from" -> "to")
0021 %    6  QF        MVAr injection at "from" bus ("from" -> "to")
0022 %    7  QT        MVAr injection at  "to"  bus ("from" -> "to")
0023 %    8  VF        voltage setpoint at "from" bus (p.u.)
0024 %    9  VT        voltage setpoint at  "to"  bus (p.u.)
0025 %   10  PMIN      lower limit on PF (MW flow at "from" end)
0026 %   11  PMAX      upper limit on PF (MW flow at "from" end)
0027 %   12  QMINF     lower limit on MVAr injection at "from" bus
0028 %   13  QMAXF     upper limit on MVAr injection at "from" bus
0029 %   14  QMINT     lower limit on MVAr injection at  "to"  bus
0030 %   15  QMAXT     upper limit on MVAr injection at  "to"  bus
0031 %   16  LOSS0     constant term of linear loss function (MW)
0032 %   17  LOSS1     linear term of linear loss function (MW/MW)
0033 %                 (loss = LOSS0 + LOSS1 * PF)
0034 %
0035 %   columns 18-23 are added to matrix after OPF solution
0036 %   they are typically not present in the input matrix
0037 %                 (assume OPF objective function has units, u)
0038 %   18  MU_PMIN   Kuhn-Tucker multiplier on lower flow lim at "from" bus (u/MW)
0039 %   19  MU_PMAX   Kuhn-Tucker multiplier on upper flow lim at "from" bus (u/MW)
0040 %   20  MU_QMINF  Kuhn-Tucker multiplier on lower VAr lim at "from" bus (u/MVAr)
0041 %   21  MU_QMAXF  Kuhn-Tucker multiplier on upper VAr lim at "from" bus (u/MVAr)
0042 %   22  MU_QMINT  Kuhn-Tucker multiplier on lower VAr lim at  "to"  bus (u/MVAr)
0043 %   23  MU_QMAXT  Kuhn-Tucker multiplier on upper VAr lim at  "to"  bus (u/MVAr)
0044 %
0045 %   See also TOGGLE_DCLINE.
0046 
0047 %   MATPOWER
0048 %   Copyright (c) 2011-2016, Power Systems Engineering Research Center (PSERC)
0049 %   by Ray Zimmerman, PSERC Cornell
0050 %
0051 %   This file is part of MATPOWER.
0052 %   Covered by the 3-clause BSD License (see LICENSE file for details).
0053 %   See https://matpower.org for more info.
0054 
0055 %% define the indices
0056 c = struct( ...
0057     'F_BUS',     1, ... %% f, "from" bus number
0058     'T_BUS',     2, ... %% t,  "to"  bus number
0059     'BR_STATUS', 3, ... %% initial dcline status, 1 - in service, 0 - out of service
0060     'PF',        4, ... %% MW flow at "from" bus ("from" -> "to")
0061     'PT',        5, ... %% MW flow at  "to"  bus ("from" -> "to")
0062     'QF',        6, ... %% MVAr injection at "from" bus ("from" -> "to")
0063     'QT',        7, ... %% MVAr injection at  "to"  bus ("from" -> "to")
0064     'VF',        8, ... %% voltage setpoint at "from" bus (p.u.)
0065     'VT',        9, ... %% voltage setpoint at  "to"  bus (p.u.)
0066     'PMIN',     10, ... %% lower limit on PF (MW flow at "from" end)
0067     'PMAX',     11, ... %% upper limit on PF (MW flow at "from" end)
0068     'QMINF',    12, ... %% lower limit on MVAr injection at "from" bus
0069     'QMAXF',    13, ... %% upper limit on MVAr injection at "from" bus
0070     'QMINT',    14, ... %% lower limit on MVAr injection at  "to"  bus
0071     'QMAXT',    15, ... %% upper limit on MVAr injection at  "to"  bus
0072     'LOSS0',    16, ... %% constant term of linear loss function (MW)
0073     'LOSS1',    17, ... %% linear term of linear loss function (MW)
0074     'MU_PMIN',  18, ... %% Kuhn-Tucker multiplier on lower flow lim at "from" bus (u/MW)
0075     'MU_PMAX',  19, ... %% Kuhn-Tucker multiplier on upper flow lim at "from" bus (u/MW)
0076     'MU_QMINF', 20, ... %% Kuhn-Tucker multiplier on lower VAr lim at "from" bus (u/MVAr)
0077     'MU_QMAXF', 21, ... %% Kuhn-Tucker multiplier on upper VAr lim at "from" bus (u/MVAr)
0078     'MU_QMINT', 22, ... %% Kuhn-Tucker multiplier on lower VAr lim at  "to"  bus (u/MVAr)
0079     'MU_QMAXT', 23  );  %% Kuhn-Tucker multiplier on upper VAr lim at  "to"  bus (u/MVAr)

Generated on Fri 09-Oct-2020 11:21:31 by m2html © 2005