estimagic


Nameestimagic JSON
Version 0.4.6 PyPI version JSON
download
home_pagehttps://github.com/OpenSourceEconomics/estimagic
SummaryTools to solve difficult numerical optimization problems.
upload_time2023-06-05 15:45:06
maintainer
docs_urlNone
authorJanos Gabler
requires_python>=3.8
licenseMIT
keywords econometrics statistics estimation extremum estimation optimization inference numerical differentiation finite differences richardson extrapolation derivative free optimization method of simulated moments maximum likelihood
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # estimagic

[![image](https://img.shields.io/pypi/v/estimagic?color=blue)](https://pypi.org/project/estimagic)
[![image](https://img.shields.io/pypi/pyversions/estimagic)](https://pypi.org/project/estimagic)
[![image](https://img.shields.io/conda/vn/conda-forge/estimagic.svg)](https://anaconda.org/conda-forge/estimagic)
[![image](https://img.shields.io/conda/pn/conda-forge/estimagic.svg)](https://anaconda.org/conda-forge/estimagic)
[![image](https://img.shields.io/pypi/l/estimagic)](https://pypi.org/project/estimagic)
[![image](https://readthedocs.org/projects/estimagic/badge/?version=latest)](https://estimagic.readthedocs.io/en/latest)
[![image](https://img.shields.io/github/actions/workflow/status/OpenSourceEconomics/estimagic/main.yml?branch=main)](https://github.com/OpenSourceEconomics/estimagic/actions?query=branch%3Amain)
[![image](https://codecov.io/gh/OpenSourceEconomics/estimagic/branch/main/graph/badge.svg)](https://codecov.io/gh/OpenSourceEconomics/estimagic)
[![image](https://results.pre-commit.ci/badge/github/OpenSourceEconomics/estimagic/main.svg)](https://github.com/OpenSourceEconomics/estimagic/actions?query=branch%3Amain)
[![image](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![image](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT.md)
[![image](https://pepy.tech/badge/estimagic/month)](https://pepy.tech/project/estimagic)

## Introduction

estimagic is a Python package for nonlinear optimization with or without constraints. It
is particularly suited to solve difficult nonlinear estimation problems. On top, it
provides functionality to perform statistical inference on estimated parameters.

### Optimization

- estimagic wraps algorithms from *scipy.optimize*, *nlopt*, *pygmo* and more.
- estimagic implements constraints efficiently via reparametrization, so you can solve
  constrained problems with any optimzer that supports bounds.
- The parameters of an optimization problem can be arbitrary pytrees
- The complete history of parameters and function evaluations can be saved in a database
  for maximum reproducibility.
- Painless and efficient multistart optimization.
- The progress of the optimization is displayed in real time via an interactive
  dashboard.

<img src="docs/source/_static/images/dashboard.gif">

### Estimation and Inference

- You can estimate a model using method of simulated moments (MSM), calculate standard
  errors and do sensitivity analysis with just one function call.
- Asymptotic standard errors for maximum likelihood estimation.
- estimagic also provides bootstrap confidence intervals and standard errors. Of course
  the bootstrap procedures are parallelized.

### Numerical differentiation

- estimagic can calculate precise numerical derivatives using
  [Richardson extrapolations](https://en.wikipedia.org/wiki/Richardson_extrapolation).
- Function evaluations needed for numerical derivatives can be done in parallel with
  pre-implemented or user provided batch evaluators.

## Installation

The package can be installed via conda. To do so, type the following commands in a
terminal:

```bash
$ conda config --add channels conda-forge
$ conda install estimagic
```

The first line adds conda-forge to your conda channels. This is necessary for conda to
find all dependencies of estimagic. The second line installs estimagic and its
dependencies.

## Installing optional dependencies

Only `scipy` is a mandatory dependency of estimagic. 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)`

## Documentation

The documentation is hosted ([on rtd](https://estimagic.readthedocs.io/en/latest/#))

## Citation

If you use Estimagic for your research, please do not forget to cite it.

```
@Unpublished{Gabler2022,
  Title  = {A Python Tool for the Estimation of large scale scientific models.},
  Author = {Janos Gabler},
  Year   = {2022},
  Url    = {https://github.com/OpenSourceEconomics/estimagic}
}
```

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/OpenSourceEconomics/estimagic",
    "name": "estimagic",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "keywords": "econometrics,statistics,estimation,extremum estimation,optimization,inference,numerical differentiation,finite differences,richardson extrapolation,derivative free optimization,method of simulated moments,maximum likelihood",
    "author": "Janos Gabler",
    "author_email": "janos.gabler@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/29/89/525194cf9387e48090685e6e7d6bd0957e7c9d0a0d64440fd746cf62a690/estimagic-0.4.6.tar.gz",
    "platform": null,
    "description": "# estimagic\n\n[![image](https://img.shields.io/pypi/v/estimagic?color=blue)](https://pypi.org/project/estimagic)\n[![image](https://img.shields.io/pypi/pyversions/estimagic)](https://pypi.org/project/estimagic)\n[![image](https://img.shields.io/conda/vn/conda-forge/estimagic.svg)](https://anaconda.org/conda-forge/estimagic)\n[![image](https://img.shields.io/conda/pn/conda-forge/estimagic.svg)](https://anaconda.org/conda-forge/estimagic)\n[![image](https://img.shields.io/pypi/l/estimagic)](https://pypi.org/project/estimagic)\n[![image](https://readthedocs.org/projects/estimagic/badge/?version=latest)](https://estimagic.readthedocs.io/en/latest)\n[![image](https://img.shields.io/github/actions/workflow/status/OpenSourceEconomics/estimagic/main.yml?branch=main)](https://github.com/OpenSourceEconomics/estimagic/actions?query=branch%3Amain)\n[![image](https://codecov.io/gh/OpenSourceEconomics/estimagic/branch/main/graph/badge.svg)](https://codecov.io/gh/OpenSourceEconomics/estimagic)\n[![image](https://results.pre-commit.ci/badge/github/OpenSourceEconomics/estimagic/main.svg)](https://github.com/OpenSourceEconomics/estimagic/actions?query=branch%3Amain)\n[![image](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![image](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT.md)\n[![image](https://pepy.tech/badge/estimagic/month)](https://pepy.tech/project/estimagic)\n\n## Introduction\n\nestimagic is a Python package for nonlinear optimization with or without constraints. It\nis particularly suited to solve difficult nonlinear estimation problems. On top, it\nprovides functionality to perform statistical inference on estimated parameters.\n\n### Optimization\n\n- estimagic wraps algorithms from *scipy.optimize*, *nlopt*, *pygmo* and more.\n- estimagic implements constraints efficiently via reparametrization, so you can solve\n  constrained problems with any optimzer that supports bounds.\n- The parameters of an optimization problem can be arbitrary pytrees\n- The complete history of parameters and function evaluations can be saved in a database\n  for maximum reproducibility.\n- Painless and efficient multistart optimization.\n- The progress of the optimization is displayed in real time via an interactive\n  dashboard.\n\n<img src=\"docs/source/_static/images/dashboard.gif\">\n\n### Estimation and Inference\n\n- You can estimate a model using method of simulated moments (MSM), calculate standard\n  errors and do sensitivity analysis with just one function call.\n- Asymptotic standard errors for maximum likelihood estimation.\n- estimagic also provides bootstrap confidence intervals and standard errors. Of course\n  the bootstrap procedures are parallelized.\n\n### Numerical differentiation\n\n- estimagic can calculate precise numerical derivatives using\n  [Richardson extrapolations](https://en.wikipedia.org/wiki/Richardson_extrapolation).\n- Function evaluations needed for numerical derivatives can be done in parallel with\n  pre-implemented or user provided batch evaluators.\n\n## Installation\n\nThe package can be installed via conda. To do so, type the following commands in a\nterminal:\n\n```bash\n$ conda config --add channels conda-forge\n$ conda install estimagic\n```\n\nThe first line adds conda-forge to your conda channels. This is necessary for conda to\nfind all dependencies of estimagic. The second line installs estimagic and its\ndependencies.\n\n## Installing optional dependencies\n\nOnly `scipy` is a mandatory dependency of estimagic. 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## Documentation\n\nThe documentation is hosted ([on rtd](https://estimagic.readthedocs.io/en/latest/#))\n\n## Citation\n\nIf you use Estimagic for your research, please do not forget to cite it.\n\n```\n@Unpublished{Gabler2022,\n  Title  = {A Python Tool for the Estimation of large scale scientific models.},\n  Author = {Janos Gabler},\n  Year   = {2022},\n  Url    = {https://github.com/OpenSourceEconomics/estimagic}\n}\n```\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Tools to solve difficult numerical optimization problems.",
    "version": "0.4.6",
    "project_urls": {
        "Homepage": "https://github.com/OpenSourceEconomics/estimagic"
    },
    "split_keywords": [
        "econometrics",
        "statistics",
        "estimation",
        "extremum estimation",
        "optimization",
        "inference",
        "numerical differentiation",
        "finite differences",
        "richardson extrapolation",
        "derivative free optimization",
        "method of simulated moments",
        "maximum likelihood"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c4fd8edfe567b5faa0ecc32305b6dbd869bd9da8e76a3f9df4d90b60e54352bf",
                "md5": "d66cfb89eab18f12773e2c09816d91e3",
                "sha256": "48ccc4ca004680d8357a6a22df7c2fb181cd56f19f334ed9d3dd624483d20b46"
            },
            "downloads": -1,
            "filename": "estimagic-0.4.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "d66cfb89eab18f12773e2c09816d91e3",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 361433,
            "upload_time": "2023-06-05T15:45:04",
            "upload_time_iso_8601": "2023-06-05T15:45:04.663234Z",
            "url": "https://files.pythonhosted.org/packages/c4/fd/8edfe567b5faa0ecc32305b6dbd869bd9da8e76a3f9df4d90b60e54352bf/estimagic-0.4.6-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2989525194cf9387e48090685e6e7d6bd0957e7c9d0a0d64440fd746cf62a690",
                "md5": "8745a1a2295d5330a659cde406b6a978",
                "sha256": "e7d91debd0d5e6baf930f6983fd11fe5e904850893266a24d117ef6cec300f05"
            },
            "downloads": -1,
            "filename": "estimagic-0.4.6.tar.gz",
            "has_sig": false,
            "md5_digest": "8745a1a2295d5330a659cde406b6a978",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 326093,
            "upload_time": "2023-06-05T15:45:06",
            "upload_time_iso_8601": "2023-06-05T15:45:06.976041Z",
            "url": "https://files.pythonhosted.org/packages/29/89/525194cf9387e48090685e6e7d6bd0957e7c9d0a0d64440fd746cf62a690/estimagic-0.4.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-06-05 15:45:06",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "OpenSourceEconomics",
    "github_project": "estimagic",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "estimagic"
}
        
Elapsed time: 0.07404s