The RationalQuadratic Kernel is a kernel of the form. More...

#include <STK_Kernel_RationalQuadratic.h>

Inheritance diagram for STK::Kernel::RationalQuadratic< Array >:

Public Types
typedef IKernelBase< Array >	Base

typedef Array::Type	Type

Public Types inherited from STK::Kernel::IKernelBase< Array >
typedef Array::Type	Type

Public Member Functions
	RationalQuadratic (Real const &shift=1.)
	Default constructor with the width.

	RationalQuadratic (Array const *p_data, Real const &shift=1.)
	constructor with a constant pointer on the data set

	RationalQuadratic (Array const &data, Real const &shift=1.)
	constructor with a constant pointer on the data set

template<class Derived >
	RationalQuadratic (Array const *p_data, ExprBase< Derived > const &param)
	constructor with an array of parameter.

template<class Derived >
	RationalQuadratic (Array const &data, ExprBase< Derived > const &param)
	constructor with a constant pointer on the data set

virtual	~RationalQuadratic ()
	destructor

Real const &	shift () const

void	setShift (Real const &shift)
	set the shift of the kernel

template<class Derived >
void	setParam (ExprBase< Derived > const &param)
	Set parameter using an array.

virtual Real	diag (int i) const
	virtual method.

virtual Real	comp (int i, int j) const
	compute the kernel value between two individuals

virtual Real	value (Type const &v) const
	compute the value of the kernel for the given value

Public Member Functions inherited from STK::Kernel::IKernelBase< Array >
	IKernelBase (Array const *p_data)
	constructor with a constant pointer on the data set

	IKernelBase (Array const &data)
	constructor with a constant reference on the data set

	IKernelBase (IKernelBase const &kernel)
	copy constructor

virtual	~IKernelBase ()
	destructor

Array const *	p_data () const

virtual bool	run ()
	compute Gram matrix

virtual int	nbSample () const

virtual int	nbVariable () const

Public Member Functions inherited from STK::Kernel::IKernel
	IKernel ()
	default constructor

	IKernel (IKernel const &kernel)
	copy constructor

virtual	~IKernel ()
	destructor

CSquareX const &	k () const

CSquareX const &	gram () const

Real	kcomp (int i, int j) const

Real	kdist (int i, int j) const

Real	kdiag (int i) const

Real	dist (int i, int j) const

Public Member Functions inherited from STK::IRunnerBase
String const &	error () const
	get the last error message.

Public Attributes
Array const *	p_data_
	pointer on the data set

CSquareX	gram_
	the resulting gram_ matrix

Public Attributes inherited from STK::Kernel::IKernelBase< Array >
CSquareX	gram_
	the resulting gram_ matrix

Private Attributes
Real	shift_
	shift of the kernel

Additional Inherited Members
Protected Member Functions inherited from STK::IRunnerBase
	IRunnerBase ()
	default constructor

	IRunnerBase (IRunnerBase const &runner)
	copy constructor

virtual	~IRunnerBase ()
	destructor

virtual void	update ()
	update the runner.

Protected Attributes inherited from STK::Kernel::IKernelBase< Array >
Array const *	p_data_
	pointer on the data set

Protected Attributes inherited from STK::Kernel::IKernel
CSquareX	gram_
	the resulting gram_ matrix

Protected Attributes inherited from STK::IRunnerBase
String	msg_error_
	String with the last error message.

bool	hasRun_
	`true` if run has been used, `false` otherwise

Detailed Description

template<class Array>
class STK::Kernel::RationalQuadratic< Array >

The RationalQuadratic Kernel is a kernel of the form.

$k(x,y) = 1 - \left( \frac{\|x-y\|^2}{\|x-y\|^2+h} \right)$

where h represents the bandwidth of the kernel.

Definition at line 54 of file STK_Kernel_RationalQuadratic.h.

Member Typedef Documentation

◆ Base

template<class Array >

typedef IKernelBase<Array> STK::Kernel::RationalQuadratic< Array >::Base

Definition at line 57 of file STK_Kernel_RationalQuadratic.h.

◆ Type

template<class Array >

typedef Array::Type STK::Kernel::RationalQuadratic< Array >::Type

Definition at line 58 of file STK_Kernel_RationalQuadratic.h.

Constructor & Destructor Documentation

