Python SciPy ndimage.uniform_filter用法及代碼示例

本文簡要介紹 python 語言中 scipy.ndimage.uniform_filter 的用法。

用法:

scipy.ndimage.uniform_filter(input, size=3, output=None, mode='reflect', cval=0.0, origin=0, *, axes=None)#

多維均勻濾波器。

參數 ：：

input： array_like

輸入數組。

size： int 或整數序列，可選

每個軸的統一過濾器的大小以序列或單個數字的形式給出，在這種情況下，所有軸的大小都相等。

output： 數組或數據類型，可選

放置輸出的數組，或返回數組的 dtype。默認情況下，將創建一個與輸入具有相同 dtype 的數組。

mode： str 或序列，可選

mode 參數確定當過濾器與邊框重疊時如何擴展輸入數組。通過傳遞長度等於輸入數組維數的模式序列，可以沿每個軸指定不同的模式。默認值為‘reflect’。有效值及其行為如下：

‘reflect’ (d c b a | a b c d | d c b a)

通過反射最後一個像素的邊來擴展輸入。此模式有時也稱為half-sample 對稱模式。

‘constant’ (k k k k | a b c d |呸呸呸呸)

通過使用 cval 參數定義的相同常量值填充邊之外的所有值來擴展輸入。

‘nearest’ (啊啊啊啊| a b c d |嘀嘀嘀嘀)

通過複製最後一個像素來擴展輸入。

‘mirror’ (d c b | a b c d | c b a)

通過反射最後一個像素的中心來擴展輸入。此模式有時也稱為whole-sample 對稱模式。

‘wrap’ (a b c d | a b c d | A B C D)

通過環繞到相對邊來擴展輸入。

為了與插值函數保持一致，還可以使用以下模式名稱：

‘grid-constant’

這是‘constant’ 的同義詞。

‘grid-mirror’

這是‘reflect’ 的同義詞。

‘grid-wrap’

這是‘wrap’ 的同義詞。

cval： 標量，可選

如果模式為‘constant’，則填充過去輸入邊的值。默認值為 0.0。

origin： int 或序列，可選

控製過濾器在輸入數組像素上的位置。值 0(默認值)使過濾器以像素為中心，正值將過濾器向左移動，負值向右移動。通過傳遞長度等於輸入數組維數的原點序列，可以沿每個軸指定不同的移位。

axes： int 或 None 的元組，可選

如果無，則沿所有軸過濾輸入。否則，將沿指定軸過濾輸入。當指定軸時，用於大小、原點和/或模式的任何元組都必須與軸的長度匹配。這些元組中的第 i 個條目對應於軸中的第 i 個條目。

返回 ：：

uniform_filter： ndarray

過濾數組。具有與輸入相同的形狀。

注意：

多維濾波器被實現為一係列一維均勻濾波器。中間數組存儲在與輸出相同的數據類型中。因此，對於精度有限的輸出類型，結果可能不精確，因為存儲的中間結果可能精度不足。

例子：

>>> from scipy import ndimage, datasets
>>> import matplotlib.pyplot as plt
>>> fig = plt.figure()
>>> plt.gray()  # show the filtered result in grayscale
>>> ax1 = fig.add_subplot(121)  # left side
>>> ax2 = fig.add_subplot(122)  # right side
>>> ascent = datasets.ascent()
>>> result = ndimage.uniform_filter(ascent, size=20)
>>> ax1.imshow(ascent)
>>> ax2.imshow(result)
>>> plt.show()