habana_frameworks.mediapipe.fn.Add

Class:

• habana_frameworks.mediapipe.fn.Add(**kwargs)

Define graph call:

• __call__(input1, input2)

Parameter:

• input1 - First input tensor to operator. Supported dimensions: minimum = 1, maximum = 5. Supported data types: INT16, INT32, FLOAT16, BFLOAT16, FLOAT32.

• input2 - Second input tensor to operator. Supported dimensions: minimum = 1, maximum = 5. Supported data types: INT16, INT32, FLOAT16, BFLOAT16, FLOAT32.

Description:

The resulting tensor is formed from the summation of the two operands element-wise. This operator performs element-wise addition and supports Broadcasting. Computes output as: output = (input1 + input2), element-wise.

Supported backend:

• HPU, CPU

Keyword Arguments

kwargs	Description
dtype	Output data type. Type: habana_frameworks.mediapipe.media_types.dtype Default: FLOAT32 Optional: yes Supported data types: INT32 BFLOAT16 FLOAT32

Note

1. All input/output tensors must be of the same data type and must have the same dimensionality except in broadcast support where dimensionality can be different.

2. This operator is agnostic to the data layout.

Example: Add Operator

The following code snippet shows usage of Add operator:

from habana_frameworks.mediapipe import fn
from habana_frameworks.mediapipe.mediapipe import MediaPipe
from habana_frameworks.mediapipe.media_types import imgtype as it
from habana_frameworks.mediapipe.media_types import dtype as dt
from habana_frameworks.mediapipe.operators.cpu_nodes.cpu_nodes import media_function
import numpy as np


class random_noise_generator(media_function):
    def __init__(self, params):
        self.priv_params = params['priv_params']
        self.batch_size = self.priv_params['batch_size']
        self.channel = self.priv_params['channel']
        self.width = self.priv_params['width']
        self.height = self.priv_params['height']
        np.random.seed(0)

    def __call__(self):  # NCHW
        return np.random.rand(self.batch_size, self.channel, self.height, self.width)


class myMediaPipe(MediaPipe):
    def __init__(self, device, dir, queue_depth, batch_size, img_h, img_w, img_c):
        super(
            myMediaPipe,
            self).__init__(
            device,
            queue_depth,
            batch_size,
            self.__class__.__name__)

        self.input = fn.ReadImageDatasetFromDir(dir=dir,
                                                format="jpg",
                                                shuffle=False,
                                                seed=0,
                                                label_dtype=dt.UINT32)

        self.decode = fn.ImageDecoder(device="hpu",
                                      output_format=it.RGB_P,
                                      resize=[img_w, img_h])

        priv_params = {}
        priv_params['batch_size'] = batch_size
        priv_params['channel'] = img_c
        priv_params['width'] = img_w
        priv_params['height'] = img_h

        self.input_node = fn.MediaFunc(func=random_noise_generator, shape=[
                                      img_w, img_h, img_c, batch_size], dtype=dt.FLOAT32, priv_params=priv_params)

        self.cast = fn.Cast(dtype=dt.FLOAT32)

        self.add = fn.Add(dtype=dt.FLOAT32)

    def definegraph(self):
        images, labels = self.input()
        images = self.decode(images)
        images = self.cast(images)
        images2 = self.input_node()
        images = self.add(images, images2)
        return images, labels


def main():
    batch_size = 6
    img_width = 200
    img_height = 200
    img_channel = 3
    img_dir = "/path/to/images"
    queue_depth = 2

    # Create media pipeline object
    pipe = myMediaPipe('hpu', img_dir, queue_depth, batch_size,
                      img_height, img_width, img_channel)

    # Build media pipeline
    pipe.build()

    # Initialize media pipeline iterator
    pipe.iter_init()

    # Run media pipeline
    images, labels = pipe.run()

    # Copy data to host from device as numpy array
    images = images.as_cpu().as_nparray()
    labels = labels.as_cpu().as_nparray()

    # Display data
    print('data:', images)


if __name__ == "__main__":
    main()

The following is the output of Add operator:

data: [[[[ 6.13178052e+13  1.22762207e+02 -3.76695680e+09 ...  1.10832237e+02
    8.20567600e+06  1.09950127e+02]
  [ 8.35879808e+08  1.19794456e+02  1.15000000e+02 ...  1.14357117e+02
    8.52577571e+21  1.07717209e+02]
  [ 1.20999992e+02  1.21655899e+02  1.17000000e+02 ...  1.11868233e+02
    7.20720036e+11  1.09865211e+02]
  ...
  ...
  [ 2.49562923e+17  7.66319962e+01  3.07828832e+33 ...  4.07631302e+01
    -4.51390026e+23  4.77172165e+01]
  [-1.05408803e+24  7.37079468e+01 -1.83894963e+35 ...  4.57067451e+01
    4.60000000e+01  4.98639374e+01]
  [ 7.90000000e+01  7.86786499e+01 -2.01810875e+05 ...  4.57857323e+01
    4.60000000e+01  4.94011192e+01]]]]