mindspore 2.0.0a0__cp37-none-any.whl → 2.0.0rc1__cp37-none-any.whl

mindspore/ops/operations/math_ops.py

@@ -20,23 +20,23 @@ from __future__ import division
 import numpy as np
 
 from mindspore import context
+from mindspore import log as logger
 from mindspore.ops import signature as sig
-from mindspore._checkparam import Validator as validator
-from mindspore._checkparam import Rel
+from mindspore import _checkparam as validator
 from mindspore.common import dtype as mstype
 from mindspore.common.tensor import Tensor
 from mindspore.common._decorator import deprecated
 from mindspore.ops._utils import get_broadcast_shape
 from mindspore.ops.primitive import Primitive, PrimitiveWithInfer, PrimitiveWithCheck, prim_attr_register, _run_op
 from mindspore._c_expression import Tensor as Tensor_
-from mindspore.ops._utils import is_shape_unknown
+from mindspore.common._utils import is_shape_unknown
 
 
 def _infer_shape_reduce(x, axis, keep_dims, prim_name):
     """Common infer for reduce operator"""
 
     def reduce_one_axis(one_axis):
-        validator.check_int_range(one_axis, -dim, dim, Rel.INC_LEFT, 'axis', prim_name)
+        validator.check_int_range(one_axis, -dim, dim, validator.INC_LEFT, 'axis', prim_name)
         if one_axis < 0:
             one_axis += dim
         axis_reduce.add(one_axis)
@@ -260,6 +260,7 @@ class Addcdiv(Primitive):
 
     Raises:
         TypeError: If dtype of `x1`, `x2`, `value`, `input_data` is not tensor.
+        TypeError: If dtype of `x1`, `x2`, `value`, `input_data` are not the same.
         ValueError: If `x1` could not be broadcast to `x2`.
         ValueError: If `value` could not be broadcast to `x1/x2`.
         ValueError: If `input_data` could not be broadcast to `value*(x1/x2)`.
@@ -303,9 +304,7 @@ class Addcmul(Primitive):
 
     Raises:
         TypeError: If dtype of `x1`, `x2`, `value`, `input_data` is not tensor.
-        TypeError: If dtype of `input_data` is not one of: float32, float16, int32.
-        TypeError: If dtype of `x1` or `x2` is not one of: float32, float16, int32.
-        TypeError: If dtype of `value` is not one of: float32, float16, int32.
+        TypeError: If dtype of `x1`, `x2`, `value`, `input_data` are not the same.
         ValueError: If `x1` could not be broadcast to `x2`.
         ValueError: If `value` could not be broadcast to `x1` * `x2`.
         ValueError: If `input_data` could not be broadcast to `value*(x1*x2)`.
@@ -338,8 +337,9 @@ class AddV2(Primitive):
 
     Inputs of `x` and `y` comply with the implicit type conversion rules to make the data types consistent.
     The inputs must be two tensors or one tensor and one scalar.
-    When the inputs are two tensors, the shapes of them should be the same.
+    When the inputs are two tensors, and the shapes of them can be broadcast.
     When the inputs are one tensor and one scalar, the scalar could only be a constant.
+    CPU/Ascend does not support broadcast for now.
 
     .. math::
 
@@ -358,14 +358,14 @@ class AddV2(Primitive):
         and the data type is the one with higher precision or higher digits among the two inputs.
 
     Raises:
-        TypeError: If neither `x` nor `y` is a Tensor .
+        TypeError: If neither `x` nor `y` is a Tensor.
         TypeError: If dtype of `x` or `y` is not in [float16, float32, float64,
         uint8, int8, int16, int32, int64, complex64, complex128].
-        ValueError: If the shape of 'x' and 'y' is not the same.
+        ValueError: If the shape of 'x' and 'y' is not the same for CPU and Ascend.
 
 
     Supported Platforms:
-        ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> from mindspore.ops.operations.math_ops import AddV2
@@ -488,7 +488,7 @@ class _Reduce(PrimitiveWithCheck):
     Definition of base class of reduction class operators.
 
     Args:
-         keep_dims (bool, optional): If true, keep these reduced dimensions and the length is 1.
+         keep_dims (bool): If true, keep these reduced dimensions and the length is 1.
                            If false, don't keep these dimensions. Default: False.
     """
 
@@ -538,18 +538,17 @@ class _Reduce(PrimitiveWithCheck):
 
 class EuclideanNorm(Primitive):
     """
-    Computes the euclidean norm of elements across dimensions of a tensor.
-    Reduces input along the dimensions given in axis.
+    Calculates the Euclidean norm(aka L2 norm) of a Tensor along the specified axes.
+    The specified `axes` are removed by default.
 
     Args:
-        keep_dims (bool, optional): If true, the reduceed dimensions are retained with length 1.
-                          If false, don't keep these dimensions. Default: False.
+        keep_dims (bool, optional): whether to retain the reduced dimensions. If true, retains them with length 1.
+            If false, these dimensions are removed. Default: False.
 
     Inputs:
-        - **x** (Tensor) - The input tensor. Must be one of the following types :float16, float32, float64, int8, int16,
-          int32, int64, complex64, complex128, uint8, uint16, uint32, uint64. The tensor to reduce.
-        - **axes** (Tensor) - The dimensions to reduce. Must be one of the following types: int32, int64.
-          Must be in the range [-rank(x), rank(x)).
+        - **x** (Tensor) - The input Tensor to reduce.
+        - **axes** (Tensor) - The axes to perform reduction on. Must be one of the following types: int32, int64.
+          It must be in range :math:`[-rank(x), rank(x))`.
 
     Outputs:
         Tensor, has the same type as the 'x'.
@@ -590,7 +589,7 @@ class ReduceMean(_Reduce):
 
     Inputs:
         - **x** (Tensor[Number]) - The input tensor. The dtype of the tensor to be reduced is number.
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions, its rank should be less than 8.
+          :math:`(N, *)` where :math:`*` means, any number of additional dimensions, its rank should be less than 8.
         - **axis** (Union[int, tuple(int), list(int)]) - The dimensions to reduce. Default: (), reduce all dimensions.
           Only constant value is allowed. Must be in the range [-r, r).
 
@@ -664,30 +663,24 @@ class ReduceMean(_Reduce):
 
 class CumulativeLogsumexp(Primitive):
     """
-    Compute the cumulative log-sum-exp of the tensor `x` along `axis` .
-
-    When `exclusive` is set `False`, this operation performs an inclusive cumulative log-sum-exp, which means that the
-    first element of the input is identical to the first element of the output. For example, when takes a tensor
-    [a, b, c] as input, this operation outputs [a, log(exp(a) + exp(b)), log(exp(a) + exp(b) + exp(c))]. When `reverse`
-    is set `True`, the cumulative log-sum-exp is performed in the opposite direction and thus get the output
-    [log(exp(a) + exp(b) + exp(c)), log(exp(b) + exp(c)), c].
-
-    When `exclusive` is set `True`, this operation performs an exclusive cumulative log-sum-exp instead. For example,
-    when takes a tensor [a, b, c] as input, this operation outputs [-inf, a, log(exp(a) * exp(b))]. Note that the
-    neutral element of the log-sum-exp operation is -inf, however, for performance reasons, the minimal value
-    representable by the floating point type is used instead. When `reverse` is set `True`, the cumulative log-sum-exp
-    is performed in the opposite direction and thus get the output [log(exp(b) * exp(c)), c, -inf].
+    Compute the cumulative log-sum-exp of the input tensor `x` along `axis` . For example, with all parameters at
+    default values, if the input `x` is a tensor [a, b, c], the output will be [a, log(exp(a) + exp(b)),
+    log(exp(a) + exp(b) + exp(c))].
 
     Args:
-        exclusive (bool, optional): If true, perform exclusive cumulative log-sum-exp.
-                                    If false, perform inclusive cumulative log-sum-exp. Default: False.
-        reverse (bool, optional): If true, the cumulative log-sum-exp is performed in the opposite direction.
-                                  If false, the cumulative log-sum-exp is performed in the forward direction.
-                                  Default: False.
+        exclusive (bool, optional): If true, the last element will be skipped during the calculation and thus an
+                                    exclusive cumulative log-sum-exp will be performed. For example, this operation
+                                    will output [-inf, a, log(exp(a) * exp(b))] with tensor [a, b, c] as the input.
+                                    Note that the minimal value -inf, for performance reasons, is representable by the
+                                    floating point type. Default: False.
+        reverse (bool, optional): If true, the function accumulation values will be calculated after the elements of
+                                  `x` on `axis` are flipped, and the calculation result will be flipped afterwards. For
+                                  example, this operation will output [log(exp(c) + exp(b) + exp(a)), log(exp(c) +
+                                  exp(b)), c] with tensor [a, b, c] as the input. Default: False.
 
     Inputs:
-        - **x** (Tensor) - The input tensor. Must be one of the following types: float16, float32, float64.
-          The dimension of `x` must greater than 0.
+        - **x** (Tensor) - The input tensor. Must be one of the following types: float16, float32, float64. The
+          dimension of `x` must greater than 0.
         - **axis** (Tensor) - A 0-D tensor describing the dimension to compute the cumulative product. Must be one of
           the following types: int64, int32, int16. Must be in the range [-rank(x), rank(x)). Default: 0.
 
@@ -703,7 +696,7 @@ class CumulativeLogsumexp(Primitive):
         RuntimeError: If `axis` is out of range [-rank(x), rank(x)).
 
     Supported Platforms:
-        ``Ascend`` ``CPU``
+        ``Ascend`` ``CPU`` ``GPU``
 
     Examples:
         >>> x = Tensor(np.array([1.0, 2.0, 3.0]).astype(np.float32))
@@ -752,7 +745,7 @@ class ReduceSum(PrimitiveWithCheck):
 
     Inputs:
          - **x** (Tensor[Number]) - The input tensor. The dtype of the tensor to be reduced is number.
-           :math:`(N,*)` where :math:`*` means, any number of additional dimensions, its rank should be less than 8.
+           :math:`(N, *)` where :math:`*` means, any number of additional dimensions, its rank should be less than 8.
          - **axis** (Union[int, tuple(int), list(int)]) - The dimensions to reduce. Default: (), reduce all dimensions
            when skip_mode is false. Only constant value is allowed. Must be in the range [-rank(`x`), rank(`x`)).
 
@@ -979,7 +972,7 @@ class ReduceMax(_Reduce):
 
     Inputs:
          - **x** (Tensor[Number]) - The input tensor. The dtype of the tensor to be reduced is number.
-           :math:`(N,*)` where :math:`*` means, any number of additional dimensions, its rank should be less than 8.
+           :math:`(N, *)` where :math:`*` means, any number of additional dimensions, its rank should be less than 8.
          - **axis** (Union[int, tuple(int), list(int)]) - The dimensions to reduce. Default: (), reduce all dimensions.
            Only constant value is allowed. Must be in the range [-r, r).
 
@@ -1063,7 +1056,7 @@ class ReduceMin(_Reduce):
 
     Inputs:
         - **x** (Tensor[Number]) - The input tensor. The dtype of the tensor to be reduced is number.
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions, its rank should be less than 8.
+          :math:`(N, *)` where :math:`*` means, any number of additional dimensions, its rank should be less than 8.
         - **axis** (Union[int, tuple(int), list(int)]) - The dimensions to reduce. Default: (), reduce all dimensions.
           Only constant value is allowed. Must be in the range [-r, r).
 
@@ -1131,7 +1124,7 @@ class ReduceMin(_Reduce):
 
 class Bucketize(Primitive):
     """
-    Bucketizes 'input' based on 'boundaries'.
+    Bucketizes `input` based on `boundaries`.
 
     Args:
         boundaries (list[float]): A sorted list of floats gives the boundary of the buckets, and no default value.
@@ -1147,7 +1140,7 @@ class Bucketize(Primitive):
         TypeError: If `input` is not a Tensor.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> class Bucketize(nn.Cell):
@@ -1186,7 +1179,7 @@ class ReduceProd(_Reduce):
 
     Inputs:
         - **x** (Tensor[Number]) - The input tensor. The dtype of the tensor to be reduced is number.
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions, its rank should be less than 8.
+          :math:`(N, *)` where :math:`*` means, any number of additional dimensions, its rank should be less than 8.
         - **axis** (Union[int, tuple(int), list(int)]) - The dimensions to reduce. Default: (), reduce all dimensions.
           Only constant value is allowed. Must be in the range [-r, r).
 
@@ -1331,7 +1324,10 @@ class Lcm(Primitive):
     """
     Computes least common multiplier of input tensors element-wise.
     The shape of two inputs should be broadcastable, and data type of them should be
-    one of: int32, int64
+    one of: int32, int64.
+
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
     Inputs:
         - **x1** (Tensor) - The first input tensor.
@@ -1346,7 +1342,7 @@ class Lcm(Primitive):
         ValueError: If shape of two inputs are not broadcastable.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x1 = Tensor(np.array([7, 8, 9]))
@@ -1402,7 +1398,29 @@ class LpNorm(Primitive):
     .. math::
         output = sum(abs(input)**p)**(1/p)
 
-    Refer to :func:`mindspore.ops.norm` for more details.
+    Args:
+        axis(int,list,tuple): Specifies which dimension or dimensions of input to calculate the norm across.
+        p(int, optional): The order of norm. Default: 2.
+        keep_dims(bool, optional): Whether the output tensors have dim retained or not. Default: False.
+        epsilon(float, optional): A value added to the denominator for numerical stability. Default: 1e-12.
+
+    Inputs:
+        - **input** (Tensor) - Input tensor.
+
+    Outputs:
+        Tensor, has the same dtype as `input`, its shape depends on `axis`. For example, if the shape of input
+        is :math:`(2, 3, 4)`, `axis` is :math:`[0, 1]`, output shape will be :math:`(4,)`.
+
+    Raises:
+        TypeError: If `input` is not a Tensor.
+        TypeError: If dtype of `input` is not one of: float16, float32.
+        TypeError: If `p` is not an int.
+        TypeError: If `axis` is not an int, a tuple or a list.
+        TypeError: If `axis` is a tuple or a list, but the element of `axis` is not an int.
+        TypeError: If `keep_dims` is not a bool.
+        ValueError: If the element of `axis` is out of the range :math:`[-r, r)`,
+            where :math:`r` is the rank of `input`.
+        ValueError: If the length of shape of `axis` is bigger than the length of shape of `input`.
 
     Supported Platforms:
         ``Ascend`` ``GPU`` ``CPU``
@@ -1452,9 +1470,9 @@ class MatMul(PrimitiveWithCheck):
 
     Inputs:
         - **a** (Tensor) - The first tensor to be multiplied. The shape of the tensor is :math:`(N, C)`. If
-          `transpose_a` is True, its shape must be :math:`(N, C)` after transpose.
+          `transpose_a` is True, its shape must be :math:`(C, N)` after transpose.
         - **b** (Tensor) - The second tensor to be multiplied. The shape of the tensor is :math:`(C, M)`. If
-          `transpose_b` is True, its shape must be :math:`(C, M)` after transpose.
+          `transpose_b` is True, its shape must be :math:`(M, C)` after transpose.
 
     Outputs:
         Tensor, the shape of the output tensor is :math:`(N, M)`.
@@ -1561,28 +1579,14 @@ class BatchMatMul(Primitive):
         >>> y = Tensor(np.ones(shape=[2, 4, 3, 4]), mindspore.float32)
         >>> batmatmul = ops.BatchMatMul()
         >>> output = batmatmul(x, y)
-        >>> print(output)
-        [[[[3. 3. 3. 3.]]
-          [[3. 3. 3. 3.]]
-          [[3. 3. 3. 3.]]
-          [[3. 3. 3. 3.]]]
-         [[[3. 3. 3. 3.]]
-          [[3. 3. 3. 3.]]
-          [[3. 3. 3. 3.]]
-          [[3. 3. 3. 3.]]]]
+        >>> print(output.shape)
+        (2, 4, 1, 4)
         >>> x = Tensor(np.ones(shape=[2, 4, 3, 1]), mindspore.float32)
         >>> y = Tensor(np.ones(shape=[2, 4, 3, 4]), mindspore.float32)
         >>> batmatmul = ops.BatchMatMul(transpose_a=True)
         >>> output = batmatmul(x, y)
-        >>> print(output)
-        [[[[3. 3. 3. 3.]]
-          [[3. 3. 3. 3.]]
-          [[3. 3. 3. 3.]]
-          [[3. 3. 3. 3.]]]
-         [[[3. 3. 3. 3.]]
-          [[3. 3. 3. 3.]]
-          [[3. 3. 3. 3.]]
-          [[3. 3. 3. 3.]]]]
+        >>> print(output.shape)
+        (2, 4, 1, 4)
     """
 
     @prim_attr_register
