mindspore 2.6.0rc1__cp39-cp39-win_amd64.whl → 2.7.0rc1__cp39-cp39-win_amd64.whl

mindspore/common/_tensor_docs.py

@@ -322,8 +322,7 @@ Examples:
 Tests if any element in tensor evaluates to `True` along the given axes.
 
 Args:
-    dim (Union[int, tuple(int), list(int), Tensor], optional): The dimensions to reduce. If ``None`` ,
-          all dimensions are reduced. Default ``None`` .
+    dim (int, optional): The dimensions to reduce. If ``None`` , all dimensions are reduced. Default ``None`` .
     keepdim (bool, optional): Whether the output tensor has dim retained or not. Default ``False`` .
 
 Returns:
@@ -343,15 +342,6 @@ Examples:
     >>> # case 2: Reduces a dimension along dim 1, with keepdim False.
     >>> x.any(dim=1)
     Tensor(shape=[2], dtype=Bool, value= [ True,  True])
-    >>>
-    >>> # case 3: Reduces a dimension along dim (0, 1), with keepdim False.
-    >>> x.any(dim=(0,1))
-    Tensor(shape=[], dtype=Bool, value= True)
-    >>>
-    >>> # case 4: Reduces a dimension along dim [0, 1], with keepdim True.
-    >>> x.any(dim=[0,1], keepdim=True)
-    Tensor(shape=[1, 1], dtype=Bool, value=
-    [[ True]])
 """)
 attach_docstr("arccosh", r"""arccosh() -> Tensor
 
@@ -718,7 +708,7 @@ Examples:
 attach_docstr("ceil", r"""ceil() -> Tensor
 
 For details, please refer to :func:`mindspore.ops.ceil`.""")
-attach_docstr("chunk", r"""chunk(chunks, dim=0) -> Tuple of Tensors
+attach_docstr("chunk", r"""chunk(chunks, dim=0) -> tuple[Tensor]
 
 Cut the self Tensor into `chunks` sub-tensors along the specified dimension.
 
@@ -756,7 +746,7 @@ Examples:
         Tensor(shape=[3], dtype=Float32, value= [ 3.00000000e+00,  4.00000000e+00,  5.00000000e+00]),
         Tensor(shape=[3], dtype=Float32, value= [ 6.00000000e+00,  7.00000000e+00,  8.00000000e+00]))
 
-.. method:: Tensor.chunk(chunks, axis=0) -> Tuple of Tensors
+.. method:: Tensor.chunk(chunks, axis=0) -> tuple[Tensor]
     :noindex:
 
 Cut the self Tensor into `chunks` sub-tensors along the specified axis.
@@ -2234,7 +2224,7 @@ Examples:
 
 For details, please refer to :func:`mindspore.ops.mean` .
 """)
-attach_docstr("median", r"""median(axis=-1, keepdims=False) -> Tuple of Tensors
+attach_docstr("median", r"""median(axis=-1, keepdims=False) -> tuple[Tensor]
 
 Computes the median and indices of input tensor.
 
@@ -2283,7 +2273,7 @@ Returns:
 Supported Platforms:
     ``Ascend``
 
-.. method:: Tensor.median(dim=-1, keepdim=False) -> Tuple of Tensors
+.. method:: Tensor.median(dim=-1, keepdim=False) -> tuple[Tensor]
     :noindex:
 
 Output the median on the specified dimension ``dim`` and its corresponding index.
@@ -2664,6 +2654,77 @@ attach_docstr("neg", r"""neg() -> Tensor
 
 For details, please refer to :func:`mindspore.ops.neg`.
 """)
+attach_docstr("new_empty", r"""new_empty(size, *, dtype=None, device=None) -> Tensor
+
+Returns an uninitialized Tensor. Its shape is specified by `size`, its dtype is specified by `dtype` and its
+device is specified by `device`.
+
+.. warning::
+    This is an experimental API that is subject to change or deletion.
+
+Args:
+    size (Union[tuple[int], list[int], int]): The specified shape of output tensor. Only positive integer or
+        tuple or list containing positive integers are allowed.
+
+Keyword Args:
+    dtype (:class:`mindspore.dtype`, optional): The specified dtype of the output tensor. If `dtype = None`,
+        the tensor will have the same dtype as `self`. Default ``None``.
+    device (string, optional): The specified device of the output tensor. In PyNative mode, ``"Ascend"``, ``"npu"``,
+        ``"cpu"`` and ``"CPU"`` are supported. In graph mode O0, ``"Ascend"`` and ``"npu"`` are supported. If `device = None`,
+        the value set by :func:`mindspore.set_device` will be used. Default ``None``.
+
+Returns:
+    Tensor, whose shape, dtype and device are defined by input but with uninitialized data (May be a random value).
+
+Raises:
+    TypeError: If `size` is neither an int nor a tuple or list of int.
+
+Supported Platforms:
+    ``Ascend`` ``CPU``
+
+Examples:
+    >>> import mindspore
+    >>> from mindspore import Tensor
+    >>> x = Tensor([[1, 2, 3], [4, 5, 6]])
+    >>> output1 = x.new_empty((2, 3))
+    >>> print(output1)
+    [[0 0 0]
+     [0 0 0]]
+    >>> output2 = x.new_empty((2, 3), dtype=mindspore.float64)
+    >>> print(output2)
+    [[0. 0. 0.]
+     [0. 0. 0.]]
+""")
+attach_docstr("new_full", r"""new_full(size, fill_value, *, dtype=None) -> Tensor
+
+Return a tensor of `size` filled with `fill_value`.
+
+Args:
+    size (Union[tuple(int), list(int)]): The output shape.
+    fill_value (Union[Number, bool]): The value to fill the output tensor.
+
+Keyword Args:
+    dtype (:class:`mindspore.dtype`, optional): The desired data type of returned Tensor. If None, the returned tensor has the same dtype as `self`. Default: ``None``.
+
+Returns:
+    Tensor, the shape and dtype is defined above and filled with `fill_value`.
+
+Raises:
+    TypeError: If `size` is not a tuple or list of int.
+    TypeError: If `dtype` is not a MindSpore dtype.
+    ValueError: If `size` contains negative values.
+
+Supported Platforms:
+    ``Ascend``
+
+Examples:
+    >>> from mindspore import Tensor
+    >>> x = Tensor([1, 2, 3, 4], mindspore.int32)
+    >>> output = x.new_full((2, 3), 3)
+    >>> print(output)
+    [[3 3 3]
+     [3 3 3]]
+""")
 attach_docstr("new_ones", r"""new_ones(size, dtype=None) -> Tensor
 
 Return a tensor of `size` filled with ones.
@@ -3729,7 +3790,7 @@ Supported Platforms:
 Examples:
     >>> import mindspore
     >>> from mindspore import Tensor
-    >>> input = Tensor([[2, 3, 4, 5],[3, 2, 4, 5]])
+    >>> input = Tensor([[2, 3, 4, 5], [3, 2, 4, 5]])
     >>> y = Tensor.select(input, 0, 0)
     >>> print(y)
     [2 3 4 5]