ee.Kernel.sobel

  • ee.Kernel.sobel generates a 3x3 Sobel edge-detection kernel.

  • The magnitude argument scales the kernel values.

  • The normalize argument normalizes the kernel values to sum to 1.

  • The default Sobel kernel has weights represented by the matrix [[-1, 0, 1], [-2, 0, 2], [-1, 0, 1]].

Generates a 3x3 Sobel edge-detection kernel.

UsageReturns
ee.Kernel.sobel(magnitude, normalize)Kernel
ArgumentTypeDetails
magnitudeFloat, default: 1Scale each value by this amount.
normalizeBoolean, default: falseNormalize the kernel values to sum to 1.

Examples

Code Editor (JavaScript)

print('A Sobel kernel', ee.Kernel.sobel());

/**
 * Output weights matrix
 *
 * [-1, 0, 1]
 * [-2, 0, 2]
 * [-1, 0, 1]
 */

Python setup

See the Python Environment page for information on the Python API and using geemap for interactive development.

import ee
import geemap.core as geemap

Colab (Python)

display('A Sobel kernel:', ee.Kernel.sobel())

#  Output weights matrix

#  [-1, 0, 1]
#  [-2, 0, 2]
#  [-1, 0, 1]