bonmin_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 "bonmin_interface.hpp"
27  #include <string>
28 
29  const std::string casadi::BonminInterface::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 BONMIN, 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 BONMIN 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_223 \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 "| bonmin | OT_DICT | Options to be passed |\n"
62 "| | | to BONMIN |\n"
63 "+-------------------------+-----------------------+------------------------+\n"
64 "| con_integer_md | OT_DICT | Integer metadata (a |\n"
65 "| | | dictionary with lists |\n"
66 "| | | of integers) about |\n"
67 "| | | constraints to be |\n"
68 "| | | passed to BONMIN |\n"
69 "+-------------------------+-----------------------+------------------------+\n"
70 "| con_numeric_md | OT_DICT | Numeric metadata (a |\n"
71 "| | | dictionary with lists |\n"
72 "| | | of reals) about |\n"
73 "| | | constraints to be |\n"
74 "| | | passed to BONMIN |\n"
75 "+-------------------------+-----------------------+------------------------+\n"
76 "| con_string_md | OT_DICT | String metadata (a |\n"
77 "| | | dictionary with lists |\n"
78 "| | | of strings) about |\n"
79 "| | | constraints to be |\n"
80 "| | | passed to BONMIN |\n"
81 "+-------------------------+-----------------------+------------------------+\n"
82 "| grad_f | OT_FUNCTION | Function for |\n"
83 "| | | calculating the |\n"
84 "| | | gradient of the |\n"
85 "| | | objective (column, |\n"
86 "| | | autogenerated by |\n"
87 "| | | default) |\n"
88 "+-------------------------+-----------------------+------------------------+\n"
89 "| grad_f_options | OT_DICT | Options for the |\n"
90 "| | | autogenerated gradient |\n"
91 "| | | of the objective. |\n"
92 "+-------------------------+-----------------------+------------------------+\n"
93 "| hess_lag | OT_FUNCTION | Function for |\n"
94 "| | | calculating the |\n"
95 "| | | Hessian of the |\n"
96 "| | | Lagrangian |\n"
97 "| | | (autogenerated by |\n"
98 "| | | default) |\n"
99 "+-------------------------+-----------------------+------------------------+\n"
100 "| hess_lag_options | OT_DICT | Options for the |\n"
101 "| | | autogenerated Hessian |\n"
102 "| | | of the Lagrangian. |\n"
103 "+-------------------------+-----------------------+------------------------+\n"
104 "| jac_g | OT_FUNCTION | Function for |\n"
105 "| | | calculating the |\n"
106 "| | | Jacobian of the |\n"
107 "| | | constraints |\n"
108 "| | | (autogenerated by |\n"
109 "| | | default) |\n"
110 "+-------------------------+-----------------------+------------------------+\n"
111 "| jac_g_options | OT_DICT | Options for the |\n"
112 "| | | autogenerated Jacobian |\n"
113 "| | | of the constraints. |\n"
114 "+-------------------------+-----------------------+------------------------+\n"
115 "| pass_nonlinear_constrai | OT_BOOL | Pass list of |\n"
116 "| nts | | constraints entering |\n"
117 "| | | nonlinearly to BONMIN |\n"
118 "+-------------------------+-----------------------+------------------------+\n"
119 "| pass_nonlinear_variable | OT_BOOL | Pass list of variables |\n"
120 "| s | | entering nonlinearly |\n"
121 "| | | to BONMIN |\n"
122 "+-------------------------+-----------------------+------------------------+\n"
123 "| sos1_groups | OT_INTVECTORVECTOR | Options for the |\n"
124 "| | | autogenerated gradient |\n"
125 "| | | of the objective. |\n"
126 "+-------------------------+-----------------------+------------------------+\n"
127 "| sos1_priorities | OT_INTVECTOR | Options for the |\n"
128 "| | | autogenerated gradient |\n"
129 "| | | of the objective. |\n"
130 "+-------------------------+-----------------------+------------------------+\n"
131 "| sos1_weights | OT_DOUBLEVECTORVECTOR | Options for the |\n"
132 "| | | autogenerated gradient |\n"
133 "| | | of the objective. |\n"
134 "+-------------------------+-----------------------+------------------------+\n"
135 "| var_integer_md | OT_DICT | Integer metadata (a |\n"
136 "| | | dictionary with lists |\n"
137 "| | | of integers) about |\n"
138 "| | | variables to be passed |\n"
139 "| | | to BONMIN |\n"
140 "+-------------------------+-----------------------+------------------------+\n"
141 "| var_numeric_md | OT_DICT | Numeric metadata (a |\n"
142 "| | | dictionary with lists |\n"
143 "| | | of reals) about |\n"
144 "| | | variables to be passed |\n"
145 "| | | to BONMIN |\n"
146 "+-------------------------+-----------------------+------------------------+\n"
147 "| var_string_md | OT_DICT | String metadata (a |\n"
148 "| | | dictionary with lists |\n"
149 "| | | of strings) about |\n"
150 "| | | variables to be passed |\n"
151 "| | | to BONMIN |\n"
152 "+-------------------------+-----------------------+------------------------+\n"
153 "\n"
154 "\n"
155 "\n"
156 "\n"
157 ;
casadi::BonminInterface::meta_doc
static const std::string meta_doc
A documentation string.
Definition: bonmin_interface.hpp:177