Version 31 (modified by pbonami, 13 years ago) (diff) |
---|

# Welcome to the Bonmin homepage

Bonmin (**B**asic **O**pen-source **N**onlinear **M**ixed **IN**teger programming) is an

experimental open-source C++ code for solving general MINLP (Mixed Integer NonLinear

Programming) problems of the form:

min f(x) s.t. g_L <= g(x) <= g_U x_L <= x <= x_U x_i in Z^n for all i in I and, x_i in R^n for all i not in I.

where ` f(x): R^n --> R`,
` g(x): R^n --> R^m ` are twice continuously differentiable functions and ` I ` is a subset of ` {1,..,n`}.

Bonmin is distributed under the Common Public License (Cpl) on COIN-OR. The CPL is a license approved by the OSI (Open Source Initiative), thus Bonmin is OSI Certified Open Source Software.

Bonmin features several algorithms

- B-BB is a NLP-based branch-and-bound algorithm,
- B-OA is an outer-approximation decomposition algorithm,
- B-QG is an implementation of Quesada and Grossmann's branch-and-cut algorithm,
- B-Hyb is a hybrid outer-approximation based branch-and-cut algorithm.

The algorithms in Bonmin are exact when the functions `f` and `g` are convex; in the case where `f` or `g` or both are non-convex they are heuristics.

More information on Bonmin installation and usage can be found in the Bonmin User's Manual.

More information on the underlying algorithms in Bonmin can be found in: P. Bonami, L.T. Biegler, A.R. Conn, G. Cornuejols, I.E. Grossmann, C.D. Laird, J. Lee, A. Lodi, F. Margot, N.Sawaya and A. Waechter, An Algorithmic Framework for Convex Mixed Integer Nonlinear Programs by IBM Research Report RC23771, Oct. 2005.

## Tested platforms

Bonmin has been installed and used on the following systems:

- Linux using g++ version 3.* and 4.*
- Windows using Cygwin version 1.5.18
- Mac OS X using gcc 3.* and 4.*

Bonmin should be easy relatively easy to install on most un*x's provided that you have a C++ and a Fortran compiler. We don't know anybody who has yet tried to build it in the Microsoft Development Studio, the contribution of anybody who uses Microsoft Development Studio and has good knoweldge of it will be very appreciated.

## Downloading Bonmin

Bonmin is preferably downloaded by using subversion.

In Un*x environments, make a directory, say `Bonmin-dist` where you want to
download the code. Change to `Bonmin-dist`, and issue the following
command:

svn co svn://projects.coin-or.org/svn/Bonmin/trunk .

This copies all the necessary COIN-OR files to compile Bonmin to
`Bonmin-dist`.

### Obtaining required third party code

Bonmin needs a few external packages which are not included in the Bonmin package:

- Lapack (Linear Algebra PACKage)
- Blas (Basic Linear Algebra Subroutines)
- the sparse linear solver MA27 from the Harwell Subroutine Library and optionally (but strongly recommended) MC19 to enable automatic scaling in \Ipopt.
- optionally ASL (the Ampl Solver Library), to be able to use Bonmin from Ampl.

Since these third-party software modules are released under licenses
that are incompatible with the CPL (pay attention to their licenses), they cannot be included for
distribution with Bonmin, but you will find scripts
to help you download them in the subdirectory `ThirdParty` of
the Bonmin distribution (Detailed instruction can be found in Ipopt manual or here?

## Instaling Bonmin

To install Bonmin issue the following command in the main Bonmin distribution (`Bonmin-dist` above) directory:

- ./configure -C
- make
- make test
- make install

The User's Manual and the BuildTools project have additional details on downloading, building, and installing.

## Improve this page, report a bug, contribute to Bonmin

As all Wiki pages, this page is editable, this means that you can modify the contents of this page simply by using your web-browser. First register and login then simply click on the "Edit this page" link at the bottom of the page. WikiFormatting will give you a detailed description of available Wiki formatting commands.

The preferred way to report a bug is to use the ticket system. To report a bug using this system:

Alternatively you can send an email to the project manager pbonami@….

As an open-source code, contribution to Bonmin are welcome. To submit a contribution to Bonmin please follow the COIN-OR guidelines.

## Included Projects

If you download the Bonmin package, you get these additional projects.