Changes between Version 80 and Version 81 of WikiStart


Ignore:
Timestamp:
Mar 6, 2016 8:59:36 AM (5 years ago)
Author:
tkr
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WikiStart

    v80 v81  
    3939== Download and Install ==
    4040
    41  * '''Linux''': On Debian, Cbc has recently become available in the package {{{coinor-cbc}}} and can be installed with apt. On Fedora, Cbc is available in the package {{{coin-or-Cbc}}}. Pre-compiled binaries are also available as part of the [http://www.coin-or.org/download/binary/CoinAll  COIN-OR Optimization Suite].
     41 * '''Linux''': On Debian/Ubuntu, Cbc is available in the package {{{coinor-cbc}}} and can be installed with apt. On Fedora, Cbc is available in the package {{{coin-or-Cbc}}}. Pre-compiled binaries are also available as part of the [http://www.coin-or.org/download/binary/CoinAll  COIN-OR Optimization Suite].
    4242 * '''Windows''': The easiest way to get Cbc on Windows is to download the Windows installer for the [http://www.coin-or.org/download/binary/CoinAll  COIN Optimization Suite], which provides Visual Studio compatible libraries and binaries. Binary archives are also available for other Windows platforms, such as MinGW and CYGWIN.
    4343 * '''OS X''': The easiest way to get Cbc on OSX is through Homebrew (recipe should be available soon). When the recipe is ready, it will be installable with {{{brew install cbc}}}.
    44 
     44 * AMPL also provides stand-alone provides [http://ampl.com/products/solvers/open-source/#cbc Cbc executables] that can be used with (or without) AMPL.
     45 * The [http://www.gams.com GAMS] distribution includes Cbc.
    4546Due to license incompatibilities, pre-compiled binaries lack some functionality. If binaries are not available for your platform for the latest version and you would like to request them to be built and posted, feel free to let us know on the mailing list.
    4647
     
    7980For Microsoft Visual C++ users, there are project files for version 10 available in the MSVisualStudio directory. First, obtain the source code using either a Windows subversion client (see the [http://www.coin-or.org/faqs.html#q4 COIN-OR FAQ]) or download a snapshot. In MSVC++ Version 10, open the solution file (this should be converted to whatever version of MSVC+ you are using) and build the Cbc project. The code should build out of the box with default settings.
    8081
    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.
     82It 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
     100If you have {{{Doxygen}}} available, you can build the html documentation by typing
     101
     102 {{{make doxydoc}}}
     103
     104in the source directory after building with the autotools in any *nix environment.
     105After making the documentation, open the file {{{doxydoc/html/index.html}}} with a browser.
     106Note that this creates the documentation for the entire {{{Cbc}}}
     107package (including dependencies). If you prefer to generate the documentation only for a subset
     108of these projects, you can edit the file {{{doxydoc/doxygen.conf}}} to exclude directories
     109(using the {{{EXCLUDE}}} variable, for example).
     110
     111If {{{Doxygen}}} is not available, you can use the link to the {{{Cbc}}} html documentation listed above.
    82112
    83113== News ==
     
    287317   * Click [https://projects.coin-or.org/Cbc/changeset?old_path=%2Freleases%2F2.7.8&new_path=%2Freleases%2F2.8.0 here] to see changes from release [https://projects.coin-or.org/Cbc/browser/releases/2.7.8 2.7.8]
    288318
    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]
    437320
    438321== Project Links ==