公告：所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件，才能继续使用 Earth Engine。
ee.Kernel.octagon
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
生成一个八边形布尔值内核。
| 用法 | 返回 |
|---|
ee.Kernel.octagon(radius, units, normalize, magnitude) | 内核 |
| 参数 | 类型 | 详细信息 |
|---|
radius | 浮点数 | 要生成的内核的半径。 |
units | 字符串，默认值：“pixels” | 内核的测量系统（“像素”或“米”）。如果以米为单位指定了内核，则当缩放级别发生变化时，内核会调整大小。 |
normalize | 布尔值，默认值：true | 将内核值归一化为总和为 1。 |
magnitude | 浮点数，默认值：1 | 按此量缩放每个值。 |
示例
代码编辑器 (JavaScript)
print('An octagon kernel', ee.Kernel.octagon({radius: 3}));
/**
* Output weights matrix (up to 1/1000 precision for brevity)
*
* [0.000, 0.000, 0.027, 0.027, 0.027, 0.000, 0.000]
* [0.000, 0.027, 0.027, 0.027, 0.027, 0.027, 0.000]
* [0.027, 0.027, 0.027, 0.027, 0.027, 0.027, 0.027]
* [0.027, 0.027, 0.027, 0.027, 0.027, 0.027, 0.027]
* [0.027, 0.027, 0.027, 0.027, 0.027, 0.027, 0.027]
* [0.000, 0.027, 0.027, 0.027, 0.027, 0.027, 0.000]
* [0.000, 0.000, 0.027, 0.027, 0.027, 0.000, 0.000]
*/
Python 设置
如需了解 Python API 和如何使用 geemap 进行交互式开发，请参阅
Python 环境页面。
import ee
import geemap.core as geemap
Colab (Python)
from pprint import pprint
print('An octagon kernel:')
pprint(ee.Kernel.octagon(**{'radius': 3}).getInfo())
# Output weights matrix (up to 1/1000 precision for brevity)
# [0.000, 0.000, 0.027, 0.027, 0.027, 0.000, 0.000]
# [0.000, 0.027, 0.027, 0.027, 0.027, 0.027, 0.000]
# [0.027, 0.027, 0.027, 0.027, 0.027, 0.027, 0.027]
# [0.027, 0.027, 0.027, 0.027, 0.027, 0.027, 0.027]
# [0.027, 0.027, 0.027, 0.027, 0.027, 0.027, 0.027]
# [0.000, 0.027, 0.027, 0.027, 0.027, 0.027, 0.000]
# [0.000, 0.000, 0.027, 0.027, 0.027, 0.000, 0.000]
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-26。
[null,null,["最后更新时间 (UTC)：2025-07-26。"],[[["\u003cp\u003eCreates a kernel with an octagon shape for use in image processing.\u003c/p\u003e\n"],["\u003cp\u003eThe kernel's radius can be specified in pixels or meters, with meter-based kernels resizing with zoom level changes.\u003c/p\u003e\n"],["\u003cp\u003eKernel values are normalized by default to sum to 1 and can be scaled using the \u003ccode\u003emagnitude\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eThis kernel can be used for various image operations, such as smoothing, blurring or edge detection by applying it to an image using a convolution.\u003c/p\u003e\n"]]],[],null,["# ee.Kernel.octagon\n\nGenerates an octagon-shaped boolean kernel.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|------------------------------------------------------------------------|---------|\n| `ee.Kernel.octagon(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('An octagon kernel', ee.Kernel.octagon({radius: 3}));\n\n/**\n * Output weights matrix (up to 1/1000 precision for brevity)\n *\n * [0.000, 0.000, 0.027, 0.027, 0.027, 0.000, 0.000]\n * [0.000, 0.027, 0.027, 0.027, 0.027, 0.027, 0.000]\n * [0.027, 0.027, 0.027, 0.027, 0.027, 0.027, 0.027]\n * [0.027, 0.027, 0.027, 0.027, 0.027, 0.027, 0.027]\n * [0.027, 0.027, 0.027, 0.027, 0.027, 0.027, 0.027]\n * [0.000, 0.027, 0.027, 0.027, 0.027, 0.027, 0.000]\n * [0.000, 0.000, 0.027, 0.027, 0.027, 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('An octagon kernel:')\npprint(ee.Kernel.octagon(**{'radius': 3}).getInfo())\n\n# Output weights matrix (up to 1/1000 precision for brevity)\n\n# [0.000, 0.000, 0.027, 0.027, 0.027, 0.000, 0.000]\n# [0.000, 0.027, 0.027, 0.027, 0.027, 0.027, 0.000]\n# [0.027, 0.027, 0.027, 0.027, 0.027, 0.027, 0.027]\n# [0.027, 0.027, 0.027, 0.027, 0.027, 0.027, 0.027]\n# [0.027, 0.027, 0.027, 0.027, 0.027, 0.027, 0.027]\n# [0.000, 0.027, 0.027, 0.027, 0.027, 0.027, 0.000]\n# [0.000, 0.000, 0.027, 0.027, 0.027, 0.000, 0.000]\n```"]]
