公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.Kernel.cross
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
產生十字形布林值核心。
| 用量 | 傳回 |
|---|
ee.Kernel.cross(radius, units, normalize, magnitude) | 核心 |
| 引數 | 類型 | 詳細資料 |
|---|
radius | 浮點值 | 要產生的核心半徑。 |
units | 字串，預設值為「pixels」 | 核心的測量系統 (「像素」或「公尺」)。如果核心是以公尺為單位指定，則會在變更縮放層級時調整大小。 |
normalize | 布林值，預設值為 true | 將核心值正規化為總和為 1。 |
magnitude | 浮點值，預設值為 1 | 將每個值按此金額縮放。 |
範例
程式碼編輯器 (JavaScript)
print('A cross kernel', ee.Kernel.cross({radius: 3}));
/**
* Output weights matrix (up to 1/1000 precision for brevity)
*
* [0.076, 0.000, 0.000, 0.000, 0.000, 0.000, 0.076]
* [0.000, 0.076, 0.000, 0.000, 0.000, 0.076, 0.000]
* [0.000, 0.000, 0.076, 0.000, 0.076, 0.000, 0.000]
* [0.000, 0.000, 0.000, 0.076, 0.000, 0.000, 0.000]
* [0.000, 0.000, 0.076, 0.000, 0.076, 0.000, 0.000]
* [0.000, 0.076, 0.000, 0.000, 0.000, 0.076, 0.000]
* [0.076, 0.000, 0.000, 0.000, 0.000, 0.000, 0.076]
*/
Python 設定
請參閱
Python 環境頁面，瞭解 Python API 和如何使用 geemap 進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
from pprint import pprint
print('A cross kernel:')
pprint(ee.Kernel.cross(**{'radius': 3}).getInfo())
# Output weights matrix (up to 1/1000 precision for brevity)
# [0.076, 0.000, 0.000, 0.000, 0.000, 0.000, 0.076]
# [0.000, 0.076, 0.000, 0.000, 0.000, 0.076, 0.000]
# [0.000, 0.000, 0.076, 0.000, 0.076, 0.000, 0.000]
# [0.000, 0.000, 0.000, 0.076, 0.000, 0.000, 0.000]
# [0.000, 0.000, 0.076, 0.000, 0.076, 0.000, 0.000]
# [0.000, 0.076, 0.000, 0.000, 0.000, 0.076, 0.000]
# [0.076, 0.000, 0.000, 0.000, 0.000, 0.000, 0.076]
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eGenerates a kernel with values arranged in a cross shape, useful for image processing operations.\u003c/p\u003e\n"],["\u003cp\u003eThe kernel's size is determined by the \u003ccode\u003eradius\u003c/code\u003e parameter, and values can be normalized and scaled.\u003c/p\u003e\n"],["\u003cp\u003eBy default, the kernel values are normalized to sum to 1 and scaled by 1.\u003c/p\u003e\n"],["\u003cp\u003eThe kernel can be defined in either 'pixels' or 'meters', affecting its behavior when the zoom level changes.\u003c/p\u003e\n"]]],["The core functionality is generating a cross-shaped boolean kernel using `ee.Kernel.cross`. Users specify the `radius` to define the kernel's size. They can also choose the `units` ('pixels' or 'meters'), `normalize` (to sum values to 1), and the `magnitude` to scale values. This method returns a `Kernel` object. An example shows how a radius of 3 results in a 7x7 weight matrix where only cross-shaped positions are populated.\n"],null,["# ee.Kernel.cross\n\nGenerates a cross-shaped boolean kernel.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|----------------------------------------------------------------------|---------|\n| `ee.Kernel.cross(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 cross kernel', ee.Kernel.cross({radius: 3}));\n\n/**\n * Output weights matrix (up to 1/1000 precision for brevity)\n *\n * [0.076, 0.000, 0.000, 0.000, 0.000, 0.000, 0.076]\n * [0.000, 0.076, 0.000, 0.000, 0.000, 0.076, 0.000]\n * [0.000, 0.000, 0.076, 0.000, 0.076, 0.000, 0.000]\n * [0.000, 0.000, 0.000, 0.076, 0.000, 0.000, 0.000]\n * [0.000, 0.000, 0.076, 0.000, 0.076, 0.000, 0.000]\n * [0.000, 0.076, 0.000, 0.000, 0.000, 0.076, 0.000]\n * [0.076, 0.000, 0.000, 0.000, 0.000, 0.000, 0.076]\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 cross kernel:')\npprint(ee.Kernel.cross(**{'radius': 3}).getInfo())\n\n# Output weights matrix (up to 1/1000 precision for brevity)\n\n# [0.076, 0.000, 0.000, 0.000, 0.000, 0.000, 0.076]\n# [0.000, 0.076, 0.000, 0.000, 0.000, 0.076, 0.000]\n# [0.000, 0.000, 0.076, 0.000, 0.076, 0.000, 0.000]\n# [0.000, 0.000, 0.000, 0.076, 0.000, 0.000, 0.000]\n# [0.000, 0.000, 0.076, 0.000, 0.076, 0.000, 0.000]\n# [0.000, 0.076, 0.000, 0.000, 0.000, 0.076, 0.000]\n# [0.076, 0.000, 0.000, 0.000, 0.000, 0.000, 0.076]\n```"]]