@@ -1598,10 +1602,9 @@ class BatchMatMul(Primitive):
 
 class Betainc(Primitive):
     r"""
-    Computes the regularized incomplete beta integral
-    :math:`I_{x}(a, b)`.
-
-    The regularized incomplete beta integral is defined as:
+    Calculates the regularized incomplete beta function
+    :math:`I_{x}(a, b)`. It is defined as the ratio of the incomplete beta function
+    to the complete beta function:
 
     .. math::
 
@@ -1611,14 +1614,23 @@ class Betainc(Primitive):
 
     .. math::
 
-        B(x ; a, b)=\int_{0}^{x} t^{a-1}(1-t)^{b-1} d t
+        B(x ; a, b)=\int_{0}^{x} t^{a-1}(1-t)^{b-1} dt
+
+    is the incomplete beta function and
+
+    .. math::
+
+        B(a, b) = \int_0^1 t^{a-1} (1-t)^{b-1} dt
 
-    is the incomplete beta function and B(a, b) is the complete beta function
+    is the complete beta function.
 
     Inputs:
-        - **a** (Tensor) - A Tensor of types: float32, float64.
-        - **b** (Tensor) - A Tensor, must have the same dtype and shape as `a` .
-        - **x** (Tensor) - A Tensor, must have the same dtype and shape as `a` .
+        - **a** (Tensor) - Peak location of beta distribution.
+          A Tensor of types: float32, float64.
+        - **b** (Tensor) - Spread of the beta distribution.
+          A Tensor, must have the same dtype and shape as `a` .
+        - **x** (Tensor) - Upper limit of integration of the incomplete beta function.
+          A Tensor, must have the same dtype and shape as `a` .
 
     Outputs:
         A Tensor, has the same dtype and shape as `a` .
@@ -1633,12 +1645,12 @@ class Betainc(Primitive):
         ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
-        >>> a = Tensor(np.array([1, 1, 1]), mindspore.float32)
-        >>> b = Tensor(np.array([1, 1, 1]), mindspore.float32)
-        >>> x = Tensor(np.array([1, 1,1 ]), mindspore.float32)
+        >>> a = Tensor(np.array([0.3, 0.1, 0.4]), mindspore.float32)
+        >>> b = Tensor(np.array([0.4, 0.5, 0.9]), mindspore.float32)
+        >>> x = Tensor(np.array([0.2, 0.6, 0.5]), mindspore.float32)
         >>> betainc = ops.Betainc()
         >>> print(betainc(a, b, x))
-        [1. 1. 1.]
+        [0.41462693 0.8706035  0.7298298 ]
     """
 
     @prim_attr_register
@@ -1768,7 +1780,7 @@ class AccumulateNV2(Primitive):
     Refer to :func:`mindspore.ops.accumulate_n` for more details.
 
     Supported Platforms:
-        ``Ascend``
+        ``Ascend`` ``GPU``
 
     Examples:
         >>> class NetAccumulateNV2(nn.Cell):
@@ -1828,37 +1840,25 @@ class Neg(Primitive):
 
 class InplaceUpdateV2(Primitive):
     r"""
-    Updates specified rows with values in `v`.
-
-    Note:
-        This operator only supports dynamic shape. As for static shape, please use operator 'InplaceUpdate' instead.
+    Updates specified values in `x` to `v` according to `indices`.
 
-    Args:
-
-    Inputs:
-        - **x** (Tensor) - A tensor which to be inplace updated. It can be one of the following data types:
-          float32, float16 and int32.
-        - **indices** (Union[int, tuple]): Indices into the left-most dimension of `x`, and determines which rows of x
-            to update with v. It is an int or tuple, whose value is in [0, the first dimension size of x).
-        - **v** (Tensor) - A tensor with the same type as `x` and the same dimension size as `x` except
-          the first dimension, which must be the same as the size of `indices`.
-
-    Outputs:
-        Tensor, with the same type and shape as the input `x`.
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
-    Raises:
-        TypeError: If `indices` is neither int nor tuple.
-        TypeError: If `indices` is a tuple and its element is not an int.
+    Refer to :func:`mindspore.ops.inplace_update` for more details.
 
     Supported Platforms:
-        ``Ascend``
+        ``GPU`` ``CPU``
 
     Examples:
+        >>> import numpy as np
+        >>> import mindspore
+        >>> from mindspore import Tensor, ops
         >>> indices = (0, 1)
         >>> x = Tensor(np.array([[1, 2], [3, 4], [5, 6]]), mindspore.float32)
         >>> v = Tensor(np.array([[0.5, 1.0], [1.0, 1.5]]), mindspore.float32)
-        >>> inplace_update = ops.InplaceUpdate(indices)
-        >>> output = inplace_update(x, v)
+        >>> inplace_update_v2 = ops.InplaceUpdateV2()
+        >>> output = inplace_update_v2(x, indices, v)
         >>> print(output)
         [[0.5 1. ]
          [1.  1.5]
@@ -1876,42 +1876,15 @@ class InplaceUpdateV2(Primitive):
         return output
 
 
-class InplaceUpdate(PrimitiveWithInfer):
+class InplaceUpdate(Primitive):
     r"""
-    Updates specified rows with values in `v`.
-
-    Args:
-        indices (Union[int, tuple]): Indices into the left-most dimension of `x`, and determines which rows of x
-            to update with v. It is an int or tuple, whose value is in [0, the first dimension size of x).
-
-    Inputs:
-        - **x** (Tensor) - A tensor which to be inplace updated. It can be one of the following data types:
-          float32, float16 and int32.
-        - **v** (Tensor) - A tensor with the same type as `x` and the same dimension size as `x` except
-          the first dimension, which must be the same as the size of `indices`.
-
-    Outputs:
-        Tensor, with the same type and shape as the input `x`.
-
-    Raises:
-        TypeError: If `indices` is neither int nor tuple.
-        TypeError: If `indices` is a tuple and its element is not an int.
+    The InplaceUpdate interface is deprecated. Please use the :class:`mindspore.ops.InplaceUpdateV2` instead.
 
     Supported Platforms:
-        ``Ascend`` ``GPU`` ``CPU``
-
-    Examples:
-        >>> indices = (0, 1)
-        >>> x = Tensor(np.array([[1, 2], [3, 4], [5, 6]]), mindspore.float32)
-        >>> v = Tensor(np.array([[0.5, 1.0], [1.0, 1.5]]), mindspore.float32)
-        >>> inplace_update = ops.InplaceUpdate(indices)
-        >>> output = inplace_update(x, v)
-        >>> print(output)
-        [[0.5 1. ]
-         [1.  1.5]
-         [5.  6. ]]
+        Deprecated
     """
 
+    @deprecated("2.0", "ops.InplaceUpdateV2", False)
     @prim_attr_register
     def __init__(self, indices):
         """Initialize InplaceUpdate"""
@@ -1924,14 +1897,14 @@ class InplaceUpdate(PrimitiveWithInfer):
             validator.check_value_type("item of indices", item, [int], self.name)
 
 
-class InplaceAdd(PrimitiveWithInfer):
+class InplaceAdd(Primitive):
     """
     Adds `v` into specified rows of `x`. Computes `y` = `x`; y[i,] += `v`.
 
     Refer to :func:`mindspore.ops.inplace_add` for more details.
 
     Supported Platforms:
-        ``Ascend`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> import numpy as np
@@ -1959,39 +1932,21 @@ class InplaceAdd(PrimitiveWithInfer):
         for item in self.indices:
             validator.check_value_type("item of indices", item, [int], self.name)
 
-    def infer_dtype(self, x_dtype, v_dtype):
-        args = {'x': x_dtype, 'v': v_dtype}
-        valid_type = [mstype.int32, mstype.float16, mstype.float32]
-        validator.check_tensors_dtypes_same_and_valid(args, valid_type, self.name)
-        return x_dtype
-
-    def infer_shape(self, x_shape, v_shape):
-        validator.check("x", len(x_shape), "v", len(v_shape), Rel.EQ, self.name)
-        validator.check("size of indices", len(self.indices), "v's first dimension", v_shape[0],
-                        Rel.EQ, self.name)
-        for i in self.indices:
-            if i < 0 or i >= x_shape[0]:
-                raise ValueError(f"For '{self.name}', the value of 'indices' must be "
-                                 f"in [0, {x_shape[0]}), but got {i}.")
-        x_rank = len(x_shape)
-        for idx in range(x_rank)[1:]:
-            validator.check('v dim %d' % idx, v_shape[idx], "x dim %d" % idx, x_shape[idx], Rel.EQ, self.name)
-
-        return x_shape
-
 
 class InplaceIndexAdd(Primitive):
     """
-    Adds tensor `updates` to specified axis and indices of tensor `var`. The axis should be in [0,  len(var.dim) - 1],
-    and indices should be in [0, the size of `var` - 1] at the axis dimension.
+    Adds Tensor `updates` to specified axis and indices of Tensor `var` element-wise.
+
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
     Refer to :func:`mindspore.ops.inplace_index_add` for more details.
 
     Supported Platforms:
-        ``CPU``
+        ``Ascend`` ``CPU``
 
     Examples:
-        >>> var = Parameter(np.array([[1, 2], [3, 4], [5, 6]]), mindspore.float32)
+        >>> var = Parameter(Tensor(np.array([[1, 2], [3, 4], [5, 6]]), mindspore.float32))
         >>> indices = Tensor(np.array([0, 1]), mindspore.int32)
         >>> updates = Tensor(np.array([[0.5, 1.0], [1.0, 1.5]]), mindspore.float32)
         >>> inplaceIndexAdd = ops.InplaceIndexAdd(axis=0)
@@ -2016,14 +1971,14 @@ class InplaceIndexAdd(Primitive):
         validator.check_value_type('axis', axis, [int], self.name)
 
 
-class InplaceSub(PrimitiveWithInfer):
+class InplaceSub(Primitive):
     r"""
     Subtracts `v` into specified rows of `x`. Computes :math:`y = x`; :math:`y[i,] -= input\_v`.
 
     Refer to :func:`mindspore.ops.inplace_sub` for more details.
 
     Supported Platforms:
-        ``Ascend`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> import numpy as np
@@ -2052,26 +2007,6 @@ class InplaceSub(PrimitiveWithInfer):
             validator.check_value_type("item of indices", item, [int], self.name)
         self.add_prim_attr("indices", self.indices)
 
-    def infer_dtype(self, x_dtype, v_dtype):
-        args = {'x': x_dtype, 'v': v_dtype}
-        valid_type = [mstype.int32, mstype.float16, mstype.float32]
-        validator.check_tensors_dtypes_same_and_valid(args, valid_type, self.name)
-        return x_dtype
-
-    def infer_shape(self, x_shape, v_shape):
-        validator.check("x", len(x_shape), "v", len(v_shape), Rel.EQ, self.name)
-        validator.check("size of indices", len(self.indices), "v's first dimension", v_shape[0],
-                        Rel.EQ, self.name)
-        for i in self.indices:
-            if i < 0 or i >= x_shape[0]:
-                raise ValueError(f"For '{self.name}', the value of 'indices' must be "
-                                 f"in [0, {x_shape[0]}), but got {i}.")
-        x_rank = len(x_shape)
-        for idx in range(x_rank)[1:]:
-            validator.check('v dim %d' % idx, v_shape[idx], "x dim %d" % idx, x_shape[idx], Rel.EQ, self.name)
-
-        return x_shape
-
 
 class Sub(_MathBinaryOp):
     r"""
@@ -2119,6 +2054,17 @@ class Mul(_MathBinaryOp):
         [ 4. 10. 18.]
     """
 
+    # Let x/y using same sig_dtype to enable implicit conversion for compatibility
+    __mindspore_signature__ = (
+        sig.make_sig('x', rw=sig.sig_rw.RW_READ, dtype=sig.sig_dtype.T),
+        sig.make_sig('y', rw=sig.sig_rw.RW_READ, dtype=sig.sig_dtype.T)
+    )
+
+    @prim_attr_register
+    def __init__(self):
+        """Initialize Xdivy."""
+        self.init_prim_io_names(inputs=['x', 'y'], outputs=['output'])
+
     @staticmethod
     def _infer_specified_mul_value(x, y):
         """Calculate min/max value for output of Mul op"""
@@ -2285,7 +2231,8 @@ class Sqrt(Primitive):
         out_{i} =  \sqrt{x_{i}}
 
     Inputs:
-        - **x** (Tensor) - The input tensor with a dtype of Number, its rank must be in [0, 7] inclusive.
+        - **x** (Tensor) - The input tensor with a dtype of Number, the shape is :math:`(N, *)`
+          where :math:`*` means, any number of additional dimensions.
 
     Outputs:
         Tensor, has the same shape and data type as the `x`.
@@ -2429,21 +2376,22 @@ class Logit(Primitive):
     r"""
     Calculate the logit of a tensor element-wise. Element in `x` is clamped to [eps, 1-eps].
 
-    .. math::
-        \begin{align}
-        y_{i} & = \ln(\frac{z_{i}}{1 - z_{i}}) \\
-        z_{i} & = \begin{cases}
-        x_{i} & \text{if eps is None} \\
-        \text{eps} & \text{if } x_{i} \lt \text{eps} \\
-        x_{i} & \text{if } \text{eps} \leq x_{i} \leq 1 - \text{eps} \\
-        1 - \text{eps} & \text{if } x_{i} \gt 1 - \text{eps}
-        \end{cases}
-        \end{align}
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
     Refer to :func:`mindspore.ops.logit` for more details.
 
+    Args:
+        eps (float, optional): The epsilon. The input clamp bound is defined as [eps, 1-eps]. Default: -1.0.
+
+    Inputs:
+        - **x** (Tensor) - The input tensor.
+
+    Outputs:
+        Tensor, with the same shape and dtype as the `x`.
+
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([0.1, 0.2, 0.3]).astype(np.float32))
@@ -2463,10 +2411,33 @@ class Logit(Primitive):
 
 class ReduceStd(Primitive):
     """
-    Returns the standard-deviation and mean of each row of the input tensor in the dimension `axis`.
-    If `axis` is a list of dimensions, reduce over all of them.
+    Returns the standard-deviation and mean of the input Tensor along
+    dimension(s) specified by `axis`.
+
+    Args:
+        axis (Union[int, tuple(int), list(int)], optional): The dimensions to reduce.
+            Default: (), reduce all dimensions. Only constant value is allowed.
+            Let `r` be rank of `input_x`, it should be in the range :math:`[-r,r)`.
+        unbiased (bool, optional):  Whether to use Bessel’s correction.
+            If True, will use the Bessel correction unbiased estimation.
+            If False, will through the biased estimation to calculate the standard deviation.
+            Default: True.
+        keep_dims (bool, optional): Whether the output Tensor has dim retained or not.
+            If True, keep these reduced dimensions specified by `axis` and the length is 1.
+            If False, don't keep these dimensions.
+            Default: Fasle.
 
-    Refer to :func:`mindspore.ops.std` for more details.
+    Inputs:
+        - **input_x** (Tensor[Number]) - The input Tensor, it has dtype Number with shape
+          :math:`(N, *)` where :math:`*` means any number of additional dimensions.
+
+    Outputs:
+        Tuple(output_std, output_mean) containing the standard deviation and mean.
+
+    Raises:
+        TypeError: If `keep_dims` is not a bool.
+        TypeError: If `input_x` is not a Tensor.
+        ValueError: If `axis` is not one of the following: int, tuple or list.
 
     Supported Platforms:
         ``Ascend`` ``CPU``
@@ -2685,7 +2656,7 @@ class Expm1(Primitive):
 
 class Histogram(Primitive):
     """
-    Computes the histogram of a tensor.
+    Computes the histogram of Tensor element distribution.
 
     The elements are sorted into equal width bins between `min` and `max`.
     If `min` and `max` are both zero, the minimum and maximum values of the data are used.
@@ -2693,12 +2664,12 @@ class Histogram(Primitive):
     Elements lower than min and higher than max are ignored.
 
     Args:
-        bins (int, optional) : Number of histogram bins, optional. Default 100. If specified, must be positive.
+        bins (int, optional): Number of histogram bins, optional. Default 100. If specified, must be positive.
         min (float, optional): An optional float of the lower end of the range (inclusive). Default value is 0.0.
         max (float, optional): An optional float of the upper end of the range (inclusive). Default value is 0.0.
 
     Inputs:
-        - **x** (Tensor) - the input tensor, type support list [float16, float32, int32]
+        - **x** (Tensor) - the input tensor, type support list: [float16, float32, int32].
 
     Outputs:
         Tensor, 1-D Tensor with type int32.
@@ -2712,7 +2683,7 @@ class Histogram(Primitive):
         ValueError: If attr `bins` <= 0.
 
     Supported Platforms:
-        ``CPU``
+        ``Ascend`` ``CPU``
 
     Examples:
         >>> x = Tensor([1., 2, 1])
@@ -2730,7 +2701,7 @@ class Histogram(Primitive):
         validator.check_value_type("min", min, [float], self.name)
         validator.check_value_type("max", max, [float], self.name)
         validator.check_positive_int(bins, 'bins', self.name)
-        validator.check('min', min, 'max', max, Rel.LE, self.name)
+        validator.check('min', min, 'max', max, validator.LE, self.name)
 
 
 class HistogramFixedWidth(PrimitiveWithInfer):
@@ -2744,7 +2715,7 @@ class HistogramFixedWidth(PrimitiveWithInfer):
 
     Inputs:
         - **x** (Tensor) - Numeric Tensor. Must be one of the following types: int32, float32, float16.
-        - **range** (Tensor) - Must have the same data type as `x`, and the shape is (2,).
+        - **range** (Tensor) - Must have the same data type as `x`, and the shape is :math:`(2,)`.
           x <= range[0] will be mapped to histogram[0], x >= range[1] will be mapped to histogram[-1].
 
     Outputs:
@@ -2771,7 +2742,7 @@ class HistogramFixedWidth(PrimitiveWithInfer):
     def __init__(self, nbins, dtype='int32'):
         """Initialize HistogramFixedWidth."""
         self.nbins = validator.check_value_type("nbins", nbins, [int], self.name)
-        validator.check_int(nbins, 1, Rel.GE, "nbins", self.name)
+        validator.check_int(nbins, 1, validator.GE, "nbins", self.name)
         valid_values = ['int32']
         self.dtype = validator.check_string(dtype, valid_values, "dtype", self.name)
         self.init_prim_io_names(inputs=['x', 'range'], outputs=['y'])
@@ -2832,7 +2803,10 @@ class Hypot(Primitive):
     """
     Computes hypotenuse of input tensors element-wise as legs of a right triangle.
     The shape of two inputs should be broadcastable, and data type of them should be
