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.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)