User Manual 4.6 Optimization : Différence entre versions

De Wiki
Aller à : navigation, rechercher
(Features Description)
(Features Description)
Ligne 87 : Ligne 87 :
 
where H is a square and symmetric matrix.
 
where H is a square and symmetric matrix.
  
The following classes are an extension of ''AbstractKKTSolver</code>:
+
The following classes are an extension of <code>AbstractKKTSolver</code>:
 
*<code>AugmentedKKTSolver</code> (for singular H)
 
*<code>AugmentedKKTSolver</code> (for singular H)
 
*<code>BasicKKTSolver</code>
 
*<code>BasicKKTSolver</code>

Version du 12 janvier 2021 à 10:44

Introduction

Scope

This section describes PATRIUS optimization features. It provides solvers for general convex optimization problems, such as LP, QP, QCQP, etc.

Javadoc

The math framework classes are available in the package fr.cnes.sirius.patrius.math.optim.

Library Javadoc
Patrius Package fr.cnes.sirius.patrius.math.optim

Links

None as of now.

Useful Documents

None as of now.

Package Overview

TODO

Features Description

TO FINISH

Optimizers

The JOptimizer class implements the convex optimizer (see "S.Boyd and L.Vandenberghe, Convex Optimization").

The algorithm selection is implemented as a Chain of Responsibility pattern, and this class is the client of the chain.

The different methods implemented to solve the convex optimization problem are:

  • Interior point methods
    • PrimalDualMethod : primal-dual interior-point method.
    • LPPrimalDualMethod : primal-dual interior-point method for linear problems.
    • BarrierMethod
  • Quality constrained minimization
    • NewtonLEConstrainedFSP : linear equality constrained newton optimizer, with feasible starting point.
    • NewtonLEConstrainedISP : linear equality constrained newton optimizer, with infeasible starting point.
  • Unconstrained minimization
    • NewtonUnconstrained : unconstrained newton optimizer.

Optimization problem

The OptimizationRequest class has all the settting field's necessaires to define an optimization problem.

The LPOptimizationRequest is an extension of this class for linear optimization problems.

The general form of a linear problem is (1):

min(c) s.t.
A.x = b
lb <= x <= ub

The OptimizationResponse is the class with the getters and setters to set and get the response after the optimization. The LPOptimizationResponse is the extension class applied to linear problems.

Standard converter

The LPStandardConverter converts a general linear problem stated in the form (2):

min(c) s.t. 
G.x < h 
A.x = b 
lb <= x <= ub

to the (strictly)standard form:

min(c) s.t. 
A.x = b 
x >= 0

or to the (quasi)standard form (1).

Presolver

The LPPresolver implements a presolver for a linear problem in the form (1).

It applies a set of techniques on the linear programming problem before a linear programming solver solves it. This set of techniques aim at reducing the size of the LP problem by eliminating redundant constraints and variables and identifying possible infeasibility and unboundedness of the problem.

Solver

The AbstractKKTSolver implements a solver for the KKT system:

H.v + [A]T.w = -g
A.v = -h

where H is a square and symmetric matrix.

The following classes are an extension of AbstractKKTSolver:

  • AugmentedKKTSolver (for singular H)
  • BasicKKTSolver
  • UpperDiagonalHKKTSolver (for upper diagonal H)

Getting Started

TODO

Contents

Interfaces

TODO. Tableau à compléter

Interface Summary Javadoc
MathLibrary Interface for low-level Math framework ...

Classes

The most relevant classes from the library are listed here:

Class Summary Javadoc
AbstractKKTSolver Abstract class for solving KKT systems. ...
AbstractLPOptimizationRequestHandler Abstract class for Linear Problem Optimization Request Handler. ...
BarrierMethod Implements the Barrier Method. ...
BasicPhaseIBM Implements the Basic Phase I Method as a Barried Method. ...
BasicPhaseILPPDM Implements the Basic Phase I Method form LP problems as a Primal-Dual Method. ...
BasicPhaseIPDM Implements the Basic Phase I Method as a Primal-Dual Method. ...
CholeskyFactorization Implements the Cholesky L.L[T] factorization and inverse for symmetric and positive matrix. ...
JOptimizer Implements the convex optimizer. ...
LinearMultivariateRealFunction Defines a linear multivariate function in the form f(x) = q.x + r. ...
LogarithmicBarrier Default barrier function for the barrier method algorithm. ...
LPOptimizationRequest Implements a linear optimization problem. ...
LPOptimizationResponse Response of the linear optimization problem. ...
LPPresolver Presolver for a linear problem. ...
LPPrimalDualMethod Implements the Primal-dual interior-point method for linear problems. ...
LPStandardConverter Converts a general LP problem into a strictly standard or quasi standard form. ...
NewtonLEConstrainedFSP Linear equality constrained newton optimizer, with feasible starting point. ...
NewtonLEConstrainedISP Linear equality constrained newton optimizer, with infeasible starting point. ...
NewtonUnconstrained Unconstrained newton optimizer. ...
OptimizationRequest Implements an optimization problem. ...
PrimalDualMethod Implements a primal-dual interior-point method. ...
QuadraticMultivariateRealFunction Implements a quadratic multivariate function in the form of f(x):= 1/2 x.P.x + q.x + r. ...
UpperDiagonalHKKTSolver Extends the class AbstractKKTSolver for upper diagonal matrix. ...