-    one of: float32, float64
+    one of: float32, float64.
+
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
     Inputs:
         - **x1** (Tensor) - The first input tensor.
@@ -2847,7 +2821,7 @@ class Hypot(Primitive):
         ValueError: If shape of two inputs are not broadcastable.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x1 = Tensor(np.array([3., 5., 7.]))
@@ -2867,7 +2841,7 @@ class Hypot(Primitive):
 
 class Heaviside(Primitive):
     r"""
-    Computes the Heaviside step function for each element in input.
+    Applies the Heaviside step function for input `x` element-wise.
 
     .. math::
             \text { heaviside }(\text { x, values })=\left\{\begin{array}{ll}
@@ -2876,14 +2850,16 @@ class Heaviside(Primitive):
             1, & \text { if x }>0
             \end{array}\right.
 
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
+
     Inputs:
         - **x** (Tensor) - The input tensor. With real number data type.
         - **values** (Tensor) - The values to use where `x` is zero.
-          Values can be broadcast with `x` . 'x' should have the same
-          dtype with 'values'.
+          It should be able to broadcast with `x` have the same dtype as `x`.
 
     Outputs:
-        Tensor, has the same type as 'x' and 'values'.
+        Tensor, has the same type as `x` and `values`.
 
     Raises:
         TypeError: If `x` or `values` is not Tensor.
@@ -2891,7 +2867,7 @@ class Heaviside(Primitive):
         ValueError: If shape of two inputs are not broadcastable.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([-1.5, 0., 2.]))
@@ -3020,6 +2996,16 @@ class RealDiv(_MathBinaryOp):
 
     Refer to :func:`mindspore.ops.div` for more details.
 
+    Inputs:
+        - **x** (Union[Tensor, Number, bool]) - The first input is a number or
+          a bool or a tensor whose data type is number or bool.
+        - **y** (Union[Tensor, Number, bool]) - The second input is a number or
+          a bool when the first input is a tensor or a tensor whose data type is number or bool.
+
+    Outputs:
+        Tensor, the shape is the same as the one after broadcasting,
+        and the data type is the one with higher precision or higher digits among the two inputs.
+
     Supported Platforms:
         ``Ascend`` ``GPU`` ``CPU``
 
@@ -3060,8 +3046,8 @@ class Div(_MathBinaryOp):
     Inputs:
         - **x** (Union[Tensor, number.Number, bool]) - The first input is a number.Number or
           a bool or a tensor whose data type is
-          `number <https://www.mindspore.cn/docs/en/r2.0.0-alpha/api_python/mindspore.html#mindspore.dtype>`_ or
-          `bool_ <https://www.mindspore.cn/docs/en/r2.0.0-alpha/api_python/mindspore.html#mindspore.dtype>`_.
+          `number <https://www.mindspore.cn/docs/en/r2.0/api_python/mindspore.html#mindspore.dtype>`_ or
+          `bool_ <https://www.mindspore.cn/docs/en/r2.0/api_python/mindspore.html#mindspore.dtype>`_.
         - **y** (Union[Tensor, number.Number, bool]) - The second input, when the first input is a Tensor,
           the second input should be a number.Number or bool value, or a Tensor whose data type is number or bool\_.
           When the first input is Scalar, the second input must be a Tensor whose data type is number or bool\_.
@@ -3152,8 +3138,9 @@ class DivNoNan(Primitive):
     Inputs:
         - **x1** (Union[Tensor, number.Number, bool]) - The first input is a number.Number or
           a bool or a tensor whose data type is
-          `number <https://www.mindspore.cn/docs/en/r2.0.0-alpha/api_python/mindspore.html#mindspore.dtype>`_ or
-          `bool_ <https://www.mindspore.cn/docs/zh-CN/r2.0.0-alpha/api_python/mindspore/mindspore.dtype.html#mindspore.dtype>`_.
+          `number <https://www.mindspore.cn/docs/en/r2.0/api_python/mindspore.html#mindspore.dtype>`_ or
+          `bool_ <https://www.mindspore.cn/docs/en/r2.0/api_python/mindspore.html#mindspore.dtype>`
+          _.
         - **x2** (Union[Tensor, number.Number, bool]) - The second input is a number.Number or
           a bool when the first input is a bool or a tensor whose data type is number or bool\_.
           When the first input is Scalar, the second input must be a Tensor whose data type is number or bool\_.
@@ -3281,8 +3268,8 @@ class FloorDiv(Primitive):
 
 class TruncateDiv(Primitive):
     """
-    Divides the first input tensor by the second input tensor element-wise for integer types, negative numbers will
-    round fractional quantities towards zero.
+    Divides the first input tensor by the second input tensor element-wise and rounds the results
+    of division towards zero. Equivalent to C-style integer division.
 
     Inputs of `x` and `y` comply with the implicit type conversion rules to make the data types consistent.
     The inputs must be two tensors or one tensor and one scalar.
@@ -3308,7 +3295,7 @@ class TruncateDiv(Primitive):
         TypeError: If `x` and `y` is not one of the following: Tensor, Number, bool.
 
     Supported Platforms:
-        ``Ascend``  ``CPU`` ``GPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([2, 4, -1]), mindspore.int32)
@@ -3343,7 +3330,7 @@ class TruncateMod(Primitive):
         - When the elements of input exceed 2048, the accuracy of operator cannot guarantee the requirement of
           double thousandths in the mini form.
         - Due to different architectures, the calculation results of this operator on NPU and CPU may be inconsistent.
-        - If shape is expressed as (D1,D2... ,Dn), then D1\*D2... \*DN<=1000000,n<=8.
+        - If shape is expressed as :math:`(D1, D2, ..., Dn)`, then :math:`D1*D2... *DN<=1000000,n<=8`.
 
     Inputs:
         - **x** (Union[Tensor, numbers.Number, bool]) - The first input is a number, or a bool,
@@ -3361,7 +3348,7 @@ class TruncateMod(Primitive):
         ValueError: If the shape `x` and `y` cannot be broadcasted to each other.
 
     Supported Platforms:
-        ``Ascend``  ``CPU`` ``GPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([2, 4, -1]), mindspore.int32)
@@ -3700,26 +3687,13 @@ class Sinc(Primitive):
     r"""
     Computes the normalized sinc of input.
 
-    Refer to :func:`mindspore.ops.sinc` for more details.
-
-    .. math::
-
-        y_i = \begin{cases}1 & \text{ if } x_i= 0\\ \frac{sin(\pi x_i)}{x_i} &
-        \text{ otherwise } \end{cases}
-
-    Inputs:
-        - **x** (Tensor) - The shape of tensor is :math:`(x_1, x_2, ..., x_R)`.
-
-    Outputs:
-        Tensor, has the same shape as the `x`. The dtype of output is float32 when dtype of `x` is in
-        [uint8, uint8, uint16, int16, uint32, int32, uint64, int64, bool]. Otherwise output has the
-        same dtype as the `x`.
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
-    Raises:
-        TypeError: If `x` is not a Tensor.
+    Refer to :func:`mindspore.ops.sinc` for more details.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> import mindspore
@@ -3776,6 +3750,42 @@ class _LogicBinaryOp(_BinaryOp):
         return _LogicBinaryOp.do_infer_dtype(x_dtype, y_dtype, prim_name=self.name)
 
 
+class Quantile(Primitive):
+    r"""
+    Computes the q-th quantiles of all elements in the input tensor, doing a linear interpolation when the
+    q-th quantile lies between two data points.
+
+    Refer to :func:`mindspore.ops.quantile` and :func:`mindspore.ops.nanquantile` for more details.
+
+    Supported Platforms:
+
+
+    Examples:
+        >>> quantile = ops.Quantile()
+        >>> input = Tensor(np.array([0.0700, -0.5446,  0.9214]), mindspore.float32)
+        >>> q = Tensor(np.array([0, 0.5, 1]), mindspore.float32)
+        >>> output = quantile(input, q)
+        >>> print(output)
+        [-0.5446  0.07  0.9214]
+    """
+
+    @prim_attr_register
+    def __init__(self, dim=None, keep_dims=False, ignore_nan=False):
+        """Initialize Quantile"""
+        if dim is not None:
+            validator.check_value_type("dim", dim, [int], self.name)
+        else:
+            self.add_prim_attr("dim", 10000)
+        if keep_dims is not None:
+            validator.check_value_type("keep_dims", keep_dims, [bool], self.name)
+        else:
+            self.add_prim_attr("keep_dims", False)
+        if ignore_nan is not None:
+            validator.check_value_type("ignore_nan", ignore_nan, [bool], self.name)
+        else:
+            self.add_prim_attr("ignore_nan", False)
+
+
 class Equal(Primitive):
     r"""
     Computes the equivalence between two tensors element-wise.
@@ -3869,12 +3879,12 @@ class EqualCount(PrimitiveWithInfer):
     Inputs:
         - **x** (Tensor) - The first input tensor. If the data type and shape of `y` are determined, then `x`
           must be the same as `y`, and vice versa.
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions.
+          :math:`(N, *)` where :math:`*` means, any number of additional dimensions.
         - **y** (Tensor) - The second input tensor. If the data type and shape of `x` are determined, then `y`
           must be the same as `x`, and vice versa.
 
     Outputs:
-        Tensor, with the type same as input tensor and shape as (1,).
+        Tensor, with the type same as input tensor and shape as :math:`(1,)`.
 
     Raises:
         TypeError: If `x` or `y` is not a Tensor.
@@ -3998,10 +4008,19 @@ class GreaterEqual(PrimitiveWithCheck):
 
 class Lerp(Primitive):
     """
-    Calculate the linear interpolation between two tensors based on the weight parameter.
+    Does a linear interpolation of two tensors start and end based on a float or tensor weight.
 
     Refer to :func:`mindspore.ops.lerp` for more details.
 
+    Inputs:
+        - **start** (Tensor) - The tensor with the starting points. Data type must be float16 or float32.
+        - **end** (Tensor) - The tensor with the ending points. Data type must be the same as `start`.
+        - **weight** (Union[float, Tensor]) - The weight for the interpolation formula. Must be a float
+          or a scalar tensor with float16 or float32 data type.
+
+    Outputs:
+        Tensor, has the same type and shape as input `start`.
+
     Supported Platforms:
         ``Ascend`` ``GPU`` ``CPU``
 
@@ -4016,7 +4035,6 @@ class Lerp(Primitive):
 
     @prim_attr_register
     def __init__(self):
-        super().__init__("Lerp")
         self.init_prim_io_names(inputs=['start', 'end', 'weight'], outputs=['output'])
 
 
@@ -4024,7 +4042,10 @@ class Gcd(Primitive):
     """
     Computes greatest common divisor of input tensors element-wise.
     The shape of two inputs should be broadcastable, and data type of them should be
-    one of: int32, int64
+    one of: int32, int64.
+
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
     Inputs:
         - **x1** (Tensor) - The first input tensor.
@@ -4032,14 +4053,14 @@ class Gcd(Primitive):
 
     Outputs:
         Tensor, the shape is the same as the one after broadcasting, and the data type is one
-        with higher digits in the two inputs.
+        with higher precision in the two inputs.
 
     Raises:
         TypeError: If data type `x1` or `x2` is not int32 or int64.
         ValueError: If shape of two inputs are not broadcastable.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x1 = Tensor(np.array([7, 8, 9]))
@@ -4186,24 +4207,13 @@ class LogicalXor(Primitive):
     r"""
     Computes the "logical XOR" of two tensors element-wise.
 
-    .. math::
-
-        out_{i} = x_{i} \oplus y_{i}
-
-    Inputs:
-        - **x** (Tensor) - The first input is a tensor whose data type is bool.
-        - **y** (Tensor) - The second input is a the tensor to compute XOR with the first input.
-          Datatype must be bool.
-
-    Outputs:
-        Tensor, the shape is the same as the one after broadcasting, and the data type is bool.
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
-    Raises:
-        TypeError: If neither `x` nor `y` is a Tensor whose data type is bool.
-        ValueError: If the shape of two inputs cannot be broadcast.
+    Refer to :func:`mindspore.ops.logical_xor` for more details.
 
     Supported Platforms:
-        ``CPU``
+        ``Ascend`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([True, False, True]), mindspore.bool_)
@@ -4295,10 +4305,10 @@ class FloatStatus(Primitive):
 
     Inputs:
         - **x** (Tensor) - The input tensor. The data type must be float16, float32 or float64.
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions.
+          :math:`(N, *)` where :math:`*` means, any number of additional dimensions.
 
     Outputs:
-        Tensor, has the shape of `(1,)`, and the dtype is `mindspore.dtype.float32`.
+        Tensor, has the shape of :math:`(1,)`, and the dtype is `mindspore.dtype.float32`.
 
     Raises:
         TypeError: If dtype of `x` is not in [float16, float32, float64].
@@ -4324,13 +4334,13 @@ class NPUAllocFloatStatus(Primitive):
     """
     Allocates a flag to store the overflow status.
 
-    The flag is a tensor whose shape is `(8,)` and data type is `mindspore.dtype.float32`.
+    The flag is a tensor whose shape is :math:`(8,)` and data type is `mindspore.dtype.float32`.
 
     Note:
         Please refer to the Examples of :class:`mindspore.ops.NPUGetFloatStatus`.
 
     Outputs:
-        Tensor, has the shape of `(8,)`.
+        Tensor, has the shape of :math:`(8,)`.
 
     Supported Platforms:
         ``Ascend``
@@ -4345,16 +4355,17 @@ class NPUAllocFloatStatus(Primitive):
     @prim_attr_register
     def __init__(self):
         """Initialize NPUAllocFloatStatus"""
+        logger.warning("The 'NPUAllocFloatStatus' operator will be deprecated in the future. Please don't use it.")
 
 
 class NPUGetFloatStatus(Primitive):
     """
-    :class:`mindspore.ops.NPUGetFloatStatus` updates the flag which is
+    `mindspore.ops.NPUGetFloatStatus` updates the flag which is
     the output tensor of :class:`mindspore.ops.NPUAllocFloatStatus` with the latest overflow status.
 
 
     Note:
-        The flag is a tensor whose shape is `(8,)` and data type is `mindspore.dtype.float32`.
+        The flag is a tensor whose shape is :math:`(8,)` and data type is `mindspore.dtype.float32`.
         If the sum of the flag equals to 0, there is no overflow happened. If the sum of the
         flag is bigger than 0, there is overflow happened.
         In addition, there are strict sequencing requirements for use, i.e., before
@@ -4414,6 +4425,7 @@ class NPUGetFloatStatus(Primitive):
     @prim_attr_register
     def __init__(self):
         """Initialize NPUGetFloatStatus"""
+        logger.warning("The 'NPUGetFloatStatus' operator will be deprecated in the future. Please don't use it.")
 
 
 class NPUClearFloatStatus(Primitive):
@@ -4477,61 +4489,226 @@ class NPUClearFloatStatus(Primitive):
     @prim_attr_register
     def __init__(self):
         """Initialize NPUClearFloatStatus"""
+        logger.warning("The 'NPUClearFloatStatus' operator will be deprecated in the future. Please don't use it.")
 
 
-class Cos(Primitive):
-    r"""
-    Computes cosine of input element-wise.
-
-    Refer to :func:`mindspore.ops.cos` for more details.
-
-    Supported Platforms:
-        ``Ascend`` ``GPU`` ``CPU``
-
-    Examples:
-        >>> cos = ops.Cos()
-        >>> x = Tensor(np.array([0.24, 0.83, 0.31, 0.09]), mindspore.float32)
-        >>> output = cos(x)
-        >>> print(output)
-        [0.971338 0.6748758 0.95233357 0.9959527]
+class NPUGetFloatStatusV2(Primitive):
     """
+    Get the flag for storage overflow status. This flag is located in a register at a
+    fixed address on the `Ascend` device, and overflow information is automatically
+    written to this register.
+    The flag is a one-dimensional Tensor with shape :math:`(8,)` and data type `mindspore.dtype.int32`.
+    If the value of flag is zero, no overflow has occurred, otherwise, overflow.
+    When performing overflow detection on the network, you should first call `NPUClearFloatStatusV2` to
+    reset the register before the detection, and then call `NPUGetFloatStatusV2` to get the register
+    status after the network execution is completed.
 
-    @prim_attr_register
-    def __init__(self):
-        """Initialize Cos"""
+    Note:
+        - In order to avoid mis-optimization by the compiler, additional input is added to
+          this operator. The input is defined as a shape of: math:`(8,)` and data type of
+          `mindspore.dtype.int32` Tensor, meaningless.
+        - Since this op lacks contextual dependencies with parameters in the network,
+          :class:`mindspore.ops.Depend` needs to be used to ensure order of execution.
 
+    Inputs:
+        Tensor, an additional input created to avoid compiler optimization, is specified as shape :math:`(8,)`,
+        data type is `mindspore.dtype.int32`, and has no actual meaning.
+        Usually use the output of `NPUClearFloatStatusV2`.
 
-class ACos(Primitive):
-    r"""
-    Computes arccosine of input tensors element-wise.
+    Outputs:
+        Tensor, shape and data type are the same as input. If all are zero, it means no overflow, otherwise, overflow.
 
