forked from mindspore-Ecosystem/mindspore
35 lines
2.3 KiB
ReStructuredText
35 lines
2.3 KiB
ReStructuredText
mindspore.ops.UpsampleTrilinear3D
|
||
=================================
|
||
|
||
.. py:class:: mindspore.ops.UpsampleTrilinear3D(output_size=None, scales=None, align_corners=False)
|
||
|
||
输入为五维度Tensor，跨其中三维执行三线性插值上调采样。
|
||
|
||
此运算符使用指定的 `output_size` 或 `scales` 缩放因子放大输入体积，过程使用三线性上调算法。
|
||
|
||
.. note::
|
||
必须指定 `output_size` 或 `scales` 中的一个值，并且不能同时指定两者。
|
||
|
||
参数：
|
||
- **output_size** (Union[tuple[int], list[int]]，可选) - 包含3个int的元组或列表。元素分别为 :math:`(output\_depth, output\_height, output\_width)` 。只能指定 `output_size` 和 `scales` 中的一个值。默认值：None。
|
||
- **scales** (Union[tuple[float], list[float]]，可选) - 包含3个float的元组或列表。元素分别为 :math:`(scale\_depth, scale\_height, scale\_width)` 。 默认值：None。
|
||
- **align_corners** (bool，可选) - 如果为True，则输入和输出Tensor由其角像素的中心点对齐，保留角像素处的值。如果为False，则输入和输出Tensor由其角像素的角点对齐，插值对边界外值使用边值填充。默认值：False。
|
||
|
||
输入：
|
||
- **x** (Tensor) - Shape为 :math:`(N, C, D_{in}, H_{in}, W_{in})` 的五维Tensor。支持的数据类型：[float16, float32, float64]。
|
||
|
||
输出：
|
||
- **y** (Tensor) - 上采样输出。其shape :math:`(N, C, D_{out}, H_{out}, W_{out})` ，数据类型与 `x` 相同。
|
||
|
||
异常：
|
||
- **TypeError** - 当 `output_size` 不是None并且 `output_size` 不是list[int]或tuple[int]。
|
||
- **TypeError** - 当 `scales` 不是None并且 `scales` 不是list[float]或tuple[float]。
|
||
- **TypeError** - `x` 的数据类型不是float16也、float32或float64。
|
||
- **TypeError** - `align_corners` 的数据类型不是bool。
|
||
- **ValueError** - `output_size` 不为空时含有非正数值。
|
||
- **ValueError** - `scales` 不为空时含有非正数值。
|
||
- **ValueError** - `x` 维度不为5。
|
||
- **ValueError** - `scales` 和 `output_size` 同时被指定或都不被指定。
|
||
- **ValueError** - `scales` 被指定时其含有的元素个数不为3。
|
||
- **ValueError** - `output_size` 被指定时其含有的元素个数不为3。
|