Define an abstract linear function. More...

#include <roboptim/core/linear-function.hh>

Inheritance diagram for roboptim::GenericLinearFunction< T >:

[legend]

Collaboration diagram for roboptim::GenericLinearFunction< T >:

[legend]

Public Member Functions
	ROBOPTIM_TWICE_DIFFERENTIABLE_FUNCTION_FWD_TYPEDEFS_ (GenericQuadraticFunction< T >)
	GenericLinearFunction (size_type inputSize, size_type outputSize=1, std::string name=std::string())
	Concrete class constructor should call this constructor.
virtual std::ostream &	print (std::ostream &) const
	Display the function on the specified output stream.
Public Member Functions inherited from roboptim::GenericQuadraticFunction< T >
	GenericQuadraticFunction (size_type inputSize, size_type outputSize=1, std::string name=std::string())
	Concrete class constructor should call this constructor.
Public Member Functions inherited from roboptim::GenericTwiceDifferentiableFunction< T >
	ROBOPTIM_DIFFERENTIABLE_FUNCTION_FWD_TYPEDEFS_ (GenericDifferentiableFunction< T >)
	ROBOPTIM_GENERATE_TRAITS_REFS_ (hessian)
	Hessian type.
hessianSize_t	hessianSize () const
	Return the size of a hessian.
bool	isValidHessian (const_hessian_ref hessian) const
	Check if the hessian is valid (check sizes).
hessian_t	hessian (const_argument_ref argument, size_type functionId=0) const
	Compute the hessian at a given point.
void	hessian (hessian_ref hessian, const_argument_ref argument, size_type functionId=0) const
	Compute the hessian at a given point.
Public Member Functions inherited from roboptim::GenericDifferentiableFunction< T >
	ROBOPTIM_FUNCTION_FWD_TYPEDEFS_ (GenericFunction< T >)
	ROBOPTIM_GENERATE_TRAITS_REFS_ (gradient)
	Gradient type.
	ROBOPTIM_GENERATE_TRAITS_REFS_ (jacobian)
	Jacobian type.
size_type	gradientSize () const
	Return the gradient size.
jacobianSize_t	jacobianSize () const
	Return the jacobian size as a pair.
bool	isValidGradient (const_gradient_ref gradient) const
	Check if the gradient is valid (check size).
bool	isValidJacobian (const_jacobian_ref jacobian) const
	Check if the jacobian is valid (check sizes).
jacobian_t	jacobian (const_argument_ref argument) const
	Computes the jacobian.
void	jacobian (jacobian_ref jacobian, const_argument_ref argument) const
	Computes the jacobian.
gradient_t	gradient (const_argument_ref argument, size_type functionId=0) const
	Computes the gradient.
void	gradient (gradient_ref gradient, const_argument_ref argument, size_type functionId=0) const
	Computes the gradient.
Public Member Functions inherited from roboptim::GenericFunction< T >
	ROBOPTIM_GENERATE_TRAITS_REFS_ (vector)
	Basic (column) vector type.
	ROBOPTIM_GENERATE_TRAITS_REFS_ (rowVector)
	Row vector type.
	ROBOPTIM_GENERATE_TRAITS_REFS_ (matrix)
	Basic matrix type.
	ROBOPTIM_GENERATE_TRAITS_REFS_ (result)
	Type of a function evaluation result.
	ROBOPTIM_GENERATE_TRAITS_REFS_ (argument)
	Type of a function evaluation argument.
bool	isValidResult (const_result_ref result) const
	Check the given result size is valid.
