Объявление : Все некоммерческие проекты, зарегистрированные для использования Earth Engine до
15 апреля 2025 года, должны
подтвердить некоммерческое право на сохранение доступа к Earth Engine.
ee.Kernel.circle
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Генерирует булево ядро в форме круга.
| Использование | Возврат | ee.Kernel.circle(radius, units , normalize , magnitude ) | Ядро |
| Аргумент | Тип | Подробности | radius | Плавать | Радиус генерируемого ядра. |
units | Строка, по умолчанию: «пиксели» | Система измерения ядра («пиксели» или «метры»). Если ядро указано в метрах, его размер будет меняться при изменении уровня масштабирования. |
normalize | Логическое значение, по умолчанию: true | Нормализуйте значения ядра так, чтобы сумма равнялась 1. |
magnitude | Плавающий, по умолчанию: 1 | Масштабируйте каждое значение на эту величину. |
Примеры
Редактор кода (JavaScript)
print('A circle kernel', ee.Kernel.circle({radius: 3}));
/**
* Output weights matrix (up to 1/1000 precision for brevity)
*
* [0.000, 0.000, 0.000, 0.034, 0.000, 0.000, 0.000]
* [0.000, 0.034, 0.034, 0.034, 0.034, 0.034, 0.000]
* [0.000, 0.034, 0.034, 0.034, 0.034, 0.034, 0.000]
* [0.034, 0.034, 0.034, 0.034, 0.034, 0.034, 0.034]
* [0.000, 0.034, 0.034, 0.034, 0.034, 0.034, 0.000]
* [0.000, 0.034, 0.034, 0.034, 0.034, 0.034, 0.000]
* [0.000, 0.000, 0.000, 0.034, 0.000, 0.000, 0.000]
*/ Настройка Python
Информацию об API Python и использовании geemap для интерактивной разработки см. на странице «Среда Python» .
import ee
import geemap.core as geemap
Colab (Python)
from pprint import pprint
print('A circle kernel:')
pprint(ee.Kernel.circle(**{'radius': 3}).getInfo())
# Output weights matrix (up to 1/1000 precision for brevity)
# [0.000, 0.000, 0.000, 0.034, 0.000, 0.000, 0.000]
# [0.000, 0.034, 0.034, 0.034, 0.034, 0.034, 0.000]
# [0.000, 0.034, 0.034, 0.034, 0.034, 0.034, 0.000]
# [0.034, 0.034, 0.034, 0.034, 0.034, 0.034, 0.034]
# [0.000, 0.034, 0.034, 0.034, 0.034, 0.034, 0.000]
# [0.000, 0.034, 0.034, 0.034, 0.034, 0.034, 0.000]
# [0.000, 0.000, 0.000, 0.034, 0.000, 0.000, 0.000]
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-24 UTC.
[null,null,["Последнее обновление: 2025-07-24 UTC."],[[["\u003cp\u003eGenerates a circle-shaped kernel for use in image processing.\u003c/p\u003e\n"],["\u003cp\u003eThe kernel's radius can be specified in pixels or meters.\u003c/p\u003e\n"],["\u003cp\u003eKernel values can be normalized to sum to 1 and scaled by a magnitude factor.\u003c/p\u003e\n"],["\u003cp\u003eUseful for operations like blurring or smoothing where a circular neighborhood is desired.\u003c/p\u003e\n"]]],["`ee.Kernel.circle()` generates a circle-shaped boolean kernel, which is returned as a Kernel object. The function takes `radius` (float) to set the kernel's size. `units` (string, 'pixels' or 'meters') defines the measurement system, with meters resizing at different zoom levels. `normalize` (boolean) determines if kernel values sum to 1. `magnitude` (float) scales each value. Example code provided demonstrate kernel creation in both JavaScript and Python, with resulting matrix outputs.\n"],null,["# ee.Kernel.circle\n\nGenerates a circle-shaped boolean kernel.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------------------------------------------------|---------|\n| `ee.Kernel.circle(radius, `*units* `, `*normalize* `, `*magnitude*`)` | Kernel |\n\n| Argument | Type | Details |\n|-------------|---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `radius` | Float | The radius of the kernel to generate. |\n| `units` | String, default: \"pixels\" | The system of measurement for the kernel ('pixels' or 'meters'). If the kernel is specified in meters, it will resize when the zoom-level is changed. |\n| `normalize` | Boolean, default: true | Normalize the kernel values to sum to 1. |\n| `magnitude` | Float, default: 1 | Scale each value by this amount. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\nprint('A circle kernel', ee.Kernel.circle({radius: 3}));\n\n/**\n * Output weights matrix (up to 1/1000 precision for brevity)\n *\n * [0.000, 0.000, 0.000, 0.034, 0.000, 0.000, 0.000]\n * [0.000, 0.034, 0.034, 0.034, 0.034, 0.034, 0.000]\n * [0.000, 0.034, 0.034, 0.034, 0.034, 0.034, 0.000]\n * [0.034, 0.034, 0.034, 0.034, 0.034, 0.034, 0.034]\n * [0.000, 0.034, 0.034, 0.034, 0.034, 0.034, 0.000]\n * [0.000, 0.034, 0.034, 0.034, 0.034, 0.034, 0.000]\n * [0.000, 0.000, 0.000, 0.034, 0.000, 0.000, 0.000]\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\nprint('A circle kernel:')\npprint(ee.Kernel.circle(**{'radius': 3}).getInfo())\n\n# Output weights matrix (up to 1/1000 precision for brevity)\n\n# [0.000, 0.000, 0.000, 0.034, 0.000, 0.000, 0.000]\n# [0.000, 0.034, 0.034, 0.034, 0.034, 0.034, 0.000]\n# [0.000, 0.034, 0.034, 0.034, 0.034, 0.034, 0.000]\n# [0.034, 0.034, 0.034, 0.034, 0.034, 0.034, 0.034]\n# [0.000, 0.034, 0.034, 0.034, 0.034, 0.034, 0.000]\n# [0.000, 0.034, 0.034, 0.034, 0.034, 0.034, 0.000]\n# [0.000, 0.000, 0.000, 0.034, 0.000, 0.000, 0.000]\n```"]]
