1 | These instructions are for UNIX-like systems (including Linux, Cygwin |
---|
2 | and MSys) only. If Microsoft Developer Studio projects are |
---|
3 | maintained for this package, you can find instructions at |
---|
4 | |
---|
5 | https://projects.coin-or.org/MSVisualStudio |
---|
6 | |
---|
7 | ********************************************************************** |
---|
8 | *** DOWNLOAD *** |
---|
9 | ********************************************************************** |
---|
10 | |
---|
11 | You can obtain the source code for the Cbc package in two ways: |
---|
12 | |
---|
13 | 1. Obtain the source directly from the COIN-OR subversion repository |
---|
14 | (recommended). For this you needs the program 'svn' installed on |
---|
15 | your machine, and output of "svn --version" must contain |
---|
16 | "handles 'https' scheme". |
---|
17 | |
---|
18 | Assuming that you want to download the code into a subdirectory |
---|
19 | "COIN-Cbc", you type |
---|
20 | |
---|
21 | svn co https://projects.coin-or.org/svn/Cbc/trunk Coin-Cbc |
---|
22 | |
---|
23 | 2. Download the tarball from http://www.coin-or.org/Tarballs/Cbc and |
---|
24 | extract it, for example, with |
---|
25 | |
---|
26 | gunzip Cbc_2006Jun07.tgz |
---|
27 | tar xvf Cbc_2006Jun07.tar |
---|
28 | |
---|
29 | (Here "2006Jun07" is of course replaced by the string in the |
---|
30 | tarball you downloaded.) |
---|
31 | |
---|
32 | More detailed download instructions can be found at |
---|
33 | |
---|
34 | https://projects.coin-or.org/BuildTools/wiki/user-download |
---|
35 | |
---|
36 | ********************************************************************** |
---|
37 | *** CONFIGURATION *** |
---|
38 | ********************************************************************** |
---|
39 | |
---|
40 | Go into the directory that you just downloaded or extracted (e.g., |
---|
41 | Coin-Cbc or Cbc_2006Jun07). Then you type |
---|
42 | |
---|
43 | ./configure |
---|
44 | |
---|
45 | Note that you might have to specify additional options, in case you |
---|
46 | don't want to use the default choices that configure makes (e.g., |
---|
47 | compilers). Please visit |
---|
48 | |
---|
49 | https://projects.coin-or.org/BuildTools/wiki/user-configure |
---|
50 | |
---|
51 | and the Cbc Trac page |
---|
52 | |
---|
53 | https://projects.coin-or.org/Cbc |
---|
54 | |
---|
55 | for more information. |
---|
56 | |
---|
57 | If everything went fine, you will see at the end of the output |
---|
58 | |
---|
59 | "Main configuration of Cbc successful" |
---|
60 | |
---|
61 | ********************************************************************** |
---|
62 | *** COMPILATION AND INSTALLATION *** |
---|
63 | ********************************************************************** |
---|
64 | |
---|
65 | In the directory where you ran the configure script: |
---|
66 | |
---|
67 | 1. Compile the code by typing |
---|
68 | |
---|
69 | make |
---|
70 | |
---|
71 | 2. To test if the code works, you can type |
---|
72 | |
---|
73 | make test |
---|
74 | |
---|
75 | 3. To install the code, you type |
---|
76 | |
---|
77 | make install |
---|
78 | |
---|
79 | After this, you will find the executables, libraries and header |
---|
80 | files in the "bin", "lib" and "include" subdirectory, respectively. |
---|
81 | |
---|
82 | More information on the compilation and installation can be found at |
---|
83 | |
---|
84 | https://projects.coin-or.org/BuildTools/wiki/user-compile |
---|
85 | |
---|
86 | ********************************************************************** |
---|
87 | *** USING THE LIBRARIES *** |
---|
88 | ********************************************************************** |
---|
89 | |
---|
90 | Now you can link your own code with the installed libraries. You can |
---|
91 | find examples in the |
---|
92 | |
---|
93 | Cbc/examples/ |
---|
94 | |
---|
95 | subdirectory, see also the information at |
---|
96 | |
---|
97 | https://projects.coin-or.org/BuildTools/wiki/user-examples |
---|
98 | |
---|
99 | |
---|
100 | |
---|
101 | ==== 8< ====================================================== |
---|
102 | |
---|
103 | From here on you find the original installation instructions for the |
---|
104 | previous GNU Makefile build system. Most details have changed, but |
---|
105 | for now we keep it here so that possibly missing items might be found |
---|
106 | here. |
---|
107 | |
---|
108 | Prerequisites for installation: |
---|
109 | - at the moment on (*)nix platforms you must use g++ 2.95.2 or higher. |
---|
110 | - must use gnu make |
---|
111 | - to make the documentation doxygen must be installed |
---|
112 | |
---|
113 | Targets are put in subdirectories, whose name is derived from the |
---|
114 | platform name (as returned by `uname`) and the optimization level |
---|
115 | (e.g., Linux-g). |
---|
116 | |
---|
117 | To build Osi library and unitTest |
---|
118 | - read and edit the top of Makefile to select |
---|
119 | - whether shared or static library should be built |
---|
120 | - optimization level |
---|
121 | - where the compiled library should be installed |
---|
122 | If you want to use the Volume Algorithm as a solver then first |
---|
123 | you must build and install libvol. See Vol/INSTALL in the COIN |
---|
124 | root directory. |
---|
125 | - read and edit ../Makefiles/Makefile.locations to uncomment Clp lines |
---|
126 | - 'make' to build and install the library. |
---|
127 | - 'make unitTest' to create the unitTest program. It will be placed |
---|
128 | in the target subdirectory. |
---|
129 | |
---|
130 | - 'make doc' to create the html documentation of the classes in the |
---|
131 | library and place them in doc/html. |
---|
132 | |
---|
133 | To run Osi unitTest |
---|
134 | - unitTest from Osi directory |
---|
135 | |
---|
136 | To build Cbc executable |
---|
137 | In This directory 'make unitTest'. This actually creates and executable |
---|
138 | cbc in this directory which can both do unit test and act as simple |
---|
139 | driver. |
---|
140 | Cbc is fairly complex in that it needs: |
---|
141 | Cbc, Clp, Coin, Osi and Cgl |
---|
142 | |
---|
143 | It has been slightly tested with Osl instead of Clp. It worked but |
---|
144 | more slowly as it was harder to give hints to OSL or switch off |
---|
145 | output etc. |
---|
146 | |
---|
147 | Samples/sample2.cpp is preferred driver |
---|
148 | |
---|
149 | For more information see README and files in Samples |
---|
150 | |
---|