Class: DNN::Layers::Layer

Inherits:
Object
  • Object
show all
Defined in:
lib/dnn/core/layers/basic_layers.rb

Overview

Super class of all layer classes.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Layer

Returns a new instance of Layer.



42
43
44
 
# File 'lib/dnn/core/layers/basic_layers.rb', line 42

def initialize
  @built = false
end

Instance Attribute Details

#input_shape ⇒ Object (readonly)

Returns the value of attribute input_shape.



26
27
28
 
# File 'lib/dnn/core/layers/basic_layers.rb', line 26

def input_shape
  @input_shape
end

#output_shape ⇒ Object (readonly)

Returns the value of attribute output_shape.



27
28
29
 
# File 'lib/dnn/core/layers/basic_layers.rb', line 27

def output_shape
  @output_shape
end

Class Method Details

.call(x, *args) ⇒ Object 



29
30
31
 
# File 'lib/dnn/core/layers/basic_layers.rb', line 29

def self.call(x, *args)
  new(*args).(x)
end

.from_hash(hash) ⇒ Object

Raises:



33
34
35
36
37
38
39
40
 
# File 'lib/dnn/core/layers/basic_layers.rb', line 33

def self.from_hash(hash)
  return nil unless hash
  layer_class = DNN.const_get(hash[:class])
  layer = layer_class.allocate
  raise DNNError, "#{layer.class} is not an instance of #{self} class." unless layer.is_a?(self)
  layer.load_hash(hash)
  layer
end

Instance Method Details

#<<(tensor) ⇒ Object 



82
83
84
 
# File 'lib/dnn/core/layers/basic_layers.rb', line 82

def <<(tensor)
  self.(tensor)
end

#build(input_shape) ⇒ Object

Build the layer.

Parameters:

  • input_shape (Array) —

    Setting the shape of the input data.



57
58
59
60
61
 
# File 'lib/dnn/core/layers/basic_layers.rb', line 57

def build(input_shape)
  @input_shape = input_shape
  @output_shape = compute_output_shape
  @built = true
end

#built? ⇒ Boolean

Returns If layer have already been built then return true.

Returns:

  • (Boolean) —

    If layer have already been built then return true.



64
65
66
 
# File 'lib/dnn/core/layers/basic_layers.rb', line 64

def built?
  @built
end

#call(input) ⇒ Tensor

Forward propagation and create a link.

Parameters:

Returns:



49
50
51
52
53
 
# File 'lib/dnn/core/layers/basic_layers.rb', line 49

def call(input)
  input = Tensor.convert(input) if !input.is_a?(Tensor) && !input.is_a?(Param)
  build(input.data.shape[1..-1]) unless built?
  forward(input)
end

#clean ⇒ Object

Clean the layer state.



98
99
100
101
102
103
104
105
106
 
# File 'lib/dnn/core/layers/basic_layers.rb', line 98

def clean
  input_shape = @input_shape
  hash = to_hash
  instance_variables.each do |ivar|
    instance_variable_set(ivar, nil)
  end
  load_hash(hash)
  build(input_shape)
end

#compute_output_shape ⇒ Array

Please reimplement this method as needed. The default implementation return input_shape.

Returns:

  • (Array) —

    Return the shape of the output data.



78
79
80
 
# File 'lib/dnn/core/layers/basic_layers.rb', line 78

def compute_output_shape
  @input_shape
end

#forward(input) ⇒ Tensor

Forward propagation.

Parameters:

  • input (Tensor) —

    Input tensor or param.

Returns:

Raises:

  • (NotImplementedError) 


71
72
73
 
# File 'lib/dnn/core/layers/basic_layers.rb', line 71

def forward(input)
  raise NotImplementedError, "Class '#{self.class.name}' has implement method 'forward'"
end

#load_hash(hash) ⇒ Object 



93
94
95
 
# File 'lib/dnn/core/layers/basic_layers.rb', line 93

def load_hash(hash)
  initialize
end

#to_hash(merge_hash = nil) ⇒ Object

Layer to a hash.



87
88
89
90
91
 
# File 'lib/dnn/core/layers/basic_layers.rb', line 87

def to_hash(merge_hash = nil)
  hash = { class: self.class.name }
  hash.merge!(merge_hash) if merge_hash
  hash
end