#include <qpOASES_e/Utils.h>
#include <qpOASES_e/Options.h>

Include dependency graph for OQPinterface.h:

This graph shows which files directly or indirectly include this file:

Functions
returnValue	readOQPdata (const char path, int nQP, int nV, int nC, int nEC, real_t H, real_t g, real_t A, real_t lb, real_t ub, real_t lbA, real_t ubA, real_t xOpt, real_t yOpt, real_t *objOpt)

BEGIN_NAMESPACE_QPOASES returnValue	readOQPdimensions (const char path, int nQP, int nV, int nC, int *nEC)

returnValue	runOQPbenchmark (const char path, BooleanType isSparse, BooleanType useHotstarts, const Options options, int maxAllowedNWSR, real_t maxNWSR, real_t avgNWSR, real_t maxCPUtime, real_t avgCPUtime, real_t maxStationarity, real_t maxFeasibility, real_t *maxComplementarity)

returnValue	solveOQPbenchmark (int nQP, int nV, int nC, int nEC, real_t _H, const real_t const g, real_t _A, const real_t const lb, const real_t const ub, const real_t const lbA, const real_t const ubA, BooleanType isSparse, BooleanType useHotstarts, const Options options, int maxAllowedNWSR, real_t maxNWSR, real_t avgNWSR, real_t maxCPUtime, real_t avgCPUtime, real_t maxStationarity, real_t maxFeasibility, real_t *maxComplementarity)

returnValue	solveOQPbenchmarkB (int nQP, int nV, real_t _H, const real_t const g, const real_t const lb, const real_t const ub, BooleanType isSparse, BooleanType useHotstarts, const Options options, int maxAllowedNWSR, real_t maxNWSR, real_t avgNWSR, real_t maxCPUtime, real_t avgCPUtime, real_t maxStationarity, real_t maxFeasibility, real_t maxComplementarity)

Detailed Description

Author: Hans Joachim Ferreau, Andreas Potschka, Christian Kirches

Version: 3.1embedded

Date: 2007-2015

