ee.Kernel.rotate

  • The rotate method is used to rotate a Kernel.

  • The rotate method takes an integer argument specifying the number of 90-degree rotations.

  • Positive rotation values indicate clockwise rotation, and negative values indicate counterclockwise rotation.

Creates a Kernel.

UsageReturns
Kernel.rotate(rotations)Kernel
ArgumentTypeDetails
this: kernelKernelThe kernel to be rotated.
rotationsIntegerNumber of 90 degree rotations to make. Negative numbers rotate counterclockwise.

Examples

Code Editor (JavaScript)

// A kernel to be rotated.
var sobelKernel = ee.Kernel.sobel();
print(sobelKernel);

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

print('One 90 degree clockwise rotation', sobelKernel.rotate(1));

/**
 * [-1, -2, -1]
 * [ 0,  0,  0]
 * [ 1,  2,  1]
 */

print('Two 90 degree counterclockwise rotations', sobelKernel.rotate(-2));

/**
 * [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)

# A kernel to be rotated.
sobel_kernel = ee.Kernel.sobel()
display(sobel_kernel)

#  Output weights matrix

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

display('One 90 degree clockwise rotation:', sobel_kernel.rotate(1))

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

display('Two 90 degree counterclockwise rotations:', sobel_kernel.rotate(-2))

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