{"id":13678916,"url":"https://github.com/coin-or/Ipopt","last_synced_at":"2025-04-29T15:33:48.464Z","repository":{"id":37382134,"uuid":"167958206","full_name":"coin-or/Ipopt","owner":"coin-or","description":"COIN-OR Interior Point Optimizer IPOPT","archived":false,"fork":false,"pushed_at":"2025-04-15T11:29:32.000Z","size":99144,"stargazers_count":1548,"open_issues_count":9,"forks_count":291,"subscribers_count":45,"default_branch":"stable/3.14","last_synced_at":"2025-04-28T14:09:25.944Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://coin-or.github.io/Ipopt","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/coin-or.png","metadata":{"files":{"readme":"README.md","changelog":"ChangeLog.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["coin-or"]}},"created_at":"2019-01-28T12:24:22.000Z","updated_at":"2025-04-27T13:54:04.000Z","dependencies_parsed_at":"2022-08-08T20:15:14.170Z","dependency_job_id":"2a053299-5667-4d7a-a968-b0b031cc85c9","html_url":"https://github.com/coin-or/Ipopt","commit_stats":{"total_commits":2358,"total_committers":34,"mean_commits":69.3529411764706,"dds":"0.45250212044105176","last_synced_commit":"e10e5c738605f0525a50cbdaa624d56378986c77"},"previous_names":[],"tags_count":85,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coin-or%2FIpopt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coin-or%2FIpopt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coin-or%2FIpopt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coin-or%2FIpopt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coin-or","download_url":"https://codeload.github.com/coin-or/Ipopt/tar.gz/refs/heads/stable/3.14","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251326839,"owners_count":21571636,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-02T13:00:59.864Z","updated_at":"2025-04-29T15:33:48.451Z","avatar_url":"https://github.com/coin-or.png","language":"C++","funding_links":["https://github.com/sponsors/coin-or"],"categories":["C++","Optimization","Open-Source Solvers"],"sub_categories":["Applications and Special Topics"],"readme":"Ipopt\n=====\n\nIntroduction\n------------\n\nIpopt (Interior Point OPTimizer, pronounced eye-pea-Opt) is a software package for large-scale [nonlinear optimization](https://en.wikipedia.org/wiki/Nonlinear_programming).\nIt is designed to find (local) solutions of mathematical optimization problems of the form\n\n$$\\begin{align}\n\\min_{x \\in R^n}\\ \u0026 f(x), \\\\\n\\text{s.t.}\\ \u0026 g_L \\le g(x) \\le g_U, \\\\\n\u0026 x_L \\le x \\le x_U,\n\\end{align}$$\n\nwhere $f: R^n \\rightarrow R$ is the objective function, \nand $g: R^n \\rightarrow R^m$ are the constraint functions.  The vectors $g_L$ and $g_U$ denote the lower and upper bounds on the constraints, and the vectors $x_L$ and $x_U$ are the bounds on the variables $x$.\nThe functions $f(x)$ and $g(x)$ can be nonlinear and nonconvex, but should be twice continuously differentiable.\nNote that equality constraints can be formulated in the above formulation by setting the corresponding components of $g_L$ and $g_U$ to the same value.\n\nIpopt is part of the [COIN-OR Initiative](http://www.coin-or.org).\nThe Ipopt project webpage is \u003chttps://github.com/coin-or/Ipopt\u003e.\n\n\nBackground\n----------\n\nIpopt is written in C++ and is released as open source code under the [Eclipse Public License (EPL)](LICENSE).\nThe code has been written by [Andreas Wächter](http://www.mccormick.northwestern.edu/directory/profiles/Andreas-Waechter.html) and [Carl Laird](http://allthingsoptimal.com/biography/).\nThe COIN-OR project managers for Ipopt are [Andreas Wächter](http://users.iems.northwestern.edu/~andreasw) und [Stefan Vigerske](https://www.gams.com/~svigerske).\nFor a list of **all contributors**, see the [AUTHORS file](AUTHORS).\n\nThe C++ version has first been [released on Aug 26, 2005](http://list.coin-or.org/pipermail/ipopt/2005-August/000331.html) as version 3.0.0.\nThe previously released [pre-3.0 Fortran version](https://github.com/coin-or/Ipopt/tree/stable/2.3) is no longer maintained.\n\n\nThe Ipopt distribution can be used to generate a library that can be linked to one's own C++, C, Fortran, or Java code, as well as a solver executable for the [AMPL](http://www.ampl.com) modeling environment.\nThe package includes an interface to the [R](http://www.r-project.org/) programming environment.\nIPOPT can be used on Linux/UNIX, macOS, and Windows platforms.\n\nAs open source software, the source code for Ipopt is provided without charge.\nYou are free to use it, also for commercial purposes.\nYou are also free to modify the source code (with the restriction that you need to make your changes public if you decide to distribute your version in any way, e.g. as an executable); for details see the EPL license.\nAnd we are certainly very keen on feedback from users, including contributions!\n\nIn order to compile Ipopt, certain third party code is required (such as some linear algebra routines).\nThose are available under different conditions/licenses.\n\nIf you want to learn more about Ipopt, you can find references in the [bibliography of the documentation](https://coin-or.github.io/Ipopt/citelist.html).\n\nFor information on projects or papers that use Ipopt, refer to the [Ipopt usage stories and papers](https://github.com/coin-or/Ipopt/discussions/497) discussion.\n\n\nGetting Started\n---------------\n\nPlease consult the [detailed installation instructions](https://coin-or.github.io/Ipopt/INSTALL.html)\nin the Ipopt documentation. In the following, we only summarize some main points.\n\n### Dependencies\n\nIpopt requires at least one of the following solvers for systems of linear equations:\n- MA27, MA57, HSL_MA77, HSL_MA86, or HSL_MA97 from the [Harwell Subroutines Library](http://hsl.rl.ac.uk) (HSL).\n  It is recommended to use project [ThirdParty-HSL](https://github.com/coin-or-tools/ThirdParty-HSL) to build a HSL library for use by Ipopt\n  or to use [prebuild macOS/Windows/Linux libraries from STFC](https://licences.stfc.ac.uk/products/Software/HSL/LibHSL), see the [Ipopt installation instruction](https://coin-or.github.io/Ipopt/INSTALL.html#DOWNLOAD_HSL).\n- [Parallel Sparse Direct Linear Solver](http://www.pardiso-project.org) (Pardiso).\n  Note, that the Intel Math Kernel Library (MKL) also includes a version of Pardiso, but the one from Pardiso Project often offers better performance.\n- [Sparse Parallel Robust Algorithms Library](https://github.com/ralna/spral) (SPRAL).\n- [MUltifrontal Massively Parallel sparse direct Solver](http://mumps.enseeiht.fr/) (MUMPS).\n  It is highly recommended to use project [ThirdParty-Mumps](https://github.com/coin-or-tools/ThirdParty-Mumps) to build a MUMPS library for use by Ipopt.\n- [Watson Sparse Matrix Package](http://www.research.ibm.com/projects/wsmp)\n\nA fast implementation of BLAS and LAPACK is required by Ipopt.\n\nTo build the AMPL interface of Ipopt, the AMPL Solver Library (ASL) is required.\nIt is recommended to use project [ThirdParty-ASL](https://github.com/coin-or-tools/ThirdParty-ASL) to build a ASL library for use by Ipopt.\n\n### Build\n\nAfter installation of dependencies, an Ipopt build and installation follows these 4 steps:\n\n1. Run `./configure`. Use `./configure --help` to see available options.\n\n2. Run `make` to build the Ipopt libraries. If ASL was made available, also Ipopt executables will be build.\n\n3. Run `make test` to test the Ipopt build.\n\n4. Run `make install` to install Ipopt (libraries, executables, and header files).\n\nIt is suggested to use the same installation prefix (`--prefix` option of `configure`)\nwhen configuring the build of ThirdParty-ASL, ThirdParty-HSL, ThirdParty-MUMPS, and Ipopt.\n\n### Using coinbrew\n\nAn alternative to the above steps is to use the `coinbrew` script from\nhttps://coin-or.github.io/coinbrew/.\n`coinbrew` automates the download of the source code for ASL, MUMPS, and Ipopt\nand the sequential build and installation of these three packages.\n\nAfter obtaining the `coinbrew` script, run\n\n    /path/to/coinbrew fetch Ipopt --no-prompt\n    /path/to/coinbrew build Ipopt --prefix=/dir/to/install --test --no-prompt --verbosity=3\n    /path/to/coinbrew install Ipopt --no-prompt\n\nMore details on using coinbrew can be found at the instructions on\n[Getting Started with the COIN-OR Optimization Suite](https://coin-or.github.io/user_introduction).\n\n### Precompiled binaries\n\nSome precompiled binaries of Ipopt are also available:\n\n- **[Ipopt releases page](https://github.com/coin-or/Ipopt/releases)** provides libraries and executables for Windows\n- **[JuliaBinaryWrappers](https://github.com/JuliaBinaryWrappers/Ipopt_jll.jl/releases)** provides libraries and executables (see also [notes on BLAS/LAPACK](https://github.com/jump-dev/Ipopt.jl#blas-and-lapack); [libHSL](https://licences.stfc.ac.uk/products/Software/HSL/LibHSL) provides prebuild HSL libraries\n- **[IDEAS](https://github.com/IDAES/idaes-ext/releases)** provides executables; these executables include HSL solvers\n\nGetting Help\n------------\n\n * **[Ipopt Documentation](https://coin-or.github.io/Ipopt/)** with installation instructions, options reference, and more\n * **[Issue tracking system](https://github.com/coin-or/Ipopt/issues/)**: If you believe you found a **bug** in the code, please use the issue tracking system.\n   Please include as much information as possible, and if possible some (ideally simple) example code so that we can reproduce the error.\n * **[Discussions](https://github.com/coin-or/Ipopt/discussions)**: ask questions, share ideas, engage with the Ipopt community\n * **[Mailing list archive](http://list.coin-or.org/pipermail/ipopt/)** (2002-2020): predecessor of Discussions\n * External resources:\n   * [short Ipopt tutorial](https://doi.org/10.4230/DagSemProc.09061.16)\n\nPlease Cite Us\n--------------\n\nWe provide this program in the hope that it may be useful to others, and we would very much like to hear about your experience with it.\nIf you found it helpful and are using it within our software, we encourage you to add your feedback to the [Ipopt usage stories and papers](https://github.com/coin-or/Ipopt/discussions/497) discussion.\n\nSince a lot of time and effort has gone into Ipopt's development, **please cite the following publication if you are using Ipopt for your own research**:\n\n* A. Wächter and L. T. Biegler, **[On the Implementation of a Primal-Dual Interior Point Filter Line Search Algorithm for Large-Scale Nonlinear Programming](http://dx.doi.org/10.1007/s10107-004-0559-y)**, _Mathematical Programming_ 106(1), pp. 25-57, 2006\n  ([preprint](http://www.optimization-online.org/DB_HTML/2004/03/836.html))\n\nVersioning\n----------\n\nIpopts version numbers have the form x.y.z.\nx.y specifies the major and minor version number of Ipopt.\nAn increase in x or y can mean the addition or removal of features, backward-incompatible API changes, etc.\nIncreases in y indicate less severe changes than increases in x. For example, the change from Ipopt 2 to Ipopt 3 came due to a complete rewrite of Ipopt in a different programming language.\nz specifies the release number of Ipopt.\nAn increase in z usually means bugfixes or additions of small feature. Changes to the API, if any, are done in a backward-compatible way. However, the ABI may changed in a backward-incompatible way.\n\nSource code is organized in branches named stable/x.y.\nDevelopment towards a next x.y.z release is happening on the stable/x.y branch.\nThe code on branch stable/x.y already caries a x.y.z version number, which can correspond to the next x.y.z release that will be made from this branch.\nThe default branch of the repository is the latest stable/x.y branch, even if x.y is still in beta testing.\n\nAn Ipopt x.y.z release is associated with a tag releases/x.y.z on branch stable/x.y.\nReleases are fixed and don't change.\n\nAdditional branches may exist where development of bugfixes or features is taking place.\nA branch devel may collect development for the next Ipopt x.y version. It will be renamed to stable/x.y when it is considered stable enough for beta testing.\n\nIf you want to contribute a bugfix or small feature, please create a pull-request to the latest stable/x.y branch.\nIf you want to contribute a larger feature or something else that changes the API, please create a pull-request to branch devel, if existing, and latest stable/x.y otherwise.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoin-or%2FIpopt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoin-or%2FIpopt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoin-or%2FIpopt/lists"}