ipopt_interface_meta.cpp
1 /*
2  * This file is part of CasADi.
3  *
4  * CasADi -- A symbolic framework for dynamic optimization.
5  * Copyright (C) 2010-2023 Joel Andersson, Joris Gillis, Moritz Diehl,
6  * KU Leuven. All rights reserved.
7  * Copyright (C) 2011-2014 Greg Horn
8  *
9  * CasADi is free software; you can redistribute it and/or
10  * modify it under the terms of the GNU Lesser General Public
11  * License as published by the Free Software Foundation; either
12  * version 3 of the License, or (at your option) any later version.
13  *
14  * CasADi is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17  * Lesser General Public License for more details.
18  *
19  * You should have received a copy of the GNU Lesser General Public
20  * License along with CasADi; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22  *
23  */
24 
25 
26  #include "ipopt_interface.hpp"
27  #include <string>
28 
29  const std::string casadi::IpoptInterface::meta_doc=
30  "\n"
31 "\n"
32 "\n"
33 "When in warmstart mode, output NLPSOL_LAM_X may be used as input\n"
34 "\n"
35 "NOTE: Even when max_iter == 0, it is not guaranteed that \n"
36 "input(NLPSOL_X0) == output(NLPSOL_X). Indeed if bounds on X or \n"
37 "constraints are unmet, they will differ.\n"
38 "\n"
39 "For a good tutorial on IPOPT, see http://drops.dagstuhl.de/volltexte/2009/2089/pdf/09061.WaechterAndreas.Paper.2089.pdf \n"
40 "\n"
41 "A good resource about the algorithms in IPOPT is: Wachter and L. T. \n"
42 "Biegler, On the Implementation of an Interior-Point Filter Line-Search\n"
43 " Algorithm for Large-Scale Nonlinear Programming, Mathematical \n"
44 "Programming 106(1), pp. 25-57, 2006 (As Research Report RC 23149, IBM \n"
45 "T. J. Watson Research Center, Yorktown, USA\n"
46 "\n"
47 "Caveats:\n"
48 "with default options, multipliers for the decision variables are wrong\n"
49 " for equality constraints. Change the 'fixed_variable_treatment' to \n"
50 "'make_constraint' or 'relax_bounds' to obtain correct results.\n"
51 "\n"
52 "Extra doc: https://github.com/casadi/casadi/wiki/L_21y \n"
53 "\n"
54 "\n"
55 "\n"
56 ">List of available options\n"
57 "\n"
58 "+--------------------------+-------------+---------------------------------+\n"
59 "| Id | Type | Description |\n"
60 "+==========================+=============+=================================+\n"
61 "| clip_inactive_lam | OT_BOOL | Explicitly set Lagrange |\n"
62 "| | | multipliers to 0 when bound is |\n"
63 "| | | deemed inactive (default: |\n"
64 "| | | false). |\n"
65 "+--------------------------+-------------+---------------------------------+\n"
66 "| con_integer_md | OT_DICT | Integer metadata (a dictionary |\n"
67 "| | | with lists of integers) about |\n"
68 "| | | constraints to be passed to |\n"
69 "| | | IPOPT |\n"
70 "+--------------------------+-------------+---------------------------------+\n"
71 "| con_numeric_md | OT_DICT | Numeric metadata (a dictionary |\n"
72 "| | | with lists of reals) about |\n"
73 "| | | constraints to be passed to |\n"
74 "| | | IPOPT |\n"
75 "+--------------------------+-------------+---------------------------------+\n"
76 "| con_string_md | OT_DICT | String metadata (a dictionary |\n"
77 "| | | with lists of strings) about |\n"
78 "| | | constraints to be passed to |\n"
79 "| | | IPOPT |\n"
80 "+--------------------------+-------------+---------------------------------+\n"
81 "| convexify_margin | OT_DOUBLE | When using a convexification |\n"
82 "| | | strategy, make sure that the |\n"
83 "| | | smallest eigenvalue is at least |\n"
84 "| | | this (default: 1e-7). |\n"
85 "+--------------------------+-------------+---------------------------------+\n"
86 "| convexify_strategy | OT_STRING | NONE|regularize|eigen- |\n"
87 "| | | reflect|eigen-clip. Strategy to |\n"
88 "| | | convexify the Lagrange Hessian |\n"
89 "| | | before passing it to the |\n"
90 "| | | solver. |\n"
91 "+--------------------------+-------------+---------------------------------+\n"
92 "| grad_f | OT_FUNCTION | Function for calculating the |\n"
93 "| | | gradient of the objective |\n"
94 "| | | (column, autogenerated by |\n"
95 "| | | default) |\n"
96 "+--------------------------+-------------+---------------------------------+\n"
97 "| hess_lag | OT_FUNCTION | Function for calculating the |\n"
98 "| | | Hessian of the Lagrangian |\n"
99 "| | | (autogenerated by default) |\n"
100 "+--------------------------+-------------+---------------------------------+\n"
101 "| inactive_lam_strategy | OT_STRING | Strategy to detect if a bound |\n"
102 "| | | is inactive. RELTOL: use |\n"
103 "| | | solver-defined constraint |\n"
104 "| | | tolerance * |\n"
105 "| | | inactive_lam_value|abstol: use |\n"
106 "| | | inactive_lam_value |\n"
107 "+--------------------------+-------------+---------------------------------+\n"
108 "| inactive_lam_value | OT_DOUBLE | Value used in |\n"
109 "| | | inactive_lam_strategy (default: |\n"
110 "| | | 10). |\n"
111 "+--------------------------+-------------+---------------------------------+\n"
112 "| ipopt | OT_DICT | Options to be passed to IPOPT |\n"
113 "+--------------------------+-------------+---------------------------------+\n"
114 "| jac_g | OT_FUNCTION | Function for calculating the |\n"
115 "| | | Jacobian of the constraints |\n"
116 "| | | (autogenerated by default) |\n"
117 "+--------------------------+-------------+---------------------------------+\n"
118 "| max_iter_eig | OT_DOUBLE | Maximum number of iterations to |\n"
119 "| | | compute an eigenvalue |\n"
120 "| | | decomposition (default: 50). |\n"
121 "+--------------------------+-------------+---------------------------------+\n"
122 "| pass_nonlinear_variables | OT_BOOL | Pass list of variables entering |\n"
123 "| | | nonlinearly to IPOPT |\n"
124 "+--------------------------+-------------+---------------------------------+\n"
125 "| var_integer_md | OT_DICT | Integer metadata (a dictionary |\n"
126 "| | | with lists of integers) about |\n"
127 "| | | variables to be passed to IPOPT |\n"
128 "+--------------------------+-------------+---------------------------------+\n"
129 "| var_numeric_md | OT_DICT | Numeric metadata (a dictionary |\n"
130 "| | | with lists of reals) about |\n"
131 "| | | variables to be passed to IPOPT |\n"
132 "+--------------------------+-------------+---------------------------------+\n"
133 "| var_string_md | OT_DICT | String metadata (a dictionary |\n"
134 "| | | with lists of strings) about |\n"
135 "| | | variables to be passed to IPOPT |\n"
136 "+--------------------------+-------------+---------------------------------+\n"
137 "\n"
138 "\n"
139 "\n"
140 "\n"
141 ;
casadi::IpoptInterface::meta_doc
static const std::string meta_doc
A documentation string.
Definition: ipopt_interface.hpp:188