mindspore/docs/api/api_python/ops/mindspore.ops.Tile.rst

26 lines
1.6 KiB
ReStructuredText
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

mindspore.ops.Tile
===================
.. py:class:: mindspore.ops.Tile
按照给定的次数复制输入Tensor。
更多参考详见 :func:`mindspore.ops.tile`
输入:
- **input** (Tensor) - 需要被复制的Tensor设其shape为 :math:`(x_1, x_2, ..., x_S)`
- **dims** (tuple[int]) - 指定复制次数的参数参数类型为tuple数据类型为整数:math:`(y_1, y_2, ..., y_S)` ,只支持常量值。
.. note::
在Ascend平台上 `dims` 参数的个数不大于8当前不支持超过4个维度同时做repeat的场景。
输出:
Tensor具有与 `input` 相同的数据类型。假设 `dims` 的长度为 `d` `input` 的维度为 `input.dim` `input` 的shape为 :math:`(x_1, x_2, ..., x_S)`
- 如果 `input.dim = d` 将其相应位置的shape相乘输出的shape为 :math:`(x_1*y_1, x_2*y_2, ..., x_S*y_S)`
- 如果 `input.dim < d` ,在 `input` 的shape的前面填充1直到它们的长度一致。例如将 `input` 的shape设置为 :math:`(1, ..., x_1, x_2, ..., x_S)` 然后可以将其相应位置的shape相乘输出的shape为 :math:`(1*y_1, ..., x_R*y_R, x_S*y_S)`
- 如果 `input.dim > d` ,在 `dims` 的前面填充1直到它们的长度一致。例如将 `dims` 设置为 :math:`(1, ..., y_1, y_2, ..., y_S)` 然后可以将其相应位置的shape相乘输出的shape为 :math:`(x_1*1, ..., x_R*y_R, x_S*y_S)`
异常:
- **TypeError** - `dims` 不是tuple或者其元素并非全部是int。
- **ValueError** - `dims` 的元素并非全部大于或等于0。