This file is indexed.

/usr/include/shogun/classifier/vw/VwLearner.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
/*
 * 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.
 *
 * 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 Shashwat Lal Das
 * Adaptation of Vowpal Wabbit v5.1.
 * Copyright (C) 2011 Berlin Institute of Technology and Max-Planck-Society.
 */

#ifndef _VW_LEARNER_H__
#define _VW_LEARNER_H__

#include <shogun/base/SGObject.h>
#include <shogun/base/Parameter.h>
#include <shogun/classifier/vw/vw_common.h>
#include <shogun/classifier/vw/VwRegressor.h>

namespace shogun
{
/** @brief Base class for all VW learners
 *
 * Learners are supplied with a regressor and the environment.
 *
 * They should implement a train function which updates
 * the weight vector given the update for the example.
 */
class CVwLearner: public CSGObject
{
public:
	/**
	 * Default constructor
	 */
	CVwLearner()
		: CSGObject(), reg(NULL), env(NULL)
	{
		register_learner_params();
	}

	/**
	 * Constructor, initializes regressor and environment
	 *
	 * @param regressor regressor
	 * @param vw_env environment
	 */
	CVwLearner(CVwRegressor* regressor, CVwEnvironment* vw_env)
		: CSGObject(), reg(regressor), env(vw_env)
	{
		SG_REF(reg);
		SG_REF(env);
		register_learner_params();
	}

	/**
	 * Destructor
	 */
	virtual ~CVwLearner()
	{
		if (reg)
			SG_UNREF(reg);
		if (env)
			SG_UNREF(env);
	}

	/**
	 * Add parameters to make them serializable
	 */
	void register_learner_params()
	{
		SG_ADD((CSGObject**) &reg, "vw_regressor", "Regressor object",
		       MS_NOT_AVAILABLE);
		SG_ADD((CSGObject**) &env, "vw_env", "Environment",
		       MS_NOT_AVAILABLE);
	}

	/**
	 * Train on the example
	 *
	 * @param ex example
	 * @param update update
	 */
	virtual void train(VwExample* &ex, float32_t update) = 0;

	/**
	 * Return the name of the object
	 *
	 * @return VwLearner
	 */
	virtual const char* get_name() const { return "VwLearner"; }

protected:
	/// Regressor object that will be used for getting updates
	CVwRegressor *reg;
	/// Environment
	CVwEnvironment *env;
};
}
#endif // _VW_LEARNER_H__