GenericFunction< T >::size_type	inputSize () const
	Return the input size (i.e.
GenericFunction< T >::size_type	outputSize () const
	Return the output size (i.e.
virtual	~GenericFunction ()
	Trivial destructor.
result_t	operator() (const_argument_ref argument) const
	Evaluate the function at a specified point.
void	operator() (result_ref result, const_argument_ref argument) const
	Evaluate the function at a specified point.
const std::string &	getName () const
	Get function name.

Protected Member Functions
void	impl_hessian (hessian_ref hessian, const_argument_ref argument, size_type functionId=0) const
	Hessian evaluation.
Protected Member Functions inherited from roboptim::GenericTwiceDifferentiableFunction< T >
	GenericTwiceDifferentiableFunction (size_type inputSize, size_type outputSize=1, std::string name=std::string())
	Concrete class constructor should call this constructor.
void	setZero (hessian_ref symmetric) const
	Set a symmetric matrix to zero.
Protected Member Functions inherited from roboptim::GenericDifferentiableFunction< T >
	GenericDifferentiableFunction (size_type inputSize, size_type outputSize=1, std::string name=std::string())
	Concrete class constructor should call this constructor.
virtual void	impl_jacobian (jacobian_ref jacobian, const_argument_ref arg) const
	Jacobian evaluation.
virtual void	impl_gradient (gradient_ref gradient, const_argument_ref argument, size_type functionId=0) const =0
	Gradient evaluation.
void	impl_jacobian (jacobian_ref jacobian, const_argument_ref argument) const
Protected Member Functions inherited from roboptim::GenericFunction< T >
	GenericFunction (size_type inputSize, size_type outputSize=1, std::string name=std::string())
	Concrete class constructor should call this constructor.
virtual void	impl_compute (result_ref result, const_argument_ref argument) const =0
	Function evaluation.

Additional Inherited Members
Public Types inherited from roboptim::GenericQuadraticFunction< T >
typedef GenericTwiceDifferentiableFunction< T >	parent_t
typedef parent_t::size_type	size_type
Public Types inherited from roboptim::GenericTwiceDifferentiableFunction< T >
typedef std::pair< size_type, size_type >	hessianSize_t
	Hessian size type represented as a pair of values.
Public Types inherited from roboptim::GenericDifferentiableFunction< T >
typedef std::pair< size_type, size_type >	jacobianSize_t
	Jacobian size type (pair of values).
Public Types inherited from roboptim::GenericFunction< T >
typedef T	traits_t
	Traits type.
typedef GenericFunctionTraits< T >::value_type	value_type
	Values type.
typedef GenericFunctionTraits< T >::size_type	size_type
	Size type.
typedef std::string	name_t
	Type of a function argument name.
typedef std::vector< name_t >	names_t
	Type of a vector of function argument names.
typedef std::pair< value_type, value_type >	interval_t
	Interval type (lower, upper).
typedef std::vector< interval_t >	intervals_t
	Vector of intervals.
typedef boost::tuple< value_type, value_type, value_type >	discreteInterval_t
	Types representing a discrete interval.
Static Public Member Functions inherited from roboptim::GenericFunction< T >
static value_type	epsilon ()
	Get the value of the machine epsilon, useful for floating types comparison.
static value_type	infinity ()
	Get the value that symbolizes positive infinity.
static interval_t	makeInterval (value_type l, value_type u)
	Construct an interval from a lower and upper bound.
static interval_t	makeInfiniteInterval ()
	Construct an infinite interval.
static interval_t	makeLowerInterval (value_type l)
	Construct an interval from a lower bound.
static interval_t	makeUpperInterval (value_type u)
	Construct an interval from an upper bound.
static value_type	getLowerBound (const interval_t &interval)
	Get the lower bound of an interval.
static value_type	getUpperBound (const interval_t &interval)
	Get the upper bound of an interval.
static discreteInterval_t	makeDiscreteInterval (value_type min, value_type max, value_type step)
	Construct a discrete interval.
static discreteInterval_t	makeDiscreteInterval (interval_t interval, value_type step)
	Construct a discrete interval.
static value_type	getLowerBound (const discreteInterval_t &interval)
	Get the lower bound of a discrete interval.
static value_type	getUpperBound (const discreteInterval_t &interval)
	Get the upper bound of a discrete interval.
static value_type	getStep (const discreteInterval_t &interval)
	Get the upper step of a discrete interval.
template<typename F>
static void	foreach (const discreteInterval_t interval, F functor)
	Iterate on an interval.
template<typename F>
static void	foreach (const interval_t interval, const size_type n, F functor)
	Iterate on an interval.
Static Protected Attributes inherited from roboptim::GenericFunction< T >
static log4cxx::LoggerPtr	logger
	Pointer to function logger (see log4cxx documentation).

Detailed Description

template<typename T>
class roboptim::GenericLinearFunction< T >

Define an abstract linear function.

Inherit from this class when implementing linear functions.

Examples: numeric-linear-function.cc.

Constructor & Destructor Documentation

◆ GenericLinearFunction()

template<typename T>

roboptim::GenericLinearFunction< T >::GenericLinearFunction	(	size_type	inputSize,
		size_type	outputSize = 1,
		std::string	name = std::string () )

Concrete class constructor should call this constructor.

Parameters

inputSize	function arity
outputSize	result size
name	function's name

References roboptim::GenericQuadraticFunction< T >::GenericQuadraticFunction(), roboptim::GenericFunction< T >::inputSize(), and roboptim::GenericFunction< T >::outputSize().

Referenced by roboptim::GenericNumericLinearFunction< T >::GenericNumericLinearFunction(), and roboptim::GenericNumericLinearFunction< T >::GenericNumericLinearFunction().

Member Function Documentation

◆ impl_hessian()

template<typename T>

void roboptim::GenericLinearFunction< T >::impl_hessian	(	hessian_ref	hessian,
		const_argument_ref	argument,
		size_type	functionId = 0 ) const

protectedvirtual

Hessian evaluation.

Compute the hessian, has to be implemented in concrete classes. The hessian is computed for a specific sub-function which id is passed through the functionId argument.