お知らせ:
2025 年 4 月 15 日より前に Earth Engine の使用を登録したすべての非商用プロジェクトは、Earth Engine へのアクセスを維持するために
非商用目的での利用資格を確認する必要があります。
ee.Kernel.circle
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
円形のブール値カーネルを生成します。
| 用途 | 戻り値 |
|---|
ee.Kernel.circle(radius, units, normalize, magnitude) | カーネル |
| 引数 | タイプ | 詳細 |
|---|
radius | 浮動小数点数 | 生成するカーネルの半径。 |
units | 文字列、デフォルト: 「pixels」 | カーネルの測定システム（「ピクセル」または「メートル」）。カーネルがメートル単位で指定されている場合、ズームレベルが変更されるとサイズが変更されます。 |
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 の設定
Python API とインタラクティブな開発での 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]
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-26 UTC。
[null,null,["最終更新日 2025-07-26 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```"]]
