Skip to main content

An NLP solver for box-constrained optimization of polynomial cost functions

Project description

optipoly

optipoly is a non conventional optimizer dedicated to the optimization of multi-variate polynomial cost functions on admissible hypercubes. It leverages the extraordinarily fast computation of scalar polynomials by the scipy.interpolation.interp1d method in oder to derive a robust to local minima solution of the polynomial optimization problem.

Interested reader can refer to the citation provided for a complete description and comparison with some existing solvers.

Here, the main elements are explained briefly for an easy and quick use of the solver.

Installation

The following pip-install will ne shortly available!

pip install optipoly

Full description of the module is available.

Here a very short presentation is given.

The problem addressed

Given a polynomial in several variables of the form:

$$ P(x)=\sum_{i=1}^{n_c}c_i\phi_i(x)\quad \text{where} \quad \phi_i(x):=\prod_{j=1}^n x_j^{p_ij} $$

Assume that we want to find the minimum value of the polynomial over some hyper box defined by xminand xmax, namely

$$ \min_{x} P(x) \quad \text{$\vert\quad x\in [x_\text{min}, x_\text{max}]\subset \mathbb R^n$} $$

This is the kind of porblem optipoly is done for.

Tip

Using specific choice of the call inputs, optipolycan be used as well to find a maximum or to find a root of the polynomial.

Full description of the module is available.

Example of use

Consider the polynomial in three variables defined by:

$$ P(x) = x_1x_3^2+2x_2^3 $$

An instance of the class Pol that represent this polynomial can be created via the following script:

from optipoly import Pol

# Define the matrix of powers and c.
 
powers = [[1, 0, 2], [0,3,0]] 
coefs = [1.0, 2.0]            

# Create an instance of the class.

pol = Pol(powers, coefs)      

The following script gives an example of a call that asks for the maximization of the polynomial defined earlier (see @eq-examplePx) then prints the results so obtained:

nx = 3
x0 = np.zeros(nx)
ntrials = 6
ngrid = 1000
xmin = -1*np.ones(nx)
xmax = 2*np.ones(nx)

solution, cpu = pol.solve(x0=x0, 
                          xmin=xmin, 
                          xmax=xmax, 
                          ngrid=ngrid, 
                          Ntrials=ntrials, 
                          psi=lambda v:-v
                          )
                          
print(f'xopt = {solution.x}')
print(f'fopt = {solution.f}')
print(f'computation time = {solution.cpu}')

>> xopt = [-1.  2.  0.]
>> fopt = 16.0
>> computation time = 0.0046999454498291016

Changing the argument psito psi=lambda v:abs(v) asks the solver to zero the polynomial and hence, leads to the following results:

>> xopt = [-0.996997    0.58858859  0.63963964]
>> fopt = -9.305087356087371e-05
>> computation time = 0.003011941909790039

Finally, using the default definition leads to solve trying to find a minimum of the polynomial leading to:

>> xopt = [-1. -1.  2.]
>> fopt = -6.0
>> computation time = 0.005150318145751953

Full description of the module is available.

Citing optipoly

@misc{optipoly2024,
      title={optipoly: A Python package for boxed-constrained multi-variable polynomial cost functions optimization}, 
      author={Mazen Alamir},
      year={2024},
      eprint={5987757},
      archivePrefix={arXiv},
      primaryClass={eess.SY},
      url={https://arxiv.org/submit/5987757}, 
}

Tip

The above reference contains some comparison with alternative solver that underlines the performance of optipoly in terms of the achieved cost as well as in terms of the compuation time.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

optipoly-0.0.1.tar.gz (5.8 kB view details)

Uploaded Source

Built Distribution

optipoly-0.0.1-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

Details for the file optipoly-0.0.1.tar.gz.

File metadata

  • Download URL: optipoly-0.0.1.tar.gz
  • Upload date:
  • Size: 5.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.7

File hashes

Hashes for optipoly-0.0.1.tar.gz
Algorithm Hash digest
SHA256 b86325be3eeb4171955c50f4b68a2bb21f9ad640f0e206ef65e5e93311e9b87d
MD5 0a6d99a65d3929f53b5a00c1c5dc6364
BLAKE2b-256 9be3d803f117f8854cf7f232356dbaaba1a6798b773f9314686a2ed9e610bc4f

See more details on using hashes here.

File details

Details for the file optipoly-0.0.1-py3-none-any.whl.

File metadata

  • Download URL: optipoly-0.0.1-py3-none-any.whl
  • Upload date:
  • Size: 6.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.7

File hashes

Hashes for optipoly-0.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4212d3c97b883c4623389c3cec3eff24615d3d5c7546ab5a8ef595dc0e5dbdfc
MD5 5cfcb09f83cfb3acec061337dfbc672f
BLAKE2b-256 9e6ffcf12fa3b2e5ea39f552e9002647f1359cf24410f407fa6f1e26be2d6fa9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page