/usr/include/shogun/kernel/CircularKernel.h is in libshogun-dev 3.2.0-7.3build4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 | /*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 3 of the License, or
* (at your option) any later version.
*
* Written (W) 2011 Abhinav Maurya
* Copyright (C) 2011 Berlin Institute of Technology and Max-Planck-Society
* Copyright (C) 2011 Indian Institute of Technology Bombay
*/
#include <shogun/lib/config.h>
#ifndef _CIRCULARKERNEL_H__
#define _CIRCULARKERNEL_H__
#include <shogun/lib/common.h>
#include <shogun/kernel/Kernel.h>
#include <shogun/distance/Distance.h>
namespace shogun
{
class CDistance;
/** @brief Circular kernel
*
* Formally described as
*
* \f[
* k(x, y) = \frac{2}{\pi}*\arccos(\frac{-||{\bf x}-{\bf x'}||}{\sigma}) - \frac{2}{\pi}*(\frac{||{\bf x}-{\bf x'}||}{\sigma})*\sqrt{1-(\frac{||{\bf x}-{\bf x'}||}{\sigma})^2}
*
* \mbox{if}~ ||x-y|| \leq \sigma \mbox{, zero otherwise}
* \f]
*
*/
class CCircularKernel: public CKernel
{
public:
/** default constructor */
CCircularKernel();
/** constructor
*
* @param size cache size
* @param sigma kernel parameter sigma
* @param dist distance
*/
CCircularKernel(int32_t size, float64_t sigma, CDistance* dist);
/** constructor
*
* @param l features of left-side
* @param r features of right-side
* @param sigma kernel parameter sigma
* @param dist distance
*/
CCircularKernel(CFeatures *l, CFeatures *r, float64_t sigma, CDistance* dist);
/** initialize kernel with features
*
* @param l features of left-side
* @param r features of right-side
* @return true if successful
*/
virtual bool init(CFeatures* l, CFeatures* r);
/**
* @return kernel type
*/
virtual EKernelType get_kernel_type() { return K_CIRCULAR; }
/**
* @return type of features
*/
virtual EFeatureType get_feature_type() { return distance->get_feature_type(); }
/**
* @return class of features
*/
virtual EFeatureClass get_feature_class() { return distance->get_feature_class(); }
/**
* @return name of kernel
*/
virtual const char* get_name() const { return "CircularKernel"; }
/** set the kernel's sigma
*
* @param s kernel sigma
*/
virtual void set_sigma(float64_t s)
{
sigma=s;
}
/** return the kernel's sigma
*
* @return kernel sigma
*/
virtual float64_t get_sigma() const
{
return sigma;
}
virtual ~CCircularKernel();
/** Can (optionally) be overridden to post-initialize some
* member variables which are not PARAMETER::ADD'ed. Make
* sure that at first the overridden method
* BASE_CLASS::LOAD_SERIALIZABLE_POST is called.
*
* @exception ShogunException Will be thrown if an error
* occurres.
*/
virtual void load_serializable_post() throw (ShogunException);
/**
* compute kernel function for features a and b
* idx_{a,b} denote the index of the feature vectors
* in the corresponding feature object
*
* @param idx_a index a
* @param idx_b index b
* @return computed kernel function at indices a,b
*/
virtual float64_t compute(int32_t idx_a, int32_t idx_b);
private:
void init();
protected:
/** distance */
CDistance* distance;
/** width */
float64_t sigma;
};
}
#endif /* _CIRCULARKERNEL_H__ */
|