# Licensed to the Apache Software Foundation (ASF) under one # or more contributor license agreements. See the NOTICE file # distributed with this work for additional information # regarding copyright ownership. The ASF licenses this file # to you under the Apache License, Version 2.0 (the # "License"); you may not use this file except in compliance # with the License. You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, # software distributed under the License is distributed on an # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY # KIND, either express or implied. See the License for the # specific language governing permissions and limitations # under the License. """Broadcast operators""" from __future__ import absolute_import as _abs from .import cpp as _cpp def broadcast_to(data, shape): """Broadcast the src to the target shape We follows the numpy broadcasting rule. See also https://docs.scipy.org/doc/numpy/user/basics.broadcasting.html Parameters ---------- data : tvm.Tensor The input data shape : list or tuple The target shape to be broadcasted. Returns ------- ret : tvm.Tensor """ return _cpp.broadcast_to(data, shape) def add(lhs, rhs): """Addition with auto-broadcasting Parameters ---------- lhs : tvm.Tensor or Expr The left operand rhs : tvm.Tensor or Expr The right operand Returns ------- ret : tvm.Tensor or Expr Returns Expr if both operands are Expr. Otherwise returns Tensor. """ return _cpp.add(lhs, rhs) def subtract(lhs, rhs): """Subtraction with auto-broadcasting Parameters ---------- lhs : tvm.Tensor or Expr The left operand rhs : tvm.Tensor or Expr The right operand Returns ------- ret : tvm.Tensor or Expr Returns Expr if both operands are Expr. Otherwise returns Tensor. """ return _cpp.subtract(lhs, rhs) def multiply(lhs, rhs): """Multiplication with auto-broadcasting Parameters ---------- lhs : tvm.Tensor or Expr The left operand rhs : tvm.Tensor or Expr The right operand Returns ------- ret : tvm.Tensor or Expr Returns Expr if both operands are Expr. Otherwise returns Tensor. """ return _cpp.multiply(lhs, rhs) def divide(lhs, rhs): """Division with auto-broadcasting Parameters ---------- lhs : tvm.Tensor or Expr The left operand rhs : tvm.Tensor or Expr The right operand Returns ------- ret : tvm.Tensor or Expr Returns Expr if both operands are Expr. Otherwise returns Tensor. """ return _cpp.divide(lhs, rhs) def floor_divide(lhs, rhs): """Floor division with auto-broadcasting Parameters ---------- lhs : tvm.Tensor or Expr The left operand rhs : tvm.Tensor or Expr The right operand Returns ------- ret : tvm.Tensor or Expr Returns Expr if both operands are Expr. Otherwise returns Tensor. """ return _cpp.floor_divide(lhs, rhs) def mod(lhs, rhs): """Modulus with auto-broadcasting Parameters ---------- lhs : tvm.Tensor or Expr The left operand rhs : tvm.Tensor or Expr The right operand Returns ------- ret : tvm.Tensor or Expr Returns Expr if both operands are Expr. Otherwise returns Tensor. """ return _cpp.mod(lhs, rhs) def floor_mod(lhs, rhs): """Floor modulus with auto-broadcasting Parameters ---------- lhs : tvm.Tensor or Expr The left operand rhs : tvm.Tensor or Expr The right operand Returns ------- ret : tvm.Tensor or Expr Returns Expr if both operands are Expr. Otherwise returns Tensor. """ return _cpp.floor_mod(lhs, rhs) def maximum(lhs, rhs): """Take element-wise maximum of two tensors with auto-broadcasting Parameters ---------- lhs : tvm.Tensor or Expr The left operand rhs : tvm.Tensor or Expr The right operand Returns ------- ret : tvm.Tensor or Expr Returns Expr if both operands are Expr. Otherwise returns Tensor. """ return _cpp.maximum(lhs, rhs) def minimum(lhs, rhs): """Take element-wise maximum of two tensors with auto-broadcasting Parameters ---------- lhs : tvm.Tensor or Expr The left operand rhs : tvm.Tensor or Expr The right operand Returns ------- ret : tvm.Tensor or Expr Returns Expr if both operands are Expr. Otherwise returns Tensor. """ return _cpp.minimum(lhs, rhs) def power(lhs, rhs): """Power with auto-broadcasting Parameters ---------- lhs : tvm.Tensor or Expr The left operand rhs : tvm.Tensor or Expr The right operand Returns ------- ret : tvm.Tensor or Expr Returns Expr if both operands are Expr. Otherwise returns Tensor. """ return _cpp.power(lhs, rhs) def left_shift(lhs, rhs): """Left shift with auto-broadcasting Parameters ---------- lhs : tvm.Tensor or Expr The left operand rhs : tvm.Tensor or Expr The right operand Returns ------- ret : tvm.Tensor or Expr Returns Expr if both operands are Expr. Otherwise returns Tensor. """ return _cpp.left_shift(lhs, rhs) def right_shift(lhs, rhs): """Right shift with auto-broadcasting Parameters ---------- lhs : tvm.Tensor or Expr The left operand rhs : tvm.Tensor or Expr The right operand Returns ------- ret : tvm.Tensor or Expr Returns Expr if both operands are Expr. Otherwise returns Tensor. """ return _cpp.right_shift(lhs, rhs) def greater(lhs, rhs): """Compute (lhs>rhs) with auto-broadcasting Parameters ---------- lhs : tvm.Tensor or Expr The left operand rhs : tvm.Tensor or Expr The right operand Returns ------- ret : tvm.Tensor or Expr Returns Expr if both operands are Expr. Otherwise returns Tensor. """ return _cpp.greater(lhs, rhs) def less(lhs, rhs): """Compute (lhs=rhs) with auto-broadcasting Parameters ---------- lhs : tvm.Tensor or Expr The left operand rhs : tvm.Tensor or Expr The right operand Returns ------- ret : tvm.Tensor or Expr Returns Expr if both operands are Expr. Otherwise returns Tensor. """ return _cpp.greater_equal(lhs, rhs) def less_equal(lhs, rhs): """Compute (lhs<=rhs) with auto-broadcasting Parameters ---------- lhs : tvm.Tensor or Expr The left operand rhs : tvm.Tensor or Expr The right operand Returns ------- ret : tvm.Tensor or Expr Returns Expr if both operands are Expr. Otherwise returns Tensor. """ return _cpp.less_equal(lhs, rhs) def logical_and(lhs, rhs): """Compute element-wise logical and of data. Parameters ---------- lhs : tvm.Tensor or Expr The left operand rhs : tvm.Tensor or Expr The right operand Returns ------- ret : tvm.Tensor or Expr Returns Expr if both operands are Expr. Otherwise returns Tensor. """ return _cpp.logical_and(lhs, rhs) def logical_or(lhs, rhs): """Compute element-wise logical or of data. Parameters ---------- lhs : tvm.Tensor or Expr The left operand rhs : tvm.Tensor or Expr The right operand Returns ------- ret : tvm.Tensor or Expr Returns Expr if both operands are Expr. Otherwise returns Tensor. """ return _cpp.logical_or(lhs, rhs) def logical_not(data): """Compute element-wise logical not of data. Parameters ---------- data : tvm.Tensor or Expr Returns ------- ret : tvm.Tensor or Expr Returns Expr if the operand are Expr. Otherwise returns Tensor. """ return _cpp.logical_not(data)