Declaration of an interface comprising several utility functions for solving test problems from the Online QP Benchmark Collection (This collection is no longer maintained, see http://www.qpOASES.org/onlineQP for a backup).

Definition in file OQPinterface.h.

Function Documentation

returnValue readOQPdata	(	const char *	path,
		int *	nQP,
		int *	nV,
		int *	nC,
		int *	nEC,
		real_t *	H,
		real_t *	g,
		real_t *	A,
		real_t *	lb,
		real_t *	ub,
		real_t *	lbA,
		real_t *	ubA,
		real_t *	xOpt,
		real_t *	yOpt,
		real_t *	objOpt
	)

Reads data of an Online QP Benchmark problem from file. This function allocates the required memory for all data; after successfully calling it, you have to free this memory yourself!

Returns: SUCCESSFUL_RETURN
RET_INVALID_ARGUMENTS
RET_UNABLE_TO_READ_FILE
RET_FILEDATA_INCONSISTENT

Parameters

path	Full path of the data files (without trailing slash!).
nQP	Output: Number of QPs.
nV	Output: Number of variables.
nC	Output: Number of constraints.
nEC	Output: Number of equality constraints.
H	Output: Hessian matrix.
g	Output: Sequence of gradient vectors.
A	Output: Constraint matrix.
lb	Output: Sequence of lower bound vectors (on variables).
ub	Output: Sequence of upper bound vectors (on variables).
lbA	Output: Sequence of lower constraints' bound vectors.
ubA	Output: Sequence of upper constraints' bound vectors.
xOpt	Output: Sequence of primal solution vectors (not read if a null pointer is passed).
yOpt	Output: Sequence of dual solution vectors (not read if a null pointer is passed).
objOpt	Output: Sequence of optimal objective function values (not read if a null pointer is passed).

Definition at line 85 of file OQPinterface.c.

BEGIN_NAMESPACE_QPOASES returnValue readOQPdimensions	(	const char *	path,
		int *	nQP,
		int *	nV,
		int *	nC,
		int *	nEC
	)

Reads dimensions of an Online QP Benchmark problem from file.

Returns: SUCCESSFUL_RETURN
RET_UNABLE_TO_READ_FILE
RET_FILEDATA_INCONSISTENT

Parameters

path	Full path of the data files (without trailing slash!).
nQP	Output: Number of QPs.
nV	Output: Number of variables.
nC	Output: Number of constraints.
nEC	Output: Number of equality constraints.

Definition at line 50 of file OQPinterface.c.

returnValue runOQPbenchmark	(	const char *	path,
		BooleanType	isSparse,
		BooleanType	useHotstarts,
		const Options *	options,
		int	maxAllowedNWSR,
		real_t *	maxNWSR,
		real_t *	avgNWSR,
		real_t *	maxCPUtime,
		real_t *	avgCPUtime,
		real_t *	maxStationarity,
		real_t *	maxFeasibility,
		real_t *	maxComplementarity
	)

Runs an Online QP Benchmark problem and determines the maximum violation of the KKT optimality conditions as well as the maximum and average number of iterations and CPU time to solve each QP.

Returns: SUCCESSFUL_RETURN
RET_UNABLE_TO_READ_BENCHMARK
RET_BENCHMARK_ABORTED

Parameters

path	Full path of the benchmark files (without trailing slash!).
isSparse	Shall convert matrices to sparse format before solution?
useHotstarts	Shall QP solution be hotstarted?
options	QP solver options to be used while solving benchmark problems.
maxAllowedNWSR	Maximum number of working set recalculations to be performed.
maxNWSR	Output: Maximum number of performed working set recalculations.
avgNWSR	Output: Average number of performed working set recalculations.
maxCPUtime	Output: Maximum CPU time required for solving each QP.
avgCPUtime	Output: Average CPU time required for solving each QP.
maxStationarity	Output: Maximum residual of stationarity condition.
maxFeasibility	Output: Maximum residual of primal feasibility condition.
maxComplementarity	Output: Maximum residual of complementarity condition.

Definition at line 413 of file OQPinterface.c.

returnValue solveOQPbenchmark	(	int	nQP,
		int	nV,
		int	nC,
		int	nEC,
		real_t *	_H,
		const real_t *const	g,
		real_t *	_A,
		const real_t *const	lb,
		const real_t *const	ub,
		const real_t *const	lbA,
		const real_t *const	ubA,
		BooleanType	isSparse,
		BooleanType	useHotstarts,
		const Options *	options,
		int	maxAllowedNWSR,
		real_t *	maxNWSR,
		real_t *	avgNWSR,
		real_t *	maxCPUtime,
		real_t *	avgCPUtime,
		real_t *	maxStationarity,
		real_t *	maxFeasibility,
		real_t *	maxComplementarity
	)

Solves an Online QP Benchmark problem as specified by the arguments. The maximum deviations from the given optimal solution as well as the maximum CPU time to solve each QP are determined.

Returns: SUCCESSFUL_RETURN
RET_BENCHMARK_ABORTED

Parameters

nQP	Number of QPs.
nV	Number of variables.
nC	Number of constraints.
nEC	Number of equality constraints.
_H	Hessian matrix.
g	Sequence of gradient vectors.
_A	Constraint matrix.
lb	Sequence of lower bound vectors (on variables).
ub	Sequence of upper bound vectors (on variables).
lbA	Sequence of lower constraints' bound vectors.
ubA	Sequence of upper constraints' bound vectors.
isSparse	Shall convert matrices to sparse format before solution?
useHotstarts	Shall QP solution be hotstarted?
options	QP solver options to be used while solving benchmark problems.
maxAllowedNWSR	Maximum number of working set recalculations to be performed.
maxNWSR	Output: Maximum number of performed working set recalculations.
avgNWSR	Output: Average number of performed working set recalculations.
maxCPUtime	Output: Maximum CPU time required for solving each QP.
avgCPUtime	Output: Average CPU time required for solving each QP.
maxStationarity	Output: Maximum residual of stationarity condition.
maxFeasibility	Output: Maximum residual of primal feasibility condition.
maxComplementarity	Output: Maximum residual of complementarity condition.

Definition at line 178 of file OQPinterface.c.

returnValue solveOQPbenchmarkB	(	int	nQP,
		int	nV,
		real_t *	_H,
		const real_t *const	g,
		const real_t *const	lb,
		const real_t *const	ub,
		BooleanType	isSparse,
		BooleanType	useHotstarts,
		const Options *	options,
		int	maxAllowedNWSR,
		real_t *	maxNWSR,
		real_t *	avgNWSR,
		real_t *	maxCPUtime,
		real_t *	avgCPUtime,
		real_t *	maxStationarity,
		real_t *	maxFeasibility,
		real_t *	maxComplementarity
	)

Solves an Online QP Benchmark problem (without constraints) as specified by the arguments. The maximum deviations from the given optimal solution as well as the maximum CPU time to solve each QP are determined.

Returns: SUCCESSFUL_RETURN
RET_BENCHMARK_ABORTED

Parameters

nQP	Number of QPs.
nV	Number of variables.
_H	Hessian matrix.
g	Sequence of gradient vectors.
lb	Sequence of lower bound vectors (on variables).
ub	Sequence of upper bound vectors (on variables).
isSparse	Shall convert matrices to sparse format before solution?
useHotstarts	Shall QP solution be hotstarted?
options	QP solver options to be used while solving benchmark problems.
maxAllowedNWSR	Maximum number of working set recalculations to be performed.
maxNWSR	Output: Maximum number of performed working set recalculations.
avgNWSR	Output: Average number of performed working set recalculations.
maxCPUtime	Output: Maximum CPU time required for solving each QP.
avgCPUtime	Output: Average CPU time required for solving each QP.
maxStationarity	Output: Maximum residual of stationarity condition.
maxFeasibility	Output: Maximum residual of primal feasibility condition.
maxComplementarity	Output: Maximum residual of complementarity condition.

Definition at line 302 of file OQPinterface.c.

Functions

Detailed Description

Function Documentation