81 | | It is also possible to build Cbc with the Visual Studio compiler from the command line using the procedure for Unix-like environments, using the Msys2 shell or CYGWIN. This is the recommended and best-supported way of building Cbc in Windows. |
| 82 | It is also possible to build Cbc with the Visual Studio compiler from the command line using the procedure for Unix-like environments, using the Msys2 shell or CYGWIN. This is the recommended and best-supported way of building Cbc in Windows from source. |
| 83 | |
| 84 | == Documentation == |
| 85 | |
| 86 | * See the current [https://projects.coin-or.org/Cbc/browser/trunk/Cbc/README README] and [https://projects.coin-or.org/Cbc/browser/trunk/Cbc/INSTALL INSTALL] files to get started quickly. |
| 87 | * [http://www.coin-or.org/Cbc/index.html User's Guide] ([http://www.coin-or.org/Cbc/cbcuserguide.html single page format]) |
| 88 | * [https://projects.coin-or.org/CoinBinary/export/1059/OptimizationSuite/trunk/Installer/files/doc/cbcCommandLine.pdf Cbc command-line guide] |
| 89 | * [http://www.coin-or.org/Doxygen/Cbc/hierarchy.html Cbc html documentation] |
| 90 | * [wiki:FAQ FAQ (Frequently Asked Questions)] |
| 91 | * [wiki:FYI Lessons from the trenches] |
| 92 | * Source code [source:trunk/Cbc/examples examples] |
| 93 | * [wiki:SuccessStories Success Stories] |
| 94 | * [wiki:CbcPapers Cbc Papers] |
| 95 | * [wiki:cbc_undocumented Cbc undocumented features]. |
| 96 | * [wiki:VSSetup Setting up a Visual Studio project to use CBC] |
| 97 | |
| 98 | == {{{Doxygen}}} Documentation == |
| 99 | |
| 100 | If you have {{{Doxygen}}} available, you can build the html documentation by typing |
| 101 | |
| 102 | {{{make doxydoc}}} |
| 103 | |
| 104 | in the source directory after building with the autotools in any *nix environment. |
| 105 | After making the documentation, open the file {{{doxydoc/html/index.html}}} with a browser. |
| 106 | Note that this creates the documentation for the entire {{{Cbc}}} |
| 107 | package (including dependencies). If you prefer to generate the documentation only for a subset |
| 108 | of these projects, you can edit the file {{{doxydoc/doxygen.conf}}} to exclude directories |
| 109 | (using the {{{EXCLUDE}}} variable, for example). |
| 110 | |
| 111 | If {{{Doxygen}}} is not available, you can use the link to the {{{Cbc}}} html documentation listed above. |
289 | | November 21, 2012 |
290 | | |
291 | | * Cbc [https://projects.coin-or.org/Cbc/browser/releases/2.7.8 2.7.8] has been released. |
292 | | * Change message when LP simplex iteration limit is hit from "Exiting on maximum nodes" to "Exiting on maximum number of iterations". |
293 | | * Fix for using overlapping SOS. |
294 | | * Fixes in buildsystem. |
295 | | * Click [https://projects.coin-or.org/Cbc/changeset?old_path=%2Freleases%2F2.7.7&new_path=%2Freleases%2F2.7.8 here] to see changes from release [https://projects.coin-or.org/Cbc/browser/releases/2.7.7 2.7.7] |
296 | | |
297 | | June 7, 2012 |
298 | | |
299 | | * Cbc [https://projects.coin-or.org/Cbc/browser/releases/2.7.7 2.7.7] has been released. |
300 | | * Fix to report interruption on user event if SIGINT is received by !CbcSolver.[[BR]] |
301 | | {{{model->status()}}} should now be 5 if this event happened.[[BR]] |
302 | | Added method CbcModel::sayEventHappened() to make cbc stop due to an 'user event'. |
303 | | * Other minor fixes. |
304 | | * Click [https://projects.coin-or.org/Cbc/changeset?old_path=%2Freleases%2F2.7.6&old=1788&new_path=%2Freleases%2F2.7.7&new=1788 here] to see changes from release [https://projects.coin-or.org/Cbc/browser/releases/2.7.6 2.7.6] |
305 | | |
306 | | February 10, 2012 |
307 | | |
308 | | * Cbc [https://projects.coin-or.org/Cbc/browser/releases/2.7.6 2.7.6] has been released. |
309 | | * Fixes to build system. |
310 | | * Other minor fixes. |
311 | | * Click [https://projects.coin-or.org/Cbc/changeset?old_path=%2Freleases%2F2.7.5&old=1768&new_path=%2Freleases%2F2.7.6&new=1768 here] to see changes from release [https://projects.coin-or.org/Cbc/browser/releases/2.7.5 2.7.5] |
312 | | |
313 | | November 3, 2011 |
314 | | |
315 | | * Cbc [https://projects.coin-or.org/Cbc/browser/releases/2.7.5 2.7.5] has been released. |
316 | | * Fixes to get AMPL interface working again. |
317 | | * More fixes to MSVC++ files. |
318 | | * Click [https://projects.coin-or.org/Cbc/changeset?old_path=%2Freleases%2F2.7.4&old=1768&new_path=%2Freleases%2F2.7.5&new=1768 here] to see changes from release [https://projects.coin-or.org/Cbc/browser/releases/2.7.4 2.7.4] |
319 | | |
320 | | October 22, 2011 |
321 | | |
322 | | * Cbc [https://projects.coin-or.org/Cbc/browser/releases/2.7.4 2.7.4] has been released. |
323 | | * Minor bug fixes |
324 | | * Click [https://projects.coin-or.org/Cbc/changeset?old_path=%2Freleases%2F2.7.3&old=1759&new_path=%2Freleases%2F2.7.4&new=1759 here] to see changes from release [https://projects.coin-or.org/Cbc/browser/releases/2.7.3 2.7.3] |
325 | | |
326 | | October 16, 2011 |
327 | | |
328 | | * Cbc [https://projects.coin-or.org/Cbc/browser/releases/2.7.3 2.7.3] has been released. |
329 | | * Minor bug fixes |
330 | | * Fixes to MSVC++ files |
331 | | * Click [https://projects.coin-or.org/Cbc/changeset?old_path=%2Freleases%2F2.7.2&old=1759&new_path=%2Freleases%2F2.7.3&new=1759 here] to see changes from release [https://projects.coin-or.org/Cbc/browser/releases/2.7.2 2.7.2] |
332 | | |
333 | | September 20, 2011 |
334 | | |
335 | | * Cbc [https://projects.coin-or.org/Cbc/browser/releases/2.7.2 2.7.2] has been released. |
336 | | * Allow row/column names for GMPL models |
337 | | * Added {{{CbcModel::haveMultiThreadSupport()}}} to indicate whether Cbc library has been compiled with multithread support |
338 | | * Added {{{CbcModel::waitingForMiniBranchAndBound()}}} to indicate whether sub-MIP heuristic is currently running |
339 | | * Cbc shell should work with readline if configured with {{{--enable-gnu-packages}}} |
340 | | * Support for compressed input files (.gz, .bz2) is now enabled by default |
341 | | * Fix problems with relative gap tolerance > 100% and further bugs |
342 | | * Fixes for MSVC++ Version 9 files |
343 | | * Minor fixes in buildsystem; update to !BuildTools 0.7.1 |
344 | | * Click [https://projects.coin-or.org/Cbc/changeset?reponame=&new=1728%40stable&old=1701%40stable here] to see changes from release [https://projects.coin-or.org/Cbc/browser/releases/2.7.1 2.7.1] |
345 | | |
346 | | July 22, 2011 |
347 | | |
348 | | * Cbc [https://projects.coin-or.org/Cbc/browser/releases/2.7.1 2.7.1] has been released. |
349 | | * Fixes for MSVC++ Version 10 files |
350 | | * Click [https://projects.coin-or.org/Cbc/changeset?old_path=%2Freleases%2F2.7.0&old=1704&new_path=%2Freleases%2F2.7.1&new=1704 here] to see changes from release [https://projects.coin-or.org/Cbc/browser/releases/2.7.0 2.7.0] |
351 | | |
352 | | July 18, 2011 |
353 | | |
354 | | * Cbc [https://projects.coin-or.org/Cbc/browser/releases/2.7.0 2.7.0] has been released. |
355 | | * License has been changed to the EPL. |
356 | | * Support for MSVC++ version 10 added. |
357 | | * Support for [https://projects.coin-or.org/BuildTools/ BuildTools] version [https://projects.coin-or.org/BuildTools/browser/stable/0.7 0.7] to incorporate recent enhancements, including proper library versioning in Linux, prohibiting installation of private headers, etc. |
358 | | * Updating externals to new stable versions of dependent projects. |
359 | | * Improvements to heuristics. |
360 | | * New options for cut generation. |
361 | | * Improved reporting of results. |
362 | | * Improvements to documentation. |
363 | | * Minor bug fixes. |
364 | | |
365 | | January 4, 2011 |
366 | | |
367 | | * Cbc stable version [https://projects.coin-or.org/Cbc/browser/stable/2.7 2.7] was created. |
368 | | * Click [https://projects.coin-or.org/Cbc/changeset?old_path=%2Fstable%2F2.6&old=1689&new_path=%2Fstable%2F2.7&new=1689 here] to see the differences from version 2.6. |
369 | | |
370 | | ------------- |
371 | | |
372 | | == !Background/Download == |
373 | | |
374 | | Cbc is written in C++ and is released as open source code under the [http://www.opensource.org/licenses/eclipse-1.0 Eclipse Public License (EPL)]. It is available from the [http://www.coin-or.org/ COIN-OR initiative]. The code has been written by primarily by John J. Forrest. |
375 | | |
376 | | You can obtain the Cbc source code either via subversion or in form of nightly generated tarballs. The recommended method is to use subversion because it makes it easier to obtain updates. The following commands may be used to obtain and build Cbc from the source code using subversion: |
377 | | 1. {{{svn co https://projects.coin-or.org/svn/Cbc/stable/2.9 coin-Cbc}}} |
378 | | 1. {{{cd coin-Cbc}}} |
379 | | 1. {{{./configure -C}}} |
380 | | 1. {{{make}}} |
381 | | 1. {{{make test}}} |
382 | | 1. {{{make install}}} |
383 | | |
384 | | Step 1 issues the subversion command to obtain the source code. One should check page [https://projects.coin-or.org/Cbc/browser/stable] to find out the latest stable version number. Alternatively one can obtain the source code from the [http://www.coin-or.org/download/source/Cbc tarball directory]. |
385 | | |
386 | | Step 3 runs a configure script that generates the make file. |
387 | | |
388 | | Step 4 builds the Cbc library and executable program. |
389 | | |
390 | | Step 5 builds and runs the Cbc unit test program. |
391 | | |
392 | | Step 6 Installs libraries, executables and header files in directories coin-Cbc/lib, coin-Cbc/bin and coin-Cbc/include. |
393 | | |
394 | | The [http://projects.coin-or.org/BuildTools/wiki BuildTools] project has additional details on downloading, building, and installing. |
395 | | |
396 | | The [http://projects.coin-or.org/CoinBinary Binary] project provides a downloadable binary distribution of Cbc. |
397 | | AMPL provides [http://ampl.com/products/solvers/open-source/#cbc Cbc executables] that can be used with AMPL. |
398 | | The [http://www.gams.com GAMS] distribution includes Cbc. |
399 | | |
400 | | Cbc is available in [http://packages.debian.org/search?searchon=sourcenames&keywords=coinor-cbc Debian] and [https://launchpad.net/ubuntu/+source/coinor-cbc Ubuntu]. |
401 | | |
402 | | --------- |
403 | | |
404 | | == {{{Doxygen}}} Documentation == |
405 | | |
406 | | If you have {{{Doxygen}}} available, you can build the html documentation by typing |
407 | | |
408 | | {{{make doxydoc}}} |
409 | | |
410 | | in the directory |
411 | | {{{coin-Cbc}}}. Then open the file {{{coin-Cbc/doxydoc/html/index.html}}} with a browser. |
412 | | Note that this creates the documentation for the {{{Cbc}}} |
413 | | package. If you |
414 | | prefer to generate the documentation only for a subset |
415 | | of these projects, you can edit the file {{{coin-Cbc/doxydoc/doxygen.conf}}} to exclude directories |
416 | | (using the {{{EXCLUDE}}} variable, for example). |
417 | | |
418 | | If {{{Doxygen}}} is not available, you can use the link to the {{{Cbc}}} html documentation listed below. |
419 | | |
420 | | ------------- |
421 | | |
422 | | == Documentation == |
423 | | |
424 | | * See the current [https://projects.coin-or.org/Cbc/browser/trunk/Cbc/README README] and [https://projects.coin-or.org/Cbc/browser/trunk/Cbc/INSTALL INSTALL] files to get started quickly. |
425 | | * [http://www.coin-or.org/Cbc/index.html User's Guide] ([http://www.coin-or.org/Cbc/cbcuserguide.html single page format]) |
426 | | * [https://projects.coin-or.org/CoinBinary/export/1059/OptimizationSuite/trunk/Installer/files/doc/cbcCommandLine.pdf Cbc command-line guide] |
427 | | * [http://www.coin-or.org/Doxygen/Cbc/hierarchy.html Cbc html documentation] |
428 | | * [wiki:FAQ FAQ (Frequently Asked Questions)] |
429 | | * [wiki:FYI Lessons from the trenches] |
430 | | * Source code [source:trunk/Cbc/examples examples] |
431 | | * [wiki:SuccessStories Success Stories] |
432 | | * [wiki:CbcPapers Cbc Papers] |
433 | | * [wiki:cbc_undocumented Cbc undocumented features]. |
434 | | * [wiki:VSSetup Setting up a Visual Studio project to use CBC] |
435 | | |
436 | | ------------- |
| 319 | [Archived News ArchivedNews] |