function [options, names] = mpoption(p1, p2, p3, p4, p5, p6, p7, p8, p9, p10, p11, p12, p13, p14, p15)%MPOPTION  Used to set and retrieve a MATPOWER options vector.%%   opt = mpoption%       returns the default options vector%%   opt = mpoption(name1, value1, name2, value2, ...)%       returns the default options vector with new values for up to 7%       options, name# is the name of an option, and value# is the new%       value. Example: options = mpoption('PF_ALG', 2, 'PF_TOL', 1e-4)%%   opt = mpoption(opt, name1, value1, name2, value2, ...)%       same as above except it uses the options vector opt as a base%       instead of the default options vector.%%   The currently defined options are as follows:%%      idx - NAME, default          description [options]%      ---   -------------          -------------------------------------%   power flow options%       1  - PF_ALG, 1              power flow algorithm%           [   1 - Newton's method                                     ]%           [   2 - Fast-Decoupled (XB version)                         ]%           [   3 - Fast-Decoupled (BX version)                         ]%           [   4 - Gauss Seidel                                        ]%       2  - PF_TOL, 1e-8           termination tolerance on per unit%                                   P & Q mismatch%       3  - PF_MAX_IT, 10          maximum number of iterations for%                                   Newton's method%       4  - PF_MAX_IT_FD, 30       maximum number of iterations for %                                   fast decoupled method%       5  - PF_MAX_IT_GS, 1000     maximum number of iterations for %                                   Gauss-Seidel method%       6  - ENFORCE_Q_LIMS, 0      enforce gen reactive power limits,%                                   at expense of |V|       [   0 or 1  ]%       10 - PF_DC, 0               use DC power flow formulation, for%                                   power flow and OPF%           [    0 - use AC formulation & corresponding algorithm opts  ]%           [    1 - use DC formulation, ignore AC algorithm options    ]%   OPF options%       11 - OPF_ALG, 0             algorithm to use for OPF%           [    0 - choose best default solver available in the        ]%           [        following order, 500, 520 then 100/200             ]%           [ Otherwise the first digit specifies the problem           ]%           [ formulation and the second specifies the solver,          ]%           [ as follows, (see the User's Manual for more details)      ]%           [  100 - standard formulation (old), constr                 ]%           [  120 - standard formulation (old), dense LP               ]%           [  140 - standard formulation (old), sparse LP (relaxed)    ]%           [  160 - standard formulation (old), sparse LP (full)       ]%           [  200 - CCV formulation (old), constr                      ]%           [  220 - CCV formulation (old), dense LP                    ]%           [  240 - CCV formulation (old), sparse LP (relaxed)         ]%           [  260 - CCV formulation (old), sparse LP (full)            ]%           [  500 - generalized formulation, MINOS                     ]%           [  520 - generalized formulation, fmincon                   ]%           [ See the User's Manual for details on the formulations.    ]%       12 - OPF_ALG_POLY, 100      default OPF algorithm for use with%                                   polynomial cost functions%                                   (used only if no solver available%                                   for generalized formulation)%       13 - OPF_ALG_PWL, 200       default OPF algorithm for use with%                                   piece-wise linear cost functions%                                   (used only if no solver available%                                   for generalized formulation)%       14 - OPF_POLY2PWL_PTS, 10   number of evaluation points to use%                                   when converting from polynomial to%                                   piece-wise linear costs%       16 - OPF_VIOLATION, 5e-6    constraint violation tolerance%       17 - CONSTR_TOL_X, 1e-4     termination tol on x for copf & fmincopf%       18 - CONSTR_TOL_F, 1e-4     termination tol on F for copf & fmincopf%       19 - CONSTR_MAX_IT, 0       max number of iterations for copf & fmincopf%                                   [       0 => 2*nb + 150             ]%       20 - LPC_TOL_GRAD, 3e-3     termination tolerance on gradient for lpopf%       21 - LPC_TOL_X, 1e-4        termination tolerance on x (min step size)%                                   for lpopf%       22 - LPC_MAX_IT, 400        maximum number of iterations for lpopf%       23 - LPC_MAX_RESTART, 5     maximum number of restarts for lpopf%       24 - OPF_P_LINE_LIM, 0      use active power instead of apparent power%                                   for line flow limits    [   0 or 1  ]%   output options%       31 - VERBOSE, 1             amount of progress info printed%           [   0 - print no progress info                              ]%           [   1 - print a little progress info                        ]%           [   2 - print a lot of progress info                        ]%           [   3 - print all progress info                             ]%       32 - OUT_ALL, -1            controls printing of results%           [  -1 - individual flags control what prints                ]%           [   0 - don't print anything                                ]%           [       (overrides individual flags, except OUT_RAW)        ]%           [   1 - print everything                                    ]%           [       (overrides individual flags, except OUT_RAW)        ]%       33 - OUT_SYS_SUM, 1         print system summary    [   0 or 1  ]%       34 - OUT_AREA_SUM, 0        print area summaries    [   0 or 1  ]%       35 - OUT_BUS, 1             print bus detail        [   0 or 1  ]%       36 - OUT_BRANCH, 1          print branch detail     [   0 or 1  ]%       37 - OUT_GEN, 0             print generator detail  [   0 or 1  ]%                                   (OUT_BUS also includes gen info)%       38 - OUT_ALL_LIM, -1        control constraint info output%           [  -1 - individual flags control what constraint info prints]%           [   0 - no constraint info (overrides individual flags)     ]%           [   1 - binding constraint info (overrides individual flags)]%           [   2 - all constraint info (overrides individual flags)    ]%       39 - OUT_V_LIM, 1           control output of voltage limit info%           [   0 - don't print                                         ]%           [   1 - print binding constraints only                      ]%           [   2 - print all constraints                               ]%           [   (same options for OUT_LINE_LIM, OUT_PG_LIM, OUT_QG_LIM) ]%       40 - OUT_LINE_LIM, 1        control output of line limit info%       41 - OUT_PG_LIM, 1          control output of gen P limit info%       42 - OUT_QG_LIM, 1          control output of gen Q limit info%       43 - OUT_RAW, 0             print raw data for Perl database%                                   interface code          [   0 or 1  ]%   other options%       51 - SPARSE_QP, 1           pass sparse matrices to QP and LP%                                   solvers if possible     [   0 or 1  ]%   MINOPF options%       61 - MNS_FEASTOL, 0 (1E-3)  primal feasibility tolerance,%                                   set to value of OPF_VIOLATION by default%       62 - MNS_ROWTOL, 0  (1E-3)  row tolerance%                                   set to value of OPF_VIOLATION by default%       63 - MNS_XTOL, 0     (1E-3) x tolerance%                                   set to value of CONSTR_TOL_X by default%       64 - MNS_MAJDAMP, 0 (0.5)   major damping parameter%       65 - MNS_MINDAMP, 0 (2.0)   minor damping parameter%       66 - MNS_PENALTY_PARM, 0 (1.0)  penalty parameter%       67 - MNS_MAJOR_IT, 0 (200)  major iterations%       68 - MNS_MINOR_IT, 0 (2500) minor iterations%       69 - MNS_MAX_IT, 0 (2500)   iterations limit%       70 - MNS_VERBOSITY, -1%           [  -1 - controlled by VERBOSE flag (0 or 1 below)           ]%           [   0 - print nothing                                       ]%           [   1 - print only termination status message               ]%           [   2 - print termination status and screen progress        ]%           [   3 - print screen progress, report file (usually fort.9) ]%       71 - MNS_CORE, 1200 * nb + 5000 %       72 - MNS_SUPBASIC_LIM, 0 (2*ng) superbasics limit%       73 - MNS_MULT_PRICE, 0 (30) multiple price%   MATPOWER%   $Id: mpoption.m,v 1.12 2005/01/18 22:48:31 ray Exp $%   by Ray Zimmerman, PSERC Cornell%   Copyright (c) 1996-2004 by Power System Engineering Research Center (PSERC)%   See http://www.pserc.cornell.edu/matpower/ for more info.%%-----  set up default option values  -----i = 1;if rem(nargin, 2)       %% odd number of arguments    options = p1;           %% base options vector passed in    i = 2;                  %% start processing parameters with 2nd oneelse                    %% even number of parameters    options = [             %% use defaults for base options vector            %% power flow options        1;      %% 1  - PF_ALG        1e-8;   %% 2  - PF_TOL        10;     %% 3  - PF_MAX_IT        30;     %% 4  - PF_MAX_IT_FD        1000;   %% 5  - PF_MAX_IT_GS        0;      %% 6  - ENFORCE_Q_LIMS        0;      %% 7  - RESERVED7        0;      %% 8  - RESERVED8        0;      %% 9  - RESERVED9        0;      %% 10 - PF_DC                %% OPF options        0;      %% 11 - OPF_ALG_POLY        100;    %% 12 - OPF_ALG_POLY        200;    %% 13 - OPF_ALG_PWL        10;     %% 14 - OPF_POLY2PWL_PTS        0;      %% 15 - OPF_NEQ, not a user option (number of eq constraints for                %%          copf, lpopf and dcopf algorithms, set by program)        5e-6;   %% 16 - OPF_VIOLATION        1e-4;   %% 17 - CONSTR_TOL_X        1e-4;   %% 18 - CONSTR_TOL_F        0;      %% 19 - CONSTR_MAX_IT        3e-3;   %% 20 - LPC_TOL_GRAD        1e-4;   %% 21 - LPC_TOL_X        400;    %% 22 - LPC_MAX_IT        5;      %% 23 - LPC_MAX_RESTART        0;      %% 24 - OPF_P_LINE_LIM        0;      %% 25 - RESERVED25        0;      %% 26 - RESERVED26        0;      %% 27 - RESERVED27