-    Refer to :func:`mindspore.ops.acos` for more details.
+    Raises:
+        TypeError: If `x` is not a Tensor.
+        TypeError: If dtype of `x` is not int32.
+        ValueError: If shape of `x` is not equal to :math:`(8,)`.
 
     Supported Platforms:
-        ``Ascend`` ``GPU`` ``CPU``
+        ``Ascend``
 
     Examples:
-        >>> acos = ops.ACos()
-        >>> x = Tensor(np.array([0.74, 0.04, 0.30, 0.56]), mindspore.float32)
-        >>> output = acos(x)
-        >>> print(output)
-        [0.737726  1.5307857 1.2661036 0.9764105]
+        >>> import mindspore as ms
+        >>> import numpy as np
+        >>> from mindspore import ops, nn, Tensor
+        >>> from mindspore.ops.operations.math_ops import NPUGetFloatStatusV2, NPUClearFloatStatusV2
+        >>> class Net(nn.Cell):
+        ...     def __init__(self):
+        ...         super().__init__()
+        ...         self.clear_status = NPUClearFloatStatusV2()
+        ...         self.get_status = NPUGetFloatStatusV2()
+        ...         self.sub = ops.Sub()
+        ...         self.neg = ops.Neg()
+        ...         self.not_equal = ops.NotEqual()
+        ...         self.reduce_any = ops.ReduceAny(keep_dims=False)
+        ...         self.base = Tensor([0], dtype=ms.int32)
+        ...
+        ...     def construct(self, x):
+        ...         init = Tensor([0]*8, dtype=ms.int32)
+        ...         clear_status = self.clear_status(init)
+        ...         x = ops.depend(x, clear_status)
+        ...         res = self.sub(x, self.neg(x))
+        ...         init = ops.depend(init, res)
+        ...         get_status = self.get_status(init)
+        ...         flag = self.not_equal(self.base, get_status)
+        ...         overflow = self.reduce_any(flag)
+        ...         return overflow
+        ...
+        >>> value = 65504
+        >>> data = np.full((2, 3), value, dtype=np.float16)
+        >>> x = Tensor(data, dtype=ms.float16)
+        >>> net = Net()
+        >>> res = net(x)
+        >>> print(res)
+        True
+        >>> value = 10
+        >>> data = np.full((2, 3), value, dtype=np.float16)
+        >>> x = Tensor(data, dtype=ms.float16)
+        >>> net = Net()
+        >>> res = net(x)
+        >>> print(res)
+        False
     """
 
     @prim_attr_register
     def __init__(self):
-        """Initialize ACos"""
-        self.init_prim_io_names(inputs=['x'], outputs=['y'])
+        """Initialize NPUGetFloatStatusV2"""
 
 
-class Sin(Primitive):
-    r"""
-    Computes sine of the input element-wise.
 
-    Refer to :func:`mindspore.ops.sin` for more details.
+class NPUClearFloatStatusV2(Primitive):
+    """
+    Clear the flag for storage overflow status. This flag is located in a register at a
+    fixed address on the `Ascend` device, and overflow information is automatically
+    written to this register.
+    The flag is a one-dimensional Tensor with shape :math:`(8,)` and data type `mindspore.dtype.int32`.
+    If the value of flag is zero, no overflow has occurred, otherwise, overflow.
+    When performing overflow detection on the network, you should first call `NPUClearFloatStatusV2` to
+    reset the register before the detection, and then call `NPUGetFloatStatusV2` to get the register
+    status after the network execution is completed.
 
-    Supported Platforms:
-        ``Ascend`` ``GPU`` ``CPU``
+    Note:
+        - In order to avoid mis-optimization by the compiler, additional input and output are added to
+          this operator. The input and output are defined as a shape of: math:`(8,)` and data type of
+          `mindspore.dtype.int32` Tensor, meaningless.
+        - Since this op lacks contextual dependencies with parameters in the network,
+          :class:`mindspore.ops.Depend` needs to be used to ensure order of execution.
+
+    Inputs:
+        Tensor, an additional input created to avoid compiler optimization, is specified as shape :math:`(8,)`,
+        data type is `mindspore.dtype.int32`, and has no actual meaning.
+
+    Outputs:
+        Tensor, shape and data type are the same as input, meaningless.
+
+    Raises:
+        TypeError: If `x` is not a Tensor.
+        TypeError: If dtype of `x` is not int32.
+        ValueError: If shape of `x` is not equal to :math:`(8,)`.
+
+    Supported Platforms:
+        ``Ascend``
+
+    Examples:
+        >>> import mindspore as ms
+        >>> import numpy as np
+        >>> from mindspore import ops, nn, Tensor
+        >>> from mindspore.ops.operations.math_ops import NPUGetFloatStatusV2, NPUClearFloatStatusV2
+        >>> class Net(nn.Cell):
+        ...     def __init__(self):
+        ...         super().__init__()
+        ...         self.clear_status = NPUClearFloatStatusV2()
+        ...         self.get_status = NPUGetFloatStatusV2()
+        ...         self.sub = ops.Sub()
+        ...         self.neg = ops.Neg()
+        ...         self.not_equal = ops.NotEqual()
+        ...         self.reduce_any = ops.ReduceAny(keep_dims=False)
+        ...         self.base = Tensor([0], dtype=ms.int32)
+        ...
+        ...     def construct(self, x):
+        ...         init = Tensor([0]*8, dtype=ms.int32)
+        ...         clear_status = self.clear_status(init)
+        ...         x = ops.depend(x, clear_status)
+        ...         res = self.sub(x, self.neg(x))
+        ...         init = ops.depend(init, res)
+        ...         get_status = self.get_status(init)
+        ...         flag = self.not_equal(self.base, get_status)
+        ...         overflow = self.reduce_any(flag)
+        ...         return overflow
+        ...
+        >>> value = 65504
+        >>> data = np.full((2, 3), value, dtype=np.float16)
+        >>> x = Tensor(data, dtype=ms.float16)
+        >>> net = Net()
+        >>> res = net(x)
+        >>> print(res)
+        True
+        >>> value = 10
+        >>> data = np.full((2, 3), value, dtype=np.float16)
+        >>> x = Tensor(data, dtype=ms.float16)
+        >>> net = Net()
+        >>> res = net(x)
+        >>> print(res)
+        False
+    """
+
+    @prim_attr_register
+    def __init__(self):
+        """Initialize NPUClearFloatStatusV2"""
+
+
+class Cos(Primitive):
+    r"""
+    Computes cosine of input element-wise.
+
+    Refer to :func:`mindspore.ops.cos` for more details.
+
+    Supported Platforms:
+        ``Ascend`` ``GPU`` ``CPU``
+
+    Examples:
+        >>> cos = ops.Cos()
+        >>> x = Tensor(np.array([0.24, 0.83, 0.31, 0.09]), mindspore.float32)
+        >>> output = cos(x)
+        >>> print(output)
+        [0.971338 0.6748758 0.95233357 0.9959527]
+    """
+
+    @prim_attr_register
+    def __init__(self):
+        """Initialize Cos"""
+
+
+class ACos(Primitive):
+    r"""
+    Computes arccosine of input tensors element-wise.
+
+    Refer to :func:`mindspore.ops.acos` for more details.
+
+    Supported Platforms:
+        ``Ascend`` ``GPU`` ``CPU``
+
+    Examples:
+        >>> acos = ops.ACos()
+        >>> x = Tensor(np.array([0.74, 0.04, 0.30, 0.56]), mindspore.float32)
+        >>> output = acos(x)
+        >>> print(output)
+        [0.737726  1.5307857 1.2661036 0.9764105]
+    """
+
+    @prim_attr_register
+    def __init__(self):
+        """Initialize ACos"""
+        self.init_prim_io_names(inputs=['x'], outputs=['y'])
+
+
+class Sin(Primitive):
+    r"""
+    Computes sine of the input element-wise.
+
+    Refer to :func:`mindspore.ops.sin` for more details.
+
+    Supported Platforms:
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> sin = ops.Sin()
@@ -4683,7 +4860,7 @@ class Sign(Primitive):
 
     Inputs:
         - **x** (Tensor) - The input tensor.
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions.
+          :math:`(N, *)` where :math:`*` means, any number of additional dimensions.
 
     Outputs:
         Tensor, has the same shape and dtype as the `x`.
@@ -4717,11 +4894,11 @@ class Round(Primitive):
         ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
-         >>> x = Tensor(np.array([0.8, 1.5, 2.3, 2.5, -4.5]), mindspore.float32)
-         >>> round = ops.Round()
-         >>> output = round(x)
-         >>> print(output)
-         [ 1.  2.  2.  2. -4.]
+        >>> x = Tensor(np.array([0.8, 1.5, 2.3, 2.5, -4.5]), mindspore.float32)
+        >>> round = ops.Round()
+        >>> output = round(x)
+        >>> print(output)
+        [ 1.  2.  2.  2. -4.]
     """
 
     @prim_attr_register
@@ -4781,7 +4958,7 @@ class Atanh(Primitive):
     Computes inverse hyperbolic tangent of the input element-wise.
 
     .. warning::
-        This is an experimental prototype that is subject to change and/or deletion.
+        This is an experimental API that is subject to change or deletion.
 
     Refer to :func:`mindspore.ops.atanh` for more details.
 
@@ -4809,7 +4986,7 @@ class Atan2(_MathBinaryOp):
     Refer to :func:`mindspore.ops.atan2` for more details.
 
     Supported Platforms:
-        ``Ascend`` ``CPU`` ``GPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([0, 1]), mindspore.float32)
@@ -4819,6 +4996,7 @@ class Atan2(_MathBinaryOp):
         >>> print(output)
         [0.        0.7853982]
     """
+
     @prim_attr_register
     def __init__(self):
         """Initialize Atan2"""
@@ -4840,7 +5018,7 @@ class SquareSumAll(Primitive):
 
     Inputs:
         - **x** (Tensor) - The input tensor. The data type must be float16 or float32.
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions.
+          :math:`(N, *)` where :math:`*` means, any number of additional dimensions.
         - **y** (Tensor) - The input tensor has the same type and shape as the `x`.
 
     Outputs:
@@ -4881,7 +5059,7 @@ class BitwiseAnd(_BitwiseBinaryOp):
     Refer to :func:`mindspore.ops.bitwise_and` for more details.
 
     Supported Platforms:
-        ``Ascend`` ``CPU`` ``GPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([0, 0, 1, -1, 1, 1, 1]), mindspore.int16)
@@ -4900,7 +5078,7 @@ class BitwiseOr(_BitwiseBinaryOp):
     Refer to :func:`mindspore.ops.bitwise_or` for more details.
 
     Supported Platforms:
-        ``Ascend`` ``CPU`` ``GPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([0, 0, 1, -1, 1, 1, 1]), mindspore.int16)
@@ -4919,7 +5097,7 @@ class BitwiseXor(_BitwiseBinaryOp):
     Refer to :func:`mindspore.ops.bitwise_xor` for more details.
 
     Supported Platforms:
-        ``Ascend`` ``CPU`` ``GPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([0, 0, 1, -1, 1, 1, 1]), mindspore.int16)
@@ -4935,16 +5113,10 @@ class BesselI0(Primitive):
     """
     Computes BesselI0 of input element-wise.
 
-    Inputs:
-        - **x** (Tensor) - The shape of tensor is
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions.
-          Data type must be float16, float32 or float64.
-
-    Outputs:
-        Tensor, has the same shape as `x`.
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
-    Raises:
-        TypeError: If `x` is not a Tensor of float16, float32 or float64.
+    Refer to :func:`mindspore.ops.bessel_i0` for more details.
 
     Supported Platforms:
         ``GPU`` ``CPU``
@@ -4954,28 +5126,22 @@ class BesselI0(Primitive):
         >>> x = Tensor(np.array([0.24, 0.83, 0.31, 0.09]), mindspore.float32)
         >>> output = bessel_i0(x)
         >>> print(output)
-        [1.014452  1.179784  1.0241697 1.0020261]
+        [1.0144521 1.1797839 1.0241698 1.0020262]
     """
 
     @prim_attr_register
     def __init__(self):
-        """Initialize BesselI0"""
+        self.init_prim_io_names(inputs=['x'], outputs='y')
 
 
 class BesselI1(Primitive):
     """
     Computes BesselI1 of input element-wise.
 
-    Inputs:
-        - **x** (Tensor) - The shape of tensor is
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions.
-          Data type must be float16 or float32.
-
-    Outputs:
-        Tensor, has the same shape as `x`.
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
-    Raises:
-        TypeError: If `x` is not a Tensor of float16, float32 or float64.
+    Refer to :func:`mindspore.ops.bessel_i1` for more details.
 
     Supported Platforms:
         ``GPU`` ``CPU``
@@ -5005,8 +5171,7 @@ class BesselI0e(Primitive):
     where bessel_i0 is Bessel function of the first kind with 0 order.
 
     Inputs:
-        - **x** (Tensor) - The shape of tensor is
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions.
+        - **x** (Tensor) - The input tensor.
           Data type must be float16, float32 or float64.
 
     Outputs:
@@ -5045,8 +5210,7 @@ class BesselI1e(Primitive):
     where bessel_i1 is Bessel function of the first kind with 1 order.
 
     Inputs:
-        - **x** (Tensor) - The shape of tensor is
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions.
+        - **x** (Tensor) - The input tensor.
           Data type must be float16 or float32, float64.
 
     Outputs:
@@ -5077,9 +5241,11 @@ class BesselK0(Primitive):
     r"""
     Computes BesselK0 of input element-wise.
 
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
+
     Inputs:
-        - **x** (Tensor) - The shape of tensor is
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions.
+        - **x** (Tensor) - The input tensor.
           Data type must be float16, float32, float64.
 
     Outputs:
@@ -5108,9 +5274,11 @@ class BesselK1(Primitive):
     r"""
     Computes BesselK1 of input element-wise.
 
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
+
     Inputs:
-        - **x** (Tensor) - The shape of tensor is
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions.
+        - **x** (Tensor) - The input tensor.
           Data type must be float16, float32, float64.
 
     Outputs:
@@ -5139,9 +5307,11 @@ class BesselK0e(Primitive):
     """
     Computes BesselK0e of input element-wise.
 
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
+
     Inputs:
-        - **x** (Tensor) - The shape of tensor is
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions.
+        - **x** (Tensor) - The input tensor.
           Data type must be float16, float32, float64.
 
     Outputs:
@@ -5170,9 +5340,11 @@ class BesselK1e(Primitive):
     """
     Computes BesselK1e of input element-wise.
 
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
+
     Inputs:
-        - **x** (Tensor) - The shape of tensor is
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions.
+        - **x** (Tensor) - The input tensor.
           Data type must be float16, float32, float64.
 
     Outputs:
@@ -5201,9 +5373,11 @@ class BesselJ0(Primitive):
     """
     Computes BesselJ0 of input element-wise.
 
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
+
     Inputs:
-        - **x** (Tensor) - The shape of tensor is
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions.
+        - **x** (Tensor) - The input tensor.
           Data type must be float16, float32 or float64.
 
     Outputs:
@@ -5233,9 +5407,11 @@ class BesselJ1(Primitive):
     """
     Computes BesselJ1 of input element-wise.
 
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
+
     Inputs:
-        - **x** (Tensor) - The shape of tensor is
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions.
+        - **x** (Tensor) - The input tensor.
           Data type must be float16, float32 or float64.
 
     Outputs:
@@ -5265,9 +5441,11 @@ class BesselY0(Primitive):
     """
     Computes BesselY0 of input element-wise.
 
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
+
     Inputs:
-        - **x** (Tensor) - The shape of tensor is
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions.
+        - **x** (Tensor) - The input tensor.
           Data type must be float16, float32 or float64.
 
     Outputs:
@@ -5297,9 +5475,11 @@ class BesselY1(Primitive):
     """
     Computes BesselY1 of input element-wise.
 
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
+
     Inputs:
