公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
ee.Kernel.kirsch
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
產生 3x3 Kirsch 指南針邊緣偵測核心。
| 用量 | 傳回 |
|---|
ee.Kernel.kirsch(magnitude, normalize) | 核心 |
| 引數 | 類型 | 詳細資料 |
|---|
magnitude | 浮點值，預設值為 1 | 將每個值按此金額縮放。 |
normalize | 布林值，預設值為 false | 將核心值正規化為總和為 1。 |
範例
程式碼編輯器 (JavaScript)
print('A Kirsch compass kernel', ee.Kernel.kirsch());
/**
* Output weights matrix
*
* [5, -3, -3]
* [5, 0, -3]
* [5, -3, -3]
*/
Python 設定
請參閱
Python 環境頁面，瞭解 Python API 和如何使用 geemap 進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
from pprint import pprint
print('A Kirsch compass kernel:')
pprint(ee.Kernel.kirsch().getInfo())
# Output weights matrix
# [5, -3, -3]
# [5, 0, -3]
# [5, -3, -3]
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-26 (世界標準時間)。
[null,null,["上次更新時間：2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eCreates a 3x3 Kirsch compass kernel for edge detection in images.\u003c/p\u003e\n"],["\u003cp\u003eThe kernel's values can be scaled using the \u003ccode\u003emagnitude\u003c/code\u003e parameter and normalized to sum to 1 with the \u003ccode\u003enormalize\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eDefault kernel weights are [[5, -3, -3], [5, 0, -3], [5, -3, -3]], representing one of the eight Kirsch compass directions.\u003c/p\u003e\n"]]],["The `ee.Kernel.kirsch()` function creates a 3x3 Kirsch's Compass edge-detection kernel. This kernel's values can be scaled using the `magnitude` parameter (defaulting to 1) and normalized to sum to 1 with the `normalize` parameter (defaulting to false). The function, when invoked, returns a kernel represented by a weight matrix: `[5, -3, -3], [5, 0, -3], [5, -3, -3]`. This is demonstrated in both JavaScript and Python examples.\n"],null,["# ee.Kernel.kirsch\n\nGenerates a 3x3 Kirsch's Compass edge-detection kernel.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------------------------------------------|---------|\n| `ee.Kernel.kirsch(`*magnitude* `, `*normalize*`)` | Kernel |\n\n| Argument | Type | Details |\n|-------------|-------------------------|------------------------------------------|\n| `magnitude` | Float, default: 1 | Scale each value by this amount. |\n| `normalize` | Boolean, default: false | Normalize the kernel values to sum to 1. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\nprint('A Kirsch compass kernel', ee.Kernel.kirsch());\n\n/**\n * Output weights matrix\n *\n * [5, -3, -3]\n * [5, 0, -3]\n * [5, -3, -3]\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 Kirsch compass kernel:')\npprint(ee.Kernel.kirsch().getInfo())\n\n# Output weights matrix\n\n# [5, -3, -3]\n# [5, 0, -3]\n# [5, -3, -3]\n```"]]
