The HamPath package  is a an open-source software developed to solve optimal control problems via indirect methods but also to study Hamiltonian systems. HamPath is developed since 2009 by members of the APO (Algorithmes Parallèles et Optimisation) team from Institut de Recherche en Informatique de Toulouse, jointly with colleagues from the Université de Bourgogne and Inria Sophia. HamPath is distributed under the GNU Lesser General Public License, and is free for both academic and industrial use.
The main use of HamPath is to study and solve optimal control problems depending on parameters and of the general form:
Here, is the state, the control and the parameters.
- Geometric optimal control;
- State and/or control constraints;
- Maximum principle;
- Simple and multiple shooting methods;
- Homotopy (or differential path following);
- Second order conditions of optimality (conjugate points);
Applying the maximum principle leads to define a set of Hamiltonians and a Boundary Value Problem, which is described by a set of non linear equations, that can be grouped together in what we call the shooting equations.
HamPath compiles the Fortran codes of the (maximized) Hamiltonians and the shooting function (defined by the shooting equations) and produces a collection of Matlab, Octave, Fortran or Python functions (depending on the chosen user interface) which allows to compute the solutions of the Hamiltonian systems but also to solve the implemented shooting equations.
However, it is well-known that the main difficulty to solve such problems – with indirect methods based on Newton algorithms – is to find a good initial guess. So a differential path following method has been implemented which makes HamPath the natural extension of the cotcot package . It is also possible to compute Jacobi fields of the Hamiltonian systems to check order two conditions of optimality and look for conjugate points, as cotcot does.
Since a lot of time and effort has gone into HamPath’s development, please cite the publication  if you are using HamPath for your own research.
Let consider a simple optimal control problem with the state and with a parameter:
where the initial and final times are fixed ( and ) and the boundaries are fixed to and . Define the pseudo-Hamiltonian depending on :
with the state dimension, and we fix (normal case). The application of the Pontryagin Maximum Principle (PMP) tells us that the minimizing trajectories are the projection of absolutely continuous extremals satisfying a.e.
Definition 1 (Maximized Hamiltonian).
the maximized (or true) Hamiltonian, where the optimal control is
and where the Hamiltonian system is given by
Definition 2 (Exponential mapping). For fixed and , we define in a neighborhood of (if possible), the following exponential mapping as the trajectory at time satisfying the Hamiltonian system for every in , with .
The minimizing curves are the projection of BC-extremals, i.e. extremals which satisfy the boundary conditions, and we can define the following shooting function:
Definition 3 (Shooting function).
where is the canonical q-projection, i.e. .
The simple shooting method consists in finding a zero of the simple shooting function , i.e. in solving This is done by Newton type methods. A zero of the simple shooting function satisfies the necessary conditions of optimality given by the PMP.
Remark 4. depends on , and we write the homotopic function (instead of shooting function) when we consider the parameter as an independent variable. With HamPath, it is possible to solve for in for instance, using differential path following methods. In this case, we say that is a homotopic parameter.
If we note then the trajectory ceases to be optimal after the time if is a critical point of the mapping . In this case, we name a conjugate time and the associated conjugate point. Let give the following definition.
Definition 5 (Jacobi field). The differential equation on
is called a Jacobi equation, or variational system, along the extremal . A solution of the Jacobi equation along is called a Jacobi field and we write
As a conclusion, it comes that if is a conjugate time then
is not of full rank .
The idea of HamPath is to produce a collection of numerical functions in order to solve general optimal control problems. The user must only implement the maximized Hamiltonian (definition 1) and the shooting function (definition 3). The different numerical functions can be used to:
- compute the solutions of the exponential mapping (definition 2);
- solve the shooting equations (definition 3);
- compute the set of zeros of a homotopic function (remark 4);
- compute the Jacobi fields (definition 5) and check if there exists any conjugate points.
At the bottom of the following figure, the part below the doted lines is a fragment of the outputs of HamPath which is in the language chosen during the installation: it may be chosen among Fortran, Python, Matlab (only) or both Matlab and Octave. AD stands for Automatic Differentiation, RK for Runge-Kutta integrators used to solve ordinary differential equations, Newton for Newton-type methods to solve non-linear equations and QR for QR factorization.
- B. Bonnard, J.-B. Caillau & E. Trélat,
Cotcot: short-reference manual. http://apo.enseeiht.fr/cotcot,
Rapport de recherche RT/APO/05/1, Institut National Polytechnique de Toulouse, Toulouse, France (2005).
- J.-B. Caillau, O. Cots & J. Gergaud, Differential continuation for regular optimal control problems, Optim. Methods Softw., 27 (2012), no 2, 177-196.