-        - **x** (Tensor) - The shape of tensor is
-          :math:`(N,*)` where :math:`*` means, any number of additional dimensions.
+        - **x** (Tensor) - The input tensor.
           Data type must be float16, float32 or float64.
 
     Outputs:
@@ -5473,7 +5653,7 @@ class MatrixInverse(Primitive):
         ValueError: If the dimension of `x` is less than 2.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([[[-0.710504  , -1.1207525],
@@ -5498,9 +5678,9 @@ class MatrixInverse(Primitive):
 
 class MatrixPower(Primitive):
     """
-    Computes the n-th power of a batch of square matrices.
-    If n = 0, it returns a batch of identity matrices. If n is negative, it
-    returns the inverse of each matrix (if invertible) raised to the power of abs(n).
+    Calculates the n-th power of a batch of square matrices.
+    When n equals 0, it returns a group of identity matrices. If n is negative,
+    it computes the inverse of each matrix (if possible) raised to the power of abs(n).
 
     Args:
         n (int) : The exponent, a required int.
@@ -5521,7 +5701,7 @@ class MatrixPower(Primitive):
         ValueError: If n is negative but got input x has singular matrices.
 
     Supported Platforms:
-        ``Ascend`` ``CPU``
+
 
     Examples:
         >>> x = Tensor([[[0, 1], [-1, 0]], [[1, 0], [0, -1]]], dtype=ms.float32)
@@ -5542,12 +5722,12 @@ class MatrixPower(Primitive):
 
 class MatrixDeterminant(Primitive):
     """
-    Computes the determinant of one or more square matrices.
+    Calculates the value of the determinant for one or more square matrices.
 
-    Refer to :func:`mindspore.ops.matrix_determinant` for more details.
+    Refer to :func:`mindspore.ops.det` for more details.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+
 
     Examples:
         >>> input_x = Tensor(np.array([[[-4.5, -1.5], [7.0, 6.0]], [[2.5, 0.5], [3.0, 9.0]]]), mindspore.float32)
@@ -5566,12 +5746,12 @@ class MatrixDeterminant(Primitive):
 
 class LogMatrixDeterminant(Primitive):
     """
-    Computes the sign and the log of the absolute value of the determinant of one or more square matrices.
+    Calculates the sign and logarithm of the determinant of one or more square matrices.
 
-    Refer to :func:`mindspore.ops.log_matrix_determinant` for more details.
+    Refer to :func:`mindspore.ops.slogdet` for more details.
 
     Supported Platforms:
-        ``Ascend`` ``GPU`` ``CPU``
+
 
     Examples:
         >>> input_x = Tensor(np.array([[[-4.5, -1.5], [7.0, 6.0]], [[2.5, 0.5], [3.0, 9.0]]]), mindspore.float32)
@@ -5599,13 +5779,13 @@ class MatrixLogarithm(Primitive):
           Must be one of the following types:complex64, complex128. And shape must be 2D-7D.
 
     Outputs:
-        - **y** (Tensor), has the same shape and type as input.
+        - **y** (Tensor) - has the same shape and type as input.
 
     Raises:
         TypeError: If `x` is not a Tensor.
         TypeError: If dtype of `x` is not one of: complex64, complex128.
         ValueError: If the dimension of `x` is less to 2.
-        ValueError: If the inner two dimension is not equal.
+        ValueError: If the size of last two dimensions are not equal.
 
     Supported Platforms:
         ``Ascend`` ``CPU``
@@ -5627,7 +5807,7 @@ class MatrixLogarithm(Primitive):
 
 class IndexAdd(Primitive):
     """
-    Adds tensor `y` to specified axis and indices of tensor `x`. The axis should be in [0,  len(x.dim) - 1],
+    Adds tensor `y` to specified axis and indices of tensor `x`. The axis should be in [-len(x.dim),  len(x.dim) - 1],
     and indices should be in [0, the size of `x` - 1] at the axis dimension.
 
     Args:
@@ -5770,25 +5950,29 @@ class ComplexAbs(Primitive):
     r"""
     Returns a Tensor that contains the magnitudes of the input.
 
-    The complex numbers in input must be of the form a + bj, where a is the real part and b is the imaginary part.
+    The complex numbers in input must be of the form :math:`a + bj`,
+    where :math:`a` is the real part and :math:`b` is the imaginary part.
 
     .. math::
 
-        y = \sqrt{a^2+b^2}.
+        y = \sqrt{a^2+b^2}
+
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
     Inputs:
         - **x** (Tensor) - A Tensor, types: complex64, complex128.
 
     Outputs:
-        - **y** (Tensor) - Tensor, has the same shape as x. If the type of x is complex64, the type of y is float32.
-          If the type of x is complex128, the type of y is float64.
+        Tensor, has the same shape as x. If the type of x is complex64, the type of output is float32.
+        If the type of x is complex128, the type of output is float64.
 
     Raises:
        TypeError: If the input is not a Tensor.
        TypeError: If the input type is not complex64 or complex128.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.asarray(np.complex(3+4j)), mindspore.complex64)
@@ -5819,7 +6003,7 @@ class Real(Primitive):
        TypeError: If the input is not a Tensor.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.asarray(np.complex(1.3+0.4j)), mindspore.complex64)
@@ -5839,6 +6023,9 @@ class Complex(Primitive):
     """
     Returns a complex Tensor from the real part and the imag part.
 
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
+
     Inputs:
         - **real** (Tensor) - The real input tensor. types: float32, float64.
         - **imag** (Tensor) - The imag input tensor. types: float32, float64.
@@ -5851,7 +6038,7 @@ class Complex(Primitive):
        TypeError: If the dtypes of two inputs are not same.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> real = Tensor(np.array([1]), mindspore.float32)
@@ -5883,7 +6070,7 @@ class Imag(Primitive):
        TypeError: If the input is not a Tensor.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.asarray(np.complex(1.3+0.4j)), mindspore.complex64)
@@ -5902,21 +6089,14 @@ class Imag(Primitive):
 class Angle(Primitive):
     """
     Returns the element-wise argument of a complex tensor.
-    The elements in input are considered to be complex numbers of the form a+bj, where a is the real part and b
-    is the imaginary part. The argument returned by this function is of the form atan2(b,a).
-
-    Inputs:
-        - **input** (Tensor) - The input tensor. types: complex64, complex128.
 
-    Outputs:
-        Tensor, has the float32 or float64 type and the same shape as input.
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
-    Raises:
-        TypeError: If `input` is not a Tensor.
-        TypeError: If the dtype of input is not one of: complex64, complex128.
+    Refer to :func:`mindspore.ops.angle` for more details.
 
     Supported Platforms:
-        ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> input = Tensor([-1.5 + 7.8j, 3 + 5.75j], mindspore.complex64)
@@ -5961,18 +6141,18 @@ class TridiagonalMatMul(Primitive):
     Inputs:
         - **superdiag** (Tensor) - Superdiagonals of Tridiagonal Matrices to the left of multiplication.
           Data types must be: float16, float32, double, complex64, complex128.
-          The shape is [..., 1, M].
+          The shape is :math:`(..., 1, M)`.
           Last element is ignored.
         - **maindiag** (Tensor) - Maindiagonals of Tridiagonal Matrices to the left of multiplication.
           Data types must be: float16, float32, double, complex64, complex128.
-          The shape is [..., 1, M].
+          The shape is :math:`(..., 1, M)`.
         - **subdiag** (Tensor) - Subdiagonals of Tridiagonal Matrices to the left of multiplication.
           Data types must be: float16, float32, double, complex64, complex128.
-          The shape is [..., 1, M].
+          The shape is :math:`(..., 1, M)`.
           First element is ignored.
         - **rhs** (Tensor) - MxN Matrices to the right of multiplication.
           Data types must be: float16, float32, double, complex64, complex128.
-          The shape is [..., M, N].
+          The shape is :math:`(..., 1, M)`.
 
     Outputs:
         Tensor, with the same shape and data type as the `rhs`.
@@ -6022,44 +6202,19 @@ class TridiagonalMatMul(Primitive):
 class Igamma(Primitive):
     r"""
     Calculates lower regularized incomplete Gamma function.
-    The lower regularized incomplete Gamma function is defined as:
-
-    .. math::
-        P(a, x) = gamma(a, x) / Gamma(a) = 1 - Q(a, x)
-
-    where
-
-    .. math::
-        gamma(a, x) = \int_0^x t^{a-1} \exp^{-t} dt
-
-    is the lower incomplete Gamma function.
-
-    Above :math:`Q(a, x)` is the upper regularized complete Gamma function.
 
     .. warning::
-        This is an experimental prototype that is subject to change and/or deletion.
-
-    Inputs:
-        - **a** (Tensor) - The input tensor. With type of float32 or float64.
-        - **x** (Tensor) - The input tensor. With float32 or float64 type. `x` should have
-          the same dtype with `a`.
-
-    Outputs:
-        Tensor, has the same dtype as `a` and `x`.
+        This is an experimental API that is subject to change or deletion.
 
-    Raises:
-        TypeError: If a or x is not a Tensor.
-        TypeError: If dtype of input x and a is not float32 nor float64.
-        TypeError: If x has different dtype with a.
-        ValueError: If `a` could not be broadcast to a tensor with shape of `x`.
+    Refer to :func:`mindspore.ops.igamma` for more details.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> a = Tensor(np.array([2.0, 4.0, 6.0, 8.0]).astype(np.float32))
         >>> x = Tensor(np.array([2.0, 3.0, 4.0, 5.0]).astype(np.float32))
-        >>> igamma = P.Igamma()
+        >>> igamma = ops.Igamma()
         >>> output = igamma(a, x)
         >>> print (output)
         [0.593994  0.35276785  0.21486944  0.13337152]
@@ -6075,39 +6230,15 @@ class Igammac(Primitive):
     r"""
     Compute the upper regularized incomplete Gamma function Q(a, x).
 
-    The upper regularized incomplete Gamma function is defined as:
-    \(Q(a, x) = Gamma(a, x) / Gamma(a) = 1 - P(a, x)\)
-    where
-    \(Gamma(a, x) = int_{x}^{\infty} t^{a-1} exp(-t) dt\)
-
-    is the upper incomplete Gama function.
-
-    Note, above P(a, x) (Igamma) is the lower regularized complete Gamma function.
-
-    .. warning::
-        This is an experimental prototype that is subject to change and/or deletion.
-
-    Inputs:
-        - **a** (Tensor) - The input tensor of igammac. With float32 or float64 data type.
-        - **x** (Tensor) - The input tensor of igammac. With float32 or float64 type. `x` should have
-          the same type with `a`.
-
-    Outputs:
-        A Tensor, has the same dtype as `a` and `x`.
-
-    Raises:
-        TypeError: If dtype of input x and a is not float32 nor float64.
-        TypeError: If a or x is not a Tensor.
-        TypeError: If x has different dtype with a.
-        ValueError: If `a` could not be broadcast to a tensor with shape of `x`.
+    Refer to :func:`mindspore.ops.igammac` for more details.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> a = Tensor(np.array([2.0, 4.0, 6.0, 8.0]).astype(np.float32))
         >>> x = Tensor(np.array([2.0, 3.0, 4.0, 5.0]).astype(np.float32))
-        >>> igammac = P.Igammac()
+        >>> igammac = ops.Igammac()
         >>> output = igammac(a, x)
         >>> print (output)
         [0.40600586 0.6472318  0.7851304  0.8666283 ]
@@ -6121,7 +6252,8 @@ class Igammac(Primitive):
 
 class IsClose(Primitive):
     r"""
-    Returns a boolean Tensor where two tensors are element-wise equal within a tolerance.
+    Returns a tensor of Boolean values indicating whether two input tensors
+    are element-wise equal within a given tolerance.
 
     Refer to :func:`mindspore.ops.isclose` for more details.
 
@@ -6160,7 +6292,7 @@ class MatrixExp(Primitive):
     Refer to :func:`mindspore.ops.matrix_exp` for more details.
 
     Supported Platforms:
-        ``CPU``
+
 
     Examples:
         >>> matrix_exp = ops.MatrixExp()
@@ -6181,19 +6313,19 @@ class MatrixSolve(Primitive):
     Solves systems of linear equations.
 
     Args:
-        adjoint (bool, optional): Indicating whether to solve with matrix or
-            its (block-wise) adjoint. Default: False.
+        adjoint (bool, optional): Indicates whether the adjoint of the
+            matrix is used during the computation. Default: False,  use its transpose instead.
 
     Inputs:
-        - **matrix** (Tensor) - A tensor of shape :math:`[..., M, M]`,
+        - **matrix** (Tensor) - A tensor of shape :math:`(..., M, M)`,
           is a matrix of coefficients for a system of linear equations.
-        - **rhs** (Tensor) - A tensor of shape :math:`[..., M, K]`,
+        - **rhs** (Tensor) - A tensor of shape :math:`(..., M, K)`,
           is a matrix of the resulting values of a system of linear equations.
-          'rhs' must have the same type as `matrix`.
+          `rhs` must have the same type as `matrix`.
 
     Outputs:
         Tensor, a matrix composed of solutions to a system of linear equations,
-        which has the same type and shape as 'rhs'.
+        which has the same type and shape as `rhs`.
 
     Raises:
         TypeError: If `adjoint` is not the type of bool.
@@ -6276,27 +6408,79 @@ class MatrixSolveLs(Primitive):
         validator.check_value_type('fast', fast, [bool], self.name)
 
 
+class Lu(Primitive):
+    """
+    Computes the LU decomposition of one or more square matrices.
+
+    Args:
+        output_idx_type (:class:`mindspore.dtype`): An optional data type of `mindspore.dtype.int32`.
+            Default: `mindspore.dtype.int32`.
+
+    Inputs:
+        - **input** (Tensor) - A tensor of shape `[..., M, M]` whose inner-most 2 dimensions form
+          matrices of size `[M, M]`, with data type float32, float64, complex64, complex128.
+
+    Outputs:
+        - **lu** (Tensor) - A tensor of shape `[..., M, M]` whose strictly lower triangular part denotes the lower
+          triangular factor `L` with unit diagonal. Upper triangular part denotes the upper triangular factor `U`.
+        - **p** (Tensor) - Permutation of the rows encoded as a list of indices in `0..M-1`, shape is `[..., M]`.
+
+    Raises:
+        TypeError: If the dtype of `input` is not one of the following dtype:
+            float32, float64, complex64, complex128.
+        TypeError: If `output_idx_type` is neither int32 nor int64.
+        ValueError: If `input` rank is less than 2.
+        ValueError: If input[-1] is not equal to input[-2].
+
+    Supported Platforms:
+        ``GPU``
+
+    Examples:
+        >>> input = Tensor(np.array([[2.5,3.1,3.5], [4.7,1.9,0.2], [1.1,3.6,2.0]]), mindspore.float32)
+        >>> lu, p = ops.Lu(output_idx_type=mindspore.int32)(input)
+        >>> print(lu)
+        [[4.7        1.9        0.2       ]
+         [0.23404257 3.155319   1.9531915 ]
+         [0.5319149  0.6621713  2.1002696 ]]
+        >>> print(p)
+        [1 2 0]
+    """
+
+    @prim_attr_register
+    def __init__(self, output_idx_type):
+        super().__init__(name="Lu")
+        self.init_prim_io_names(inputs=['input'], outputs=['lu', 'p'])
+        validator.check_type_name("output_idx_type", output_idx_type, [mstype.int32, mstype.int64], self.name)
+        self.add_prim_attr('output_idx_type', output_idx_type)
+
+
 class LuSolve(Primitive):
     r"""
-    Return the solution of the linear equation :math:`Ax = b` .
+    Computes the solution y to the system of linear equations :math:`Ay = b` ,
+    given LU decomposition A and column vector b.
+
+    LU decomposition of a matrix can be generated from :func:`mindspore.scipy.linalg.lu` .
 
     Note:
         The batch dimensions of lu_pivots must match the batch dimensions of lu_data, the size of the dimension and the
-        number of each dimension must be the same. For example, lu_data is (3, 3, 2, 2) lu_pivots is (3, 3, 2),
-        lu_data's batch dimensions is (3, 3), lu_pivots's batch dimensions is (3, 3).
+        number of each dimension must be the same. For example, lu_data is :math:`(3, 3, 2, 2)` lu_pivots is
+        :math:`(3, 3, 2)`,
+        lu_data's batch dimensions is :math:`(3, 3)`, lu_pivots's batch dimensions is :math:`(3, 3)`.
 
         The batch dimensions of lu_data must match the batch dimensions of x, the batch dimensions may have
         different sizes, from right to left, the corresponding dimensions must be equal. For example, lu_data
-        is (3, 3, 2, 2) x is (2, 3, 3, 2, 1), lu_data's batch dimensions is (3, 3), x's batch dimensions is (2, 3, 3).
+        is :math:`(3, 3, 2, 2)` x is :math:`(2, 3, 3, 2, 1)`, lu_data's batch dimensions is
+        :math:`(3, 3)`, x's batch dimensions is :math:`(2, 3, 3)`.
 
     Inputs:
-        - **x** (Tensor) - The input is a tensor of size `(*, m, k)`, where * is batch dimensions, with data type
-          float32, float16.
-        - **lu_data** (Tensor) - The input is a tensor of size `(*, m, m)`, where * is batch dimensions, that can
-          be decomposed into an upper
-          triangular matrix U and a lower triangular matrix L, with data type float32, float16.
-        - **lu_pivots** (Tensor) - The input is a tensor of size `(*, m)`, where * is batch dimensions, that can
-          be converted to a permutation matrix P, with data type int32.
+        - **x** (Tensor) - Column vector `b` in the above equation. It has shape :math:`(*, m, k)`,
+          where :math:`*` is batch dimensions, with data type float32, float16.
+        - **lu_data** (Tensor) - LU decomposition. It has shape :math:`(*, m, m)`, where * is batch
+          dimensions, that can be decomposed into an upper triangular matrix U and a lower triangular
+          matrix L, with data type float32, float16.
+        - **lu_pivots** (Tensor) - Permutation matrix P of LU decomposition. It has
+          shape :math:`(*, m)`, where :math:`*` is batch dimensions, that can be converted
+          to a permutation matrix P, with data type int32.
 
     Outputs:
         Tensor, the same data type as the x and lu_data.
@@ -6310,7 +6494,7 @@ class LuSolve(Primitive):
         ValueError: If `x` dimension less than 2, `lu_data` dimension less than 2 or `lu_pivots` dimension less than 1.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([[1], [3], [3]]), mindspore.float32)
@@ -6331,41 +6515,18 @@ class LuSolve(Primitive):
 
 class LuUnpack(Primitive):
     """
-    Unpack the LU_data and LU_pivots from a LU factorization of a tensor.
+    Converts `LU_data` and `LU_pivots` back into P, L and U matrices, where
+    P is a permutation matrix, L is a lower triangular matrix, and U is an
+    upper triangular matrix. Typically, `LU_data` and `LU_pivots` are generated
+    from the LU decomposition of a matrix.
 
-    Args:
-        unpack_data (bool, optional): A flag indicating if the LU_data should be unpacked.
-            If False, then the returned L and U are None. Default: True.
-        unpack_pivots (bool, optional): A flag indicating if the LU_pivots should be unpacked
-            into a permutation matrix P. If False, then the returned P is None. Default: True.
-
-    Inputs:
-        - **LU_data** (Tensor) - The packed LU factorization data. A tensor of size `[*, M, N]`,
-          where * is batch dimensions, with data type int8, uint8, int16, int32, int64, float16,
-          float32, float64. The dims of LU_data must be equal to or greater than 2.
-        - **LU_pivots** (Tensor) - The packed LU factorization pivots. A tensor of size `[*, min(M, N)]`,
-          where * is batch dimensions, with data type int8, uint8, int16, int32, int64.
-
-    Outputs:
-        - **pivots** (Tensor) - The permutation matrix of LU factorization. The shape is `[*, M, M]`,
-          the dtype is same as `LU_data`.
-        - **L** (Tensor) - The L matrix  of LU factorization. The dtype is the same as `LU_data`.
-        - **U** (Tensor) - The U matrix  of LU factorization. The dtype is the same as `LU_data`.
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
-    Raises:
-        TypeError: If the dtype of `LU_data` is not one of the following: int8, uint8, int16, int32,
-                   int64, float16, float32, float64.
-        TypeError: If the dtype of `LU_pivots` is not one of the following: int8, uint8, int16, int32, int64.
-        ValueError: If the dimension of `LU_data` is less than 2.
-        ValueError: If the dimension of `LU_pivots` is less than 1.
-        ValueError: If the size of the last dimension of LU_pivots is not equal to the minimum of the sizes of
-                    the last two dimensions of LU_data.
-        ValueError: If the batch dimensions of LU_data's does not match LU_pivots's batch dimensions.
-        ValueError: On the CPU platform, if the value of `LU_pivots` are out of range[1, LU_data.shape[-2]).
-        RuntimeError: On the Ascend platform, if the value of `LU_pivots` are out of range[1, LU_data.shape[-2]).
+    Refer to :func:`mindspore.ops.lu_unpack` for more details.
 
     Supported Platforms:
-        ``CPU``
+        ``GPU`` ``CPU``
 
     Examples:
         >>> LU_data = Tensor(np.array([[[-0.3806, -0.4872,  0.5536],
@@ -6377,10 +6538,31 @@ class LuUnpack(Primitive):
         >>> LU_pivots = Tensor(np.array([[1, 3, 3],
         ...                              [2, 3, 3]]), mstype.int32)
         >>> lu_unpack = ops.LuUnpack()
-        >>> pivots, L, U = lu_unpack(LU_data, LU_pivots, unpack_data, unpack_pivots)
+        >>> pivots, L, U = lu_unpack(LU_data, LU_pivots)
         >>> print(pivots)
+        [[[1. 0. 0.]
+          [0. 0. 1.]
+          [0. 1. 0.]]
+        <BLANKLINE>
+         [[0. 0. 1.]
+          [1. 0. 0.]
+          [0. 1. 0.]]]
         >>> print(L)
+        [[[ 1.      0.      0.    ]
+          [-0.1287  1.      0.    ]
+          [ 0.2583  0.5239  1.    ]]
+        <BLANKLINE>
+         [[ 1.      0.      0.    ]
+          [-0.6401  1.      0.    ]
+          [ 0.1015 -0.5363  1.    ]]]
         >>> print(U)
+        [[[-0.3806 -0.4872  0.5536]
+          [ 0.      0.6508 -0.2396]
+          [ 0.      0.      0.6902]]
+        <BLANKLINE>
+         [[ 0.6706 -1.1782  0.4574]
+          [ 0.     -0.4779  0.6701]
+          [ 0.      0.      0.6165]]]
     """
 
     @prim_attr_register
@@ -6392,26 +6574,12 @@ class LuUnpack(Primitive):
 
 class Lgamma(Primitive):
     r"""
-    Computes the natural logarithm of the absolute value of the gamma function on `input`.
-
-    .. math::
-    \text{out}_{i} = \ln \Gamma(|\text{input}_{i}|)
-
-    Args:
-        input (Tensor): the tensor to compute the lgamma function.
-
-    Inputs:
-        - **x** (Tensor) - The input tensor, types: float16, float32, float64.
+    Computes the natural logarithm of the absolute value of the gamma function on input.
 
-    Outputs:
-        Tensor, has the same dtype as `x`.
-
-    Raises:
-        TypeError: If x is not a Tensor.
-        TypeError: If dtype of input x is not one of: float16, float32, float64.
+    Refer to :func:`mindspore.ops.lgamma` for more details.
 
     Supported Platforms:
-        ``GPU``
+        ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([0.5, 3.2, 8.5]), mindspore.float32)
@@ -6435,7 +6603,7 @@ class Digamma(Primitive):
         P(x) = grad(ln(gamma(x)))
 
     .. warning::
-        This is an experimental prototype that is subject to change and/or deletion.
+        This is an experimental API that is subject to change or deletion.
 
     Inputs:
         - **x** (Tensor) - The input tensor. With type of float16 or float32 or float64.
@@ -6448,7 +6616,7 @@ class Digamma(Primitive):
         TypeError: If dtype of input x is not float16 or float32 or float64.
 
     Supported Platforms:
-        ``GPU``
+        ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([1.5, 0.5, 9]).astype(np.float16))
@@ -6466,29 +6634,15 @@ class Digamma(Primitive):
 
 class Polygamma(Primitive):
     r"""
-    Computes the :math:`a^{th}` derivative of the polygamma function on `x`.
-
-    .. math::
-    \psi^{(a)}(x) = \frac{d^{(a)}}{dx^{(a)}} \psi(x)
-
-    Args:
-        :math:`a \geq 0`: the order of the polygamma function.
-        input (Tensor): the tensor to compute the polygamma function.
+    Computes the :math:`a`th derivative of the polygamma function on `x`.
 
-    Inputs:
-        - **a** (Tensor) - The order of the polygamma function, types: int32, int64.
-        - **x** (Tensor) - The input tensor, types: float16, float32, float64.
-
-    Outputs:
-        Tensor, has the same dtype as `x`.
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
-    Raises:
-        TypeError: If x is not a Tensor.
-        TypeError: If dtype of input x is not one of: float16, float32, float64.
-        TypeError: If dtype of input a is not one of: int32, int64.
+    Refer to :func:`mindspore.ops.polygamma` for more details.
 
     Supported Platforms:
-        ``GPU``
+        ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([1.0, -0.5]), mindspore.float32)
@@ -6519,12 +6673,12 @@ class Polygamma(Primitive):
 
 class CholeskyInverse(Primitive):
     """
-    Returns the inverse of the positive definite matrix using cholesky matrix factorization.
+    Returns the inverse of the positive definite matrix using cholesky matrix factorization given its Cholesky factor.
 
     Refer to :func:`mindspore.ops.cholesky_inverse` for more details.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([[2,0,0], [4,1,0], [-1,1,2]]), mindspore.float32)
@@ -6547,10 +6701,24 @@ class Cross(Primitive):
     """
     Returns the cross product of vectors in dimension `dim` of x1 and x2.
 
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
+
     Refer to :func:`mindspore.ops.cross` for more details.
 
+    Args:
+        dim (int): Spefcified dim along which to cumpute cross product with. Default: -65530.
+
+    Inputs:
+        - **x1** (Tensor) - Input Tensor.
+        - **x2** (Tensor) - Another input Tensor, must have the same shape and
+          the same type as `x1`, and the size of their `dim` dimension should be 3.
+
+    Outputs:
+        Tensor, has the same shape and type as inputs.
+
     Supported Platforms:
-        ``CPU``
+        ``Ascend`` ``CPU``
 
     Examples:
         >>> import mindspore
@@ -6576,17 +6744,17 @@ class RaggedRange(Primitive):
     """
     Returns a `RaggedTensor` containing the specified sequences of numbers.
 
-      Args:
+    Args:
         Tsplits (mindspore.dtype): An mindspore.dtype from: mindspore.int32, mindspore.int64.
 
-      Inputs:
+    Inputs:
         - **starts** (Tensor) - The starts of each range, whose type is int32, int64, float32 or float64,
           and shape is 0D or 1D.
         - **limits** (Tensor) - The limits of each range, whose type and shape should be same as input `starts`.
         - **deltas** (Tensor) - The deltas of each range, whose type and shape should be same as input `starts`,
           and each element in the tensor should not be equal to 0.
 
-      Outputs:
+    Outputs:
         - **rt_nested_splits** (Tensor) - The nested splits of the return `RaggedTensor`,
           and type of the tensor is `Tsplits`,
           shape of the tensor is equal to shape of input `starts` plus 1.
@@ -6596,10 +6764,10 @@ class RaggedRange(Primitive):
 
           - if type of the input `starts`, input `limits` and input `deltas`
             are int32 or int64, shape of the output `rt_dense_values` is equal to
-            sum(abs(limits[i] - starts[i]) + abs(deltas[i]) - 1) / abs(deltas[i])),
+            :math:`sum(abs(limits[i] - starts[i]) + abs(deltas[i] - 1) / abs(deltas[i]))`.
           - if type of the input `starts`, input `limits` and input `deltas`
             are float32 or float64, shape of the output `rt_dense_values` is equal to
-            sum(ceil(abs((limits[i] - starts[i]) / deltas[i]))).
+            :math:`sum(ceil(abs((limits[i] - starts[i]) / deltas[i])))`.
 
     Raises:
         TypeError: If any input is not Tensor.
@@ -6611,7 +6779,7 @@ class RaggedRange(Primitive):
         ValueError: If the shape of `starts`, `limits` and `deltas` are not same.
 
     Supported Platforms:
-        ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> raggedrange = ops.RaggedRange(Tsplits=mstype.int64)
@@ -6642,11 +6810,14 @@ class Trace(Primitive):
     Note:
         Input must be matrix, and complex number is not supported at present.
 
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
+
     Inputs:
         - **x** (Tensor) - A matrix to be calculated. The matrix must be two dimensional.
 
     Outputs:
-        Tensor, with the same data type as input `x`, and size equals to 1.
+        Tensor, 0D Tensor with 1 element, it has the same data type as input `x`.
 
     Raises:
         TypeError: If `x` is not a Tensor.
@@ -6660,7 +6831,17 @@ class Trace(Primitive):
         >>> trace = ops.Trace()
         >>> output = trace(x)
         >>> print(output)
-        15.
+        15.0
+        >>> x = Tensor(np.arange(1, 13).reshape(3, 4), mindspore.float32)
+        >>> trace = ops.Trace()
+        >>> output = trace(x)
+        >>> print(output)
+        18.0
+        >>> x = Tensor(np.arange(12, 0, -1).reshape(4, 3), mindspore.float32)
+        >>> trace = ops.Trace()
+        >>> output = trace(x)
+        >>> print(output)
+        24.0
     """
 
     @prim_attr_register
@@ -6670,32 +6851,36 @@ class Trace(Primitive):
 
 class Median(Primitive):
     """
-    Computes the median of elements of input tensor in the `axis` dimension. If `global_median` is True, computes the
-    median of all elements of tensor.
+    Computes the median and its corresponding indices of input tensor in the `axis` dimension.
+    If `global_median` is True, computes the  median of all elements of tensor.
 
     .. warning::
         When attr `global_median` is True, the value of the second output tensor `indices` is meaningless.
 
     Args:
-        global_median (bool): Whether the output tensor is the median of all input tensor elements or not.
-        axis (int): The dimension need to reduce. Default: 0.
-        keep_dims (bool): Whether the output tensor need to retain `axis` dimension or not. Default: False.
+        global_median (bool, optional): Whether the output tensor is the median of all
+            input tensor elements or not. Default: Fasle.
+        axis (int, optional): The specified dimension to compute median. Default: 0.
+        keep_dims (bool, optional): Whether the output tensor need to retain `axis` dimension or not. Default: False.
 
     Inputs:
-        - **x** (Tensor) - A Tensor, whose dtype is int16, int32, int64, float32 or float64.
+        - **x** (Tensor) - A Tensor to calculate median with. Supported dtype:int16, int32, int64, float32 or float64.
 
     Outputs:
-        - **y** (Tensor) - A Tensor, Has the same dtype as the `x`. If `global_median` is true, the `y` has only one
-          element. If `keep_dims` is true, the `y` has the same shape as the `x` except the shape of `y` in dimension
-          `axis` is size 1. Otherwise, the `y` lacks `axis` dimension than input.
-        - **indices** (Tensor) - A Tensor, Has the same shape as the `y`, but dtype is int64.
+        - **y** (Tensor) - Median, has the same dtype as the `x`.
+
+          - If `global_median` is True, the `y` has only one element.
+          - If `keep_dims` is True, the `y` has the same shape as the `x` except the size
+            of `y` in dimension `axis` is 1.
+          - Otherwise, the `y` lacks `axis` dimension than input.
+
+        - **indices** (Tensor) - Indices, Has the same shape as the `y`, with dtype int64.
 
     Raises:
-        TypeError: If dtype of `x` is not one of the following: int16, int32, int64, float32, double.
+        TypeError: If dtype of `x` is not one of the following: int16, int32, int64, float32, float64.
         TypeError: If input `x` is not a Tensor.
-        TypeError: If `global_median` is not a bool.
-        TypeError: If `axis` is not a int.
-        TypeError: If `keep_dims` is not a bool.
+        TypeError: If `global_median` or `keep_dims` is assigned a nonboolean value.
+        TypeError: If `axis` is not int.
         ValueError: If `axis` is not in range of [-x.dim, x.dim-1].
 
     Supported Platforms:
@@ -6703,20 +6888,18 @@ class Median(Primitive):
 
     Examples:
         >>> # case 1 : common median compute
-        >>> from mindspore import Tensor
-        >>> from mindspore.ops.operations.math_ops import Median
+        >>> from mindspore import Tensor, ops
         >>> import numpy as np
         >>> x = Tensor(np.array([[5, 1, 2],[3, 5, 7], [1, 6, 4]]).astype(np.int64))
-        >>> median = Median(global_median=False, axis=0, keep_dims=False)
+        >>> median = ops.Median(global_median=False, axis=0, keep_dims=False)
         >>> y = median(x)
         >>> print(y)
         (Tensor(shape=[3], dtype=Int64, value= [3, 5, 4]), Tensor(shape=[3], dtype=Int64, value= [1, 1, 2]))
         >>> # case 2 : global median compute
-        >>> from mindspore import Tensor
-        >>> from mindspore.ops.operations.math_ops import Median
+        >>> from mindspore import Tensor, ops
         >>> import numpy as np
         >>> x = Tensor(np.array([[1, 7, 6],[5, 1, 3],[9, 17, 1]]).astype(np.int32))
-        >>> median = Median(global_median=True)
+        >>> median = ops.Median(global_median=True)
         >>> y = median(x)
         >>> print(y)
         (Tensor(shape=[], dtype=Int32, value= 5), Tensor(shape=[], dtype=Int64, value= 0))
@@ -6762,15 +6945,14 @@ class SparseSegmentMean(Primitive):
 
 
 class Zeta(Primitive):
-    """
+    r"""
     Compute the Hurwitz zeta function ζ(x,q) of input Tensor.
 
     .. warning::
-        This is an experimental prototype that is subject to change and/or deletion.
+        This is an experimental API that is subject to change or deletion.
 
     .. math::
-
-        \\zeta \\left ( x,q \\right )=  \\textstyle \\sum_{n=0} ^ {\\infty} \\left (  q+n\\right )^{-x}
+        \zeta \left ( x,q \right )=  \textstyle \sum_{n=0} ^ {\infty} \left ( q+n\right )^{-x}
 
     Inputs:
         - **x** (Tensor) - A Tensor, types: float32, float64.
@@ -6806,25 +6988,28 @@ class Bernoulli(Primitive):
     """
     Randomly set the elements of output to 0 or 1 with the probability of P which follows the Bernoulli distribution.
 
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
+
     Refer to :func:`mindspore.ops.bernoulli` for more details.
 
     Supported Platforms:
-        ``GPU``
+        ``GPU`` ``CPU``
 
     Examples:
-        >>> input_x = Tensor(np.array([1, 2, 3]), mindspore.int8)
-        >>> bernoulli = Bernoulli()
-        >>> output = bernoulli(input_x, 1.0)
+        >>> input_x = Tensor([0.1, 0.2, 0.3], mindspore.float32)
+        >>> bernoulli = ops.Bernoulli()
+        >>> output = bernoulli(input_x, Tensor([1.0]))
         >>> print(output)
-        [1 1 1]
-        >>> input_p = Tensor(np.array([0.0, 1.0, 1.0]), mindspore.float32)
+        [1. 1. 1.]
+        >>> input_p = Tensor([0.0, 1.0, 1.0], mindspore.float32)
         >>> output = bernoulli(input_x, input_p)
         >>> print(output)
-        [0 1 1]
+        [0. 1. 1.]
     """
 
     @prim_attr_register
-    def __init__(self, seed=-1):
+    def __init__(self, seed=-1, offset=0):
         """Initialize Bernoulli"""
         self.init_prim_io_names(inputs=['x', 'p'], outputs=['y'])
         validator.check_value_type("seed", seed, [int], self.name)
@@ -6893,7 +7078,7 @@ class Renorm(Primitive):
     Refer to :func:`mindspore.ops.renorm` for more details.
 
     Supported Platforms:
-        ``Ascend`` ``CPU`` ``GPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([[1, 1, 1], [2, 2, 2], [3, 3, 3]]), mindspore.float32)
@@ -6918,13 +7103,16 @@ class Renorm(Primitive):
 
 class Cholesky(Primitive):
     """
-    Computes the Cholesky decomposition of a symmetric positive-definite matrix `A`
-    or for batches of symmetric positive-definite matrices.
+    Performs the Cholesky decomposition on a single or a batch of
+    symmetric positive-definite matrices.
+
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
     Refer to :func:`mindspore.ops.cholesky` for more details.
 
     Supported Platforms:
-        ``CPU``
+        ``GPU`` ``CPU``
 
     Examples:
         >>> input_x = Tensor(np.array([[1.0, 1.0], [1.0, 2.0]]), mindspore.float32)
@@ -6944,25 +7132,16 @@ class Cholesky(Primitive):
 
 class STFT(Primitive):
     """
-    STFTs can be used as a way of quantifying the change of a nonstationary signal’s
-    frequency and phase content over time.
+    Applies Short-time Fourier transform (STFT) on input signal.
 
-    Args:
-        n_fft (int): The size of Fourier transform.
-        hop_length (int): The distance between neighboring sliding window frames.
-        win_length (int): the size of window frame and STFT filter.
-        normalized (bool): controls whether to return the normalized STFT results.
-        onesided (bool): controls whether to return half of results to
-            avoid redundancy for real inputs.
-        return_complex (bool): If True, return a complex tensor. If False, return
-            a real tensor with an extra last dimension for the real and imaginary components.
+    STFT segments the signal into narrow time intervals and takes the Fourier transform
+    of each segment to quantify the change of a nonstationary signal’s frequency
+    and phase content over time.
 
-    Inputs:
-        - **x** (Tensor) - Time sequence of stft, must be either a 1-D time tensor or a 2-D tensor.
-        - **window** (Tensor) - the optional window function.
+    Refer to :func:`mindspore.ops.stft` for more details.
 
-    Outputs:
-        - **y** (Tensor) - A tensor containing the STFT result with shape described above.
+    Supported Platforms:
+        ``Ascend`` ``CPU``
 
     Examples:
         >>> import mindspore as ms
@@ -6990,21 +7169,22 @@ class STFT(Primitive):
 
 class CholeskySolve(Primitive):
     """
-    Given its Cholesky factor `u`, solves a linear system of equations with a positive definite matrix.
+    Computes the solution of a set of linear equations with a positive definite matrix,
+    according to its Cholesky decomposition factor `u` , and outputs the result as `c`.
 
-    If `upper` is `True`, `u` is upper triangular and `c` is returned such that:
+    If `upper` is set to `True`, `u` is upper triangular and `c` is returned such that:
 
     .. math::
         c = (u^{T}u)^{{-1}}b
 
-    If `upper` is `False`, `u` is lower triangular and `c` is returned such that:
+    If `upper` is set to `False`, `u` is lower triangular and `c` is returned such that:
 
     .. math::
         c = (uu^{T})^{{-1}}b
 
     Args:
-        upper (bool, optional): Flag which indicates whether to consider the Cholesky factor
-            as a lower or upper triangular matrix. Default: False.
+        upper (bool, optional): A flag indicates whether to treat the Cholesky factor
+            as an upper or a lower triangular matrix. Default: False.
 
     Inputs:
         - **x1** (Tensor) - Tensor of shape :math:`(*, N, M)`, indicating 2D or 3D matrices,
@@ -7027,7 +7207,7 @@ class CholeskySolve(Primitive):
         ValueError: If `x2` is not 2D or 3D square matrices.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x1 = Tensor(np.array([[1, 0, 0], [0, 1, 0], [0, 0, 1]]), mindspore.float32)
@@ -7079,21 +7259,33 @@ class FFTWithSize(Primitive):
     Args:
         signal_ndim (int): The number of dimensions in each signal, this controls how many dimensions
             of the fourier transform are realized, can only be 1, 2 or 3.
-        inverse (bool): Whether it is the inverse transformation, used to select FFT or IFFT and RFFT or
-            IRFFT. inverse=False means FFT or RFFT, inverse=True means IFFT or IRFFT.
-        real (bool): Whether it is the real transformation, used to select FFT/IFFT or RFFT/IRFFT.
-            real=False means FFT or IFFT, real=True means RFFT or IRFFT.
+        inverse (bool): Whether it is the inverse transformation.
+        real (bool): Whether it is the real transformation.
+
+            - "inverse:False real:False" corresponds to FFT.
+            - "inverse:True real:False" corresponds to IFFT.
+            - "inverse:False real:True" corresponds to RFFT.
+            - "inverse:True real:True" corresponds to IRFFT.
+
         norm (str, optional): The normalization, optional values: ["backward", "forward", "ortho"].
             Default value: "backward".
 
-            - "backward" has the direct (forward) transforms unscaled and the inverse (backward) transforms
-              scaled by 1/n, where n is the input x's element numbers.
-            - "ortho" has both direct and inverse transforms are scaled by :math:`1/\sqrt(n)` .
-            - "forward" has the direct transforms scaled by 1/n and the inverse transforms unscaled.
+            - "backward" has the direct transforms unscaled and the inverse transforms scaled by :math:`1/n`,
+              where n is the input x's element numbers.
+            - "ortho" has both direct and inverse transforms are scaled by :math:`1/\sqrt n`.
+            - "forward" has the direct transforms scaled by :math:`1/n` and the inverse transforms unscaled.
 
         onesided (bool, optional): Controls whether the input is halved to avoid redundancy. Default: True.
-        signal_sizes (list, optional): Size of the original signal (the signal before rfft, no batch dimension),
-            only in irfft mode and set onesided=true requires the parameter. Default: [].
+        signal_sizes (tuple, optional): Size of the original signal (the signal before rfft, no batch dimension),
+            only in IRFFT mode and set `onesided` to True requires the parameter, the following conditions must be
+            satisfied. Default: ().
+
+            - The length of `signal_sizes` is equal to the signal_ndim of the IRFFT:
+              :math:`len(signal_sizes)=signal_ndim`.
+            - The last dimension of `signal_sizes` divided by 2 is equal to
+              the last dimension of the IRFFT input: :math:`signal_size[-1]/2+1=x.shape[-1]`.
+            - `signal_sizes` has exactly the same dimensions as the input shape
+              except for the last dimension: :math:`signal_sizes[:-1]=x.shape[:-1]`.
 
     Inputs:
         - **x** (Tensor) - The dimension of the input tensor must be greater than or equal to signal_ndim.
@@ -7113,33 +7305,33 @@ class FFTWithSize(Primitive):
         ``GPU`` ``CPU``
 
     Examples:
-          >>> # case FFT: signal_ndim: 1, inverse: False, real: False.
-          >>> fft_in = Tensor(np.array([2, 1, 2]), mindspore.complex64)
-          >>> fft_net = math_ops.FFTWithSize(signal_ndim=1, inverse=False, real=False)
-          >>> fft_output = fft_net(fft_in)
-          >>> print(fft_output)
-          [5.0000005 +2.9802322e-08j 0.50000036+8.6602569e-01j
-           0.49999955-8.6602527e-01j]
-          >>> # case IFFT: signal_ndim: 1, inverse: True, real: False.
-          >>> ifft_in = fft_output
-          >>> ifft_net = math_ops.FFTWithSize(signal_ndim=1, inverse=True, real=False)
-          >>> ifft_output = ifft_net(ifft_in)
-          >>> print(ifft_output)
-          [2.       +1.291434e-07j 1.0000004+7.947286e-08j 2.0000005-7.947286e-08j]
-          >>> # case RFFT2D: signal_ndim: 2, inverse: False, real: True.
-          >>> rfft_in = Tensor(np.array([[2, 1, 2], [3, 1, 6]]), mindspore.float32)
-          >>> rfft_net = math_ops.FFTWithSize(signal_ndim=2, inverse=False, real=True)
-          >>> rfft_output = rfft_net(rfft_in)
-          >>> print(rfft_output)
-          [[ 1.5000001e+01+2.0954278e-07j  1.1920929e-06+5.1961541e+00j]
-           [-5.0000005e+00-5.9604645e-08j  9.9999934e-01-3.4641027e+00j]]
-          >>> # case IRFFT2D: signal_ndim: 2, inverse: True, real: True.
-          >>> irfft_in = rfft_output
-          >>> irfft_net = math_ops.FFTWithSize(signal_ndim=2, inverse=True, real=True, signal_sizes=rfft_in.shape)
-          >>> irfft_output = irfft_net(irfft_in)
-          >>> print(irfft_output)
-          [[2.0000002  0.99999976 2.0000005 ]
-          [3.0000007  0.999999   6.000002  ]]
+        >>> # case FFT: signal_ndim: 1, inverse: False, real: False.
+        >>> fft_in = Tensor(np.array([2, 1, 2]), mindspore.complex64)
+        >>> fft_net = ops.FFTWithSize(signal_ndim=1, inverse=False, real=False)
+        >>> fft_output = fft_net(fft_in)
+        >>> print(fft_output)
+        [5.        +0.j         0.5       +0.86602545j 0.50000006-0.8660255j ]
+        >>> # case IFFT: signal_ndim: 1, inverse: True, real: False.
+        >>> ifft_in = fft_output
+        >>> ifft_net = ops.FFTWithSize(signal_ndim=1, inverse=True, real=False)
+        >>> ifft_output = ifft_net(ifft_in)
+        >>> print(ifft_output)
+        [2.        -1.9868216e-08j 0.99999994+0.0000000e+00j
+         1.9999999 +7.9472862e-08j]
+        >>> # case RFFT2D: signal_ndim: 2, inverse: False, real: True.
+        >>> rfft_in = Tensor(np.array([[2, 1, 2], [3, 1, 6]]), mindspore.float32)
+        >>> rfft_net = ops.FFTWithSize(signal_ndim=2, inverse=False, real=True)
+        >>> rfft_output = rfft_net(rfft_in)
+        >>> print(rfft_output)
+        [[ 1.5000000e+01+1.1920929e-07j -2.3841858e-07+5.1961522e+00j]
+         [-5.0000000e+00-2.9802322e-08j  9.9999988e-01-3.4641016e+00j]]
+        >>> # case IRFFT2D: signal_ndim: 2, inverse: True, real: True.
+        >>> irfft_in = rfft_output
+        >>> irfft_net = ops.FFTWithSize(signal_ndim=2, inverse=True, real=True, signal_sizes=rfft_in.shape)
+        >>> irfft_output = irfft_net(irfft_in)
+        >>> print(irfft_output)
+        [[2.         1.         2.        ]
+         [3.         0.99999994 5.9999995 ]]
     """
 
     @prim_attr_register
@@ -7155,34 +7347,12 @@ class FFTWithSize(Primitive):
 
 class Polar(Primitive):
     r"""
-    Returns a complex tensor whose elements are Cartesian coordinates corresponding to the polar
-    coordinates with absolute value and angle.
-
-    .. math::
-
-        y_{i} =  abs_{i} * cos(angle_{i}) + abs_{i} * sin(angle_{i}) * j
+    Converts polar coordinates to Cartesian coordinates.
 
-    Inputs:
-        - **abs** (Tensor) - The shape of tensor is
-          :math:`(N,*)` where :math:`N` means the batchsize of the input tensor,
-          math:`*` means, any number of additional dimensions.
-          Must be one of the following types: float32, float64.
-
-        - **angle** (Tensor) - The shape of tensor is
-          the same as the input tensor abs.
-          Must be the same type as the input tensor abs.
-
-    Outputs:
-        Tensor, has the same shape and data type as `abs`.
-
-    Raises:
-        TypeError: If neither `abs` nor `angle` is a Tensor.
-        TypeError: If the dtype of input is not one of: float32, float64.
-        TypeError: If the dtypes of two inputs are not the same.
-        ValueError: If `abs`'s shape is not the same as `angle`.
+    Refer to :func:`mindspore.ops.polar` for more details.
 
     Supported Platforms:
-        ``GPU``
+        ``GPU`` ``CPU``
 
     Examples:
         >>> polar = ops.Polar()
@@ -7203,15 +7373,19 @@ class NextAfter(Primitive):
     """
     Returns the next representable floating-point value after `x1` towards `x2` element-wise.
 
-    Say there are two float32 numbers :math:`a`, :math:`b`, and let the
+    Say there are two float32 numbers :math:`a, b`, and let the
     representable delta of float32 datatype is :math:`eps`. If :math:`a < b`,
     then the next representable of :math:`a` towards :math:`b` is :math:`a+eps`,
+    If :math:`a > b`,
     the next representable of :math:`b` towards :math:`a` is :math:`b-eps`.
 
     .. math::
 
         out_{i} =  nextafter({x1_{i}, x2_{i}})
 
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
+
     Inputs:
         - **x1** (Tensor) - The shape of tensor is
           :math:`(N,*)` where :math:`*` means, any number of additional dimensions.
@@ -7231,7 +7405,7 @@ class NextAfter(Primitive):
         ValueError: If `x1`'s shape is not the same as `x2`.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> nextafter = ops.NextAfter()
@@ -7250,16 +7424,13 @@ class NextAfter(Primitive):
 
 class TrilIndices(Primitive):
     r"""
-    Returns the indices of the lower triangular part of a `row` -by- `col` matrix in a Tensor.
-    The Tensor has a shape :math:`(2, tril\_size)` where :math:`tril\_size` is the number of
-    elements in the lower triangular matrix. The first row contains row coordinates of
-    all indices and the second row contains column coordinates.
-    Indices are ordered based on rows and then columns.
+    Calculates the indices of the lower triangular elements in a `row` * `col` matrix
+    and returns them as a 2-by-N Tensor.
 
-    The lower triangular part of the matrix is defined as the elements on and below the diagonal.
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
-    Note:
-        When running on CUDA, row * col must be less than 2^59 to prevent overflow during calculation.
+    Refer to :func:`mindspore.ops.tril_indices` for more details.
 
     Args:
         row (int): number of rows in the 2-D matrix.
@@ -7273,13 +7444,8 @@ class TrilIndices(Primitive):
           The shape of output is :math:`(2, tril\_size)`, where :math:`tril\_size` is the number of elements in the
           lower triangular matrix.
 
-    Raises:
-        TypeError: If `row`, `col` or `offset` is not an int.
-        TypeError: If `dtype` is neither int32 nor int64.
-        ValueError: If `row` or `col` < 0.
-
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> net = ops.TrilIndices(4, 3, -1, mstype.int64)
@@ -7295,8 +7461,8 @@ class TrilIndices(Primitive):
     def __init__(self, row, col, offset=0, dtype=mstype.int32):
         """Initialize TrilIndices"""
         self.init_prim_io_names(inputs=[], outputs=['y'])
-        validator.check_int(row, 0, Rel.GE, "row", self.name)
-        validator.check_int(col, 0, Rel.GE, "col", self.name)
+        validator.check_int(row, 0, validator.GE, "row", self.name)
+        validator.check_int(col, 0, validator.GE, "col", self.name)
         validator.check_value_type("offset", offset, [int], self.name)
         valid_values = (mstype.int32, mstype.int64)
         validator.check_type_name("dtype", dtype, valid_values, self.name)
@@ -7304,14 +7470,17 @@ class TrilIndices(Primitive):
 
 class MatrixTriangularSolve(Primitive):
     r"""
-    Returns a new tensor with the solotion of a linear equation system with an
+    Returns a new tensor with the solution of a linear equation system with an
     upper or lower triangular matrix.
 
+    Note:
+        Only GPU platforms now support the broadcast mechanism.
+
     Args:
         lower (bool, optional): If True, the innermost matrices in `matrix` is
             are lower triangular. Default: True.
-        adjoint (bool, optional): If True, solve with the adjoint of `matrix`.
-            Default: False.
+        adjoint (bool, optional): Indicates whether the adjoint of the
+            matrix is used during the computation. Default: False,  use its transpose instead.
 
     Inputs:
         - **matrix** (Tensor) - Tensor of shape :math:`(*, M, M)`,
@@ -7325,24 +7494,26 @@ class MatrixTriangularSolve(Primitive):
     Raises:
         TypeError: If `matrix` or `rhs` is not a Tensor.
         TypeError: If `lower` or `adjoint` is not bool.
-        ValueError: If the batch sizes of `matrix` and `rhs` are not equal.
+        ValueError: For GPU platform, if the batch sizes of `matrix` and `rhs` do not satisfy broadcasting rules.
+            For other platforms, if the batch sizes of `matrix` and `rhs` are not equal.
         ValueError: If the inner-most 2 dimensions of `matrix` are not equal.
         ValueError: If the second-last dimensions of `matrix` and `rhs` are not equal.
 
     Supported Platforms:
-        ``Ascend`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> matrix_triangular_solve = ops.MatrixTriangularSolve(lower=True, adjoint=False)
-        >>> a = np.array([[3, 0, 0, 0], [2, 1, 0, 0], [1, 0, 1, 0], [1, 1, 1, 1]])
-        >>> b = np.array([[1, 0],[2, 2],[1, 5],[0, 3]])
-        >>> output = matrix_triangular_solve(Tensor(a, mindspore.float32), Tensor(b, mindspore.float32))
+        >>> matrix = np.array([[3, 0, 0, 0], [2, 1, 0, 0], [1, 0, 1, 0], [1, 1, 1, 1]])
+        >>> rhs = np.array([[1, 0],[2, 2],[1, 5],[0, 3]])
+        >>> output = matrix_triangular_solve(Tensor(matrix, mindspore.float32), Tensor(rhs, mindspore.float32))
         >>> print(output)
         [[ 0.33333334  0.        ]
          [ 1.3333333   2.        ]
          [ 0.6666666   5.        ]
          [-2.3333333  -4.        ]]
     """
+
     @prim_attr_register
     def __init__(self, lower=True, adjoint=False):
         """Initialize MatrixTriangularSolve"""
@@ -7356,7 +7527,8 @@ class CompareAndBitpack(Primitive):
 
     Each comparison returns a boolean true (if x_value > threshold) or and false otherwise.
 
-    Given an `x` shaped `[s0, s1, ..., s_n]`, the output is a `uint8` tensor shaped `[s0, s1, ..., s_n / 8]`.
+    Given an `x` shaped :math:`(s_0, s_1, ..., s_n)`, the output is a `uint8`
+    Tensor shaped :math:`(s_0, s_1, ..., s_n / 8)`.
 
     Inputs:
         - **x** (Tensor) - Input tensor. Values to compare against `threshold` and bitpack. The data type must be
@@ -7376,7 +7548,7 @@ class CompareAndBitpack(Primitive):
         ValueError: If the innermost dimension of `x`'s shape is not disvisible by 8.
 
     Supported Platforms:
-        ``Ascend`` ``GPU`` ``CPU``
+        ``Ascend`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([1, 2, 3, 4, 5, 6, 7, 8]), mindspore.float32)
@@ -7394,29 +7566,13 @@ class CompareAndBitpack(Primitive):
 
 class NanToNum(Primitive):
     """
-    Replaces `NaN`, positive infinity, and negative infinity values in the `x` with the values
-    specified by `nan`, `posinf`, and `neginf`, respectively. By default, NaN is replaced by 0,
-    positive infinity is replaced by the largest finite value representable by the x dtype,
-    and negative infinity is replaced by the smallest finite value representable by the x dtype.
-
-    Args:
-        nan (float): The value to replace `NaN`. Default value is 0.0.
-        posinf (float): If a Number, the value to replace positive infinity values with. If None, positive
-          infinity values are replaced with the greatest finite value representable by `x`'s dtype.
-          Default value is None.
-        neginf (float): if a Number, the value to replace negative infinity values with. If None, negative
-          infinity values are replaced with the lowest finite value representable by `x`'s dtype.
-          Default value is None.
+    Replaces `NaN`, positive infinity and negative infinity values in the input Tensor with the values
+    specified by `nan`, `posinf` and `neginf` respectively.
 
-    Inputs:
-        - **x** (Tensor) - The shape of tensor is :math:`(x_1, x_2, ..., x_R)`. With float32 or float16 data type.
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
-    Outputs:
-        Tensor, has the same shape and dtype as the `x`.
-
-    Raises:
-        TypeError: If `x` is not a Tensor.
-        TypeError: If dtype of `x` is not float16 or float32.
+    Refer to :func:`mindspore.ops.nan_to_num` for more details.
 
     Supported Platforms:
         ``Ascend`` ``CPU``
@@ -7448,12 +7604,16 @@ class NanToNum(Primitive):
 
 class Orgqr(Primitive):
     r"""
