One-norm of the input as an objective function. More...

#include <shark/ObjectiveFunctions/Regularizer.h>

Inheritance diagram for shark::OneNormRegularizer:

Public Member Functions
	OneNormRegularizer (std::size_t numVariables=0)
	Constructor. More...

std::string	name () const
	From INameable: return the class name. More...

std::size_t	numberOfVariables () const
	Accesses the number of variables. More...

bool	hasScalableDimensionality () const

void	setNumberOfVariables (std::size_t numberOfVariables)
	Adjusts the number of variables if the function is scalable. More...

void	setMask (const RealVector &mask)

const RealVector &	mask () const

double	eval (RealVector const &input) const
	Evaluates the objective function. More...

double	evalDerivative (RealVector const &input, FirstOrderDerivative &derivative) const

double	evalDerivative (RealVector const &input, SecondOrderDerivative &derivative) const
	Evaluates the objective function and calculates its gradient. More...

Public Member Functions inherited from shark::AbstractObjectiveFunction< RealVector, double >
const Features &	features () const

virtual void	updateFeatures ()

bool	hasValue () const
	returns whether this function can calculate it's function value More...

bool	hasFirstDerivative () const
	returns whether this function can calculate the first derivative More...

bool	hasSecondDerivative () const
	returns whether this function can calculate the second derivative More...

bool	canProposeStartingPoint () const
	returns whether this function can propose a starting point. More...

bool	isConstrained () const
	returns whether this function can return More...

bool	hasConstraintHandler () const
	returns whether this function can return More...

bool	canProvideClosestFeasible () const
	Returns whether this function can calculate thee closest feasible to an infeasible point. More...

bool	isThreadSafe () const
	Returns true, when the function can be usd in parallel threads. More...

	AbstractObjectiveFunction ()
	Default ctor. More...

virtual	~AbstractObjectiveFunction ()
	Virtual destructor. More...

virtual void	init ()

virtual std::size_t	numberOfObjectives () const

virtual bool	hasScalableObjectives () const

virtual void	setNumberOfObjectives (std::size_t numberOfObjectives)
	Adjusts the number of objectives if the function is scalable. More...

std::size_t	evaluationCounter () const
	Accesses the evaluation counter of the function. More...

AbstractConstraintHandler< SearchPointType > const &	getConstraintHandler () const
	Returns the constraint handler of the function if it has one. More...

virtual bool	isFeasible (const SearchPointType &input) const
	Tests whether a point in SearchSpace is feasible, e.g., whether the constraints are fulfilled. More...

virtual void	closestFeasible (SearchPointType &input) const
	If supported, the supplied point is repaired such that it satisfies all of the function's constraints. More...

virtual SearchPointType	proposeStartingPoint () const
	Proposes a starting point in the feasible search space of the function. More...

ResultType	operator() (const SearchPointType &input) const
	Evaluates the function. Useful together with STL-Algorithms like std::transform. More...

Public Member Functions inherited from shark::INameable
virtual	~INameable ()

Additional Inherited Members
Public Types inherited from shark::AbstractObjectiveFunction< RealVector, double >
enum	Feature
	List of features that are supported by an implementation. More...

typedef RealVector	SearchPointType

typedef double	ResultType

typedef SearchPointType	FirstOrderDerivative

typedef TypedFlags< Feature >	Features
	This statement declares the member m_features. See Core/Flags.h for details. More...

typedef TypedFeatureNotAvailableException< Feature >	FeatureNotAvailableException

Protected Member Functions inherited from shark::AbstractObjectiveFunction< RealVector, double >
void	announceConstraintHandler (AbstractConstraintHandler< SearchPointType > const *handler)
	helper function which is called to announce the presence of an constraint handler. More...

Protected Attributes inherited from shark::AbstractObjectiveFunction< RealVector, double >
Features	m_features

std::size_t	m_evaluationCounter
	Evaluation counter, default value: 0. More...

AbstractConstraintHandler< SearchPointType > const *	m_constraintHandler

Detailed Description

One-norm of the input as an objective function.

: The OneNormRegularizer is intended to be used together with other objective functions within a CombinedObjectiveFunction, in order to obtain a more smooth and more sparse solution.

