Home > matpower5.1 > 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 branch 4 out of service
 
   The index, name and meaning of each column of the branch 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 branch 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 branch 4 out of service
0011 %
0012 %   The index, name and meaning of each column of the branch 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 branch 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-2015 by Power System Engineering Research Center (PSERC)
0049 %   by Ray Zimmerman, PSERC Cornell
0050 %
0051 %   $Id: idx_dcline.m 2644 2015-03-11 19:34:22Z ray $
0052 %
0053 %   This file is part of MATPOWER.
0054 %   Covered by the 3-clause BSD License (see LICENSE file for details).
0055 %   See http://www.pserc.cornell.edu/matpower/ for more info.
0056 
0057 %% define the indices
0058 c = struct( ...
0059     'F_BUS',     1, ... %% f, "from" bus number
0060     'T_BUS',     2, ... %% t,  "to"  bus number
0061     'BR_STATUS', 3, ... %% initial branch status, 1 - in service, 0 - out of service
0062     'PF',        4, ... %% MW flow at "from" bus ("from" -> "to")
0063     'PT',        5, ... %% MW flow at  "to"  bus ("from" -> "to")
0064     'QF',        6, ... %% MVAr injection at "from" bus ("from" -> "to")
0065     'QT',        7, ... %% MVAr injection at  "to"  bus ("from" -> "to")
0066     'VF',        8, ... %% voltage setpoint at "from" bus (p.u.)
0067     'VT',        9, ... %% voltage setpoint at  "to"  bus (p.u.)
0068     'PMIN',     10, ... %% lower limit on PF (MW flow at "from" end)
0069     'PMAX',     11, ... %% upper limit on PF (MW flow at "from" end)
0070     'QMINF',    12, ... %% lower limit on MVAr injection at "from" bus
0071     'QMAXF',    13, ... %% upper limit on MVAr injection at "from" bus
0072     'QMINT',    14, ... %% lower limit on MVAr injection at  "to"  bus
0073     'QMAXT',    15, ... %% upper limit on MVAr injection at  "to"  bus
0074     'LOSS0',    16, ... %% constant term of linear loss function (MW)
0075     'LOSS1',    17, ... %% linear term of linear loss function (MW)
0076     'MU_PMIN',  18, ... %% Kuhn-Tucker multiplier on lower flow lim at "from" bus (u/MW)
0077     'MU_PMAX',  19, ... %% Kuhn-Tucker multiplier on upper flow lim at "from" bus (u/MW)
0078     'MU_QMINF', 20, ... %% Kuhn-Tucker multiplier on lower VAr lim at "from" bus (u/MVAr)
0079     'MU_QMAXF', 21, ... %% Kuhn-Tucker multiplier on upper VAr lim at "from" bus (u/MVAr)
0080     'MU_QMINT', 22, ... %% Kuhn-Tucker multiplier on lower VAr lim at  "to"  bus (u/MVAr)
0081     'MU_QMAXT', 23  );  %% Kuhn-Tucker multiplier on upper VAr lim at  "to"  bus (u/MVAr)

Generated on Fri 20-Mar-2015 18:23:34 by m2html © 2005