Home > matpower7.0 > lib > makeApq.m

makeApq

PURPOSE ^

MAKEAPQ Construct linear constraints for generator capability curves.

SYNOPSIS ^

function [Apqh, ubpqh, Apql, ubpql, data] = makeApq(baseMVA, gen)

DESCRIPTION ^

MAKEAPQ Construct linear constraints for generator capability curves.
   [APQH, UBPQH, APQL, UBPQL, DATA] = MAKEAPQ(BASEMVA, GEN)

   Constructs the parameters for the following linear constraints
   implementing trapezoidal generator capability curves, where
   Pg and Qg are the real and reactive generator injections.

   APQH * [Pg; Qg] <= UBPQH
   APQL * [Pg; Qg] <= UBPQL

   DATA constains additional information as shown below.

   Example:
       [Apqh, ubpqh, Apql, ubpql, data] = makeApq(baseMVA, gen);

       data.h      [QC1MAX-QC2MAX, PC2-PC1]
       data.l      [QC2MIN-QC1MIN, PC1-PC2]
       data.ipqh   indices of gens with general PQ cap curves (upper)
       data.ipql   indices of gens with general PQ cap curves (lower)

CROSS-REFERENCE INFORMATION ^

This function calls: This function is called by:

SOURCE CODE ^

0001 function [Apqh, ubpqh, Apql, ubpql, data] = makeApq(baseMVA, gen)
0002 %MAKEAPQ Construct linear constraints for generator capability curves.
0003 %   [APQH, UBPQH, APQL, UBPQL, DATA] = MAKEAPQ(BASEMVA, GEN)
0004 %
0005 %   Constructs the parameters for the following linear constraints
0006 %   implementing trapezoidal generator capability curves, where
0007 %   Pg and Qg are the real and reactive generator injections.
0008 %
0009 %   APQH * [Pg; Qg] <= UBPQH
0010 %   APQL * [Pg; Qg] <= UBPQL
0011 %
0012 %   DATA constains additional information as shown below.
0013 %
0014 %   Example:
0015 %       [Apqh, ubpqh, Apql, ubpql, data] = makeApq(baseMVA, gen);
0016 %
0017 %       data.h      [QC1MAX-QC2MAX, PC2-PC1]
0018 %       data.l      [QC2MIN-QC1MIN, PC1-PC2]
0019 %       data.ipqh   indices of gens with general PQ cap curves (upper)
0020 %       data.ipql   indices of gens with general PQ cap curves (lower)
0021 
0022 %   MATPOWER
0023 %   Copyright (c) 1996-2016, Power Systems Engineering Research Center (PSERC)
0024 %   by Ray Zimmerman, PSERC Cornell
0025 %   and Carlos E. Murillo-Sanchez, PSERC Cornell & Universidad Nacional de Colombia
0026 %
0027 %   This file is part of MATPOWER.
0028 %   Covered by the 3-clause BSD License (see LICENSE file for details).
0029 %   See https://matpower.org for more info.
0030 
0031 %% define named indices into data matrices
0032 [GEN_BUS, PG, QG, QMAX, QMIN, VG, MBASE, GEN_STATUS, PMAX, PMIN, ...
0033     MU_PMAX, MU_PMIN, MU_QMAX, MU_QMIN, PC1, PC2, QC1MIN, QC1MAX, ...
0034     QC2MIN, QC2MAX, RAMP_AGC, RAMP_10, RAMP_30, RAMP_Q, APF] = idx_gen;
0035 
0036 %% data dimensions
0037 ng = size(gen, 1);      %% number of dispatchable injections
0038 
0039 %% which generators require additional linear constraints
0040 %% (in addition to simple box constraints) on (Pg,Qg) to correctly
0041 %% model their PQ capability curves
0042 ipqh = find( hasPQcap(gen, 'U') );
0043 ipql = find( hasPQcap(gen, 'L') );
0044 npqh = size(ipqh, 1);   %% number of general PQ capability curves (upper)
0045 npql = size(ipql, 1);   %% number of general PQ capability curves (lower)
0046 
0047 %% make Apqh if there is a need to add general PQ capability curves;
0048 %% use normalized coefficient rows so multipliers have right scaling
0049 %% in $$/pu
0050 if npqh > 0
0051   data.h = [gen(ipqh,QC1MAX)-gen(ipqh,QC2MAX), gen(ipqh,PC2)-gen(ipqh,PC1)];
0052   ubpqh = data.h(:, 1) .* gen(ipqh,PC1) + data.h(:, 2) .* gen(ipqh,QC1MAX);
0053   for i=1:npqh,
0054     tmp = norm(data.h(i,:));
0055     data.h(i,:) = data.h(i, :) / tmp;
0056     ubpqh(i) = ubpqh(i) / tmp;
0057   end
0058   Apqh = sparse([1:npqh, 1:npqh]', [ipqh; ipqh+ng], ...
0059                 data.h(:), npqh, 2*ng);
0060   ubpqh = ubpqh / baseMVA;
0061 else
0062   data.h = [];
0063   Apqh  = sparse(0, 2*ng);
0064   ubpqh = [];
0065 end
0066 
0067 %% similarly Apql
0068 if npql > 0
0069   data.l = [gen(ipql,QC2MIN)-gen(ipql,QC1MIN), gen(ipql,PC1)-gen(ipql,PC2)];
0070   ubpql= data.l(:, 1) .* gen(ipql,PC1) + data.l(:, 2) .* gen(ipql,QC1MIN) ;
0071   for i=1:npql,
0072     tmp = norm(data.l(i, : ));
0073     data.l(i, :) = data.l(i, :) / tmp;
0074     ubpql(i) = ubpql(i) / tmp;
0075   end
0076   Apql = sparse([1:npql, 1:npql]', [ipql; ipql+ng], ...
0077                 data.l(:), npql, 2*ng);
0078   ubpql = ubpql / baseMVA;
0079 else
0080   data.l = [];
0081   Apql  = sparse(0, 2*ng);
0082   ubpql = [];
0083 end
0084 
0085 data.ipql = ipql;
0086 data.ipqh = ipqh;

Generated on Mon 24-Jun-2019 15:58:45 by m2html © 2005