Definition at line 51 of file Regularizer.h.

Constructor & Destructor Documentation

§ OneNormRegularizer()

shark::OneNormRegularizer::OneNormRegularizer ( std::size_t numVariables = 0 )

inline

Constructor.

Definition at line 56 of file Regularizer.h.

References shark::AbstractObjectiveFunction< RealVector, double >::HAS_FIRST_DERIVATIVE, shark::AbstractObjectiveFunction< RealVector, double >::HAS_SECOND_DERIVATIVE, and shark::AbstractObjectiveFunction< RealVector, double >::m_features.

Member Function Documentation

§ eval()

double shark::OneNormRegularizer::eval ( RealVector const & input ) const

inlinevirtual

Evaluates the objective function.

Reimplemented from shark::AbstractObjectiveFunction< RealVector, double >.

Definition at line 85 of file Regularizer.h.

References shark::blas::norm_1().

Referenced by evalDerivative(), and shark::TwoNormRegularizer::evalDerivative().

§ evalDerivative() [1/2]

double shark::OneNormRegularizer::evalDerivative	(	RealVector const &	input,
		FirstOrderDerivative &	derivative
	)		const

inlinevirtual

Evaluates the objective function and calculates its gradient.

Reimplemented from shark::AbstractObjectiveFunction< RealVector, double >.

Definition at line 97 of file Regularizer.h.

References eval(), and SIZE_CHECK.

§ evalDerivative() [2/2]

double shark::OneNormRegularizer::evalDerivative	(	RealVector const &	input,
		SecondOrderDerivative &	derivative
	)		const

inlinevirtual

Evaluates the objective function and calculates its gradient.

Parameters

[in]	input	The argument to eval the function for.
[out]	derivative	The derivate and the Hessian are placed here.

Returns: The result of evaluating the function for the supplied argument.

Exceptions

FeatureNotAvailableException in the default implementation and if a function does not support this feature.

Reimplemented from shark::AbstractObjectiveFunction< RealVector, double >.

Definition at line 114 of file Regularizer.h.

References eval(), and SIZE_CHECK.

§ hasScalableDimensionality()

bool shark::OneNormRegularizer::hasScalableDimensionality ( ) const

inlinevirtual

Reimplemented from shark::AbstractObjectiveFunction< RealVector, double >.

Definition at line 70 of file Regularizer.h.

§ mask()

const RealVector& shark::OneNormRegularizer::mask ( ) const

inline

Definition at line 81 of file Regularizer.h.

Referenced by setMask(), and shark::TwoNormRegularizer::setMask().

§ name()

std::string shark::OneNormRegularizer::name ( ) const

inlinevirtual

From INameable: return the class name.

Reimplemented from shark::INameable.

Definition at line 63 of file Regularizer.h.

§ numberOfVariables()

std::size_t shark::OneNormRegularizer::numberOfVariables ( ) const

inlinevirtual

Accesses the number of variables.

Implements shark::AbstractObjectiveFunction< RealVector, double >.

Definition at line 66 of file Regularizer.h.

Referenced by setNumberOfVariables(), and shark::TwoNormRegularizer::setNumberOfVariables().

§ setMask()

void shark::OneNormRegularizer::setMask ( const RealVector & mask )

inline

Definition at line 78 of file Regularizer.h.

References mask().

§ setNumberOfVariables()

void shark::OneNormRegularizer::setNumberOfVariables ( std::size_t numberOfVariables )

inlinevirtual

Adjusts the number of variables if the function is scalable.

Parameters

[in] numberOfVariables The new dimension.

Reimplemented from shark::AbstractObjectiveFunction< RealVector, double >.

Definition at line 74 of file Regularizer.h.

References numberOfVariables().

The documentation for this class was generated from the following file:

include/shark/ObjectiveFunctions/Regularizer.h

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

§ OneNormRegularizer()

Member Function Documentation

§ eval()

§ evalDerivative() [1/2]

§ evalDerivative() [2/2]

§ hasScalableDimensionality()

§ mask()

§ name()

§ numberOfVariables()

§ setMask()

§ setNumberOfVariables()