mpoption_info_knitro

MPOPTION_INFO_KNITRO  Returns MATPOWER option info for KNITRO.

   DEFAULT_OPTS = MPOPTION_INFO_KNITRO('D')
   VALID_OPTS   = MPOPTION_INFO_KNITRO('V')
   EXCEPTIONS   = MPOPTION_INFO_KNITRO('E')

   Returns a structure for KNITRO options for MATPOWER containing ...
   (1) default options,
   (2) valid options, or
   (3) NESTED_STRUCT_COPY exceptions for setting options
   ... depending on the value of the input argument.

   This function is used by MPOPTION to set default options, check validity
   of option names or modify option setting/copying behavior for this
   subset of optional MATPOWER options.

   See also MPOPTION.

0001 function opt = mpoption_info_knitro(selector)
0002 %MPOPTION_INFO_KNITRO  Returns MATPOWER option info for KNITRO.
0003 %
0004 %   DEFAULT_OPTS = MPOPTION_INFO_KNITRO('D')
0005 %   VALID_OPTS   = MPOPTION_INFO_KNITRO('V')
0006 %   EXCEPTIONS   = MPOPTION_INFO_KNITRO('E')
0007 %
0008 %   Returns a structure for KNITRO options for MATPOWER containing ...
0009 %   (1) default options,
0010 %   (2) valid options, or
0011 %   (3) NESTED_STRUCT_COPY exceptions for setting options
0012 %   ... depending on the value of the input argument.
0013 %
0014 %   This function is used by MPOPTION to set default options, check validity
0015 %   of option names or modify option setting/copying behavior for this
0016 %   subset of optional MATPOWER options.
0017 %
0018 %   See also MPOPTION.
0019 
0020 %   MATPOWER
0021 %   Copyright (c) 2014-2016, Power Systems Engineering Research Center (PSERC)
0022 %   by Ray Zimmerman, PSERC Cornell
0023 %
0024 %   This file is part of MATPOWER.
0025 %   Covered by the 3-clause BSD License (see LICENSE file for details).
0026 %   See http://www.pserc.cornell.edu/matpower/ for more info.
0027 
0028 if nargin < 1
0029     selector = 'D';
0030 end
0031 if have_fcn('knitro')
0032     switch upper(selector)
0033         case {'D', 'V'}     %% default and valid options
0034             opt = struct(...
0035                 'knitro',       struct(...
0036                     'tol_x',        1e-4, ...
0037                     'tol_f',        1e-4, ...
0038                     'opts',         [], ...
0039                     'opt_fname',    '', ...
0040                     'opt',          0 ...
0041                 ) ...
0042             );
0043         case 'E'            %% exceptions used by nested_struct_copy() for applying
0044             opt = struct(...
0045                 'name',         { 'knitro.opts' }, ...
0046                 'check',        0, ...
0047                 'copy_mode',    { '' } ...
0048                 );
0049         otherwise
0050             error('mpoption_info_knitro: ''%s'' is not a valid input argument', selector);
0051     end
0052 else
0053     opt = struct([]);       %% KNITRO is not available
0054 end