scipy.ndimage.

gaussian_gradient_magnitude#

scipy.ndimage.gaussian_gradient_magnitude(input, sigma, output=None, mode='reflect', cval=0.0, *, axes=None, **kwargs)[source]#

使用高斯導數的多維梯度幅度。

參數:
inputarray_like

輸入陣列。

sigma純量或純量序列

高斯濾波器的標準差,針對每個軸以序列或單一數字給出,在後者的情況下,所有軸都相等。

output陣列或 dtype,選用

放置輸出的陣列,或傳回陣列的 dtype。預設情況下,將建立與輸入相同 dtype 的陣列。

modestr 或 序列,選用

mode 參數決定當濾波器與邊界重疊時,輸入陣列如何延伸。透過傳遞模式序列,其長度等於輸入陣列的維度數量,可以沿著每個軸指定不同的模式。預設值為 ‘reflect’。有效值及其行為如下

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

輸入透過反射最後一個像素的邊緣來延伸。此模式有時也稱為半樣本對稱。

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

輸入透過以相同的常數值填充邊緣之外的所有值來延伸,常數值由 cval 參數定義。

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

輸入透過複製最後一個像素來延伸。

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

輸入透過反射最後一個像素的中心來延伸。此模式有時也稱為全樣本對稱。

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

輸入透過環繞到相對的邊緣來延伸。

為了與內插函數保持一致,也可以使用以下模式名稱

‘grid-constant’

這是 ‘constant’ 的同義詞。

‘grid-mirror’

這是 ‘reflect’ 的同義詞。

‘grid-wrap’

這是 ‘wrap’ 的同義詞。

cval純量,選用

如果 mode 為 ‘constant’,則用於填充輸入邊緣之外的值。預設值為 0.0。

axes整數元組或 None

套用濾波器的軸。如果提供 sigmamode 元組,則其長度必須與軸的數量相符。

額外的關鍵字參數將傳遞給 gaussian_filter()。
返回:
gaussian_gradient_magnitudendarray

已濾波的陣列。具有與 input 相同的形狀。

範例

>>> 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.gaussian_gradient_magnitude(ascent, sigma=5)
>>> ax1.imshow(ascent)
>>> ax2.imshow(result)
>>> plt.show()
../../_images/scipy-ndimage-gaussian_gradient_magnitude-1.png