Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Kernel.rotate
Stay organized with collections
Save and categorize content based on your preferences.
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]
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-19 UTC.
[null,null,["Last updated 2024-09-19 UTC."],[[["\u003cp\u003e\u003ccode\u003erotate()\u003c/code\u003e is a method applied to a Kernel object to rotate its weights matrix by a specified number of 90-degree turns.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003erotations\u003c/code\u003e argument accepts an integer, with positive values indicating clockwise rotations and negative values indicating counterclockwise rotations.\u003c/p\u003e\n"],["\u003cp\u003eRotating a kernel changes the direction in which the kernel is applied, impacting the output of image processing operations.\u003c/p\u003e\n"],["\u003cp\u003eThe examples provided demonstrate how to rotate a Sobel kernel by 90 degrees clockwise, and by 180 degrees (two 90-degree turns counterclockwise).\u003c/p\u003e\n"]]],[],null,["# ee.Kernel.rotate\n\nCreates a Kernel.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|----------------------------|---------|\n| Kernel.rotate`(rotations)` | Kernel |\n\n| Argument | Type | Details |\n|----------------|---------|----------------------------------------------------------------------------------|\n| this: `kernel` | Kernel | The kernel to be rotated. |\n| `rotations` | Integer | Number of 90 degree rotations to make. Negative numbers rotate counterclockwise. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A kernel to be rotated.\nvar sobelKernel = ee.Kernel.sobel();\nprint(sobelKernel);\n\n/**\n * Output weights matrix\n *\n * [-1, 0, 1]\n * [-2, 0, 2]\n * [-1, 0, 1]\n */\n\nprint('One 90 degree clockwise rotation', sobelKernel.rotate(1));\n\n/**\n * [-1, -2, -1]\n * [ 0, 0, 0]\n * [ 1, 2, 1]\n */\n\nprint('Two 90 degree counterclockwise rotations', sobelKernel.rotate(-2));\n\n/**\n * [1, 0, -1]\n * [2, 0, -2]\n * [1, 0, -1]\n */\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\nfrom pprint import pprint\n\n# A kernel to be rotated.\nsobel_kernel = ee.Kernel.sobel()\npprint(sobel_kernel.getInfo())\n\n# Output weights matrix\n\n# [-1, 0, 1]\n# [-2, 0, 2]\n# [-1, 0, 1]\n\nprint('One 90 degree clockwise rotation:')\npprint(sobel_kernel.rotate(1).getInfo())\n\n# [-1, -2, -1]\n# [ 0, 0, 0]\n# [ 1, 2, 1]\n\nprint('Two 90 degree counterclockwise rotations:')\npprint(sobel_kernel.rotate(-2).getInfo())\n\n# [1, 0, -1]\n# [2, 0, -2]\n# [1, 0, -1]\n```"]]