Skip to main content
Build Status GNU GPL v3 License

DFBGN is a Python package for nonlinear least-squares minimization, where derivatives are not available. It is particularly useful when evaluations of the objective are expensive and/or noisy, and the number of variables to be optimized is large.

DFBGN is based on DFO-LS, but is better-suited when there are many variables to be optimized (so the linear algebra in DFO-LS is too slow). Unlike DFO-LS, DFBGN does not currently support bound constraints on the variables.

If you are interested in solving general optimization problems (without a least-squares structure), you may wish to try Py-BOBYQA.

Requirements

DFBGN requires the following software to be installed:

Additionally, the following python packages should be installed (these will be installed automatically if using pip, see Installation using pip):

Installation using pip

For easy installation, use pip as root:

$ [sudo] pip install dfbgn

or alternatively easy_install:

$ [sudo] easy_install dfbgn

If you do not have root privileges or you want to install DFBGN for your private use, you can use:

$ pip install --user dfbgn

which will install DFBGN in your home directory.

Note that if an older install of DFBGN is present on your system you can use:

$ [sudo] pip install --upgrade dfbgn

to upgrade DFBGN to the latest version.

Manual installation

Alternatively, you can download the source code from Github and unpack as follows:

$ git clone https://github.com/numericalalgorithmsgroup/dfbgn
$ cd dfbgn

DFBGN is written in pure Python and requires no compilation. It can be installed using:

$ [sudo] pip install .

If you do not have root privileges or you want to install DFBGN for your private use, you can use:

$ pip install --user .

instead.

To upgrade DFBGN to the latest version, navigate to the top-level directory (i.e. the one containing setup.py) and rerun the installation using pip, as above:

$ git pull
$ [sudo] pip install .  # with admin privileges

Testing

If you installed DFBGN manually, you can test your installation by running:

$ python setup.py test

Alternatively, the HTML documentation provides some simple examples of how to run DFBGN.

Examples

Examples of how to run DFBGN are given in the documentation, and the examples directory in Github.

Uninstallation

If DFBGN was installed using pip you can uninstall as follows:

$ [sudo] pip uninstall dfbgn

If DFBGN was installed manually you have to remove the installed files by hand (located in your python site-packages directory).

Bugs

Please report any bugs using GitHub’s issue tracker.

License

This algorithm is released under the GNU GPL license. Please contact NAG for alternative licensing.

Metadata

Release files for dfbgn 0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for dfbgn 0.1
File Size Uploaded
dfbgn-0.1.tar.gz 30.2 kB Details

Release files / dfbgn-0.1.tar.gz

Download URL dfbgn-0.1.tar.gz
Size 30.2 kB
Tags Source
SHA-256 checksum
How to use checksums
c0b681b868989b1dc2f68e0a67f5e23e174dd8cd478f1483ef80ddeadbbf82fe
BLAKE2b-256 checksum
How to use checksums
df100c975e03d39d5b1191c350e91dc9443e457f649a4a7dc46b1faa36828e8a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.6.0 requests/2.24.0 setuptools/39.0.1 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.6.9

Release history Release notifications | RSS feed

This release

0.1 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page