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