Description of idx

DESCRIPTION

IDX_GEN   Defines constants for named column indices to gen matrix.
   Example:

   [GEN_BUS, PG, QG, QMAX, QMIN, VG, MBASE, GEN_STATUS, PMAX, PMIN, ...
   MU_PMAX, MU_PMIN, MU_QMAX, MU_QMIN, PC1, PC2, QC1MIN, QC1MAX, ...
   QC2MIN, QC2MAX, RAMP_AGC, RAMP_10, RAMP_30, RAMP_Q, APF] = idx_gen;

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

    Pg = gen(4, PG);   % get the real power output of generator 4
    gen(:, PMIN) = 0;  % set to zero the minimum real power limit of all gens
 
   The index, name and meaning of each column of the gen matrix is given
   below:

   columns 1-21 must be included in input matrix (in case file)
    1  GEN_BUS     bus number
    2  PG          Pg, real power output (MW)
    3  QG          Qg, reactive power output (MVAr)
    4  QMAX        Qmax, maximum reactive power output (MVAr)
    5  QMIN        Qmin, minimum reactive power output (MVAr)
    6  VG          Vg, voltage magnitude setpoint (p.u.)
    7  MBASE       mBase, total MVA base of machine, defaults to baseMVA
    8  GEN_STATUS  status, > 0 - in service, <= 0 - out of service
    9  PMAX        Pmax, maximum real power output (MW)
    10 PMIN        Pmin, minimum real power output (MW)
    11 PC1         Pc1, lower real power output of PQ capability curve (MW)
    12 PC2         Pc2, upper real power output of PQ capability curve (MW)
    13 QC1MIN      Qc1min, minimum reactive power output at Pc1 (MVAr)
    14 QC1MAX      Qc1max, maximum reactive power output at Pc1 (MVAr)
    15 QC2MIN      Qc2min, minimum reactive power output at Pc2 (MVAr)
    16 QC2MAX      Qc2max, maximum reactive power output at Pc2 (MVAr)
    17 RAMP_AGC    ramp rate for load following/AGC (MW/min)
    18 RAMP_10     ramp rate for 10 minute reserves (MW)
    19 RAMP_30     ramp rate for 30 minute reserves (MW)
    20 RAMP_Q      ramp rate for reactive power (2 sec timescale) (MVAr/min)
    21 APF         area participation factor
   
   columns 22-25 are added to matrix after OPF solution
   they are typically not present in the input matrix
                   (assume OPF objective function has units, u)
    22 MU_PMAX     Kuhn-Tucker multiplier on upper Pg limit (u/MW)
    23 MU_PMIN     Kuhn-Tucker multiplier on lower Pg limit (u/MW)
    24 MU_QMAX     Kuhn-Tucker multiplier on upper Qg limit (u/MVAr)
    25 MU_QMIN     Kuhn-Tucker multiplier on lower Qg limit (u/MVAr)

   See also DEFINE_CONSTANTS.

CROSS-REFERENCE INFORMATION

bustypes BUSTYPES Builds index lists for each type of bus (REF, PV, PQ).

case_info CASE_INFO Prints information about islands in a network.

cdf2mpc CDF2MPC Converts an IEEE CDF data file into a MATPOWER case struct.

compare_case COMPARE_CASE Compares the bus, gen, branch matrices of 2 MATPOWER cases.

dcopf_solver DCOPF_SOLVER Solves a DC optimal power flow.

define_constants DEFINE_CONSTANTS Defines constants for named column indices to data matrices.

ext2int EXT2INT Converts external to internal indexing.

extract_islands function mpck = extract_islands(mpc, groups, k, custom)

check_feasibility CHECK_FEASIBILITY Returns the maximum constraint violation in p.u.

makeBloss [BL2, BL1, BL0] = MAKEBLOSS(MPC)

make_opf_feasible MAKE_OPF_FEASIBLE Attempts to relax constraints to make an OPF feasible.

insolvablepf INSOLVABLEPF A sufficient condition for power flow insolvability

insolvablepf_limitQ INSOLVABLEPF_LIMITQ A sufficient condition for power flow insolvability

sdpopf_solver SDPOPF_SOLVER A semidefinite programming relaxtion of the OPF problem

t_insolvablepf T_INSOLVABLEPF Test for power flow insolvability condition

t_insolvablepf_limitQ T_INSOLVABLEPF_LIMITQ Test for power flow insolvability condition

t_insolvablepfsos T_INSOLVABLEPF Test for power flow insolvability condition

t_insolvablepfsos_limitQ T_INSOLVABLEPF Test for power flow insolvability condition

t_opf_sdpopf T_OPF_SDPOPF Tests for SDP-based AC optimal power flow.

t_testglobalopt T_TESTGLOBALOPT Test for Global Optimality Condition

doSE DOSE Do state estimation.

