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)

from pprint import pprint

print('A Sobel kernel:')
pprint(ee.Kernel.sobel().getInfo())

#  Output weights matrix

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