File: CbcGenCbcParam.hpp

package info (click to toggle)
coinor-cbc 2.9.9+repack1-1
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 7,848 kB
  • ctags: 5,787
  • sloc: cpp: 104,337; sh: 8,921; xml: 2,950; makefile: 520; ansic: 491; awk: 197
file content (195 lines) | stat: -rw-r--r-- 5,138 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
/*
  Copyright (C) 2007, Lou Hafer, International Business Machines Corporation
  and others.  All Rights Reserved.

  This code is licensed under the terms of the Eclipse Public License (EPL).

  $Id: CbcGenCbcParam.hpp 1899 2013-04-09 18:12:08Z stefan $
*/
/*
  This file is part of cbc-generic.
*/

#ifndef CbcCbcParam_H
#define CbcCbcParam_H

/* \file CbcGenCbcParam.hpp
   \brief Declarations for parameters that act on a CbcModel object.
*/

/*
  $Id: CbcGenCbcParam.hpp 1899 2013-04-09 18:12:08Z stefan $
*/

/*! \class CbcCbcParam
    \brief Class for control parameters that act on a CbcModel object.

    Adds parameter type codes and push/pull functions to the generic parameter
    object.
*/

class CbcCbcParam : public CoinParam {

public:

    /*! \name Subtypes */
//@{

    /*! \enum CbcCbcParamCode
        \brief Enumeration for parameters that control a CbcModel object

      These are parameters that control the operation of a CbcModel object.
      CBCCBC_FIRSTPARAM and CBCCBC_LASTPARAM are markers to allow convenient
      separation of parameter groups.
    */
    typedef enum { CBCCBC_FIRSTPARAM = CbcGenParam::CBCGEN_LASTPARAM + 1,

                   ALLOWABLEGAP, COSTSTRATEGY,
                   CUTDEPTH, CUTOFF, CUTPASS, DIRECTION,
                   GAPRATIO,
                   INCREMENT, INFEASIBILITYWEIGHT, INTEGERTOLERANCE,
                   LOGLEVEL, MAXIMIZE, MAXNODES, MINIMIZE,
                   MIPOPTIONS, MOREMIPOPTIONS, NUMBERANALYZE,
                   NUMBERBEFORE, NUMBERMINI,
                   STRONGBRANCHING, TIMELIMIT_BAB,

                   CBCCBC_LASTPARAM

                 } CbcCbcParamCode ;

//@}

    /*! \name Constructors and Destructors

      Be careful how you specify parameters for the constructors! There's great
      potential for confusion.
    */
//@{
    /*! \brief Default constructor */

    CbcCbcParam() ;

    /*! \brief Constructor for a parameter with a double value

      The default value is 0.0. Be careful to clearly indicate that \p lower and
      \p upper are real (double) values to distinguish this constructor from the
      constructor for an integer parameter.
    */
    CbcCbcParam(CbcCbcParamCode code, std::string name, std::string help,
                double lower, double upper, double dflt = 0.0,
                bool display = true) ;

    /*! \brief Constructor for a parameter with an integer value

      The default value is 0.
    */
    CbcCbcParam(CbcCbcParamCode code, std::string name, std::string help,
                int lower, int upper, int dflt = 0,
                bool display = true) ;

    /*! \brief Constructor for a parameter with keyword values

      The string supplied as \p firstValue becomes the first keyword.
      Additional keywords can be added using appendKwd(). Keywords are numbered
      from zero. It's necessary to specify both the first keyword (\p
      firstValue) and the default keyword index (\p dflt) in order to
      distinguish this constructor from the string and action parameter
      constructors.
    */
    CbcCbcParam(CbcCbcParamCode code, std::string name, std::string help,
                std::string firstValue, int dflt, bool display = true) ;

    /*! \brief Constructor for a string parameter

      The default string value must be specified explicitly to distinguish
      a string constructor from an action parameter constructor.
    */

    CbcCbcParam(CbcCbcParamCode code, std::string name, std::string help,
                std::string dflt, bool display = true) ;

    /*! \brief Constructor for an action parameter */

    CbcCbcParam(CbcCbcParamCode code, std::string name, std::string help,
                bool display = true) ;

    /*! \brief Copy constructor */

    CbcCbcParam(const CbcCbcParam &orig) ;

    /*! \brief Clone */

    CbcCbcParam *clone() ;

    /*! \brief Assignment */

    CbcCbcParam &operator=(const CbcCbcParam &rhs) ;

    /*! \brief  Destructor */

    ~CbcCbcParam() ;

//@}

    /*! \name Methods to query and manipulate a parameter object */
//@{

    /*! \brief Get the parameter code  */

    inline CbcCbcParamCode paramCode() const {
        return (paramCode_) ;
    }

    /*! \brief Set the parameter code */

    inline void setParamCode(CbcCbcParamCode code) {
        paramCode_ = code ;
    }

    /*! \brief Get the underlying CbcModel object */

    inline CbcModel *obj() const {
        return (obj_) ;
    }

    /*! \brief Set the underlying CbcModel object */

    inline void setObj(CbcModel *obj) {
        obj_ = obj ;
    }

//@}

private:

    /*! \name Data */
//@{

    /// Parameter code
    CbcCbcParamCode paramCode_ ;

    /// CbcModel object
    CbcModel *obj_ ;

//@}

} ;


/*
  Declare the utility functions.
*/

namespace CbcCbcParamUtils {
void addCbcCbcParams(int &numParams, CoinParamVec &paramVec,
                     CbcModel *model) ;
void loadCbcParamObj(const CoinParamVec paramVec, int first, int last,
                     CbcModel *model) ;
void setCbcModelDefaults (CbcModel *model) ;

int pushCbcCbcDbl(CoinParam *param) ;
int pushCbcCbcInt(CoinParam *param) ;
}

#endif