forked from mindspore-Ecosystem/mindspore
46 lines
3.1 KiB
ReStructuredText
46 lines
3.1 KiB
ReStructuredText
mindspore.ops.interpolate
|
||
=========================
|
||
|
||
.. py:function:: mindspore.ops.interpolate(x, roi=None, scales=None, sizes=None, coordinate_transformation_mode="align_corners", mode="linear")
|
||
|
||
使用 `mode` 设置的插值方式调整输入 `x` 大小。
|
||
|
||
.. warning::
|
||
- 实验特性，接口可能发生变化。
|
||
- `roi` 是保留输入， `crop_and_resize` 坐标变换模式下生效，当前不支持。
|
||
- Ascend平台下，当前不支持将 `mode` 设置为"linear"。
|
||
- CPU平台下，当 `mode` 是"bilinear"时，当前不支持将 `coordinate_transformation_mode` 设置为"half_pixel"。
|
||
|
||
参数：
|
||
- **x** (Tensor) - 输入Tensor。当 `mode` 是"linear"时， `x` 为三维Tensor。当 `mode` 是"bilinear"时， `x` 为四维Tensor。
|
||
- **roi** (tuple[float]，可选) - 在 `crop_and_resize` 坐标变换模式下生效，当前不支持。
|
||
- **scales** (tuple[float]，可选) - 输入shape每个维度resize的系数。 `scales` 中的数全是正数。 `scales` 的长度跟 `x` 的shape长度相同。 `scales` 和 `sizes` 同时只能指定一个。
|
||
- **sizes** (tuple[int]，可选) - 输入shape指定轴的新维度。 `sizes` 中的数全是正数。 `scales` 和 `sizes` 同时只能指定一个。当 `mode` 是"linear"时， `sizes` 为1个int元素 :math:`(new\_width,)` 的tuple。当 `mode` 是"bilinear"时， `sizes` 为2个int元素 :math:`(new\_height, new\_width)` 的tuple。
|
||
- **coordinate_transformation_mode** (str) - 指定进行坐标变换的方式，默认值是"align_corners"，还可选"half_pixel"和"asymmetric"。
|
||
假如我们需要将输入Tensor的x轴进行resize。我们记 `new_i` 为resize之后的Tenosr沿x轴的第i个坐标；记 `old_i` 为输入Tensor沿x轴的对应坐标；
|
||
记 `new_length` 是resize之后的Tensor沿着x轴的长度，记 `old_length` 是输入Tensor沿x轴的长度。我们可以通过下面的公式计算出来 `old_i` ：
|
||
|
||
.. code-block::
|
||
|
||
old_i = new_length != 1 ? new_i * (old_length - 1) / (new_length - 1) : 0 # if set to 'align_corners'
|
||
|
||
old_i = new_length > 1 ? (new_x + 0.5) * old_length / new_length - 0.5 : 0 # if set to 'half_pixel'
|
||
|
||
old_i = new_length != 0 ? new_i * old_length / new_length : 0 # if set to 'asymmetric'
|
||
|
||
- **mode** (str) - 所使用的插值方式。目前支持"linear"和"bilinear"插值方式。默认值："linear"。
|
||
|
||
返回：
|
||
Tensor，数据类型与 `x` 相同。
|
||
|
||
异常：
|
||
- **TypeError** - `x` 不是Tensor。
|
||
- **TypeError** - `x` 的数据类型不支持。
|
||
- **TypeError** - `scales` 不是float类型的tuple。
|
||
- **ValueError** - `scales` 中的数不全是正数。
|
||
- **TypeError** - `sizes` 不是int64类型的tuple。
|
||
- **ValueError** - `sizes` 中的数不全是正数。
|
||
- **TypeError** - `coordinate_transformation_mode` 不是string。
|
||
- **ValueError** - `coordinate_transformation_mode` 不在支持的列表中。
|
||
- **TypeError** - `mode` 不是string类型。
|
||
- **ValueError** - `mode` 不在支持的列表中。 |