Source code for akida.layers.input_conv2d

from akida.core import (Layer, Padding, PoolType, LayerType, LayerParams)


[docs]class InputConv2D(Layer): """This represents the Akida V2 InputConv2D layer. This layer is an image-specific input layer. It only accepts images in 8-bit pixels, either grayscale or RGB. Its kernel weights should be 8-bit. It applies a convolution (actually a cross-correlation) optionally followed by a bias addition, a pooling operation and a ReLU activation. Inputs shape must be in the form (X, Y, C). Being the result of a quantized operation, it is possible to apply some shifts to adjust the output scales to the equivalent operation performed on floats, while maintaining a limited usage of bits and performing the operations on integer values. The order of the input spatial dimensions is preserved, but their values may change according to the convolution and pooling parameters. The InputConv2D operation can be described as follows: >>> prod = conv2d(inputs, weights) >>> output = prod + (bias << bias_shift) #optional >>> output = pool(output) #optional >>> output = ReLU(output) #optional >>> output = output * output_scale >> output_shift Note that output values will be saturated on the range that can be represented with output_bits. Args: input_shape (tuple): the 3D input shape. kernel_size (int): integer value specifying the height and width of the 2D convolution window. filters (int): number of filters. padding (:obj:`Padding`, optional): type of convolution rather Padding.Same or Padding.Valid. Defaults to Padding.Same. kernel_stride (int, optional): integer representing the convolution stride across both spatial dimensions. Defaults to 1. pool_type (:obj:`PoolType`, optional): pooling type (NoPooling, Max). Defaults to PoolType.NoPooling. pool_size (int, optional): integer value specifying the height and width of the window over which to take the maximum or the average (depending on pool_type parameter). Defaults to -1. pool_stride (int, optional): integer representing the stride across both dimensions. Defaults to -1. activation (bool, optional): enable or disable activation function. Defaults to True. output_bits (int, optional): output bitwidth. Defaults to 8. buffer_bits (int, optional): buffer bitwidth. Defaults to 32. post_op_buffer_bits (int, optional): internal bitwidth for post operations. Defaults to 32. name (str, optional): name of the layer. Defaults to empty string. """ def __init__(self, input_shape, filters, kernel_size, padding=Padding.Same, kernel_stride=1, pool_type=PoolType.NoPooling, pool_size=-1, pool_stride=-1, activation=True, output_bits=8, buffer_bits=32, post_op_buffer_bits=32, name=""): try: params = LayerParams( LayerType.InputConv2D, { "input_x": input_shape[0], "input_y": input_shape[1], "input_channels": input_shape[2], "filters": filters, "kernel_size": kernel_size, "padding": padding, "kernel_stride": kernel_stride, "pool_type": pool_type, "pool_size": pool_size, "pool_stride": pool_stride, "activation": activation, "output_bits": output_bits, "buffer_bits": buffer_bits, "post_op_buffer_bits": post_op_buffer_bits, }) # Call parent constructor to initialize C++ bindings # Note that we invoke directly __init__ instead of using super, as # specified in pybind documentation Layer.__init__(self, params, name) except BaseException: self = None raise