t_pf

T_PF  Tests for power flow solvers.

0001 function t_pf(quiet)
0002 %T_PF  Tests for power flow solvers.
0003 
0004 %   MATPOWER
0005 %   $Id: t_pf.m,v 1.10 2010/04/28 19:06:45 ray Exp $
0006 %   by Ray Zimmerman, PSERC Cornell
0007 %   Copyright (c) 2004-2010 by Power System Engineering Research Center (PSERC)
0008 %
0009 %   This file is part of MATPOWER.
0010 %   See http://www.pserc.cornell.edu/matpower/ for more info.
0011 %
0012 %   MATPOWER is free software: you can redistribute it and/or modify
0013 %   it under the terms of the GNU General Public License as published
0014 %   by the Free Software Foundation, either version 3 of the License,
0015 %   or (at your option) any later version.
0016 %
0017 %   MATPOWER is distributed in the hope that it will be useful,
0018 %   but WITHOUT ANY WARRANTY; without even the implied warranty of
0019 %   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
0020 %   GNU General Public License for more details.
0021 %
0022 %   You should have received a copy of the GNU General Public License
0023 %   along with MATPOWER. If not, see <http://www.gnu.org/licenses/>.
0024 %
0025 %   Additional permission under GNU GPL version 3 section 7
0026 %
0027 %   If you modify MATPOWER, or any covered work, to interface with
0028 %   other modules (such as MATLAB code and MEX-files) available in a
0029 %   MATLAB(R) or comparable environment containing parts covered
0030 %   under other licensing terms, the licensors of MATPOWER grant
0031 %   you additional permission to convey the resulting work.
0032 
0033 if nargin < 1
0034     quiet = 0;
0035 end
0036 
0037 t_begin(25, quiet);
0038 
0039 casefile = 't_case9_pf';
0040 if quiet
0041     verbose = 0;
0042 else
0043     verbose = 1;
0044 end
0045 if have_fcn('octave')
0046     s1 = warning('query', 'Octave:load-file-in-path');
0047     warning('off', 'Octave:load-file-in-path');
0048 end
0049 mpopt = mpoption('OUT_ALL', 0, 'VERBOSE', verbose);
0050 
0051 [GEN_BUS, PG, QG, QMAX, QMIN, VG, MBASE, GEN_STATUS, PMAX, PMIN, ...
0052     MU_PMAX, MU_PMIN, MU_QMAX, MU_QMIN, PC1, PC2, QC1MIN, QC1MAX, ...
0053     QC2MIN, QC2MAX, RAMP_AGC, RAMP_10, RAMP_30, RAMP_Q, APF] = idx_gen;
0054 
0055 %% get solved AC power flow case from MAT-file
0056 load soln9_pf;      %% defines bus_soln, gen_soln, branch_soln
0057 
0058 %% run Newton PF
0059 t = 'Newton PF : ';
0060 mpopt = mpoption(mpopt, 'PF_ALG', 1);
0061 [baseMVA, bus, gen, branch, success, et] = runpf(casefile, mpopt);
0062 t_ok(success, [t 'success']);
0063 t_is(bus, bus_soln, 6, [t 'bus']);
0064 t_is(gen, gen_soln, 6, [t 'gen']);
0065 t_is(branch, branch_soln, 6, [t 'branch']);
0066 
0067 %% run fast-decoupled PF (XB version)
0068 t = 'Fast Decoupled (XB) PF : ';
0069 mpopt = mpoption(mpopt, 'PF_ALG', 2);
0070 [baseMVA, bus, gen, branch, success, et] = runpf(casefile, mpopt);
0071 t_ok(success, [t 'success']);
0072 t_is(bus, bus_soln, 6, [t 'bus']);
0073 t_is(gen, gen_soln, 6, [t 'gen']);
0074 t_is(branch, branch_soln, 6, [t 'branch']);
0075 
0076 %% run fast-decoupled PF (BX version)
0077 t = 'Fast Decoupled (BX) PF : ';
0078 mpopt = mpoption(mpopt, 'PF_ALG', 3);
0079 [baseMVA, bus, gen, branch, success, et] = runpf(casefile, mpopt);
0080 t_ok(success, [t 'success']);
0081 t_is(bus, bus_soln, 6, [t 'bus']);
0082 t_is(gen, gen_soln, 6, [t 'gen']);
0083 t_is(branch, branch_soln, 6, [t 'branch']);
0084 
0085 %% run Gauss-Seidel PF
0086 t = 'Gauss-Seidel PF : ';
0087 mpopt = mpoption(mpopt, 'PF_ALG', 4);
0088 [baseMVA, bus, gen, branch, success, et] = runpf(casefile, mpopt);
0089 t_ok(success, [t 'success']);
0090 t_is(bus, bus_soln, 5, [t 'bus']);
0091 t_is(gen, gen_soln, 5, [t 'gen']);
0092 t_is(branch, branch_soln, 5, [t 'branch']);
0093 
0094 %% get solved AC power flow case from MAT-file
0095 load soln9_dcpf;        %% defines bus_soln, gen_soln, branch_soln
0096 
0097 %% run DC PF
0098 t = 'DC PF : ';
0099 [baseMVA, bus, gen, branch, success, et] = rundcpf(casefile, mpopt);
0100 t_ok(success, [t 'success']);
0101 t_is(bus, bus_soln, 6, [t 'bus']);
0102 t_is(gen, gen_soln, 6, [t 'gen']);
0103 t_is(branch, branch_soln, 6, [t 'branch']);
0104 
0105 %% check Qg distribution, when Qmin = Qmax
0106 t = 'check Qg : ';
0107 mpopt = mpoption(mpopt, 'PF_ALG', 1, 'VERBOSE', 0);
0108 mpc = loadcase(casefile);
0109 mpc.gen(1, [QMIN QMAX]) = [20 20];
0110 [baseMVA, bus, gen, branch, success, et] = runpf(mpc, mpopt);
0111 t_is(gen(1, QG), 24.07, 2, [t 'single gen, Qmin = Qmax']);
0112 
0113 mpc.gen = [mpc.gen(1, :); mpc.gen];
0114 mpc.gen(1, [QMIN QMAX]) = [10 10];
0115 mpc.gen(2, [QMIN QMAX]) = [0 50];
0116 [baseMVA, bus, gen, branch, success, et] = runpf(mpc, mpopt);
0117 t_is(gen(1:2, QG), [10; 14.07], 2, [t '2 gens, Qmin = Qmax for one']);
0118 
0119 mpc.gen(1, [QMIN QMAX]) = [10 10];
0120 mpc.gen(2, [QMIN QMAX]) = [-50 -50];
0121 [baseMVA, bus, gen, branch, success, et] = runpf(mpc, mpopt);
0122 t_is(gen(1:2, QG), [12.03; 12.03], 2, [t '2 gens, Qmin = Qmax for both']);
0123 
0124 mpc.gen(1, [QMIN QMAX]) = [0 50];
0125 mpc.gen(2, [QMIN QMAX]) = [0 100];
0126 [baseMVA, bus, gen, branch, success, et] = runpf(mpc, mpopt);
0127 t_is(gen(1:2, QG), [8.02; 16.05], 2, [t '2 gens, proportional']);
0128 
0129 mpc.gen(1, [QMIN QMAX]) = [-50 0];
0130 mpc.gen(2, [QMIN QMAX]) = [50 150];
0131 [baseMVA, bus, gen, branch, success, et] = runpf(mpc, mpopt);
0132 t_is(gen(1:2, QG), [-50+8.02; 50+16.05], 2, [t '2 gens, proportional']);
0133 
0134 if have_fcn('octave')
0135     warning(s1.state, 'Octave:load-file-in-path');
0136 end
0137 
0138 t_end;