/usr/include/shogun/loss/LossFunction.h is in libshogun-dev 3.2.0-7.5.
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 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 | /*
Copyright (c) 2009 Yahoo! Inc. All rights reserved. The copyrights
embodied in the content of this file are licensed under the BSD
(revised) open source license.
Copyright (c) 2011 Berlin Institute of Technology and Max-Planck-Society.
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.
Modifications (w) 2011 Shashwat Lal Das
Modifications (w) 2012 Fernando José Iglesias García
*/
#ifndef _LOSSFUNCTION_H__
#define _LOSSFUNCTION_H__
#include <shogun/base/SGObject.h>
#include <shogun/lib/common.h>
#include <math.h>
namespace shogun
{
/// shogun loss type
enum ELossType
{
L_HINGELOSS = 0,
L_SMOOTHHINGELOSS = 10,
L_SQUAREDHINGELOSS = 20,
L_SQUAREDLOSS = 30,
L_LOGLOSS = 100,
L_LOGLOSSMARGIN = 110
};
}
namespace shogun
{
/** @brief Class CLossFunction is the base class of
* all loss functions.
*
* The class provides the loss for one example,
* first and second derivates of the loss function,
* (used very commonly) the square of the gradient and
* the importance-aware weight update for the function.
* (used mainly for VW)
*
* Refer: Online Importance Weight Aware Updates,
* Nikos Karampatziakis, John Langford
* http://arxiv.org/abs/1011.1576
*/
class CLossFunction: public CSGObject
{
public:
/**
* Constructor
*/
CLossFunction(): CSGObject() {}
/**
* Destructor
*/
virtual ~CLossFunction() {};
/**
* Get loss for an example
*
* @param prediction prediction
* @param label label
*
* @return loss
*/
virtual float64_t loss(float64_t prediction, float64_t label)
{
return loss(prediction * label);
}
/**
* Get loss for an example
*
* @param z where to evaluate the loss
*
* @return loss
*/
virtual float64_t loss(float64_t z) = 0;
/**
* Get first derivative of the loss function
*
* @param prediction prediction
* @param label label
*
* @return first derivative
*/
virtual float64_t first_derivative(float64_t prediction, float64_t label)
{
return loss(prediction * label);
}
/**
* Get first derivative of the loss function
*
* @param z where to evaluate the derivative of the loss
*
* @return first derivative
*/
virtual float64_t first_derivative(float64_t z) = 0;
/**
* Get second derivative of the loss function
*
* @param prediction prediction
* @param label label
*
* @return second derivative
*/
virtual float64_t second_derivative(float64_t prediction, float64_t label)
{
return loss(prediction * label);
}
/**
* Get second derivative of the loss function
*
* @param z where to evaluate the second derivative of the loss
*
* @return second derivative
*/
virtual float64_t second_derivative(float64_t z) = 0;
/**
* Get importance aware weight update for this loss function
*
* @param prediction prediction
* @param label label
* @param eta_t learning rate at update number t
* @param norm scale value
*
* @return update
*/
virtual float64_t get_update(float64_t prediction, float64_t label, float64_t eta_t, float64_t norm) = 0;
/**
* Get square of gradient, used for adaptive learning
*
* @param prediction prediction
* @param label label
*
* @return square of gradient
*/
virtual float64_t get_square_grad(float64_t prediction, float64_t label) = 0;
/**
* Get loss type
*
* abstract base method
*
* @return loss type as enum
*/
virtual ELossType get_loss_type()=0;
/**
* Return the name of the object
*
* @return LossFunction
*/
virtual const char* get_name() const { return "LossFunction"; }
};
}
#endif // _LOSSFUNCTION_H__
|