Announcement: On November 13, 2024, all users will need to use a Cloud project in order to access Earth Engine. After this date, continued individual access without a Cloud project will require an exception.

ee.Kernel.rotate

Creates a Kernel.

Usage	Returns
`Kernel.rotate(rotations)`	Kernel

Argument	Type	Details
this: `kernel`	Kernel	The kernel to be rotated.
`rotations`	Integer	Number 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)

from pprint import pprint

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

#  Output weights matrix

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

print('One 90 degree clockwise rotation:')
pprint(sobel_kernel.rotate(1).getInfo())

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

print('Two 90 degree counterclockwise rotations:')
pprint(sobel_kernel.rotate(-2).getInfo())

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