-    Computes the first :math:`N` columns of a product of Householder matrices.
+    Calculates the explicit representation of the orthogonal matrix :math:`Q`
+    returned by :class:`mindspore.ops.Geqrf`.
+
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
     Refer to :func:`mindspore.ops.orgqr` for more details.
 
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> x = Tensor(np.array([[-114.6, 10.9, 1.1], [-0.304, 38.07, 69.38], [-0.45, -0.17, 62.]]), mindspore.float32)
@@ -7474,16 +7634,13 @@ class Orgqr(Primitive):
 
 class TriuIndices(Primitive):
     r"""
-    Returns the indices of the upper triangular part of a `row` -by- `col` matrix in a Tensor.
-    The Tensor has a shape :math:`(2, tril\_size)` where :math:`tril\_size` is the number of
-    elements in the upper triangular matrix. The first row contains row coordinates of
-    all indices and the second row contains column coordinates.
-    Indices are ordered based on rows and then columns.
+    Calculates the indices of the upper triangular elements in a `row` * `col` matrix
+    and returns them as a 2-by-N Tensor.
 
-    The upper triangular part of the matrix is defined as the elements on and above the diagonal.
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
 
-    Note:
-        When running on CUDA, row * col must be less than 2^59 to prevent overflow during calculation.
+    Refer to :func:`mindspore.ops.triu_indices` for more details.
 
     Args:
         row (int): number of rows in the 2-D matrix.
@@ -7497,13 +7654,8 @@ class TriuIndices(Primitive):
           The shape of output is :math:`(2, tril\_size)`, where :math:`tril\_size` is the number of elements in the
           lower triangular matrix.
 
-    Raises:
-        TypeError: If `row`, `col` or `offset` is not an int.
-        TypeError: If `dtype` is neither int32 nor int64.
-        ValueError: If `row` or `col` < 0.
-
     Supported Platforms:
-        ``GPU`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> net = ops.TriuIndices(5, 4, 2, mstype.int64)
@@ -7519,21 +7671,80 @@ class TriuIndices(Primitive):
     def __init__(self, row, col, offset=0, dtype=mstype.int32):
         """Initialize TriuIndices"""
         self.init_prim_io_names(inputs=[], outputs=['y'])
-        validator.check_int(row, 0, Rel.GE, "row", self.name)
-        validator.check_int(col, 0, Rel.GE, "col", self.name)
+        validator.check_int(row, 0, validator.GE, "row", self.name)
+        validator.check_int(col, 0, validator.GE, "col", self.name)
         validator.check_value_type("offset", offset, [int], self.name)
         valid_values = (mstype.int32, mstype.int64)
         validator.check_type_name("dtype", dtype, valid_values, self.name)
 
 
+class Fmin(Primitive):
+    """
+    Computes the minimum of input tensors element-wise.
+
+    Refer to :func:`mindspore.ops.fmin` for more detail.
+
+    Supported Platforms:
+
+
+    Examples:
+        >>> x1 = Tensor(np.array([1.0, 5.0, 3.0]), mstype.float32)
+        >>> x2 = Tensor(np.array([4.0, 2.0, 6.0]), mstype.float32)
+        >>> fmin = ops.Fmin()
+        >>> output = fmin(x1, x2)
+        >>> print(output)
+        [1. 2. 3.]
+    """
+
+    __mindspore_signature__ = (sig.sig_dtype.T, sig.sig_dtype.T)
+
+    @prim_attr_register
+    def __init__(self):
+        """Initialize Fmin"""
+        self.add_prim_attr('ignore_nan', True)
+        self.init_prim_io_names(inputs=['x1, x2'], outputs=['y'])
+
+
+class Fmax(Primitive):
+    """
+    Computes the maximum of input tensors element-wise.
+
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
+
+    Refer to :func:`mindspore.ops.fmax` for more detail.
+
+    Supported Platforms:
+        ``CPU``
+
+    Examples:
+        >>> x1 = Tensor(np.array([1.0, 5.0, 3.0]), mindspore.float32)
+        >>> x2 = Tensor(np.array([4.0, 2.0, 6.0]), mindspore.float32)
+        >>> fmax = ops.Fmax()
+        >>> output = fmax(x1, x2)
+        >>> print(output)
+        [4. 5. 6.]
+    """
+
+    __mindspore_signature__ = (sig.sig_dtype.T, sig.sig_dtype.T)
+
+    @prim_attr_register
+    def __init__(self):
+        """Initialize Fmax"""
+        self.add_prim_attr('ignore_nan', True)
+        self.init_prim_io_names(inputs=['x1, x2'], outputs=['y'])
+
+
 class Eig(Primitive):
     """
     Computes the eigenvalues and eigenvectors of a square matrix(batch square matrices).
 
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
+
     Args:
         compute_v (bool, optional): If `True`, compute both eigenvalues and eigenvectors;
             If `False`, just eigenvalues will be computed. Default: False.