◆ RationalQuadratic() [1/5]

template<class Array >

STK::Kernel::RationalQuadratic< Array >::RationalQuadratic ( Real const & shift = 1. )

inline

Default constructor with the width.

Parameters

shift the shift to use in the kernel

Definition at line 66 of file STK_Kernel_RationalQuadratic.h.

67 : Base(0), shift_(shift)

68 {}

STK::Kernel::RationalQuadratic::Base

IKernelBase< Array > Base

Definition STK_Kernel_RationalQuadratic.h:57

STK::Kernel::RationalQuadratic::shift

Real const & shift() const

Definition STK_Kernel_RationalQuadratic.h:107

STK::Kernel::RationalQuadratic::shift_

Real shift_

shift of the kernel

Definition STK_Kernel_RationalQuadratic.h:133

Referenced by STK::Kernel::RationalQuadratic< Array >::RationalQuadratic(), and STK::Kernel::RationalQuadratic< Array >::RationalQuadratic().

◆ RationalQuadratic() [2/5]

template<class Array >

STK::Kernel::RationalQuadratic< Array >::RationalQuadratic	(	Array const *	p_data,
		Real const &	shift = `1.`
	)

inline

constructor with a constant pointer on the data set

Parameters

p_data	a pointer on a data set that will be "kernelized"
shift	the shift to use in the kernel

Definition at line 73 of file STK_Kernel_RationalQuadratic.h.

                    : Base(p_data), shift_(shift)
    { if (shift_ == 0.)
        STKDOMAIN_ERROR_1ARG(RationalQuadratic::RationalQuadratic,shift,shift must be!=0);
    }

References STK::Kernel::RationalQuadratic< Array >::RationalQuadratic(), STK::Kernel::RationalQuadratic< Array >::shift(), STK::Kernel::RationalQuadratic< Array >::shift_, and STKDOMAIN_ERROR_1ARG.

◆ RationalQuadratic() [3/5]

template<class Array >

STK::Kernel::RationalQuadratic< Array >::RationalQuadratic	(	Array const &	data,
		Real const &	shift = `1.`
	)

inline

constructor with a constant pointer on the data set

Parameters

data	a reference on a data set that will be "kernelized"
shift	the size of the windows to use in the kernel

Definition at line 82 of file STK_Kernel_RationalQuadratic.h.

                    : Base(data),shift_(shift)
    { if (shift_ == 0.)
        STKDOMAIN_ERROR_1ARG(RationalQuadratic::RationalQuadratic,shift,shift must be!=0);
    }

References STK::Kernel::RationalQuadratic< Array >::RationalQuadratic(), STK::Kernel::RationalQuadratic< Array >::shift(), STK::Kernel::RationalQuadratic< Array >::shift_, and STKDOMAIN_ERROR_1ARG.

◆ RationalQuadratic() [4/5]

template<class Array >

template<class Derived >

STK::Kernel::RationalQuadratic< Array >::RationalQuadratic	(	Array const *	p_data,
		ExprBase< Derived > const &	param
	)

inline

constructor with an array of parameter.

Parameters

p_data	a pointer on a data set that will be "kernelized"
param	array of parameter

Definition at line 92 of file STK_Kernel_RationalQuadratic.h.

93 : Base(p_data), shift_(param.empty() ? 1. : param.front())

94 {}

◆ RationalQuadratic() [5/5]

template<class Array >

template<class Derived >

STK::Kernel::RationalQuadratic< Array >::RationalQuadratic	(	Array const &	data,
		ExprBase< Derived > const &	param
	)

inline

constructor with a constant pointer on the data set

Parameters

data	a reference on a data set that will be "kernelized"
param	array of parameter

Definition at line 100 of file STK_Kernel_RationalQuadratic.h.

101 : Base(data), shift_(param.empty() ? 1. : param.front())

102 {}

◆ ~RationalQuadratic()

template<class Array >

virtual STK::Kernel::RationalQuadratic< Array >::~RationalQuadratic ( )

inlinevirtual

destructor

Definition at line 105 of file STK_Kernel_RationalQuadratic.h.

105{}

Member Function Documentation

◆ comp()

template<class Array >

Real STK::Kernel::RationalQuadratic< Array >::comp	(	int	i,
		int	j
	)		const

