Home > matpower5.0 > mpoption_old.m

mpoption_old

PURPOSE ^

MPOPTION_OLD Used to set and retrieve old-style MATPOWER options vector.

SYNOPSIS ^

function [options, names] = mpoption_old(varargin)

DESCRIPTION ^

MPOPTION_OLD  Used to set and retrieve old-style MATPOWER options vector.

   OPT = MPOPTION_OLD
       returns the default options vector

   OPT = MPOPTION_OLD(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.

   OPT = MPOPTION_OLD(OPT, NAME1, VALUE1, NAME2, VALUE2, ...)
       same as above except it uses the options vector OPT as a base
       instead of the default options vector.

   Examples:
       opt = mpoption_old('PF_ALG', 2, 'PF_TOL', 1e-4);
       opt = mpoption_old(opt, 'OPF_ALG', 565, 'VERBOSE', 2);

   The currently defined options are as follows:

      idx - NAME, default          description [options]
      ---   -------------          -----------------------------------------
   power flow options
       1  - PF_ALG, 1              AC 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 - do NOT enforce limits                                  ]
           [    1 - enforce limits, simultaneous bus type conversion       ]
           [    2 - enforce limits, one-at-a-time bus type conversion      ]
       10 - PF_DC, 0               DC modeling for power flow & OPF
           [    0 - use AC formulation & corresponding algorithm options   ]
           [    1 - use DC formulation, ignore AC algorithm options        ]
   OPF options
       11 - OPF_ALG, 0             solver to use for AC OPF
           [    0 - choose default solver based on availability in the     ]
           [        following order, 540, 560                              ]
           [  500 - MINOPF, MINOS-based solver, requires optional          ]
           [        MEX-based MINOPF package, available from:              ]
           [        http://www.pserc.cornell.edu/minopf/                   ]
           [  520 - fmincon, MATLAB Optimization Toolbox >= 2.x            ]
           [  540 - PDIPM, primal/dual interior point method, requires     ]
           [        optional MEX-based TSPOPF package, available from:     ]
           [        http://www.pserc.cornell.edu/tspopf/                   ]
           [  545 - SC-PDIPM, step-controlled variant of PDIPM, requires   ]
           [        TSPOPF (see 540)                                       ]
           [  550 - TRALM, trust region based augmented Langrangian        ]
           [        method, requires TSPOPF (see 540)                      ]
           [  560 - MIPS, MATLAB Interior Point Solver                     ]
           [        primal/dual interior point method (pure MATLAB)        ]
           [  565 - MIPS-sc, step-controlled variant of MIPS               ]
           [        primal/dual interior point method (pure MATLAB)        ]
           [  580 - IPOPT, requires MEX interface to IPOPT solver          ]
           [        available from: https://projects.coin-or.org/Ipopt/    ]
           [  600 - KNITRO, requires MATLAB Optimization Toolbox and       ]
           [        KNITRO libraries available from: http://www.ziena.com/ ]
       16 - OPF_VIOLATION, 5e-6    constraint violation tolerance
       17 - CONSTR_TOL_X, 1e-4     termination tol on x for fmincon/Knitro
       18 - CONSTR_TOL_F, 1e-4     termination tol on f for fmincon/Knitro
       19 - CONSTR_MAX_IT, 0       max number of iterations for fmincon
                                   [       0 => default                    ]
       24 - OPF_FLOW_LIM, 0        qty to limit for branch flow constraints
           [   0 - apparent power flow (limit in MVA)                      ]
           [   1 - active power flow (limit in MW)                         ]
           [   2 - current magnitude (limit in MVA at 1 p.u. voltage)      ]
       25 - OPF_IGNORE_ANG_LIM, 0  ignore angle difference limits for branches
                                   even if specified           [   0 or 1  ]
       26 - OPF_ALG_DC, 0          solver to use for DC OPF
           [    0 - choose default solver based on availability in the     ]
           [        following order: 500, 600, 700, 100, 300, 200          ]
           [  100 - BPMPD, requires optional MEX-based BPMPD_MEX package   ]
           [        available from: http://www.pserc.cornell.edu/bpmpd/    ]
           [  200 - MIPS, MATLAB Interior Point Solver                     ]
           [        primal/dual interior point method (pure MATLAB)        ]
           [  250 - MIPS-sc, step-controlled variant of MIPS               ]
           [  300 - MATLAB Optimization Toolbox, QUADPROG, LINPROG         ]
           [  400 - IPOPT, requires MEX interface to IPOPT solver          ]
           [        available from: https://projects.coin-or.org/Ipopt/    ]
           [  500 - CPLEX, requires Matlab interface to CPLEX solver       ]
           [  600 - MOSEK, requires Matlab interface to MOSEK solver       ]
           [        available from: http://www.mosek.com/                  ]
           [  700 - GUROBI, requires Gurobi optimizer (v. 5+)              ]
           [        available from: http://www.gurobi.com/                 ]
   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 pretty-printing of results
           [  -1 - individual flags control what prints                    ]
           [   0 - do not print anything                                   ]
           [       (overrides individual flags)                            ]
           [   1 - print everything                                        ]
           [       (overrides individual flags)                            ]
       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        controls what constraint info is printed
           [  -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 - do not 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 flow 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
       44 - OUT_FORCE, 0           print results even if success = 0
                                                               [   0 or 1  ]
       52 - RETURN_RAW_DER, 0      return constraint and derivative info
                                   in results.raw (in fields g, dg, df, d2f)
   FMINCON options
       55 - FMC_ALG, 4             algorithm used by fmincon for OPF
                                   for Optimization Toolbox 4 and later
            [  1 - active-set                                              ]
            [  2 - interior-point, w/default 'bfgs' Hessian approx         ]
            [  3 - interior-point, w/ 'lbfgs' Hessian approx               ]
            [  4 - interior-point, w/exact user-supplied Hessian           ]
            [  5 - interior-point, w/Hessian via finite differences        ]

   KNITRO options
       58 - KNITRO_OPT, 0          a non-zero integer N indicates that all
                                   KNITRO options should be handled by a
                                   KNITRO options file named
                                   'knitro_user_options_N.txt'

   IPOPT options
       60 - IPOPT_OPT, 0           See IPOPT_OPTIONS for details.

   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 option                            ]
           [   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, 0 (1200 * nb + 2 * (nb + ng)^2) memory allocation
       72 - MNS_SUPBASIC_LIM, 0 (2*nb + 2*ng) superbasics limit
       73 - MNS_MULT_PRICE, 0 (30) multiple price

   MIPS (including MIPS-sc), PDIPM, SC-PDIPM, and TRALM options
       81 - PDIPM_FEASTOL, 0       feasibility (equality) tolerance
                                   for MIPS, PDIPM and SC-PDIPM, set
                                   to value of OPF_VIOLATION by default
       82 - PDIPM_GRADTOL, 1e-6    gradient tolerance for MIPS, PDIPM
                                   and SC-PDIPM
       83 - PDIPM_COMPTOL, 1e-6    complementary condition (inequality)
                                   tolerance for MIPS, PDIPM and SC-PDIPM
       84 - PDIPM_COSTTOL, 1e-6    optimality tolerance for MIPS, PDIPM
                                   and SC-PDIPM
       85 - PDIPM_MAX_IT,  150     maximum number of iterations for MIPS,
                                   PDIPM and SC-PDIPM
       86 - SCPDIPM_RED_IT, 20     maximum number of MIPS-sc or SC-PDIPM
                                   reductions per iteration
       87 - TRALM_FEASTOL, 0       feasibility tolerance for TRALM
                                   set to value of OPF_VIOLATION by default
       88 - TRALM_PRIMETOL, 5e-4   primal variable tolerance for TRALM
       89 - TRALM_DUALTOL, 5e-4    dual variable tolerance for TRALM
       90 - TRALM_COSTTOL, 1e-5    optimality tolerance for TRALM
       91 - TRALM_MAJOR_IT, 40     maximum number of major iterations
       92 - TRALM_MINOR_IT, 100    maximum number of minor iterations
       93 - SMOOTHING_RATIO, 0.04  piecewise linear curve smoothing ratio
                                   used in SC-PDIPM and TRALM

   CPLEX options
       95 - CPLEX_LPMETHOD, 0      solution algorithm for continuous LPs
           [   0 - automatic: let CPLEX choose                             ]
           [   1 - primal simplex                                          ]
           [   2 - dual simplex                                            ]
           [   3 - network simplex                                         ]
           [   4 - barrier                                                 ]
           [   5 - sifting                                                 ]
           [   6 - concurrent (dual, barrier, and primal)                  ]
       96 - CPLEX_QPMETHOD, 0      solution algorithm for continuous QPs
           [   0 - automatic: let CPLEX choose                             ]
           [   1 - primal simplex optimizer                                ]
           [   2 - dual simplex optimizer                                  ]
           [   3 - network optimizer                                       ]
           [   4 - barrier optimizer                                       ]
       97 - CPLEX_OPT, 0           See CPLEX_OPTIONS for details

   MOSEK options
       111 - MOSEK_LP_ALG, 0       solution algorithm for continuous LPs
                                       (MSK_IPAR_OPTIMIZER)
           [   0 - automatic: let MOSEK choose                             ]
           [   1 - interior point                                          ]
           [   4 - primal simplex                                          ]
           [   5 - dual simplex                                            ]
           [   6 - primal dual simplex                                     ]
           [   7 - automatic simplex (MOSEK chooses which simplex method)  ]
           [   10 - concurrent                                             ]
       112 - MOSEK_MAX_IT, 0 (400)     interior point max iterations
                                           (MSK_IPAR_INTPNT_MAX_ITERATIONS)
       113 - MOSEK_GAP_TOL, 0 (1e-8)   interior point relative gap tolerance
                                           (MSK_DPAR_INTPNT_TOL_REL_GAP)
       114 - MOSEK_MAX_TIME, 0 (-1)    maximum time allowed for solver
                                           (MSK_DPAR_OPTIMIZER_MAX_TIME)
       115 - MOSEK_NUM_THREADS, 0 (1)  maximum number of threads to use
                                           (MSK_IPAR_INTPNT_NUM_THREADS)
       116 - MOSEK_OPT, 0              See MOSEK_OPTIONS for details

   Gurobi options
       121 - GRB_METHOD, -1         solution algorithm (Method)
           [  -1 - automatic, let Gurobi decide                            ]
           [   0 - primal simplex                                          ]
           [   1 - dual simplex                                            ]
           [   2 - barrier                                                 ]
           [   3 - concurrent (LP only)                                    ]
           [   4 - deterministic concurrent (LP only)                      ]
       122 - GRB_TIMELIMIT, Inf    maximum time allowed for solver (TimeLimit)
       123 - GRB_THREADS, 0 (auto) maximum number of threads to use (Threads)
       124 - GRB_OPT, 0            See GUROBI_OPTIONS for details

CROSS-REFERENCE INFORMATION ^

This function calls: This function is called by:

SOURCE CODE ^

0001 function [options, names] = mpoption_old(varargin)
0002 %MPOPTION_OLD  Used to set and retrieve old-style MATPOWER options vector.
0003 %
0004 %   OPT = MPOPTION_OLD
0005 %       returns the default options vector
0006 %
0007 %   OPT = MPOPTION_OLD(NAME1, VALUE1, NAME2, VALUE2, ...)
0008 %       returns the default options vector with new values for up to 7
0009 %       options, NAME# is the name of an option, and VALUE# is the new
0010 %       value.
0011 %
0012 %   OPT = MPOPTION_OLD(OPT, NAME1, VALUE1, NAME2, VALUE2, ...)
0013 %       same as above except it uses the options vector OPT as a base
0014 %       instead of the default options vector.
0015 %
0016 %   Examples:
0017 %       opt = mpoption_old('PF_ALG', 2, 'PF_TOL', 1e-4);
0018 %       opt = mpoption_old(opt, 'OPF_ALG', 565, 'VERBOSE', 2);
0019 %
0020 %   The currently defined options are as follows:
0021 %
0022 %      idx - NAME, default          description [options]
0023 %      ---   -------------          -----------------------------------------
0024 %   power flow options
0025 %       1  - PF_ALG, 1              AC power flow algorithm
0026 %           [   1 - Newton's method                                         ]
0027 %           [   2 - Fast-Decoupled (XB version)                             ]
0028 %           [   3 - Fast-Decoupled (BX version)                             ]
0029 %           [   4 - Gauss-Seidel                                            ]
0030 %       2  - PF_TOL, 1e-8           termination tolerance on per unit
0031 %                                   P & Q mismatch
0032 %       3  - PF_MAX_IT, 10          maximum number of iterations for
0033 %                                   Newton's method
0034 %       4  - PF_MAX_IT_FD, 30       maximum number of iterations for
0035 %                                   fast decoupled method
0036 %       5  - PF_MAX_IT_GS, 1000     maximum number of iterations for
0037 %                                   Gauss-Seidel method
0038 %       6  - ENFORCE_Q_LIMS, 0      enforce gen reactive power limits
0039 %                                   at expense of |V|
0040 %           [    0 - do NOT enforce limits                                  ]
0041 %           [    1 - enforce limits, simultaneous bus type conversion       ]
0042 %           [    2 - enforce limits, one-at-a-time bus type conversion      ]
0043 %       10 - PF_DC, 0               DC modeling for power flow & OPF
0044 %           [    0 - use AC formulation & corresponding algorithm options   ]
0045 %           [    1 - use DC formulation, ignore AC algorithm options        ]
0046 %   OPF options
0047 %       11 - OPF_ALG, 0             solver to use for AC OPF
0048 %           [    0 - choose default solver based on availability in the     ]
0049 %           [        following order, 540, 560                              ]
0050 %           [  500 - MINOPF, MINOS-based solver, requires optional          ]
0051 %           [        MEX-based MINOPF package, available from:              ]
0052 %           [        http://www.pserc.cornell.edu/minopf/                   ]
0053 %           [  520 - fmincon, MATLAB Optimization Toolbox >= 2.x            ]
0054 %           [  540 - PDIPM, primal/dual interior point method, requires     ]
0055 %           [        optional MEX-based TSPOPF package, available from:     ]
0056 %           [        http://www.pserc.cornell.edu/tspopf/                   ]
0057 %           [  545 - SC-PDIPM, step-controlled variant of PDIPM, requires   ]
0058 %           [        TSPOPF (see 540)                                       ]
0059 %           [  550 - TRALM, trust region based augmented Langrangian        ]
0060 %           [        method, requires TSPOPF (see 540)                      ]
0061 %           [  560 - MIPS, MATLAB Interior Point Solver                     ]
0062 %           [        primal/dual interior point method (pure MATLAB)        ]
0063 %           [  565 - MIPS-sc, step-controlled variant of MIPS               ]
0064 %           [        primal/dual interior point method (pure MATLAB)        ]
0065 %           [  580 - IPOPT, requires MEX interface to IPOPT solver          ]
0066 %           [        available from: https://projects.coin-or.org/Ipopt/    ]
0067 %           [  600 - KNITRO, requires MATLAB Optimization Toolbox and       ]
0068 %           [        KNITRO libraries available from: http://www.ziena.com/ ]
0069 %       16 - OPF_VIOLATION, 5e-6    constraint violation tolerance
0070 %       17 - CONSTR_TOL_X, 1e-4     termination tol on x for fmincon/Knitro
0071 %       18 - CONSTR_TOL_F, 1e-4     termination tol on f for fmincon/Knitro
0072 %       19 - CONSTR_MAX_IT, 0       max number of iterations for fmincon
0073 %                                   [       0 => default                    ]
0074 %       24 - OPF_FLOW_LIM, 0        qty to limit for branch flow constraints
0075 %           [   0 - apparent power flow (limit in MVA)                      ]
0076 %           [   1 - active power flow (limit in MW)                         ]
0077 %           [   2 - current magnitude (limit in MVA at 1 p.u. voltage)      ]
0078 %       25 - OPF_IGNORE_ANG_LIM, 0  ignore angle difference limits for branches
0079 %                                   even if specified           [   0 or 1  ]
0080 %       26 - OPF_ALG_DC, 0          solver to use for DC OPF
0081 %           [    0 - choose default solver based on availability in the     ]
0082 %           [        following order: 500, 600, 700, 100, 300, 200          ]
0083 %           [  100 - BPMPD, requires optional MEX-based BPMPD_MEX package   ]
0084 %           [        available from: http://www.pserc.cornell.edu/bpmpd/    ]
0085 %           [  200 - MIPS, MATLAB Interior Point Solver                     ]
0086 %           [        primal/dual interior point method (pure MATLAB)        ]
0087 %           [  250 - MIPS-sc, step-controlled variant of MIPS               ]
0088 %           [  300 - MATLAB Optimization Toolbox, QUADPROG, LINPROG         ]
0089 %           [  400 - IPOPT, requires MEX interface to IPOPT solver          ]
0090 %           [        available from: https://projects.coin-or.org/Ipopt/    ]
0091 %           [  500 - CPLEX, requires Matlab interface to CPLEX solver       ]
0092 %           [  600 - MOSEK, requires Matlab interface to MOSEK solver       ]
0093 %           [        available from: http://www.mosek.com/                  ]
0094 %           [  700 - GUROBI, requires Gurobi optimizer (v. 5+)              ]
0095 %           [        available from: http://www.gurobi.com/                 ]
0096 %   output options
0097 %       31 - VERBOSE, 1             amount of progress info printed
0098 %           [   0 - print no progress info                                  ]
0099 %           [   1 - print a little progress info                            ]
0100 %           [   2 - print a lot of progress info                            ]
0101 %           [   3 - print all progress info                                 ]
0102 %       32 - OUT_ALL, -1            controls pretty-printing of results
0103 %           [  -1 - individual flags control what prints                    ]
0104 %           [   0 - do not print anything                                   ]
0105 %           [       (overrides individual flags)                            ]
0106 %           [   1 - print everything                                        ]
0107 %           [       (overrides individual flags)                            ]
0108 %       33 - OUT_SYS_SUM, 1         print system summary        [   0 or 1  ]
0109 %       34 - OUT_AREA_SUM, 0        print area summaries        [   0 or 1  ]
0110 %       35 - OUT_BUS, 1             print bus detail            [   0 or 1  ]
0111 %       36 - OUT_BRANCH, 1          print branch detail         [   0 or 1  ]
0112 %       37 - OUT_GEN, 0             print generator detail      [   0 or 1  ]
0113 %                                   (OUT_BUS also includes gen info)
0114 %       38 - OUT_ALL_LIM, -1        controls what constraint info is printed
0115 %           [  -1 - individual flags control what constraint info prints    ]
0116 %           [   0 - no constraint info (overrides individual flags)         ]
0117 %           [   1 - binding constraint info (overrides individual flags)    ]
0118 %           [   2 - all constraint info (overrides individual flags)        ]
0119 %       39 - OUT_V_LIM, 1           control output of voltage limit info
0120 %           [   0 - do not print                                            ]
0121 %           [   1 - print binding constraints only                          ]
0122 %           [   2 - print all constraints                                   ]
0123 %           [   (same options for OUT_LINE_LIM, OUT_PG_LIM, OUT_QG_LIM)     ]
0124 %       40 - OUT_LINE_LIM, 1        control output of line flow limit info
0125 %       41 - OUT_PG_LIM, 1          control output of gen P limit info
0126 %       42 - OUT_QG_LIM, 1          control output of gen Q limit info
0127 %       44 - OUT_FORCE, 0           print results even if success = 0
0128 %                                                               [   0 or 1  ]
0129 %       52 - RETURN_RAW_DER, 0      return constraint and derivative info
0130 %                                   in results.raw (in fields g, dg, df, d2f)
0131 %   FMINCON options
0132 %       55 - FMC_ALG, 4             algorithm used by fmincon for OPF
0133 %                                   for Optimization Toolbox 4 and later
0134 %            [  1 - active-set                                              ]
0135 %            [  2 - interior-point, w/default 'bfgs' Hessian approx         ]
0136 %            [  3 - interior-point, w/ 'lbfgs' Hessian approx               ]
0137 %            [  4 - interior-point, w/exact user-supplied Hessian           ]
0138 %            [  5 - interior-point, w/Hessian via finite differences        ]
0139 %
0140 %   KNITRO options
0141 %       58 - KNITRO_OPT, 0          a non-zero integer N indicates that all
0142 %                                   KNITRO options should be handled by a
0143 %                                   KNITRO options file named
0144 %                                   'knitro_user_options_N.txt'
0145 %
0146 %   IPOPT options
0147 %       60 - IPOPT_OPT, 0           See IPOPT_OPTIONS for details.
0148 %
0149 %   MINOPF options
0150 %       61 - MNS_FEASTOL, 0 (1e-3)  primal feasibility tolerance,
0151 %                                   set to value of OPF_VIOLATION by default
0152 %       62 - MNS_ROWTOL, 0  (1e-3)  row tolerance
0153 %                                   set to value of OPF_VIOLATION by default
0154 %       63 - MNS_XTOL, 0    (1e-3)  x tolerance
0155 %                                   set to value of CONSTR_TOL_X by default
0156 %       64 - MNS_MAJDAMP, 0 (0.5)   major damping parameter
0157 %       65 - MNS_MINDAMP, 0 (2.0)   minor damping parameter
0158 %       66 - MNS_PENALTY_PARM, 0 (1.0)  penalty parameter
0159 %       67 - MNS_MAJOR_IT, 0 (200)  major iterations
0160 %       68 - MNS_MINOR_IT, 0 (2500) minor iterations
0161 %       69 - MNS_MAX_IT, 0 (2500)   iterations limit
0162 %       70 - MNS_VERBOSITY, -1
0163 %           [  -1 - controlled by VERBOSE option                            ]
0164 %           [   0 - print nothing                                           ]
0165 %           [   1 - print only termination status message                   ]
0166 %           [   2 - print termination status and screen progress            ]
0167 %           [   3 - print screen progress, report file (usually fort.9)     ]
0168 %       71 - MNS_CORE, 0 (1200 * nb + 2 * (nb + ng)^2) memory allocation
0169 %       72 - MNS_SUPBASIC_LIM, 0 (2*nb + 2*ng) superbasics limit
0170 %       73 - MNS_MULT_PRICE, 0 (30) multiple price
0171 %
0172 %   MIPS (including MIPS-sc), PDIPM, SC-PDIPM, and TRALM options
0173 %       81 - PDIPM_FEASTOL, 0       feasibility (equality) tolerance
0174 %                                   for MIPS, PDIPM and SC-PDIPM, set
0175 %                                   to value of OPF_VIOLATION by default
0176 %       82 - PDIPM_GRADTOL, 1e-6    gradient tolerance for MIPS, PDIPM
0177 %                                   and SC-PDIPM
0178 %       83 - PDIPM_COMPTOL, 1e-6    complementary condition (inequality)
0179 %                                   tolerance for MIPS, PDIPM and SC-PDIPM
0180 %       84 - PDIPM_COSTTOL, 1e-6    optimality tolerance for MIPS, PDIPM
0181 %                                   and SC-PDIPM
0182 %       85 - PDIPM_MAX_IT,  150     maximum number of iterations for MIPS,
0183 %                                   PDIPM and SC-PDIPM
0184 %       86 - SCPDIPM_RED_IT, 20     maximum number of MIPS-sc or SC-PDIPM
0185 %                                   reductions per iteration
0186 %       87 - TRALM_FEASTOL, 0       feasibility tolerance for TRALM
0187 %                                   set to value of OPF_VIOLATION by default
0188 %       88 - TRALM_PRIMETOL, 5e-4   primal variable tolerance for TRALM
0189 %       89 - TRALM_DUALTOL, 5e-4    dual variable tolerance for TRALM
0190 %       90 - TRALM_COSTTOL, 1e-5    optimality tolerance for TRALM
0191 %       91 - TRALM_MAJOR_IT, 40     maximum number of major iterations
0192 %       92 - TRALM_MINOR_IT, 100    maximum number of minor iterations
0193 %       93 - SMOOTHING_RATIO, 0.04  piecewise linear curve smoothing ratio
0194 %                                   used in SC-PDIPM and TRALM
0195 %
0196 %   CPLEX options
0197 %       95 - CPLEX_LPMETHOD, 0      solution algorithm for continuous LPs
0198 %           [   0 - automatic: let CPLEX choose                             ]
0199 %           [   1 - primal simplex                                          ]
0200 %           [   2 - dual simplex                                            ]
0201 %           [   3 - network simplex                                         ]
0202 %           [   4 - barrier                                                 ]
0203 %           [   5 - sifting                                                 ]
0204 %           [   6 - concurrent (dual, barrier, and primal)                  ]
0205 %       96 - CPLEX_QPMETHOD, 0      solution algorithm for continuous QPs
0206 %           [   0 - automatic: let CPLEX choose                             ]
0207 %           [   1 - primal simplex optimizer                                ]
0208 %           [   2 - dual simplex optimizer                                  ]
0209 %           [   3 - network optimizer                                       ]
0210 %           [   4 - barrier optimizer                                       ]
0211 %       97 - CPLEX_OPT, 0           See CPLEX_OPTIONS for details
0212 %
0213 %   MOSEK options
0214 %       111 - MOSEK_LP_ALG, 0       solution algorithm for continuous LPs
0215 %                                       (MSK_IPAR_OPTIMIZER)
0216 %           [   0 - automatic: let MOSEK choose                             ]
0217 %           [   1 - interior point                                          ]
0218 %           [   4 - primal simplex                                          ]
0219 %           [   5 - dual simplex                                            ]
0220 %           [   6 - primal dual simplex                                     ]
0221 %           [   7 - automatic simplex (MOSEK chooses which simplex method)  ]
0222 %           [   10 - concurrent                                             ]
0223 %       112 - MOSEK_MAX_IT, 0 (400)     interior point max iterations
0224 %                                           (MSK_IPAR_INTPNT_MAX_ITERATIONS)
0225 %       113 - MOSEK_GAP_TOL, 0 (1e-8)   interior point relative gap tolerance
0226 %                                           (MSK_DPAR_INTPNT_TOL_REL_GAP)
0227 %       114 - MOSEK_MAX_TIME, 0 (-1)    maximum time allowed for solver
0228 %                                           (MSK_DPAR_OPTIMIZER_MAX_TIME)
0229 %       115 - MOSEK_NUM_THREADS, 0 (1)  maximum number of threads to use
0230 %                                           (MSK_IPAR_INTPNT_NUM_THREADS)
0231 %       116 - MOSEK_OPT, 0              See MOSEK_OPTIONS for details
0232 %
0233 %   Gurobi options
0234 %       121 - GRB_METHOD, -1         solution algorithm (Method)
0235 %           [  -1 - automatic, let Gurobi decide                            ]
0236 %           [   0 - primal simplex                                          ]
0237 %           [   1 - dual simplex                                            ]
0238 %           [   2 - barrier                                                 ]
0239 %           [   3 - concurrent (LP only)                                    ]
0240 %           [   4 - deterministic concurrent (LP only)                      ]
0241 %       122 - GRB_TIMELIMIT, Inf    maximum time allowed for solver (TimeLimit)
0242 %       123 - GRB_THREADS, 0 (auto) maximum number of threads to use (Threads)
0243 %       124 - GRB_OPT, 0            See GUROBI_OPTIONS for details
0244 
0245 %   MATPOWER
0246 %   $Id: mpoption_old.m 2229 2013-12-11 01:28:09Z ray $
0247 %   by Ray Zimmerman, PSERC Cornell
0248 %   Copyright (c) 1996-2013 by Power System Engineering Research Center (PSERC)
0249 %
0250 %   This file is part of MATPOWER.
0251 %   See http://www.pserc.cornell.edu/matpower/ for more info.
0252 %
0253 %   MATPOWER is free software: you can redistribute it and/or modify
0254 %   it under the terms of the GNU General Public License as published
0255 %   by the Free Software Foundation, either version 3 of the License,
0256 %   or (at your option) any later version.
0257 %
0258 %   MATPOWER is distributed in the hope that it will be useful,
0259 %   but WITHOUT ANY WARRANTY; without even the implied warranty of
0260 %   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
0261 %   GNU General Public License for more details.
0262 %
0263 %   You should have received a copy of the GNU General Public License
0264 %   along with MATPOWER. If not, see <http://www.gnu.org/licenses/>.
0265 %
0266 %   Additional permission under GNU GPL version 3 section 7
0267 %
0268 %   If you modify MATPOWER, or any covered work, to interface with
0269 %   other modules (such as MATLAB code and MEX-files) available in a
0270 %   MATLAB(R) or comparable environment containing parts covered
0271 %   under other licensing terms, the licensors of MATPOWER grant
0272 %   you additional permission to convey the resulting work.
0273 
0274 %%-----  set up default option values  -----
0275 i = 1;
0276 if rem(nargin, 2)       %% odd number of arguments
0277     options = varargin{1};  %% base options vector passed in
0278     i = 2;                  %% start processing parameters with 2nd one
0279 else                    %% even number of parameters
0280     options = [             %% use defaults for base options vector
0281     
0282         %% power flow options
0283         1;      %% 1  - PF_ALG
0284         1e-8;   %% 2  - PF_TOL
0285         10;     %% 3  - PF_MAX_IT
0286         30;     %% 4  - PF_MAX_IT_FD
0287         1000;   %% 5  - PF_MAX_IT_GS
0288         0;      %% 6  - ENFORCE_Q_LIMS
0289         0;      %% 7  - RESERVED7
0290         0;      %% 8  - RESERVED8
0291         0;      %% 9  - RESERVED9
0292         0;      %% 10 - PF_DC
0293         
0294         %% OPF options
0295         0;      %% 11 - OPF_ALG
0296         0;      %% 12 - RESERVED12 (was OPF_ALG_POLY = 100)
0297         0;      %% 13 - RESERVED13 (was OPF_ALG_PWL = 200)
0298         0;      %% 14 - RESERVED14 (was OPF_POLY2PWL_PTS = 10)
0299         0;      %% 15 - OPF_NEQ (removed)
0300         5e-6;   %% 16 - OPF_VIOLATION
0301         1e-4;   %% 17 - CONSTR_TOL_X
0302         1e-4;   %% 18 - CONSTR_TOL_F
0303         0;      %% 19 - CONSTR_MAX_IT
0304         3e-3;   %% 20 - LPC_TOL_GRAD (removed)
0305         1e-4;   %% 21 - LPC_TOL_X (removed)
0306         400;    %% 22 - LPC_MAX_IT (removed)
0307         5;      %% 23 - LPC_MAX_RESTART (removed)
0308         0;      %% 24 - OPF_FLOW_LIM
0309         0;      %% 25 - OPF_IGNORE_ANG_LIM
0310         0;      %% 26 - OPF_ALG_DC
0311         0;      %% 27 - RESERVED27
0312         0;      %% 28 - RESERVED28
0313         0;      %% 29 - RESERVED29
0314         0;      %% 30 - RESERVED30
0315         
0316         %% output options
0317         1;      %% 31 - VERBOSE
0318         -1;     %% 32 - OUT_ALL
0319         1;      %% 33 - OUT_SYS_SUM
0320         0;      %% 34 - OUT_AREA_SUM
0321         1;      %% 35 - OUT_BUS
0322         1;      %% 36 - OUT_BRANCH
0323         0;      %% 37 - OUT_GEN
0324         -1;     %% 38 - OUT_ALL_LIM
0325         1;      %% 39 - OUT_V_LIM
0326         1;      %% 40 - OUT_LINE_LIM
0327         1;      %% 41 - OUT_PG_LIM
0328         1;      %% 42 - OUT_QG_LIM
0329         0;      %% 43 - RESERVED43 (was OUT_RAW)
0330         0;      %% 44 - OUT_FORCE
0331         0;      %% 45 - RESERVED45
0332         0;      %% 46 - RESERVED46
0333         0;      %% 47 - RESERVED47
0334         0;      %% 48 - RESERVED48
0335         0;      %% 49 - RESERVED49
0336         0;      %% 50 - RESERVED50
0337         
0338         %% other options
0339         1;      %% 51 - SPARSE_QP (removed)
0340         0;      %% 52 - RETURN_RAW_DER
0341         0;      %% 53 - RESERVED53
0342         0;      %% 54 - RESERVED54
0343         4;      %% 55 - FMC_ALG
0344         0;      %% 56 - RESERVED56
0345         0;      %% 57 - RESERVED57
0346         0;      %% 58 - KNITRO_OPT
0347         0;      %% 59 - RESERVED59
0348         0;      %% 60 - IPOPT_OPT
0349         
0350         %% MINOPF options
0351         0;      %% 61 - MNS_FEASTOL
0352         0;      %% 62 - MNS_ROWTOL
0353         0;      %% 63 - MNS_XTOL
0354         0;      %% 64 - MNS_MAJDAMP
0355         0;      %% 65 - MNS_MINDAMP
0356         0;      %% 66 - MNS_PENALTY_PARM
0357         0;      %% 67 - MNS_MAJOR_IT
0358         0;      %% 68 - MNS_MINOR_IT
0359         0;      %% 69 - MNS_MAX_IT
0360         -1;     %% 70 - MNS_VERBOSITY
0361         0;      %% 71 - MNS_CORE
0362         0;      %% 72 - MNS_SUPBASIC_LIM
0363         0;      %% 73 - MNS_MULT_PRICE
0364         0;      %% 74 - RESERVED74
0365         0;      %% 75 - RESERVED75
0366         0;      %% 76 - RESERVED76
0367         0;      %% 77 - RESERVED77
0368         0;      %% 78 - RESERVED78
0369         0;      %% 79 - RESERVED79
0370         0;      %% 80 - FORCE_PC_EQ_P0, for c3sopf
0371         
0372         %% MIPS, PDIPM, SC-PDIPM, and TRALM options
0373         0;      %% 81 - PDIPM_FEASTOL
0374         1e-6;   %% 82 - PDIPM_GRADTOL
0375         1e-6;   %% 83 - PDIPM_COMPTOL
0376         1e-6;   %% 84 - PDIPM_COSTTOL
0377         150;    %% 85 - PDIPM_MAX_IT
0378         20;     %% 86 - SCPDIPM_RED_IT
0379         0;      %% 87 - TRALM_FEASTOL
0380         5e-4;   %% 88 - TRALM_PRIMETOL
0381         5e-4;   %% 89 - TRALM_DUALTOL
0382         1e-5;   %% 90 - TRALM_COSTTOL
0383         40;     %% 91 - TRALM_MAJOR_IT
0384         100;    %% 92 - TRALM_MINOR_IT
0385         0.04;   %% 93 - SMOOTHING_RATIO
0386         0;      %% 94 - RESERVED94
0387         
0388         %% CPLEX options
0389         0;      %% 95 - CPLEX_LPMETHOD
0390         0;      %% 96 - CPLEX_QPMETHOD
0391         0;      %% 97 - CPLEX_OPT
0392         0;      %% 98 - RESERVED98
0393         0;      %% 99 - RESERVED99
0394         0;      %% 100 - RESERVED100
0395         0;      %% 101 - RESERVED101
0396         0;      %% 102 - RESERVED102
0397         0;      %% 103 - RESERVED103
0398         0;      %% 104 - RESERVED104
0399         0;      %% 105 - RESERVED105
0400         0;      %% 106 - RESERVED106
0401         0;      %% 107 - RESERVED107
0402         0;      %% 108 - RESERVED108
0403         0;      %% 109 - RESERVED109
0404         0;      %% 110 - RESERVED110
0405 
0406         %% MOSEK options
0407         0;      %% 111 - MOSEK_LP_ALG
0408         0;      %% 112 - MOSEK_MAX_IT
0409         0;      %% 113 - MOSEK_GAP_TOL
0410         0;      %% 114 - MOSEK_MAX_TIME
0411         0;      %% 115 - MOSEK_NUM_THREADS
0412         0;      %% 116 - MOSEK_OPT
0413         0;      %% 117 - RESERVED117
0414         0;      %% 118 - RESERVED118
0415         0;      %% 119 - RESERVED119
0416         0;      %% 120 - RESERVED120
0417 
0418         %% Gurobi options
0419         -1;     %% 121 - GRB_METHOD
0420         Inf;    %% 122 - GRB_TIMELIMIT
0421         0;      %% 123 - GRB_THREADS
0422         0;      %% 124 - GRB_OPT
0423     ];
0424 end
0425 
0426 %%-----  set up option names  -----
0427 %% power flow options
0428 names = char(   'PF_ALG', ...               %% 1
0429                 'PF_TOL', ...               %% 2
0430                 'PF_MAX_IT', ...            %% 3
0431                 'PF_MAX_IT_FD', ...         %% 4
0432                 'PF_MAX_IT_GS', ...         %% 5
0433                 'ENFORCE_Q_LIMS', ...       %% 6
0434                 'RESERVED7', ...            %% 7
0435                 'RESERVED8', ...            %% 8
0436                 'RESERVED9', ...            %% 9
0437                 'PF_DC' );                  %% 10
0438 
0439 %% OPF options
0440 names = char(   names, ...
0441                 'OPF_ALG', ...              %% 11
0442                 'RESERVED12', ...           %% 12   (was OPF_ALG_POLY)
0443                 'RESERVED13', ...           %% 13   (was OPF_ALG_PWL)
0444                 'RESERVED14', ...           %% 14   (was OPF_POLY2PWL_PTS)
0445                 'OPF_NEQ', ...              %% 15   (removed)
0446                 'OPF_VIOLATION', ...        %% 16
0447                 'CONSTR_TOL_X', ...         %% 17
0448                 'CONSTR_TOL_F', ...         %% 18
0449                 'CONSTR_MAX_IT', ...        %% 19
0450                 'LPC_TOL_GRAD'  );          %% 20   (removed)
0451 names = char(   names, ...
0452                 'LPC_TOL_X', ...            %% 21   (removed)
0453                 'LPC_MAX_IT', ...           %% 22   (removed)
0454                 'LPC_MAX_RESTART', ...      %% 23   (removed)
0455                 'OPF_FLOW_LIM', ...         %% 24
0456                 'OPF_IGNORE_ANG_LIM', ...   %% 25
0457                 'OPF_ALG_DC', ...           %% 26
0458                 'RESERVED27', ...           %% 27
0459                 'RESERVED28', ...           %% 28
0460                 'RESERVED29', ...           %% 29
0461                 'RESERVED30'    );          %% 30
0462 
0463 %% output options
0464 names = char(   names, ...
0465                 'VERBOSE', ...              %% 31
0466                 'OUT_ALL', ...              %% 32
0467                 'OUT_SYS_SUM', ...          %% 33
0468                 'OUT_AREA_SUM', ...         %% 34
0469                 'OUT_BUS', ...              %% 35
0470                 'OUT_BRANCH', ...           %% 36
0471                 'OUT_GEN', ...              %% 37
0472                 'OUT_ALL_LIM', ...          %% 38
0473                 'OUT_V_LIM', ...            %% 39
0474                 'OUT_LINE_LIM'  );          %% 40
0475 names = char(   names, ...
0476                 'OUT_PG_LIM', ...           %% 41
0477                 'OUT_QG_LIM', ...           %% 42
0478                 'RESERVED43', ...           %% 43 (was OUT_RAW)
0479                 'OUT_FORCE', ...            %% 44
0480                 'RESERVED45', ...           %% 45
0481                 'RESERVED46', ...           %% 46
0482                 'RESERVED47', ...           %% 47
0483                 'RESERVED48', ...           %% 48
0484                 'RESERVED49', ...           %% 49
0485                 'RESERVED50'    );          %% 50
0486 %% other options
0487 names = char(   names, ...
0488                 'SPARSE_QP', ...            %% 51   (removed)
0489                 'RETURN_RAW_DER', ...       %% 52
0490                 'RESERVED53', ...           %% 53
0491                 'RESERVED54', ...           %% 54
0492                 'FMC_ALG', ...              %% 55
0493                 'RESERVED56', ...           %% 56
0494                 'RESERVED57', ...           %% 57
0495                 'KNITRO_OPT', ...           %% 58
0496                 'RESERVED59', ...           %% 59
0497                 'IPOPT_OPT'     );          %% 60
0498 %% MINOS options
0499 names = char(   names, ...
0500                 'MNS_FEASTOL', ...          %% 61
0501                 'MNS_ROWTOL', ...           %% 62
0502                 'MNS_XTOL', ...             %% 63
0503                 'MNS_MAJDAMP', ...          %% 64
0504                 'MNS_MINDAMP', ...          %% 65
0505                 'MNS_PENALTY_PARM', ...     %% 66
0506                 'MNS_MAJOR_IT', ...         %% 67
0507                 'MNS_MINOR_IT', ...         %% 68
0508                 'MNS_MAX_IT', ...           %% 69
0509                 'MNS_VERBOSITY' );          %% 70
0510 %% other flags
0511 names = char(   names, ...
0512                 'MNS_CORE', ...             %% 71
0513                 'MNS_SUPBASIC_LIM', ...     %% 72
0514                 'MNS_MULT_PRICE', ...       %% 73
0515                 'RESERVED74', ...           %% 74
0516                 'RESERVED75', ...           %% 75
0517                 'RESERVED76', ...           %% 76
0518                 'RESERVED77', ...           %% 77
0519                 'RESERVED78', ...           %% 78
0520                 'RESERVED79', ...           %% 79
0521                 'FORCE_PC_EQ_P0'    );      %% 80
0522 
0523 %% MIPS, PDIPM, SC-PDIPM, and TRALM options
0524 names = char(   names, ...
0525                 'PDIPM_FEASTOL', ...        %% 81
0526                 'PDIPM_GRADTOL', ...        %% 82
0527                 'PDIPM_COMPTOL', ...        %% 83
0528                 'PDIPM_COSTTOL', ...        %% 84
0529                 'PDIPM_MAX_IT', ...         %% 85
0530                 'SCPDIPM_RED_IT', ...       %% 86
0531                 'TRALM_FEASTOL', ...        %% 87
0532                 'TRALM_PRIMETOL', ...       %% 88
0533                 'TRALM_DUALTOL', ...        %% 89
0534                 'TRALM_COSTTOL', ...        %% 90
0535                 'TRALM_MAJOR_IT', ...       %% 91
0536                 'TRALM_MINOR_IT', ...       %% 92
0537                 'SMOOTHING_RATIO'   );      %% 93
0538 
0539 %% CPLEX options
0540 names = char(   names, ...
0541                 'RESERVED94', ...           %% 94
0542                 'CPLEX_LPMETHOD', ...       %% 95
0543                 'CPLEX_QPMETHOD', ...       %% 96
0544                 'CPLEX_OPT', ...            %% 97
0545                 'RESERVED98', ...           %% 98
0546                 'RESERVED99', ...           %% 99
0547                 'RESERVED100', ...          %% 100
0548                 'RESERVED101', ...          %% 101
0549                 'RESERVED102', ...          %% 102
0550                 'RESERVED103', ...          %% 103
0551                 'RESERVED104', ...          %% 104
0552                 'RESERVED105', ...          %% 105
0553                 'RESERVED106', ...          %% 106
0554                 'RESERVED107', ...          %% 107
0555                 'RESERVED108', ...          %% 108
0556                 'RESERVED109', ...          %% 109
0557                 'RESERVED110'   );          %% 110
0558 
0559 %% MOSEK options
0560 names = char(   names, ...
0561                 'MOSEK_LP_ALG', ...         %% 111
0562                 'MOSEK_MAX_IT', ...         %% 112
0563                 'MOSEK_GAP_TOL', ...        %% 113
0564                 'MOSEK_MAX_TIME', ...       %% 114
0565                 'MOSEK_NUM_THREADS', ...    %% 115
0566                 'MOSEK_OPT', ...            %% 116
0567                 'RESERVED117', ...          %% 117
0568                 'RESERVED118', ...          %% 118
0569                 'RESERVED119', ...          %% 119
0570                 'RESERVED120'   );          %% 120
0571 
0572 %% Gurobi options
0573 names = char(   names, ...
0574                 'GRB_METHOD', ...           %% 121
0575                 'GRB_TIMELIMIT', ...        %% 122
0576                 'GRB_THREADS', ...          %% 123
0577                 'GRB_OPT'   );              %% 124
0578 
0579 %%-----  process parameters  -----
0580 while i <= nargin
0581     %% get parameter name and value
0582     pname = varargin{i};
0583     pval  = varargin{i+1};
0584     
0585     %% get parameter index
0586     namestr = names';
0587     namestr = namestr(:)';
0588     namelen = size(names, 2);
0589     pidx = ceil(findstr([pname blanks(namelen-length(pname))], namestr) / namelen);
0590     if isempty(pidx)
0591         error('"%s" is not a valid named option', pname);
0592     end
0593     % fprintf('''%s'' (%d) = %d\n', pname, pidx, pval);
0594 
0595     %% update option
0596     options(pidx) = pval;
0597 
0598     i = i + 2;                              %% go to next parameter
0599 end

Generated on Mon 26-Jan-2015 15:21:31 by m2html © 2005