# optimagic
[](https://pypi.org/project/optimagic)
[](https://anaconda.org/conda-forge/optimagic)
[](https://anaconda.org/conda-forge/optimagic)
[](https://pypi.org/project/optimagic)
[](https://optimagic.readthedocs.io/en/latest)
[](https://github.com/optimagic-dev/optimagic/actions?query=branch%3Amain)
[](https://codecov.io/gh/optimagic-dev/optimagic)
[](https://results.pre-commit.ci/latest/github/optimagic-dev/optimagic/main)
[](https://github.com/astral-sh/ruff)
[](CODE_OF_CONDUCT.md)
[](https://pepy.tech/project/optimagic)
[](https://numfocus.org/sponsored-projects/affiliated-projects)
[](https://x.com/optimagic)
## Introduction
*optimagic* is a Python package for numerical optimization. It is a unified interface to
optimizers from SciPy, NlOpt and many other Python packages.
*optimagic*'s `minimize` function works just like SciPy's, so you don't have to adjust
your code. You simply get more optimizers for free. On top you get powerful diagnostic
tools, parallel numerical derivatives and more.
*optimagic* was formerly called *estimagic*, because it also provides functionality to
perform statistical inference on estimated parameters. *estimagic* is now a subpackage
of *optimagic*.
## Documentation
The documentation is hosted at https://optimagic.readthedocs.io
## Installation
The package can be installed via pip or conda. To do so, type the following commands in
a terminal:
```bash
pip install optimagic
```
or
```bash
$ conda config --add channels conda-forge
$ conda install optimagic
```
The first line adds conda-forge to your conda channels. This is necessary for conda to
find all dependencies of optimagic. The second line installs optimagic and its
dependencies.
## Installing optional dependencies
Only `scipy` is a mandatory dependency of optimagic. Other algorithms become available
if you install more packages. We make this optional because most of the time you will
use at least one additional package, but only very rarely will you need all of them.
For an overview of all optimizers and the packages you need to install to enable them
see {ref}`list_of_algorithms`.
To enable all algorithms at once, do the following:
`conda install nlopt`
`pip install Py-BOBYQA`
`pip install DFO-LS`
`conda install petsc4py` (Not available on Windows)
`conda install cyipopt`
`conda install pygmo`
`pip install fides>=0.7.4 (Make sure you have at least 0.7.1)`
## Citation
If you use optimagic for your research, please do not forget to cite it.
```
@Unpublished{Gabler2024,
Title = {optimagic: A library for nonlinear optimization},
Author = {Janos Gabler},
Year = {2022},
Url = {https://github.com/optimagic-dev/optimagic}
}
```
## Acknowledgements
We thank all institutions that have funded or supported optimagic (formerly estimagic)
<img src="docs/source/_static/images/aai-institute-logo.svg" width="185">
<img src="docs/source/_static/images/numfocus_logo.png" width="200">
<img src="docs/source/_static/images/tra_logo.png" width="240">
<img src="docs/source/_static/images/hoover_logo.png" width="192">
<img src="docs/source/_static/images/transferlab-logo.svg" width="400">
Raw data
{
"_id": null,
"home_page": null,
"name": "optimagic",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Janos Gabler <janos.gabler@gmail.com>, Tim Mensinger <mensingertim@gmail.com>",
"keywords": "derivative free optimization, estimation, extremum estimation, finite differences, global optimization, inference, maximum likelihood, method of simulated moments, nonlinear optimization, numerical differentiation, optimization, parallel optimization, statistics",
"author": null,
"author_email": "Janos Gabler <janos.gabler@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/5a/75/c03c08f82ce9707636ca99fc4e24fbfb51537dcad90aeddfa3acc1a1865e/optimagic-0.5.1.tar.gz",
"platform": null,
"description": "# optimagic\n\n\n[](https://pypi.org/project/optimagic)\n[](https://anaconda.org/conda-forge/optimagic)\n[](https://anaconda.org/conda-forge/optimagic)\n[](https://pypi.org/project/optimagic)\n[](https://optimagic.readthedocs.io/en/latest)\n[](https://github.com/optimagic-dev/optimagic/actions?query=branch%3Amain)\n[](https://codecov.io/gh/optimagic-dev/optimagic)\n[](https://results.pre-commit.ci/latest/github/optimagic-dev/optimagic/main)\n[](https://github.com/astral-sh/ruff)\n[](CODE_OF_CONDUCT.md)\n[](https://pepy.tech/project/optimagic)\n[](https://numfocus.org/sponsored-projects/affiliated-projects)\n[](https://x.com/optimagic)\n\n## Introduction\n\n*optimagic* is a Python package for numerical optimization. It is a unified interface to\noptimizers from SciPy, NlOpt and many other Python packages.\n\n*optimagic*'s `minimize` function works just like SciPy's, so you don't have to adjust\nyour code. You simply get more optimizers for free. On top you get powerful diagnostic\ntools, parallel numerical derivatives and more.\n\n*optimagic* was formerly called *estimagic*, because it also provides functionality to\nperform statistical inference on estimated parameters. *estimagic* is now a subpackage\nof *optimagic*.\n\n## Documentation\n\nThe documentation is hosted at https://optimagic.readthedocs.io\n\n## Installation\n\nThe package can be installed via pip or conda. To do so, type the following commands in\na terminal:\n\n```bash\npip install optimagic\n```\n\nor\n\n```bash\n$ conda config --add channels conda-forge\n$ conda install optimagic\n```\n\nThe first line adds conda-forge to your conda channels. This is necessary for conda to\nfind all dependencies of optimagic. The second line installs optimagic and its\ndependencies.\n\n## Installing optional dependencies\n\nOnly `scipy` is a mandatory dependency of optimagic. Other algorithms become available\nif you install more packages. We make this optional because most of the time you will\nuse at least one additional package, but only very rarely will you need all of them.\n\nFor an overview of all optimizers and the packages you need to install to enable them\nsee {ref}`list_of_algorithms`.\n\nTo enable all algorithms at once, do the following:\n\n`conda install nlopt`\n\n`pip install Py-BOBYQA`\n\n`pip install DFO-LS`\n\n`conda install petsc4py` (Not available on Windows)\n\n`conda install cyipopt`\n\n`conda install pygmo`\n\n`pip install fides>=0.7.4 (Make sure you have at least 0.7.1)`\n\n## Citation\n\nIf you use optimagic for your research, please do not forget to cite it.\n\n```\n@Unpublished{Gabler2024,\n Title = {optimagic: A library for nonlinear optimization},\n Author = {Janos Gabler},\n Year = {2022},\n Url = {https://github.com/optimagic-dev/optimagic}\n}\n```\n\n## Acknowledgements\n\nWe thank all institutions that have funded or supported optimagic (formerly estimagic)\n\n<img src=\"docs/source/_static/images/aai-institute-logo.svg\" width=\"185\">\n<img src=\"docs/source/_static/images/numfocus_logo.png\" width=\"200\">\n<img src=\"docs/source/_static/images/tra_logo.png\" width=\"240\">\n\n<img src=\"docs/source/_static/images/hoover_logo.png\" width=\"192\">\n<img src=\"docs/source/_static/images/transferlab-logo.svg\" width=\"400\">\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Tools to solve difficult numerical optimization problems.",
"version": "0.5.1",
"project_urls": {
"Github": "https://github.com/optimagic-dev/optimagic",
"Repository": "https://github.com/optimagic-dev/optimagic",
"Tracker": "https://github.com/optimagic-dev/optimagic/issues"
},
"split_keywords": [
"derivative free optimization",
" estimation",
" extremum estimation",
" finite differences",
" global optimization",
" inference",
" maximum likelihood",
" method of simulated moments",
" nonlinear optimization",
" numerical differentiation",
" optimization",
" parallel optimization",
" statistics"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6c976f317ac8a0bc558392d17a250dfb82dcf8f0a1be2675a296c75ca043398f",
"md5": "288299c9f2a05fa5653f52c112d76978",
"sha256": "c7a14e7409e77dea6720bea311cc55b2546834a2d12aaf7ac739ab1b0d713cd6"
},
"downloads": -1,
"filename": "optimagic-0.5.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "288299c9f2a05fa5653f52c112d76978",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 393521,
"upload_time": "2024-11-13T17:03:14",
"upload_time_iso_8601": "2024-11-13T17:03:14.226679Z",
"url": "https://files.pythonhosted.org/packages/6c/97/6f317ac8a0bc558392d17a250dfb82dcf8f0a1be2675a296c75ca043398f/optimagic-0.5.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5a75c03c08f82ce9707636ca99fc4e24fbfb51537dcad90aeddfa3acc1a1865e",
"md5": "0082aa6f34fe0e559db76f8608a8784b",
"sha256": "0b14baab36ee3cb6bc86a37176993e1ad065c3e8026c5456a811e16c561ed0c8"
},
"downloads": -1,
"filename": "optimagic-0.5.1.tar.gz",
"has_sig": false,
"md5_digest": "0082aa6f34fe0e559db76f8608a8784b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 338411,
"upload_time": "2024-11-13T17:03:15",
"upload_time_iso_8601": "2024-11-13T17:03:15.813362Z",
"url": "https://files.pythonhosted.org/packages/5a/75/c03c08f82ce9707636ca99fc4e24fbfb51537dcad90aeddfa3acc1a1865e/optimagic-0.5.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-13 17:03:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "optimagic-dev",
"github_project": "optimagic",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "optimagic"
}
JSON
