Scippy

SCIP

Solving Constraint Integer Programs

paramset.h
Go to the documentation of this file.
1 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
2 /* */
3 /* This file is part of the program and library */
4 /* SCIP --- Solving Constraint Integer Programs */
5 /* */
6 /* Copyright (c) 2002-2023 Zuse Institute Berlin (ZIB) */
7 /* */
8 /* Licensed under the Apache License, Version 2.0 (the "License"); */
9 /* you may not use this file except in compliance with the License. */
10 /* You may obtain a copy of the License at */
11 /* */
12 /* http://www.apache.org/licenses/LICENSE-2.0 */
13 /* */
14 /* Unless required by applicable law or agreed to in writing, software */
15 /* distributed under the License is distributed on an "AS IS" BASIS, */
16 /* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. */
17 /* See the License for the specific language governing permissions and */
18 /* limitations under the License. */
19 /* */
20 /* You should have received a copy of the Apache-2.0 license */
21 /* along with SCIP; see the file LICENSE. If not visit scipopt.org. */
22 /* */
23 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
24 
25 /**@file paramset.h
26  * @ingroup INTERNALAPI
27  * @brief internal methods for handling parameter settings
28  * @author Tobias Achterberg
29  * @author Timo Berthold
30  */
31 
32 /*---+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8----+----9----+----0----+----1----+----2*/
33 
34 #ifndef __SCIP_PARAMSET_H__
35 #define __SCIP_PARAMSET_H__
36 
37 
38 #include "scip/def.h"
39 #include "blockmemshell/memory.h"
40 #include "scip/type_set.h"
41 #include "scip/type_retcode.h"
42 #include "scip/type_paramset.h"
43 #include "scip/pub_paramset.h"
44 #include "scip/pub_misc.h"
45 
46 #ifdef __cplusplus
47 extern "C" {
48 #endif
49 
50 /** creates parameter set */
52  SCIP_PARAMSET** paramset, /**< pointer to store the parameter set */
53  BMS_BLKMEM* blkmem /**< block memory */
54  );
55 
56 /** frees parameter set */
57 void SCIPparamsetFree(
58  SCIP_PARAMSET** paramset, /**< pointer to the parameter set */
59  BMS_BLKMEM* blkmem /**< block memory */
60  );
61 
62 /** creates a bool parameter, sets it to its default value, and adds it to the parameter set */
64  SCIP_PARAMSET* paramset, /**< parameter set */
65  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
66  BMS_BLKMEM* blkmem, /**< block memory */
67  const char* name, /**< name of the parameter */
68  const char* desc, /**< description of the parameter */
69  SCIP_Bool* valueptr, /**< pointer to store the current parameter value, or NULL */
70  SCIP_Bool isadvanced, /**< is this parameter an advanced parameter? */
71  SCIP_Bool defaultvalue, /**< default value of the parameter */
72  SCIP_DECL_PARAMCHGD ((*paramchgd)), /**< change information method of parameter */
73  SCIP_PARAMDATA* paramdata /**< locally defined parameter specific data */
74  );
75 
76 /** creates a int parameter, sets it to its default value, and adds it to the parameter set */
78  SCIP_PARAMSET* paramset, /**< parameter set */
79  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
80  BMS_BLKMEM* blkmem, /**< block memory */
81  const char* name, /**< name of the parameter */
82  const char* desc, /**< description of the parameter */
83  int* valueptr, /**< pointer to store the current parameter value, or NULL */
84  SCIP_Bool isadvanced, /**< is this parameter an advanced parameter? */
85  int defaultvalue, /**< default value of the parameter */
86  int minvalue, /**< minimum value for parameter */
87  int maxvalue, /**< maximum value for parameter */
88  SCIP_DECL_PARAMCHGD ((*paramchgd)), /**< change information method of parameter */
89  SCIP_PARAMDATA* paramdata /**< locally defined parameter specific data */
90  );
91 
92 /** creates a SCIP_Longint parameter, sets it to its default value, and adds it to the parameter set */
94  SCIP_PARAMSET* paramset, /**< parameter set */
95  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
96  BMS_BLKMEM* blkmem, /**< block memory */
97  const char* name, /**< name of the parameter */
98  const char* desc, /**< description of the parameter */
99  SCIP_Longint* valueptr, /**< pointer to store the current parameter value, or NULL */
100  SCIP_Bool isadvanced, /**< is this parameter an advanced parameter? */
101  SCIP_Longint defaultvalue, /**< default value of the parameter */
102  SCIP_Longint minvalue, /**< minimum value for parameter */
103  SCIP_Longint maxvalue, /**< maximum value for parameter */
104  SCIP_DECL_PARAMCHGD ((*paramchgd)), /**< change information method of parameter */
105  SCIP_PARAMDATA* paramdata /**< locally defined parameter specific data */
106  );
107 
108 /** creates a SCIP_Real parameter, sets it to its default value, and adds it to the parameter set */
110  SCIP_PARAMSET* paramset, /**< parameter set */
111  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
112  BMS_BLKMEM* blkmem, /**< block memory */
113  const char* name, /**< name of the parameter */
114  const char* desc, /**< description of the parameter */
115  SCIP_Real* valueptr, /**< pointer to store the current parameter value, or NULL */
116  SCIP_Bool isadvanced, /**< is this parameter an advanced parameter? */
117  SCIP_Real defaultvalue, /**< default value of the parameter */
118  SCIP_Real minvalue, /**< minimum value for parameter */
119  SCIP_Real maxvalue, /**< maximum value for parameter */
120  SCIP_DECL_PARAMCHGD ((*paramchgd)), /**< change information method of parameter */
121  SCIP_PARAMDATA* paramdata /**< locally defined parameter specific data */
122  );
123 
124 /** creates a char parameter, sets it to its default value, and adds it to the parameter set */
126  SCIP_PARAMSET* paramset, /**< parameter set */
127  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
128  BMS_BLKMEM* blkmem, /**< block memory */
129  const char* name, /**< name of the parameter */
130  const char* desc, /**< description of the parameter */
131  char* valueptr, /**< pointer to store the current parameter value, or NULL */
132  SCIP_Bool isadvanced, /**< is this parameter an advanced parameter? */
133  char defaultvalue, /**< default value of the parameter */
134  const char* allowedvalues, /**< array with possible parameter values, or NULL if not restricted */
135  SCIP_DECL_PARAMCHGD ((*paramchgd)), /**< change information method of parameter */
136  SCIP_PARAMDATA* paramdata /**< locally defined parameter specific data */
137  );
138 
139 /** creates a string parameter, sets it to its default value, and adds it to the parameter set */
141  SCIP_PARAMSET* paramset, /**< parameter set */
142  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
143  BMS_BLKMEM* blkmem, /**< block memory */
144  const char* name, /**< name of the parameter */
145  const char* desc, /**< description of the parameter */
146  char** valueptr, /**< pointer to store the current parameter value, or NULL */
147  SCIP_Bool isadvanced, /**< is this parameter an advanced parameter? */
148  const char* defaultvalue, /**< default value of the parameter */
149  SCIP_DECL_PARAMCHGD ((*paramchgd)), /**< change information method of parameter */
150  SCIP_PARAMDATA* paramdata /**< locally defined parameter specific data */
151  );
152 
153 /** returns whether an existing parameter is fixed */
155  SCIP_PARAMSET* paramset, /**< parameter set */
156  const char* name /**< name of the parameter */
157  );
158 
159 /** returns the pointer to an existing SCIP parameter */
161  SCIP_PARAMSET* paramset, /**< parameter set */
162  const char* name /**< name of the parameter */
163  );
164 
165 /** gets the value of an existing SCIP_Bool parameter */
167  SCIP_PARAMSET* paramset, /**< parameter set */
168  const char* name, /**< name of the parameter */
169  SCIP_Bool* value /**< pointer to store the parameter */
170  );
171 
172 /** gets the value of an existing int parameter */
174  SCIP_PARAMSET* paramset, /**< parameter set */
175  const char* name, /**< name of the parameter */
176  int* value /**< pointer to store the parameter */
177  );
178 
179 /** gets the value of an existing SCIP_Longint parameter */
181  SCIP_PARAMSET* paramset, /**< parameter set */
182  const char* name, /**< name of the parameter */
183  SCIP_Longint* value /**< pointer to store the parameter */
184  );
185 
186 /** gets the value of an existing SCIP_Real parameter */
188  SCIP_PARAMSET* paramset, /**< parameter set */
189  const char* name, /**< name of the parameter */
190  SCIP_Real* value /**< pointer to store the parameter */
191  );
192 
193 /** gets the value of an existing char parameter */
195  SCIP_PARAMSET* paramset, /**< parameter set */
196  const char* name, /**< name of the parameter */
197  char* value /**< pointer to store the parameter */
198  );
199 
200 /** gets the value of an existing string parameter */
202  SCIP_PARAMSET* paramset, /**< parameter set */
203  const char* name, /**< name of the parameter */
204  char** value /**< pointer to store the parameter */
205  );
206 
207 /** changes the fixing status of an existing parameter */
209  SCIP_PARAMSET* paramset, /**< parameter set */
210  const char* name, /**< name of the parameter */
211  SCIP_Bool fixed /**< new fixing status of the parameter */
212  );
213 
214 /** changes the value of an existing SCIP_Bool parameter */
216  SCIP_PARAMSET* paramset, /**< parameter set */
217  SCIP_SET* set, /**< global SCIP settings */
218  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
219  const char* name, /**< name of the parameter */
220  SCIP_Bool value /**< new value of the parameter */
221  );
222 
223 /** changes the value of an existing int parameter */
225  SCIP_PARAMSET* paramset, /**< parameter set */
226  SCIP_SET* set, /**< global SCIP settings */
227  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
228  const char* name, /**< name of the parameter */
229  int value /**< new value of the parameter */
230  );
231 
232 /** changes the value of an existing SCIP_Longint parameter */
234  SCIP_PARAMSET* paramset, /**< parameter set */
235  SCIP_SET* set, /**< global SCIP settings */
236  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
237  const char* name, /**< name of the parameter */
238  SCIP_Longint value /**< new value of the parameter */
239  );
240 
241 /** changes the value of an existing SCIP_Real parameter */
243  SCIP_PARAMSET* paramset, /**< parameter set */
244  SCIP_SET* set, /**< global SCIP settings */
245  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
246  const char* name, /**< name of the parameter */
247  SCIP_Real value /**< new value of the parameter */
248  );
249 
250 /** changes the value of an existing char parameter */
252  SCIP_PARAMSET* paramset, /**< parameter set */
253  SCIP_SET* set, /**< global SCIP settings */
254  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
255  const char* name, /**< name of the parameter */
256  char value /**< new value of the parameter */
257  );
258 
259 /** changes the value of an existing string parameter */
261  SCIP_PARAMSET* paramset, /**< parameter set */
262  SCIP_SET* set, /**< global SCIP settings */
263  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
264  const char* name, /**< name of the parameter */
265  const char* value /**< new value of the parameter */
266  );
267 
268 /** changes the default value of an existing SCIP_Bool parameter */
270  SCIP_PARAMSET* paramset, /**< parameter set */
271  const char* name, /**< name of the parameter */
272  SCIP_Bool defaultvalue /**< new default value of the parameter */
273  );
274 
275 /** changes the default value of an existing int parameter */
277  SCIP_PARAMSET* paramset, /**< parameter set */
278  const char* name, /**< name of the parameter */
279  int defaultvalue /**< new default value of the parameter */
280  );
281 
282 /** changes the default value of an existing SCIP_Longint parameter */
284  SCIP_PARAMSET* paramset, /**< parameter set */
285  const char* name, /**< name of the parameter */
286  SCIP_Longint defaultvalue /**< new default value of the parameter */
287  );
288 
289 /** changes the default value of an existing SCIP_Real parameter */
291  SCIP_PARAMSET* paramset, /**< parameter set */
292  const char* name, /**< name of the parameter */
293  SCIP_Real defaultvalue /**< new default value of the parameter */
294  );
295 
296 /** changes the default value of an existing char parameter */
298  SCIP_PARAMSET* paramset, /**< parameter set */
299  const char* name, /**< name of the parameter */
300  char defaultvalue /**< new default value of the parameter */
301  );
302 
303 /** changes the default value of an existing string parameter */
305  SCIP_PARAMSET* paramset, /**< parameter set */
306  const char* name, /**< name of the parameter */
307  const char* defaultvalue /**< new default value of the parameter */
308  );
309 
310 /** reads parameters from a file */
312  SCIP_PARAMSET* paramset, /**< parameter set */
313  SCIP_SET* set, /**< global SCIP settings */
314  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
315  const char* filename /**< file name */
316  );
317 
318 /** writes all parameters in the parameter set to a file */
320  SCIP_PARAMSET* paramset, /**< parameter set */
321  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
322  const char* filename, /**< file name, or NULL for stdout */
323  SCIP_Bool comments, /**< should parameter descriptions be written as comments? */
324  SCIP_Bool onlychanged /**< should only the parameters been written, that are changed from default? */
325  );
326 
327 /** installs default values for all parameters */
329  SCIP_PARAMSET* paramset, /**< parameter set */
330  SCIP_SET* set, /**< global SCIP settings */
331  SCIP_MESSAGEHDLR* messagehdlr /**< message handler */
332  );
333 
334 /** installs default value for a single parameter */
336  SCIP_PARAMSET* paramset, /**< parameter set */
337  SCIP_SET* set, /**< global SCIP settings */
338  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
339  const char* paramname /**< name of the parameter */
340  );
341 
342 /** sets parameters to
343  *
344  * - \ref SCIP_PARAMEMPHASIS_DEFAULT to use default values (see also SCIPparamsetSetToDefault())
345  * - \ref SCIP_PARAMEMPHASIS_COUNTER to get feasible and "fast" counting process
346  * - \ref SCIP_PARAMEMPHASIS_CPSOLVER to get CP like search (e.g. no LP relaxation)
347  * - \ref SCIP_PARAMEMPHASIS_EASYCIP to solve easy problems fast
348  * - \ref SCIP_PARAMEMPHASIS_FEASIBILITY to detect feasibility fast
349  * - \ref SCIP_PARAMEMPHASIS_HARDLP to be capable to handle hard LPs
350  * - \ref SCIP_PARAMEMPHASIS_OPTIMALITY to prove optimality fast
351  * - \ref SCIP_PARAMEMPHASIS_PHASEFEAS to find feasible solutions during a 3 phase solution process
352  * - \ref SCIP_PARAMEMPHASIS_PHASEIMPROVE to find improved solutions during a 3 phase solution process
353  * - \ref SCIP_PARAMEMPHASIS_PHASEPROOF to proof optimality during a 3 phase solution process
354  * - \ref SCIP_PARAMEMPHASIS_NUMERICS to solve problems which cause numerical issues
355  */
357  SCIP_PARAMSET* paramset, /**< parameter set */
358  SCIP_SET* set, /**< global SCIP settings */
359  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
360  SCIP_PARAMEMPHASIS paramemphasis, /**< parameter emphasis */
361  SCIP_Bool quiet /**< should the parameter be set quiet (no output) */
362  );
363 
364 /** sets parameters to deactivate separators and heuristics that use auxiliary SCIP instances; should be called for
365  * auxiliary SCIP instances to avoid recursion
366  */
368  SCIP_PARAMSET* paramset, /**< parameter set */
369  SCIP_SET* set, /**< global SCIP settings */
370  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
371  SCIP_Bool quiet /**< should the parameter be set quiet (no output) */
372  );
373 
374 /** sets heuristic parameters values to
375  * - SCIP_PARAMSETTING_DEFAULT which are the default values of all heuristic parameters
376  * - SCIP_PARAMSETTING_FAST such that the time spend for heuristic is decreased
377  * - SCIP_PARAMSETTING_AGGRESSIVE such that the heuristic are called more aggregative
378  * - SCIP_PARAMSETTING_OFF which turn off all heuristics
379  */
381  SCIP_PARAMSET* paramset, /**< parameter set */
382  SCIP_SET* set, /**< global SCIP settings */
383  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
384  SCIP_PARAMSETTING paramsetting, /**< parameter settings */
385  SCIP_Bool quiet /**< should the parameter be set quiet (no output) */
386  );
387 
388 /** sets presolving parameters to
389  * - SCIP_PARAMSETTING_DEFAULT which are the default values of all presolving parameters
390  * - SCIP_PARAMSETTING_FAST such that the time spend for presolving is decreased
391  * - SCIP_PARAMSETTING_AGGRESSIVE such that the presolving is more aggregative
392  * - SCIP_PARAMSETTING_OFF which turn off all presolving
393  */
395  SCIP_PARAMSET* paramset, /**< parameter set */
396  SCIP_SET* set, /**< global SCIP settings */
397  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
398  SCIP_PARAMSETTING paramsetting, /**< parameter settings */
399  SCIP_Bool quiet /**< should the parameter be set quiet (no output) */
400  );
401 
402 /** sets separating parameters to
403  * - SCIP_PARAMSETTING_DEFAULT which are the default values of all separating parameters
404  * - SCIP_PARAMSETTING_FAST such that the time spend for separating is decreased
405  * - SCIP_PARAMSETTING_AGGRESSIVE such that the separating is done more aggregative
406  * - SCIP_PARAMSETTING_OFF which turn off all separating
407  */
409  SCIP_PARAMSET* paramset, /**< parameter set */
410  SCIP_SET* set, /**< global SCIP settings */
411  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
412  SCIP_PARAMSETTING paramsetting, /**< parameter settings */
413  SCIP_Bool quiet /**< should the parameter be set quiet (no output) */
414  );
415 
416 /** returns the array of parameters */
418  SCIP_PARAMSET* paramset /**< parameter set */
419  );
420 
421 /** returns the number of parameters in the parameter set */
423  SCIP_PARAMSET* paramset /**< parameter set */
424  );
425 
426 /** copies all parameter values of the source parameter set to the corresponding parameters in the target set */
428  SCIP_PARAMSET* sourceparamset, /**< source parameter set */
429  SCIP_PARAMSET* targetparamset, /**< target parameter set */
430  SCIP_SET* set, /**< global SCIP settings of target SCIP */
431  SCIP_MESSAGEHDLR* messagehdlr /**< message handler of target SCIP */
432  );
433 
434 /** checks whether value of SCIP_Bool parameter is valid */
436  SCIP_PARAM* param, /**< parameter */
437  SCIP_Bool value /**< value to check */
438  );
439 
440 /** checks whether value of integer parameter is valid */
442  SCIP_PARAM* param, /**< parameter */
443  int value /**< value to check */
444  );
445 
446 /** checks whether value of SCIP_Longint parameter is valid */
448  SCIP_PARAM* param, /**< parameter */
449  SCIP_Longint value /**< value to check */
450  );
451 
452 /** checks whether value of SCIP_Real parameter is valid */
454  SCIP_PARAM* param, /**< parameter */
455  SCIP_Real value /**< value to check */
456  );
457 
458 /** checks whether value of char parameter is valid */
460  SCIP_PARAM* param, /**< parameter */
461  const char value /**< value to check */
462  );
463 
464 /** checks whether value of string parameter is valid */
466  SCIP_PARAM* param, /**< parameter */
467  const char* value /**< value to check */
468  );
469 
470 /** sets value of SCIP_Bool parameter */
472  SCIP_PARAM* param, /**< parameter */
473  SCIP_SET* set, /**< global SCIP settings, or NULL if param change method should not be called */
474  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
475  SCIP_Bool value, /**< new value of the parameter */
476  SCIP_Bool initialize, /**< is this the initialization of the parameter? */
477  SCIP_Bool quiet /**< should the parameter be set quiet (no output) */
478  );
479 
480 /** sets value of int parameter */
482  SCIP_PARAM* param, /**< parameter */
483  SCIP_SET* set, /**< global SCIP settings, or NULL if param change method should not be called */
484  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
485  int value, /**< new value of the parameter */
486  SCIP_Bool initialize, /**< is this the initialization of the parameter? */
487  SCIP_Bool quiet /**< should the parameter be set quiet (no output) */
488  );
489 
490 /** sets value of SCIP_Longint parameter */
492  SCIP_PARAM* param, /**< parameter */
493  SCIP_SET* set, /**< global SCIP settings, or NULL if param change method should not be called */
494  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
495  SCIP_Longint value, /**< new value of the parameter */
496  SCIP_Bool initialize, /**< is this the initialization of the parameter? */
497  SCIP_Bool quiet /**< should the parameter be set quiet (no output) */
498  );
499 
500 /** sets value of SCIP_Real parameter */
502  SCIP_PARAM* param, /**< parameter */
503  SCIP_SET* set, /**< global SCIP settings, or NULL if param change method should not be called */
504  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
505  SCIP_Real value, /**< new value of the parameter */
506  SCIP_Bool initialize, /**< is this the initialization of the parameter? */
507  SCIP_Bool quiet /**< should the parameter be set quiet (no output) */
508  );
509 
510 /** sets value of char parameter */
512  SCIP_PARAM* param, /**< parameter */
513  SCIP_SET* set, /**< global SCIP settings, or NULL if param change method should not be called */
514  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
515  char value, /**< new value of the parameter */
516  SCIP_Bool initialize, /**< is this the initialization of the parameter? */
517  SCIP_Bool quiet /**< should the parameter be set quiet (no output) */
518  );
519 
520 /** sets value of string parameter */
522  SCIP_PARAM* param, /**< parameter */
523  SCIP_SET* set, /**< global SCIP settings, or NULL if param change method should not be called */
524  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
525  const char* value, /**< new value of the parameter */
526  SCIP_Bool initialize, /**< is this the initialization of the parameter? */
527  SCIP_Bool quiet /**< should the parameter be set quiet (no output) */
528  );
529 
530 /** sets default value of SCIP_Bool parameter */
532  SCIP_PARAM* param, /**< parameter */
533  SCIP_Bool defaultvalue /**< new default value */
534  );
535 
536 /** sets default value of int parameter */
538  SCIP_PARAM* param, /**< parameter */
539  int defaultvalue /**< new default value */
540  );
541 
542 /** sets default value of SCIP_Longint parameter */
544  SCIP_PARAM* param, /**< parameter */
545  SCIP_Longint defaultvalue /**< new default value */
546  );
547 
548 /** sets default value of SCIP_Real parameter */
550  SCIP_PARAM* param, /**< parameter */
551  SCIP_Real defaultvalue /**< new default value */
552  );
553 
554 /** sets default value of char parameter */
556  SCIP_PARAM* param, /**< parameter */
557  char defaultvalue /**< new default value */
558  );
559 
560 /** sets default value of string parameter */
562  SCIP_PARAM* param, /**< parameter */
563  const char* defaultvalue /**< new default value */
564  );
565 
566 /** sets the parameter to its default setting */
568  SCIP_PARAM* param, /**< parameter */
569  SCIP_SET* set, /**< global SCIP settings */
570  SCIP_MESSAGEHDLR* messagehdlr /**< message handler */
571  );
572 
573 /** writes a single parameter to a file */
575  SCIP_PARAM* param, /**< parameter */
576  SCIP_MESSAGEHDLR* messagehdlr, /**< message handler */
577  const char* filename, /**< file name, or NULL for stdout */
578  SCIP_Bool comments, /**< should parameter descriptions be written as comments? */
579  SCIP_Bool onlychanged /**< should only the parameters been written, that are changed from default? */
580  );
581 
582 #ifdef __cplusplus
583 }
584 #endif
585 
586 #endif
SCIP_Bool SCIPparamIsValidInt(SCIP_PARAM *param, int value)
Definition: paramset.c:4432
SCIP_RETCODE SCIPparamsetWrite(SCIP_PARAMSET *paramset, SCIP_MESSAGEHDLR *messagehdlr, const char *filename, SCIP_Bool comments, SCIP_Bool onlychanged)
Definition: paramset.c:2689
void SCIPparamSetDefaultReal(SCIP_PARAM *param, SCIP_Real defaultvalue)
Definition: paramset.c:4931
SCIP_RETCODE SCIPparamsetFix(SCIP_PARAMSET *paramset, const char *name, SCIP_Bool fixed)
Definition: paramset.c:1916
void SCIPparamSetDefaultLongint(SCIP_PARAM *param, SCIP_Longint defaultvalue)
Definition: paramset.c:4917
SCIP_Bool SCIPparamIsValidLongint(SCIP_PARAM *param, SCIP_Longint value)
Definition: paramset.c:4443
SCIP_RETCODE SCIPparamSetString(SCIP_PARAM *param, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, const char *value, SCIP_Bool initialize, SCIP_Bool quiet)
Definition: paramset.c:4820
struct SCIP_ParamData SCIP_PARAMDATA
Definition: type_paramset.h:87
SCIP_RETCODE SCIPparamsetSetToDefault(SCIP_PARAMSET *paramset, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, const char *paramname)
Definition: paramset.c:2790
SCIP_RETCODE SCIPparamsetAddChar(SCIP_PARAMSET *paramset, SCIP_MESSAGEHDLR *messagehdlr, BMS_BLKMEM *blkmem, const char *name, const char *desc, char *valueptr, SCIP_Bool isadvanced, char defaultvalue, const char *allowedvalues, SCIP_DECL_PARAMCHGD((*paramchgd)), SCIP_PARAMDATA *paramdata)
Definition: paramset.c:1616
SCIP_RETCODE SCIPparamsetSetToDefaults(SCIP_PARAMSET *paramset, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr)
Definition: paramset.c:2772
void SCIPparamSetDefaultBool(SCIP_PARAM *param, SCIP_Bool defaultvalue)
Definition: paramset.c:4891
enum SCIP_Retcode SCIP_RETCODE
Definition: type_retcode.h:63
SCIP_RETCODE SCIPparamsetGetInt(SCIP_PARAMSET *paramset, const char *name, int *value)
Definition: paramset.c:1756
type definitions for global SCIP settings
SCIP_RETCODE SCIPparamsetSetReal(SCIP_PARAMSET *paramset, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, const char *name, SCIP_Real value)
Definition: paramset.c:2042
SCIP_RETCODE SCIPparamsetSetToSubscipsOff(SCIP_PARAMSET *paramset, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, SCIP_Bool quiet)
Definition: paramset.c:4085
SCIP_RETCODE SCIPparamsetGetBool(SCIP_PARAMSET *paramset, const char *name, SCIP_Bool *value)
Definition: paramset.c:1724
type definitions for return codes for SCIP methods
SCIP_RETCODE SCIPparamsetSetSeparating(SCIP_PARAMSET *paramset, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, SCIP_PARAMSETTING paramsetting, SCIP_Bool quiet)
Definition: paramset.c:4262
SCIP_PARAM * SCIPparamsetGetParam(SCIP_PARAMSET *paramset, const char *name)
Definition: paramset.c:1712
SCIP_RETCODE SCIPparamsetCreate(SCIP_PARAMSET **paramset, BMS_BLKMEM *blkmem)
Definition: paramset.c:1426
enum SCIP_ParamSetting SCIP_PARAMSETTING
Definition: type_paramset.h:65
public methods for handling parameter settings
SCIP_RETCODE SCIPparamSetChar(SCIP_PARAM *param, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, char value, SCIP_Bool initialize, SCIP_Bool quiet)
Definition: paramset.c:4759
SCIP_RETCODE SCIPparamSetLongint(SCIP_PARAM *param, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, SCIP_Longint value, SCIP_Bool initialize, SCIP_Bool quiet)
Definition: paramset.c:4633
int SCIPparamsetGetNParams(SCIP_PARAMSET *paramset)
Definition: paramset.c:4303
#define SCIP_DECL_PARAMCHGD(x)
SCIP_RETCODE SCIPparamsetSetHeuristics(SCIP_PARAMSET *paramset, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, SCIP_PARAMSETTING paramsetting, SCIP_Bool quiet)
Definition: paramset.c:4190
SCIP_RETCODE SCIPparamsetGetLongint(SCIP_PARAMSET *paramset, const char *name, SCIP_Longint *value)
Definition: paramset.c:1788
SCIP_RETCODE SCIPparamSetBool(SCIP_PARAM *param, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, SCIP_Bool value, SCIP_Bool initialize, SCIP_Bool quiet)
Definition: paramset.c:4509
SCIP_RETCODE SCIPparamsetAddString(SCIP_PARAMSET *paramset, SCIP_MESSAGEHDLR *messagehdlr, BMS_BLKMEM *blkmem, const char *name, const char *desc, char **valueptr, SCIP_Bool isadvanced, const char *defaultvalue, SCIP_DECL_PARAMCHGD((*paramchgd)), SCIP_PARAMDATA *paramdata)
Definition: paramset.c:1645
SCIP_RETCODE SCIPparamSetInt(SCIP_PARAM *param, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, int value, SCIP_Bool initialize, SCIP_Bool quiet)
Definition: paramset.c:4571
SCIP_RETCODE SCIPparamsetSetInt(SCIP_PARAMSET *paramset, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, const char *name, int value)
Definition: paramset.c:1974
SCIP_Bool SCIPparamIsValidReal(SCIP_PARAM *param, SCIP_Real value)
Definition: paramset.c:4454
SCIP_RETCODE SCIPparamsetSetDefaultLongint(SCIP_PARAMSET *paramset, const char *name, SCIP_Longint defaultvalue)
Definition: paramset.c:2206
public data structures and miscellaneous methods
#define SCIP_Bool
Definition: def.h:93
SCIP_RETCODE SCIPparamsetSetDefaultBool(SCIP_PARAMSET *paramset, const char *name, SCIP_Bool defaultvalue)
Definition: paramset.c:2144
static const char * paramname[]
Definition: lpi_msk.c:5096
SCIP_RETCODE SCIPparamsetSetDefaultInt(SCIP_PARAMSET *paramset, const char *name, int defaultvalue)
Definition: paramset.c:2175
SCIP_RETCODE SCIPparamsetSetBool(SCIP_PARAMSET *paramset, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, const char *name, SCIP_Bool value)
Definition: paramset.c:1940
SCIP_RETCODE SCIPparamsetAddInt(SCIP_PARAMSET *paramset, SCIP_MESSAGEHDLR *messagehdlr, BMS_BLKMEM *blkmem, const char *name, const char *desc, int *valueptr, SCIP_Bool isadvanced, int defaultvalue, int minvalue, int maxvalue, SCIP_DECL_PARAMCHGD((*paramchgd)), SCIP_PARAMDATA *paramdata)
Definition: paramset.c:1526
SCIP_Bool SCIPparamIsValidBool(SCIP_PARAM *param, SCIP_Bool value)
Definition: paramset.c:4422
SCIP_RETCODE SCIPparamsetGetReal(SCIP_PARAMSET *paramset, const char *name, SCIP_Real *value)
Definition: paramset.c:1820
void SCIPparamsetFree(SCIP_PARAMSET **paramset, BMS_BLKMEM *blkmem)
Definition: paramset.c:1446
SCIP_RETCODE SCIPparamsetRead(SCIP_PARAMSET *paramset, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, const char *filename)
Definition: paramset.c:2639
SCIP_RETCODE SCIPparamsetGetString(SCIP_PARAMSET *paramset, const char *name, char **value)
Definition: paramset.c:1884
SCIP_RETCODE SCIPparamsetSetEmphasis(SCIP_PARAMSET *paramset, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, SCIP_PARAMEMPHASIS paramemphasis, SCIP_Bool quiet)
Definition: paramset.c:3817
SCIP_RETCODE SCIPparamsetAddLongint(SCIP_PARAMSET *paramset, SCIP_MESSAGEHDLR *messagehdlr, BMS_BLKMEM *blkmem, const char *name, const char *desc, SCIP_Longint *valueptr, SCIP_Bool isadvanced, SCIP_Longint defaultvalue, SCIP_Longint minvalue, SCIP_Longint maxvalue, SCIP_DECL_PARAMCHGD((*paramchgd)), SCIP_PARAMDATA *paramdata)
Definition: paramset.c:1556
void SCIPparamSetDefaultString(SCIP_PARAM *param, const char *defaultvalue)
Definition: paramset.c:4957
SCIP_RETCODE SCIPparamsetGetChar(SCIP_PARAMSET *paramset, const char *name, char *value)
Definition: paramset.c:1852
enum SCIP_ParamEmphasis SCIP_PARAMEMPHASIS
Definition: type_paramset.h:84
SCIP_RETCODE SCIPparamsetSetChar(SCIP_PARAMSET *paramset, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, const char *name, char value)
Definition: paramset.c:2076
SCIP_RETCODE SCIPparamsetSetDefaultChar(SCIP_PARAMSET *paramset, const char *name, char defaultvalue)
Definition: paramset.c:2268
SCIP_RETCODE SCIPparamsetAddBool(SCIP_PARAMSET *paramset, SCIP_MESSAGEHDLR *messagehdlr, BMS_BLKMEM *blkmem, const char *name, const char *desc, SCIP_Bool *valueptr, SCIP_Bool isadvanced, SCIP_Bool defaultvalue, SCIP_DECL_PARAMCHGD((*paramchgd)), SCIP_PARAMDATA *paramdata)
Definition: paramset.c:1499
SCIP_RETCODE SCIPparamsetSetPresolving(SCIP_PARAMSET *paramset, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, SCIP_PARAMSETTING paramsetting, SCIP_Bool quiet)
Definition: paramset.c:4226
SCIP_RETCODE SCIPparamsetAddReal(SCIP_PARAMSET *paramset, SCIP_MESSAGEHDLR *messagehdlr, BMS_BLKMEM *blkmem, const char *name, const char *desc, SCIP_Real *valueptr, SCIP_Bool isadvanced, SCIP_Real defaultvalue, SCIP_Real minvalue, SCIP_Real maxvalue, SCIP_DECL_PARAMCHGD((*paramchgd)), SCIP_PARAMDATA *paramdata)
Definition: paramset.c:1586
SCIP_RETCODE SCIPparamsetCopyParams(SCIP_PARAMSET *sourceparamset, SCIP_PARAMSET *targetparamset, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr)
Definition: paramset.c:4317
SCIP_RETCODE SCIPparamsetSetString(SCIP_PARAMSET *paramset, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, const char *name, const char *value)
Definition: paramset.c:2110
type definitions for handling parameter settings
SCIP_RETCODE SCIPparamsetSetLongint(SCIP_PARAMSET *paramset, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, const char *name, SCIP_Longint value)
Definition: paramset.c:2008
#define SCIP_Real
Definition: def.h:186
SCIP_RETCODE SCIPparamWrite(SCIP_PARAM *param, SCIP_MESSAGEHDLR *messagehdlr, const char *filename, SCIP_Bool comments, SCIP_Bool onlychanged)
Definition: paramset.c:5021
SCIP_Bool SCIPparamIsValidString(SCIP_PARAM *param, const char *value)
Definition: paramset.c:4491
SCIP_RETCODE SCIPparamsetSetDefaultReal(SCIP_PARAMSET *paramset, const char *name, SCIP_Real defaultvalue)
Definition: paramset.c:2237
#define SCIP_Longint
Definition: def.h:171
SCIP_Bool SCIPparamIsValidChar(SCIP_PARAM *param, const char value)
Definition: paramset.c:4465
common defines and data types used in all packages of SCIP
void SCIPparamSetDefaultChar(SCIP_PARAM *param, char defaultvalue)
Definition: paramset.c:4945
struct BMS_BlkMem BMS_BLKMEM
Definition: memory.h:439
SCIP_PARAM ** SCIPparamsetGetParams(SCIP_PARAMSET *paramset)
Definition: paramset.c:4293
SCIP_RETCODE SCIPparamSetToDefault(SCIP_PARAM *param, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr)
Definition: paramset.c:4970
SCIP_Bool SCIPparamsetIsFixed(SCIP_PARAMSET *paramset, const char *name)
Definition: paramset.c:1690
void SCIPparamSetDefaultInt(SCIP_PARAM *param, int defaultvalue)
Definition: paramset.c:4903
SCIP_RETCODE SCIPparamsetSetDefaultString(SCIP_PARAMSET *paramset, const char *name, const char *defaultvalue)
Definition: paramset.c:2299
SCIP_RETCODE SCIPparamSetReal(SCIP_PARAM *param, SCIP_SET *set, SCIP_MESSAGEHDLR *messagehdlr, SCIP_Real value, SCIP_Bool initialize, SCIP_Bool quiet)
Definition: paramset.c:4695
memory allocation routines