cobyqa 1.0.0

Constrained Optimization BY Quadratic Approximations

COBYQA, an acronym for Constrained Optimization BY Quadratic Approximations, is designed to supersede COBYLA as a general derivative-free optimization solver. It can handle unconstrained, bound-constrained, linearly constrained, and nonlinearly constrained problems. It uses only function values of the objective and constraint functions, if any. No derivative information is needed.

Documentation: https://www.cobyqa.com.

Installation

COBYQA can be installed for Python 3.8 or above.

Dependencies

The following Python packages are required by COBYQA:

• NumPy 1.17.0 or higher, and

• SciPy 1.10.0 or higher.

If you install COBYQA using pip (see below), these dependencies will be installed automatically. More dependencies are required to run the test suite and some examples given in the folder examples. See the relevant sections below for more details.

User installation

The easiest way to install COBYQA is using pip. In a terminal or command window type

pip install cobyqa

To check your installation, you can execute

python -c "import cobyqa; cobyqa.show_versions()"

If your python launcher is not python, you can replace it with the appropriate command (similarly for pip). For example, you may need to use python3 instead of python and pip3 instead of pip.

Testing

To execute the test suite of COBYQA, you first need to install pytest. You can then run the test suite by executing

pytest --pyargs cobyqa

The test suite takes several minutes to run. It is unnecessary to run the test suite if you installed COBYQA using the recommended method described above.

Examples

The folder examples contains a few examples of how to use COBYQA. To run powell2015.py, you first need to install matplotlib. These files contains headers explaining what problems they solve.

Support

To report a bug or request a new feature, please open a new issue using the issue tracker.