cupyx.scipy.ndimage.zoom#

cupyx.scipy.ndimage.zoom(input, zoom, output=None, order=3, mode='constant', cval=0.0, prefilter=True, *, grid_mode=False)[source]#

缩放数组。

使用指定阶数的样条插值对数组进行缩放。

参数:
  • input (cupy.ndarray) – 输入数组。

  • zoom (floatsequence) – 沿轴的缩放因子。如果是一个 float,则 zoom 对每个轴都相同。如果是一个 sequence,则 zoom 应包含每个轴的一个值。

  • output (cupy.ndarraydtype) – 存放输出的数组,或返回数组的数据类型 (dtype)。

  • order (int) – 样条插值的阶数,默认为 3。必须在 0-5 的范围内。

  • mode (str) – 根据给定的模式('constant', 'nearest', 'mirror', 'reflect', 'wrap', 'grid-mirror', 'grid-wrap', 'grid-constant''opencv')填充输入边界外的点。

  • cval (scalar) – 如果 mode='constant'mode='opencv',则用于输入边界外点的值。默认为 0.0

  • prefilter (bool) – 确定输入数组在插值前是否使用 spline_filter 进行预过滤。默认为 True,如果 order > 1 则会创建一个临时的 float64 过滤值数组。如果设置为 False,则如果 order > 1,输出将略微模糊,除非输入已预过滤,即它是对原始输入调用 spline_filter 的结果。

  • grid_mode (bool, 可选) –

    如果为 False,则缩放距离像素中心点。否则,使用包含完整像素范围的距离。例如,当 grid_mode 为 False 时,长度为 5 的一维信号被认为长度为 4,而当 grid_mode 为 True 时则为长度 5。请参阅以下示意图

    | pixel 1 | pixel 2 | pixel 3 | pixel 4 | pixel 5 |
         |<-------------------------------------->|
                            vs.
    |<----------------------------------------------->|
    

    上图中箭头的起点对应于每种模式下的坐标位置 0。

返回值:

缩放后的输入。

返回类型:

cupy.ndarray 或 None

另请参阅

scipy.ndimage.zoom()