mpoption_info_knitro

MPOPTION_INFO_KNITRO  Returns MATPOWER option info for Artelys 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 Artelys 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 https://matpower.org for more info.
0027 
0028 if nargin < 1
0029     selector = 'D';
0030 end
0031 if have_feature('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                     'maxit',        0, ...
0039                     'opts',         [], ...
0040                     'opt_fname',    '', ...
0041                     'opt',          0 ...
0042                 ) ...
0043             );
0044         case 'E'            %% exceptions used by nested_struct_copy() for applying
0045             opt = struct(...
0046                 'name',         { 'knitro.opts' }, ...
0047                 'check',        0, ...
0048                 'copy_mode',    { '' } ...
0049                 );
0050         otherwise
0051             error('mpoption_info_knitro: ''%s'' is not a valid input argument', selector);
0052     end
0053 else
0054     opt = struct([]);       %% Artelys Knitro is not available
0055 end