-
     Inputs:
         - **x** (Tensor) - Square matrices of shape :math:`(*, N, N)`,
           with float32, float64, complex64 or complex128 data type.
@@ -7611,6 +7822,7 @@ class SelfAdjointEig(Primitive):
            [[1.  0.]
             [0.  1.]]
     """
+
     @prim_attr_register
     def __init__(self, compute_v=True):
         """Initialize SelfAdjointEig."""
@@ -7623,13 +7835,16 @@ class Qr(Primitive):
     Returns the QR decomposition of one or more matrices. If `full_matrices` is true, compute full-sized q and r,
     If False (the default), compute the P columns of q where P is minimum of the 2 innermost dimensions of x.
 
+    .. warning::
+        This is an experimental API that is subject to change or deletion.
+
     Args:
         full_matrices (bool, optional): Whether compute full-sized QR decomposition. Default: False.
 
     Inputs:
         - **x** (Tensor) - A matrix to be calculated. The matrix must be at least two dimensions.
           types: float16, float32, float64, complex64, complex128.
-          Define the shape of x as (..., m, n), p as the minimum values of m and n.
+          Define the shape of x as :math:`(..., m, n)` p as the minimum values of m and n.
 
     Outputs:
         - **q** (Tensor) - The orthonormal matrices of x.
@@ -7645,20 +7860,20 @@ class Qr(Primitive):
         ValueError: If the dimension of `x` is less than 2.
 
     Supported Platforms:
-        ``Ascend`` ``CPU``
+        ``Ascend`` ``GPU`` ``CPU``
 
     Examples:
         >>> qr_op = ops.Qr(full_matrices=False)
-        >>> x = Tensor([[12., -51, 4], [6, 167, -68], [-4, 24, -41]], mstype.float32)
+        >>> x = Tensor([[20., -31, 7], [4, 270, -90], [-8, 17, -32]], mstype.float32)
         >>> q, r = qr_op(x)
         >>> print(q)
-        [[-0.8571428   0.39428577  0.3314286 ]
-        [-0.42857143 -0.90285724 -0.03428572]
-        [ 0.2857143  -0.17142859  0.94285715]]
+        [[-0.912871    0.16366126  0.37400758]
+         [-0.18257418 -0.9830709  -0.01544376]
+         [ 0.36514837 -0.08238228  0.92729706]]
         >>> print(r)
-        [[ -14.        -21.000008   13.999999]
-        [   0.       -175.         70.000015]
-        [   0.          0.        -34.999996]]
+        [[ -21.908903  -14.788506  -1.6431675]
+        [    0.       -271.9031    92.25824  ]
+        [    0.          0.       -25.665514 ]]
     """
 
     @prim_attr_register
