ee.Kernel.inverse

  • Returns a new kernel with the multiplicative inverse of the original kernel's weights.

  • Weights with a value of zero in the original kernel remain zero in the inverted kernel.

  • Useful for reversing the effect of a previously applied kernel, if mathematically possible.

  • Demonstrated using the Sobel kernel as an example, showing the original and inverted weights.

 Returns a kernel which has each of its weights multiplicatively inverted. Weights with a value of zero are not inverted and remain zero.

UsageReturns
Kernel.inverse()Kernel
ArgumentTypeDetails
this: kernelKernelThe kernel to have its entries inverted.

Examples

Code Editor (JavaScript)

var sobelKernel = ee.Kernel.sobel();
print(sobelKernel);

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

print('Inverse of Sobel kernel weights', sobelKernel.inverse());

/**
 * [-1.0, 0.0, 1.0]
 * [-0.5, 0.0, 0.5]
 * [-1.0, 0.0, 1.0]
 */

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

sobel_kernel = ee.Kernel.sobel()
pprint(sobel_kernel.getInfo())

# Output weights matrix

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

print('Inverse of Sobel kernel weights:')
pprint(sobel_kernel.inverse().getInfo())

#  [-1.0, 0.0, 1.0]
#  [-0.5, 0.0, 0.5]
#  [-1.0, 0.0, 1.0]