getV0 GETV0 Get initial voltage profile for power flow calculation.

outputpfsoln OUTPUTPFSOLN Output power flow solution.

auction AUCTION Clear auction based on OPF results (qty's and lambdas).

case2off CASE2OFF Creates quantity & price offers from gen & gencost.

off2case OFF2CASE Updates case variables gen & gencost from quantity & price offers.

printmkt PRINTMKT Prints results of ISO computation.

smartmkt SMARTMKT Runs the PowerWeb smart market.

runse RUNSE Runs a state estimator.

fmincopf_solver FMINCOPF_SOLVER Solves AC optimal power flow using FMINCON.

hasPQcap HASPQCAP Checks for P-Q capability curve constraints.

int2ext INT2EXT Converts internal to external bus numbering.

ipoptopf_solver IPOPTOPF_SOLVER Solves AC optimal power flow using MIPS.

isload ISLOAD Checks for dispatchable loads.

ktropf_solver KTROPF_SOLVER Solves AC optimal power flow using KNITRO.

load2disp LOAD2DISP Converts fixed loads to dispatchable.

loadcase LOADCASE Load .m or .mat case files or data struct in MATPOWER format.

makeApq MAKEAPQ Construct linear constraints for generator capability curves.

makeAvl MAKEAVL Construct linear constraints for constant power factor var loads.

makeJac MAKEJAC Forms the power flow Jacobian.

makeSbus MAKESBUS Builds the vector of complex bus power injections.

mipsopf_solver MIPSOPF_SOLVER Solves AC optimal power flow using MIPS.

opf OPF Solves an optimal power flow.

opf_consfcn OPF_CONSFCN Evaluates nonlinear constraints and their Jacobian for OPF.

opf_costfcn OPF_COSTFCN Evaluates objective function, gradient and Hessian for OPF.

opf_execute OPF_EXECUTE Executes the OPF specified by an OPF model object.

opf_hessfcn OPF_HESSFCN Evaluates Hessian of Lagrangian for AC OPF.

opf_setup OPF Constructs an OPF model object from a MATPOWER case struct.

pfsoln PFSOLN Updates bus, gen, branch data structures to match power flow soln.

printpf PRINTPF Prints power flow results.

psse_convert PSSE_CONVERT Converts data read from PSS/E RAW file to MATPOWER case.

runcpf RUNCPF Runs a full AC continuation power flow

runpf RUNPF Runs a power flow.

savecase SAVECASE Saves a MATPOWER case file, given a filename and the data.

scale_load SCALE_LOAD Scales fixed and/or dispatchable loads.

t_auction_minopf T_AUCTION_MINOPF Tests for code in auction.m, using MINOPF solver.

t_auction_mips T_AUCTION_MIPS Tests for code in auction.m, using MIPS solver.

t_auction_tspopf_pdipm T_AUCTION_TSPOPF_PDIPM Tests for code in auction.m, using PDIPMOPF solver.

t_cpf T_CPF Tests for continuation power flow.

t_dcline T_DCLINE Tests for DC line extension in TOGGLE_DCLINE.

t_islands T_ISLANDS Tests for FIND_ISLANDS, EXTRACT_ISLANDS, CONNECTED_COMPONENTS and CASE_INFO.

t_loadcase T_LOADCASE Test that LOADCASE works with a struct as well as case file.

t_makeLODF T_MAKELODF Tests for MAKELODF.

t_makePTDF T_MAKEPTDF Tests for MAKEPTDF.

t_margcost T_MARGCOST Tests for code in MARGCOST.

t_modcost T_MODCOST Tests for code in MODCOST.

t_off2case T_OFF2CASE Tests for code in OFF2CASE.

t_opf_dc_bpmpd T_OPF_DC_BPMPD Tests for DC optimal power flow using BPMPD_MEX solver.

t_opf_dc_clp T_OPF_DC_CLP Tests for DC optimal power flow using CLP solver.

t_opf_dc_cplex T_OPF_DC_CPLEX Tests for DC optimal power flow using CPLEX solver.

t_opf_dc_glpk T_OPF_DC_GLPK Tests for DC optimal power flow using GLPK solver.

t_opf_dc_gurobi T_OPF_DC_GUROBI Tests for DC optimal power flow using Gurobi solver.

t_opf_dc_ipopt T_OPF_DC_MIPS Tests for DC optimal power flow using MIPS solver.

t_opf_dc_mips T_OPF_DC_MIPS Tests for DC optimal power flow using MIPS solver.

t_opf_dc_mips_sc T_OPF_DC_MIPS_SC Tests for DC optimal power flow using MIPS-sc solver.

t_opf_dc_mosek T_OPF_DC_MOSEK Tests for DC optimal power flow using MOSEK solver.

t_opf_dc_ot T_OPF_DC_OT Tests for DC optimal power flow using Opt Tbx solvers.

t_opf_fmincon T_OPF_FMINCON Tests for FMINCON-based optimal power flow.

t_opf_ipopt T_OPF_IPOPT Tests for IPOPT-based AC optimal power flow.

t_opf_knitro T_OPF_FMINCON Tests for FMINCON-based optimal power flow.

t_opf_minopf T_OPF_MINOPF Tests for MINOS-based optimal power flow.

t_opf_mips T_OPF_MIPS Tests for MIPS-based AC optimal power flow.

t_opf_mips_sc T_OPF_MIPS_SC Tests for step-controlled MIPS-based AC optimal power flow.

t_opf_model T_OPF_MODEL Tests for OPF_MODEL.

t_opf_softlims T_OPF_SOFTLIMS Tests for userfcn callbacks (softlims) w/OPF.

t_opf_tspopf_pdipm T_OPF_TSPOPF_PDIPM Tests for PDIPM-based optimal power flow.

t_opf_tspopf_scpdipm T_OPF_TSPOPF_SCPDIPM Tests for SCPDIPM-based optimal power flow.

t_opf_tspopf_tralm T_OPF_TSPOPF_TRALM Tests for TRALM-based optimal power flow.

t_opf_userfcns T_OPF_USERFCNS Tests for userfcn callbacks (reserves/iflims) w/OPF.

t_pf T_PF Tests for power flow solvers.

t_runmarket T_RUNMARKET Tests for code in RUNMKT, SMARTMKT AND AUCTION.

t_runopf_w_res T_RUNOPF_W_RES Tests RUNOPF_W_RES and the associated callbacks.

t_scale_load T_SCALE_LOAD Tests for code in SCALE_LOAD.

t_total_load T_TOTAL_LOAD Tests for code in TOTAL_LOAD.

t_totcost T_TOTCOST Tests for code in TOTCOST.

toggle_dcline TOGGLE_DCLINE Enable, disable or check status of DC line modeling.

toggle_reserves TOGGLE_RESERVES Enable, disable or check status of fixed reserve requirements.

total_load TOTAL_LOAD Returns vector of total load in each load zone.

uopf UOPF Solves combined unit decommitment / optimal power flow.

update_mupq UPDATE_MUPQ Updates values of generator limit shadow prices.

SOURCE CODE

0001 function [GEN_BUS, PG, QG, QMAX, QMIN, VG, MBASE, GEN_STATUS, PMAX, PMIN, ...
0002     MU_PMAX, MU_PMIN, MU_QMAX, MU_QMIN, PC1, PC2, QC1MIN, QC1MAX, ...
0003     QC2MIN, QC2MAX, RAMP_AGC, RAMP_10, RAMP_30, RAMP_Q, APF] = idx_gen
0004 %IDX_GEN   Defines constants for named column indices to gen matrix.
0005 %   Example:
0006 %
0007 %   [GEN_BUS, PG, QG, QMAX, QMIN, VG, MBASE, GEN_STATUS, PMAX, PMIN, ...
0008 %   MU_PMAX, MU_PMIN, MU_QMAX, MU_QMIN, PC1, PC2, QC1MIN, QC1MAX, ...
0009 %   QC2MIN, QC2MAX, RAMP_AGC, RAMP_10, RAMP_30, RAMP_Q, APF] = idx_gen;
0010 %
0011 %   Some examples of usage, after defining the constants using the line above,
0012 %   are:
0013 %
0014 %    Pg = gen(4, PG);   % get the real power output of generator 4
0015 %    gen(:, PMIN) = 0;  % set to zero the minimum real power limit of all gens
0016 %
0017 %   The index, name and meaning of each column of the gen matrix is given
0018 %   below:
0019 %
0020 %   columns 1-21 must be included in input matrix (in case file)
0021 %    1  GEN_BUS     bus number
0022 %    2  PG          Pg, real power output (MW)
0023 %    3  QG          Qg, reactive power output (MVAr)
0024 %    4  QMAX        Qmax, maximum reactive power output (MVAr)
0025 %    5  QMIN        Qmin, minimum reactive power output (MVAr)
0026 %    6  VG          Vg, voltage magnitude setpoint (p.u.)
0027 %    7  MBASE       mBase, total MVA base of machine, defaults to baseMVA
0028 %    8  GEN_STATUS  status, > 0 - in service, <= 0 - out of service
0029 %    9  PMAX        Pmax, maximum real power output (MW)
0030 %    10 PMIN        Pmin, minimum real power output (MW)
0031 %    11 PC1         Pc1, lower real power output of PQ capability curve (MW)
0032 %    12 PC2         Pc2, upper real power output of PQ capability curve (MW)
0033 %    13 QC1MIN      Qc1min, minimum reactive power output at Pc1 (MVAr)
0034 %    14 QC1MAX      Qc1max, maximum reactive power output at Pc1 (MVAr)
0035 %    15 QC2MIN      Qc2min, minimum reactive power output at Pc2 (MVAr)
0036 %    16 QC2MAX      Qc2max, maximum reactive power output at Pc2 (MVAr)
0037 %    17 RAMP_AGC    ramp rate for load following/AGC (MW/min)
0038 %    18 RAMP_10     ramp rate for 10 minute reserves (MW)
0039 %    19 RAMP_30     ramp rate for 30 minute reserves (MW)
0040 %    20 RAMP_Q      ramp rate for reactive power (2 sec timescale) (MVAr/min)
0041 %    21 APF         area participation factor
0042 %
0043 %   columns 22-25 are added to matrix after OPF solution
0044 %   they are typically not present in the input matrix
0045 %                   (assume OPF objective function has units, u)
0046 %    22 MU_PMAX     Kuhn-Tucker multiplier on upper Pg limit (u/MW)
0047 %    23 MU_PMIN     Kuhn-Tucker multiplier on lower Pg limit (u/MW)
0048 %    24 MU_QMAX     Kuhn-Tucker multiplier on upper Qg limit (u/MVAr)
0049 %    25 MU_QMIN     Kuhn-Tucker multiplier on lower Qg limit (u/MVAr)
0050 %
0051 %   See also DEFINE_CONSTANTS.
0052 
0053 %   MATPOWER
0054 %   Copyright (c) 1996-2015 by Power System Engineering Research Center (PSERC)
0055 %   by Ray Zimmerman, PSERC Cornell
0056 %
0057 %   $Id: idx_gen.m 2644 2015-03-11 19:34:22Z ray $
0058 %
0059 %   This file is part of MATPOWER.
0060 %   Covered by the 3-clause BSD License (see LICENSE file for details).
0061 %   See http://www.pserc.cornell.edu/matpower/ for more info.
0062 
0063 %% define the indices
0064 GEN_BUS     = 1;    %% bus number
0065 PG          = 2;    %% Pg, real power output (MW)
0066 QG          = 3;    %% Qg, reactive power output (MVAr)
0067 QMAX        = 4;    %% Qmax, maximum reactive power output at Pmin (MVAr)
0068 QMIN        = 5;    %% Qmin, minimum reactive power output at Pmin (MVAr)
0069 VG          = 6;    %% Vg, voltage magnitude setpoint (p.u.)
0070 MBASE       = 7;    %% mBase, total MVA base of this machine, defaults to baseMVA
0071 GEN_STATUS  = 8;    %% status, 1 - machine in service, 0 - machine out of service
0072 PMAX        = 9;    %% Pmax, maximum real power output (MW)
0073 PMIN        = 10;   %% Pmin, minimum real power output (MW)
0074 PC1         = 11;   %% Pc1, lower real power output of PQ capability curve (MW)
0075 PC2         = 12;   %% Pc2, upper real power output of PQ capability curve (MW)
0076 QC1MIN      = 13;   %% Qc1min, minimum reactive power output at Pc1 (MVAr)
0077 QC1MAX      = 14;   %% Qc1max, maximum reactive power output at Pc1 (MVAr)
0078 QC2MIN      = 15;   %% Qc2min, minimum reactive power output at Pc2 (MVAr)
0079 QC2MAX      = 16;   %% Qc2max, maximum reactive power output at Pc2 (MVAr)
0080 RAMP_AGC    = 17;   %% ramp rate for load following/AGC (MW/min)
0081 RAMP_10     = 18;   %% ramp rate for 10 minute reserves (MW)
0082 RAMP_30     = 19;   %% ramp rate for 30 minute reserves (MW)
0083 RAMP_Q      = 20;   %% ramp rate for reactive power (2 sec timescale) (MVAr/min)
0084 APF         = 21;   %% area participation factor
0085 
0086 %% included in opf solution, not necessarily in input
0087 %% assume objective function has units, u
0088 MU_PMAX     = 22;   %% Kuhn-Tucker multiplier on upper Pg limit (u/MW)
0089 MU_PMIN     = 23;   %% Kuhn-Tucker multiplier on lower Pg limit (u/MW)
0090 MU_QMAX     = 24;   %% Kuhn-Tucker multiplier on upper Qg limit (u/MVAr)
0091 MU_QMIN     = 25;   %% Kuhn-Tucker multiplier on lower Qg limit (u/MVAr)
0092 
0093 %% Note: When a generator's PQ capability curve is not simply a box and the
0094 %% upper Qg limit is binding, the multiplier on this constraint is split into
0095 %% it's P and Q components and combined with the appropriate MU_Pxxx and
0096 %% MU_Qxxx values. Likewise for the lower Q limits.

idx_gen

PURPOSE

SYNOPSIS

DESCRIPTION

CROSS-REFERENCE INFORMATION

SOURCE CODE