summaryrefslogtreecommitdiff
path: root/src/CuTNetLib/cuUpdatableBias.h
blob: d557173dfe697e5cfea0a670129320826c8b6c4f (plain)
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
#ifndef _CUUPDATABLE_BIAS_H_
#define _CUUPDATABLE_BIAS_H_


#include "cuComponent.h"
#include "cumatrix.h"


#include "Matrix.h"
#include "Vector.h"


namespace TNet {
  /**
   * \brief CuUpdatableBias summation function
   *
   * \ingroup CuNNUpdatable
   * Implements forward pass: \f[ Y_i=X_i +{\beta}_i \f]
   * Error propagation: \f[ E_i = e_i \f]
   *
   * Weight adjust:
   * for bias: \f[ B_i = {\beta}_i - \alpha (1-\mu) e_i - \mu \Delta \f]
   * where
   *  - D for weight decay => penalizing large weight
   *  - \f$ \alpha \f$ for learning rate
   *  - \f$ \mu \f$ for momentum => avoiding oscillation
   */
  class CuUpdatableBias : public CuUpdatableComponent
  {
    public:

      CuUpdatableBias(size_t nInputs, size_t nOutputs, CuComponent *pPred); 
      ~CuUpdatableBias();  
      
      ComponentType GetType() const;
      const char* GetName() const;
      
      const CuMatrix<float>& GetErrorOutput();

      void PropagateFnc(const CuMatrix<BaseFloat>& X, CuMatrix<BaseFloat>& Y);
      void BackpropagateFnc(const CuMatrix<BaseFloat>& X, CuMatrix<BaseFloat>& Y);

      void Update();

      void ReadFromStream(std::istream& rIn);
      void WriteToStream(std::ostream& rOut);
      
      void Backpropagate();

    protected:
      CuVector<BaseFloat> mBias;       ///< Vector with biases

      CuVector<BaseFloat> mBiasCorrection;      ///< Vector for bias updates

  };




  ////////////////////////////////////////////////////////////////////////////
  // INLINE FUNCTIONS 
  // CuUpdatableBias::
  inline 
  CuUpdatableBias::
  CuUpdatableBias(size_t nInputs, size_t nOutputs, CuComponent *pPred)
    : CuUpdatableComponent(nInputs, nOutputs, pPred), 
      mBias(nOutputs), mBiasCorrection(nOutputs)
  { 
    mBiasCorrection.SetConst(0.0);
  }


  inline
  CuUpdatableBias::
  ~CuUpdatableBias()
  { }

  inline CuComponent::ComponentType
  CuUpdatableBias::
  GetType() const
  {
    return CuComponent::UPDATABLEBIAS;
  }

  inline const char*
  CuUpdatableBias::
  GetName() const
  {
    return "<updatablebias>";
  }
 
  inline void
  CuUpdatableBias::
  Backpropagate()
  {
  }

  inline const CuMatrix<BaseFloat>&
  CuUpdatableBias::
  GetErrorOutput()
  {
    return GetErrorInput();
  }

} //namespace



#endif