@@ -7670,6 +7885,7 @@ class Qr(Primitive):
 class Cauchy(Primitive):
     r"""
     Create a tensor of shape `size` with random numbers drawn from Cauchy distribution.
+    It is defined as follows:
 
     .. math::
         f(x)= \frac{1}{\pi} \frac{\sigma}{(x-median)^2 +\sigma^2}
@@ -7715,21 +7931,23 @@ class Ormqr(Primitive):
     r"""
     Computes the matrix-matrix multiplication of a product of Householder matrices with a general matrix.
     Multiplies a(m, n) matrix C (given by other) with a matrix Q, where Q is represented using Householder
-    reflectors (x, tau), which is the output of torch.geqrf().
+    reflectors (x, tau), which is the output of geqrf().
 
     Args:
         left (bool, optional): controls the order of multiplication. If true, compute op(Q)*C.
-                               If false, compute C*op(Q). Default: True.
+            If false, compute C*op(Q). Default: True.
         transpose(bool, optional): controls whether the matrix Q is conjugate transposed or not.Default: False.
 
     Inputs:
-        - **x** (Tensor) - Tensor of shape: (*, mn, k) where mn equals to m or n depending on the left.
-          with float32, float64, complex64 and complex128 data type.
-        - **tau** (Tensor) - Tensor of shape (*, min(mn, k)) which have the same type as x.
-        - **other** (Tensor) - tensor of shape (*, m, n) where * is zero or more batch dimensions.
+        - **x** (Tensor) - Tensor of shape: (*, mn, k) where mn equals to m or n depending on the the args of `left`,
+          and `*` is zero or more batch dimensions.
+        - **tau** (Tensor) - Tensor of shape (*, min(mn, k)) where `*` is zero or more batch dimensions,
+          and its type is the same as `x`.
+        - **other** (Tensor) - Tensor of shape (*, m, n) where `*` is zero or more batch dimensions,
+          and its type is the same as `x`.
 
     Outputs:
-        - **y** (Tensor) - the output Tensor.
+        - **y** (Tensor) - the output Tensor, has the same shape and data type as `other`.
 
     Raises:
         TypeError: If `x` or `tau` or `other` is not Tensor.
@@ -7759,6 +7977,7 @@ class Ormqr(Primitive):
          [ -53.659264  -28.157839  -70.42702 ]
          [ -79.54292    24.00183   -41.34253 ]]
     """
+
     @prim_attr_register
     def __init__(self, left=True, transpose=False):
         """Initialize Ormqr"""
@@ -7775,8 +7994,20 @@ class Roll(Primitive):
 
     Refer to :func:`mindspore.ops.roll` for more details.
 
+    Args:
+        shift (Union[list(int), tuple(int), int]): Specifies the number of places by which elements are shifted
+            positively (towards larger indices) along the specified dimension. Negative shifts will roll the elements
+            in the opposite direction.
+        axis (Union[list(int), tuple(int), int]): Specifies the dimension indexes of shape to be rolled.
+
+    Inputs:
+        - **input_x** (Tensor) - Input tensor.
+
+    Outputs:
+        Tensor, has the same shape and type as `input_x`.
+
     Supported Platforms:
-        ``Ascend`` ``GPU``
+        ``GPU``
 
     Examples:
         >>> input_x = Tensor(np.array([0, 1, 2, 3, 4]).astype(np.float32))
@@ -7808,5 +8039,5 @@ class Roll(Primitive):
                 validator.check_equal_int(len(axis), 1, "shift size", self.name)
                 validator.check_equal_int(axis[0], 0, "axis", self.name)
             elif isinstance(shift, int) and isinstance(axis, int):
-                validator.check_equal_int(axis, 0, "axis", self.name)
+                validator.check_is_int(axis, "axis", self.name)
         self.init_prim_io_names(inputs=['input_x'], outputs=['output'])