Changes between Version 32 and Version 33 of WikiStart

Feb 23, 2020 5:34:52 AM (22 months ago)



  • WikiStart

    v32 v33  
    1 = Welcome to the qpOASES webpage =
    3 ''Note that these project webpages are based on Wiki, which allows webusers to modify certain parts of the content or share their experience and tips with other users. You are welcome to contribute to the qpOASES project. To contribute to the Wiki or submit a ticket you must first [ register and login].''
    6 == Introduction ==
    8 qpOASES is an open-source C++ implementation of the recently proposed **o**nline **a**ctive **se**t **s**trategy, which was inspired by important observations from the field of parametric quadratic programming (QP). It has several theoretical features that make it particularly suited for model predictive control (MPC) applications. Further numerical modifications have made qpOASES a reliable QP solver, even when tackling semi-definite, ill-posed or degenerated QP problems. Moreover, several interfaces to third-party software like [ Matlab] or [ Simulink] are provided that make qpOASES easy-to-use even for users without knowledge of C/C++.
    10 qpOASES can solve quadratic programming (QP) problems of any form equivalent to
    11 {{{
    12 min   1/2*x'Hx + x'g
    13 s.t.  lb  <=  x <= ub
    14       lbA <= Ax <= ubA
    15 }}}
    16 where {{{H}}} denotes a (typically positive semi-definite) symmetric Hessian matrix and all other quantities match common notation. qpOASES also does a good job in detecting infeasible or unbounded QP problem formulations.
    18 qpOASES has been initially released and developed at [ KU Leuven] within the [ Optimization in Engineering Center (OPTEC)]. Current development is mainly supported by researchers at the [ Interdisciplinary Center for Scientific Computing] at [ Heidelberg University] and at [ ABB Corporate Research].
    20 Note that there also exists a [wiki:QpoasesEmbedded Plain C Translation] of qpOASES for use cases where using C++ code is highly undesirable or even impossible.
    22 == License and Download ==
    24 qpOASES is open-source software, distributed under the [ GNU Lesser General Public License (LGPL)], version 2.1.
    26 qpOASES is part of the [ COIN-OR Initiative] and its code base is hosted in an SVN repository with public read access. You can either obtain the source code by using an SVN client or by downloading a zipped archive. More details are given on the [wiki:QpoasesDownload Download] page.
    29 == Installation and Dependencies ==
    31 qpOASES is self-contained! Except for a couple of standard C libraries, no further external software packages are required. Optionally, the [ LAPACK] and [ BLAS] libraries can be linked for performing internal linear algebra operations.
    33 qpOASES has been successfully installed on PCs running Linux, Windows or Mac OS X, and can also run on embedded computing hardware. Detailled information on how
    34 to install qpOASES can be found on the [wiki:QpoasesInstallation Installation] page.
    37 == Documentation and Support ==
    39 qpOASES has a fully documented source code (see its doxygen-generated [ source code documentation]) and provides
    40 a concise [ User's Manual]. New users are recommended to get started by following the tutorial examples described in the manual.
    42 In case you encounter any kind of troubles when installing or running qpOASES, please follow these steps:
    44 1. check whether you can find any hint in the [ User's Manual];
    45 2. browse the [ User Support] knowledge base to see whether other users have encountered your problem before;
    46 3. browse [ All Issues] reported by other users to see whether you find a solution to your problem.
    48 If none of the above helps you to overcome your troubles, '''you are most welcome to ask for support'''. We strongly encourage you to send your bug report, question, remark, features request or any other kind of feedback by '''[ creating a new ticket]'''. When doing so, please follow our simple [wiki:QpoasesFeedback Feedback Guidelines] in order to receive our help as soon as possible.
    52 == Interfaces and Applications ==
    54 qpOASES comes along with a number of interfaces to third-party software, namely [ Matlab], [ Simulink], [ octave], [ Scilab], and [ Python]. Please consult Chapter 6 of the [ User's Manual] to get more information.
    56 Moreover, qpOASES can be used as QP solver in a number of third-party software, including the [ ACADO Toolkit], [ MUSCOD-II], [ YALMIP], [ CasADi].
    58 Finally, it is worth mentioning that qpOASES has been successfully used in numerous real-world applications and industrial projects. Some of them can be found on
    59 the [wiki:QpoasesSuccess Success Stories] page. If you also want to report your successful application of qpOASES, please send an e-mail to [[|]] or add to the Wiki yourself.
    62 == Citing qpOASES ==
    64 If you use qpOASES within your scientific work, we strongly encourage you to cite at least
    65 one of the following publications.
    67 * Reference to the **software**:
    68 {{{
    69 @ARTICLE{Ferreau2014,
    70 author = {H.J. Ferreau and C. Kirches and A. Potschka and H.G. Bock and M. Diehl},
    71 title = {{qpOASES}: A parametric active-set algorithm for quadratic programming},
    72 journal = {Mathematical Programming Computation},
    73 year = {2014},
    74 volume = {6},
    75 number = {4},
    76 pages = {327--363},
    77 keywords = {qpOASES, parametric quadratic programming, active set method,
    78             model predictive control}
    79 }
    80 }}}
    82 * Reference to the **online active set strategy**:
    83 {{{
    84 @ARTICLE{Ferreau2008,
    85 author = {H.J. Ferreau and H.G. Bock and M. Diehl},
    86 title = {An online active set strategy to overcome the limitations of explicit MPC},
    87 journal = {International Journal of Robust and Nonlinear Control},
    88 year = {2008},
    89 volume = {18},
    90 number = {8},
    91 pages = {816--830},
    92 keywords = {model predictive control, parametric quadratic programming,
    93             online active set strategy}
    94 }
    95 }}}
    97 * Reference to the **webpage**:
    98 {{{
    99 @MISC{qpOASES2017,
    100 author = {H.J. Ferreau and A. Potschka and C. Kirches},
    101 title = {{qpOASES} webpage},
    102 howpublished = {},
    103 year = {2007--2017},
    104 keywords = {qpOASES, model predictive control, parametric quadratic programming,
    105             online active set strategy}
    106 }
    107 }}}
    109 Further qpOASES-related publications can be found on
    110 the [wiki:QpoasesPublications Publications] page.
    113 == Contact and Mailing List ==
    115 If you want to receive latest information on qpOASES or participate in public discussions on future developments of the code, you should subscribe to the [ qpOASES mailing list]. Note that unlike mailing lists of other projects hosted at COIN-OR, this **mailing list is not intended for reporting installation issues, bugs or minor feature requests**. Instead, please use Trac to [ create a new ticket] for reporting these kind of issues.
    117 In case you do not want to disclose your feedback to the public, you may to get in touch with the [wiki:QpoasesAuthors qpOASES developers] by sending an e-mail to [[|]].
    120 ----
    122 See also  [wiki:QpoasesDownload Download], [wiki:QpoasesInstallation Installation],  [ User's Manual],  [ Source Code Documentation],  [ User Support],  [wiki:QpoasesFeedback Feedback Guidelines],  [wiki:QpoasesSuccess Success Stories],  [wiki:QpoasesPublications Publications],  [wiki:QpoasesAuthors Authors and Contributors],  [wiki:QpoasesEmbedded Plain C Translation]
     1= This project has moved to =