virtual

compute the kernel value between two individuals

Parameters

i,j	index of the two individuals to compare using the kernel metric

Implements STK::Kernel::IKernel.

Definition at line 137 of file STK_Kernel_RationalQuadratic.h.

{
  if (hasRun_) return gram_(i,j);
  Real aux = (p_data_->row(i) - p_data_->row(j)).norm2();
  return 1. - aux/(aux + shift_);
}

◆ diag()

template<class Array >

virtual Real STK::Kernel::RationalQuadratic< Array >::diag ( int i ) const

inlinevirtual

virtual method.

Returns: diagonal value of the kernel for the ith individuals.

Parameters

i	index of the individual

Reimplemented from STK::Kernel::IKernel.

Definition at line 121 of file STK_Kernel_RationalQuadratic.h.

121{return 1.;};

◆ setParam()

template<class Array >

template<class Derived >

void STK::Kernel::RationalQuadratic< Array >::setParam ( ExprBase< Derived > const & param )

inline

Set parameter using an array.

Parameters

param array of parameter

Definition at line 114 of file STK_Kernel_RationalQuadratic.h.

115 { shift_ = (param.empty() ? 1. : param.front());}

References STK::Kernel::RationalQuadratic< Array >::shift_.

◆ setShift()

template<class Array >

void STK::Kernel::RationalQuadratic< Array >::setShift ( Real const & shift )

inline

set the shift of the kernel

Definition at line 109 of file STK_Kernel_RationalQuadratic.h.

109{ shift_ = shift;}

References STK::Kernel::RationalQuadratic< Array >::shift(), and STK::Kernel::RationalQuadratic< Array >::shift_.

◆ shift()

template<class Array >

Real const & STK::Kernel::RationalQuadratic< Array >::shift ( ) const

inline

Returns: the shift of the kernel

Definition at line 107 of file STK_Kernel_RationalQuadratic.h.

107{return shift_;}

References STK::Kernel::RationalQuadratic< Array >::shift_.

Referenced by STK::Kernel::RationalQuadratic< Array >::RationalQuadratic(), STK::Kernel::RationalQuadratic< Array >::RationalQuadratic(), and STK::Kernel::RationalQuadratic< Array >::setShift().

◆ value()

template<class Array >

Real STK::Kernel::RationalQuadratic< Array >::value ( Type const & v ) const

virtual

compute the value of the kernel for the given value

Parameters

v value

Returns: the value of the kernel at v

Reimplemented from STK::Kernel::IKernelBase< Array >.

Definition at line 145 of file STK_Kernel_RationalQuadratic.h.

146{ return 1- v*v/(v*v + shift_);}

Member Data Documentation

◆ gram_

template<class Array >

CSquareX STK::Kernel::IKernel::gram_

the resulting gram_ matrix

Definition at line 53 of file STK_Kernel_IKernel.h.

◆ p_data_

template<class Array >

Array const* STK::Kernel::IKernelBase< Array >::p_data_

pointer on the data set

Definition at line 90 of file STK_Kernel_IKernelBase.h.

◆ shift_

template<class Array >

Real STK::Kernel::RationalQuadratic< Array >::shift_

private

shift of the kernel

Definition at line 133 of file STK_Kernel_RationalQuadratic.h.

Referenced by STK::Kernel::RationalQuadratic< Array >::RationalQuadratic(), STK::Kernel::RationalQuadratic< Array >::RationalQuadratic(), STK::Kernel::RationalQuadratic< Array >::setParam(), STK::Kernel::RationalQuadratic< Array >::setShift(), and STK::Kernel::RationalQuadratic< Array >::shift().

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

STK_Kernel_RationalQuadratic.h

Public Types

Public Member Functions

Public Attributes

Private Attributes

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ Base

◆ Type

Constructor & Destructor Documentation

◆ RationalQuadratic() [1/5]

◆ RationalQuadratic() [2/5]

◆ RationalQuadratic() [3/5]

◆ RationalQuadratic() [4/5]

◆ RationalQuadratic() [5/5]

◆ ~RationalQuadratic()

Member Function Documentation

◆ comp()

◆ diag()

◆ setParam()

◆ setShift()

◆ shift()

◆ value()

Member Data Documentation

◆ gram_

◆ p_data_

◆ shift_