Multistart Solver
==================

The multistart solver is used in cases where the objective function is known
to be non-convex but the global optimum is still desired. It works by running a non-linear
solver of your choice multiple times at different starting points, and
returns the best of the solutions.


Using Multistart Solver
-----------------------
To use the multistart solver, define your Pyomo model as usual:

.. doctest::

  Required import
  >>> import pyomo.environ as pyo

  Create a simple model
  >>> m = pyo.ConcreteModel()
  >>> m.x = pyo.Var()
  >>> m.y = pyo.Var()
  >>> m.obj = pyo.Objective(expr=m.x**2 + m.y**2)
  >>> m.c = pyo.Constraint(expr=m.y >= -2*m.x + 5)

  Invoke the multistart solver
  >>> pyo.SolverFactory('multistart').solve(m)  # doctest: +SKIP


Multistart wrapper implementation and optional arguments
--------------------------------------------------------

.. autoclass:: pyomo.contrib.multistart.multi.MultiStart
    :noindex:
    :members: