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

apply_changes APPLY_CHANGES Applies a set of changes to a MATPOWER case

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.

cpf_current_mpc CPF_CURRENT_MPC Construct MPC for current continuation step.

cpf_plim_event CPF_PLIM_EVENT Event function to detect the generator active power limits

cpf_plim_event_cb CPF_PLIM_EVENT_CB Callback to handle PLIM events

cpf_qlim_event CPF_QLIM_EVENT Event function to detect the generator reactive power limits

cpf_qlim_event_cb CPF_QLIM_EVENT_CB Callback to handle QLIM events

dcopf_solver DCOPF_SOLVER Solves a DC optimal power flow.

define_constants DEFINE_CONSTANTS Defines useful constants for indexing data, etc.

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.

run_se RUN_SE Run state estimation.

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.

loadstoragedata LOADSTORAGEDATA Load StorageData table into StorageData struct.

loadxgendata LOADXGENDATA Load xGenData table into xGenData struct.

most MOST MATPOWER Optimal Scheduling Tool

most_summary MOST_SUMMARY Collects and optionally prints a summary of MOST results.

plot_gen PLOT_GEN Plot generator results

plot_storage PLOT_STORAGE Plot storage unit results

plot_uc PLOT_UC Plot generator commitment summary

ex_contab EX_CONTAB Example contingency data for stochastic unit commitment.

ex_wind_profile EX_WIND_PROFILE Example wind profile data for stochastic unit commitment.

ex_wind_profile_d EX_WIND_PROFILE_D Example wind profile data for deterministic unit commitment.

t_most_30b_1_1_0 T_MOST_30B_1_1_0 Tests for MOST.

t_most_30b_1_1_0_uc T_MOST_30B_1_1_0_UC Tests for MOST.

t_most_30b_1_1_17 T_MOST_30B_1_1_17 Tests for MOST.

t_most_30b_3_1_0 T_MOST_30B_3_1_0 Tests for MOST.

t_most_30b_3_1_17 T_MOST_30B_3_1_17 Tests for MOST.

t_most_3b_1_1_0 T_MOST_3B_1_1_0 Tests for MOST.

t_most_3b_1_1_2 T_MOST_3B_1_1_2 Tests for MOST.

t_most_3b_3_1_0 T_MOST_3B_3_1_0 Tests for MOST.

t_most_3b_3_1_2 T_MOST_3B_1_1_2 Tests for MOST.

t_most_fixed_res T_MOST_FIXED_RES Tests MOST with fixed reserve requirements.

t_most_sp T_MOST_SP Tests of single-period continuous optimizations

t_most_spuc T_MOST_SPUC Tests of single-period unit commitment optimizations

t_most_suc T_MOST_SUC Tests of stochastic unit commitment optimizations.

t_most_uc T_MOST_UC Tests of deteministic unit commitment optimizations

t_most_w_ds T_MOST_W_DS Test for MOST with dynamical system constraints.

uniformwindprofile UNIFORMWINDPROFILE Creates a wind profile with evenly spaced capacity values.

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_apply_changes T_APPLY_CHANGES Tests for code in apply_changes.m.

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.

t_vdep_load T_VDEP_LOAD Test voltage dependent ZIP load model for PF, CPF, OPF.

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-2016, Power Systems Engineering Research Center (PSERC)
0055 %   by Ray Zimmerman, PSERC Cornell
0056 %
0057 %   This file is part of MATPOWER.
0058 %   Covered by the 3-clause BSD License (see LICENSE file for details).
0059 %   See http://www.pserc.cornell.edu/matpower/ for more info.
0060 
0061 %% define the indices
0062 GEN_BUS     = 1;    %% bus number
0063 PG          = 2;    %% Pg, real power output (MW)
0064 QG          = 3;    %% Qg, reactive power output (MVAr)
0065 QMAX        = 4;    %% Qmax, maximum reactive power output at Pmin (MVAr)
0066 QMIN        = 5;    %% Qmin, minimum reactive power output at Pmin (MVAr)
0067 VG          = 6;    %% Vg, voltage magnitude setpoint (p.u.)
0068 MBASE       = 7;    %% mBase, total MVA base of this machine, defaults to baseMVA
0069 GEN_STATUS  = 8;    %% status, 1 - machine in service, 0 - machine out of service
0070 PMAX        = 9;    %% Pmax, maximum real power output (MW)
0071 PMIN        = 10;   %% Pmin, minimum real power output (MW)
0072 PC1         = 11;   %% Pc1, lower real power output of PQ capability curve (MW)
0073 PC2         = 12;   %% Pc2, upper real power output of PQ capability curve (MW)
0074 QC1MIN      = 13;   %% Qc1min, minimum reactive power output at Pc1 (MVAr)
0075 QC1MAX      = 14;   %% Qc1max, maximum reactive power output at Pc1 (MVAr)
0076 QC2MIN      = 15;   %% Qc2min, minimum reactive power output at Pc2 (MVAr)
0077 QC2MAX      = 16;   %% Qc2max, maximum reactive power output at Pc2 (MVAr)
0078 RAMP_AGC    = 17;   %% ramp rate for load following/AGC (MW/min)
0079 RAMP_10     = 18;   %% ramp rate for 10 minute reserves (MW)
0080 RAMP_30     = 19;   %% ramp rate for 30 minute reserves (MW)
0081 RAMP_Q      = 20;   %% ramp rate for reactive power (2 sec timescale) (MVAr/min)
0082 APF         = 21;   %% area participation factor
0083 
0084 %% included in opf solution, not necessarily in input
0085 %% assume objective function has units, u
0086 MU_PMAX     = 22;   %% Kuhn-Tucker multiplier on upper Pg limit (u/MW)
0087 MU_PMIN     = 23;   %% Kuhn-Tucker multiplier on lower Pg limit (u/MW)
0088 MU_QMAX     = 24;   %% Kuhn-Tucker multiplier on upper Qg limit (u/MVAr)
0089 MU_QMIN     = 25;   %% Kuhn-Tucker multiplier on lower Qg limit (u/MVAr)
0090 
0091 %% Note: When a generator's PQ capability curve is not simply a box and the
0092 %% upper Qg limit is binding, the multiplier on this constraint is split into
0093 %% it's P and Q components and combined with the appropriate MU_Pxxx and
0094 %% MU_Qxxx values. Likewise for the lower Q limits.

idx_gen

PURPOSE

SYNOPSIS

DESCRIPTION

CROSS-REFERENCE INFORMATION

SOURCE CODE