Scippy

SCIP

Solving Constraint Integer Programs

cons_conjunction.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-2018 Konrad-Zuse-Zentrum */
7 /* fuer Informationstechnik Berlin */
8 /* */
9 /* SCIP is distributed under the terms of the ZIB Academic License. */
10 /* */
11 /* You should have received a copy of the ZIB Academic License */
12 /* along with SCIP; see the file COPYING. If not visit scip.zib.de. */
13 /* */
14 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
15 
16 /**@file cons_conjunction.h
17  * @ingroup CONSHDLRS
18  * @brief constraint handler for conjunction constraints
19  * @author Tobias Achterberg
20  *
21  */
22 
23 /*---+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8----+----9----+----0----+----1----+----2*/
24 
25 #ifndef __SCIP_CONS_CONJUNCTION_H__
26 #define __SCIP_CONS_CONJUNCTION_H__
27 
28 
29 #include "scip/def.h"
30 #include "scip/type_cons.h"
31 #include "scip/type_retcode.h"
32 #include "scip/type_scip.h"
33 
34 #ifdef __cplusplus
35 extern "C" {
36 #endif
37 
38 /** creates the handler for conjunction constraints and includes it in SCIP
39  *
40  * @ingroup ConshdlrIncludes
41  * */
42 extern
44  SCIP* scip /**< SCIP data structure */
45  );
46 
47 /**@addtogroup CONSHDLRS
48  *
49  * @{
50  *
51  * @name Conjunction Constraints
52  *
53  * @{
54  *
55  * A conjunction constraint \f$ C \f$ is a constraint of the form
56  * \f[
57  * C = C_1 \wedge \dots \wedge C_n
58  * \f]
59  * where all the \f$ C_i \f$ are individual constraints themselves.
60  */
61 
62 /** creates and captures a conjunction constraint
63  *
64  * @note the constraint gets captured, hence at one point you have to release it using the method SCIPreleaseCons()
65  */
66 extern
68  SCIP* scip, /**< SCIP data structure */
69  SCIP_CONS** cons, /**< pointer to hold the created constraint */
70  const char* name, /**< name of constraint */
71  int nconss, /**< number of initial constraints in conjunction */
72  SCIP_CONS** conss, /**< initial constraint in conjunction */
73  SCIP_Bool enforce, /**< should the constraint be enforced during node processing?
74  * TRUE for model constraints, FALSE for additional, redundant constraints. */
75  SCIP_Bool check, /**< should the constraint be checked for feasibility?
76  * TRUE for model constraints, FALSE for additional, redundant constraints. */
77  SCIP_Bool local, /**< is constraint only valid locally?
78  * Usually set to FALSE. Has to be set to TRUE, e.g., for branching constraints. */
79  SCIP_Bool modifiable, /**< is constraint modifiable (subject to column generation)?
80  * Usually set to FALSE. In column generation applications, set to TRUE if pricing
81  * adds coefficients to this constraint. */
82  SCIP_Bool dynamic /**< is constraint subject to aging?
83  * Usually set to FALSE. Set to TRUE for own cuts which
84  * are separated as constraints. */
85  );
86 
87 /** creates and captures an and constraint
88  * in its most basic version, i. e., all constraint flags are set to their basic value as explained for the
89  * method SCIPcreateConsConjunction(); all flags can be set via SCIPsetConsFLAGNAME-methods in scip.h
90  *
91  * @see SCIPcreateConsConjunction() for information about the basic constraint flag configuration
92  *
93  * @note the constraint gets captured, hence at one point you have to release it using the method SCIPreleaseCons()
94  */
95 extern
97  SCIP* scip, /**< SCIP data structure */
98  SCIP_CONS** cons, /**< pointer to hold the created constraint */
99  const char* name, /**< name of constraint */
100  int nconss, /**< number of initial constraints in conjunction */
101  SCIP_CONS** conss /**< initial constraint in conjunction */
102  );
103 
104 /** adds constraint to the conjunction of constraints */
105 extern
107  SCIP* scip, /**< SCIP data structure */
108  SCIP_CONS* cons, /**< conjunction constraint */
109  SCIP_CONS* addcons /**< additional constraint in conjunction */
110  );
111 
112 /* @} */
113 
114 /* @} */
115 
116 #ifdef __cplusplus
117 }
118 #endif
119 
120 #endif
enum SCIP_Retcode SCIP_RETCODE
Definition: type_retcode.h:53
type definitions for return codes for SCIP methods
SCIP_RETCODE SCIPcreateConsBasicConjunction(SCIP *scip, SCIP_CONS **cons, const char *name, int nconss, SCIP_CONS **conss)
type definitions for SCIP&#39;s main datastructure
SCIP_RETCODE SCIPaddConsElemConjunction(SCIP *scip, SCIP_CONS *cons, SCIP_CONS *addcons)
SCIP_RETCODE SCIPincludeConshdlrConjunction(SCIP *scip)
#define SCIP_Bool
Definition: def.h:62
SCIP_RETCODE SCIPcreateConsConjunction(SCIP *scip, SCIP_CONS **cons, const char *name, int nconss, SCIP_CONS **conss, SCIP_Bool enforce, SCIP_Bool check, SCIP_Bool local, SCIP_Bool modifiable, SCIP_Bool dynamic)
common defines and data types used in all packages of SCIP
type definitions for constraints and constraint handlers