公告:凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案,都必須
驗證非商業用途資格,才能繼續存取 Earth Engine。
ee.Image.select
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
從圖片中選取波段。
傳回含有所選波段的圖片。
用量 | 傳回 |
---|
Image.select(var_args) | 圖片 |
引數 | 類型 | 詳細資料 |
---|
這個:image | 圖片 | Image 執行個體。 |
var_args | VarArgs<Object> | 有兩種可能:
- 任意數量的非清單引數。這些都會解讀為頻帶選取器。可以是樂團名稱、規則運算式或數字索引。例如:selected = image.select('a', 'b', 3, 'd');
- 兩份清單。第一個會做為樂團選取器,第二個則做為所選樂團的新名稱。新名稱的數量必須與所選樂團數量相符。例如:selected = image.select(['a', 4], ['newA', 'newB']);
|
範例
程式碼編輯器 (JavaScript)
// A Sentinel-2 surface reflectance image.
var img = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG');
print('All band names', img.bandNames());
print('Select a band by name',
img.select('B11').bandNames());
print('Select a band by index',
img.select(10).bandNames());
print('Select bands using a list',
img.select(['B11', 'B8', 'B3']).bandNames());
print('Select bands by an argument series',
img.select('B11', 'B8', 'B3').bandNames());
print('Mixing string and integer selectors is valid',
img.select(10, 'B8', 2).bandNames());
print('Rename selected bands using two corresponding lists',
img.select(['B11', 'B8', 'B3'], ['SWIR1', 'NIR', 'Green']).bandNames());
// Use regular expressions to select bands.
print('Match "QA" followed by any two characters',
img.select('QA..').bandNames());
print('Match "B" followed by any character, any number of times',
img.select('B.*').bandNames());
print('Match "B" followed by any character, and any optional third character',
img.select('B..?').bandNames());
print('Match "B" followed by a character in the range 6-8',
img.select('B[6-8]').bandNames());
print('Match "B" followed by a character in the range 1-9 and then 1-2',
img.select('B[1-9][1-2]').bandNames());
print('Match "B" or "QA" each followed by any character, any number of times.',
img.select('B.*|QA.*').bandNames());
Python 設定
請參閱
Python 環境頁面,瞭解 Python API 和如何使用 geemap
進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
# A Sentinel-2 surface reflectance image.
img = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG')
print('All band names:', img.bandNames().getInfo())
print('Select a band by name:', img.select('B11').bandNames().getInfo())
print('Select a band by index:', img.select(10).bandNames().getInfo())
print('Select bands using a list:',
img.select(['B11', 'B8', 'B3']).bandNames().getInfo())
print('Select bands by an argument series:',
img.select('B11', 'B8', 'B3').bandNames().getInfo())
print('Mixing string and integer selectors is valid:',
img.select(10, 'B8', 2).bandNames().getInfo())
print('Rename selected bands using two corresponding lists:',
img.select(['B11', 'B8', 'B3'], ['SWIR1', 'NIR', 'Green'])
.bandNames().getInfo())
# Use regular expressions to select bands.
print('Match "QA" followed by any two characters:',
img.select('QA..').bandNames().getInfo())
print('Match "B" followed by any character, any number of times:',
img.select('B.*').bandNames().getInfo())
print('Match "B" followed by any character, and any optional third character',
img.select('B..?').bandNames().getInfo())
print('Match "B" followed by a character in the range 6-8',
img.select('B[6-8]').bandNames().getInfo())
print('Match "B" followed by a character in the range 1-9 and then 1-2',
img.select('B[1-9][1-2]').bandNames().getInfo())
print('Match "B" or "QA" each followed by any character, any number of times.',
img.select('B.*|QA.*').bandNames().getInfo())
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\u003cp\u003e\u003ccode\u003eImage.select()\u003c/code\u003e is used to select specific bands from an image by their name, index, or using regular expressions.\u003c/p\u003e\n"],["\u003cp\u003eYou can provide band selectors as individual arguments, a single list, or two lists (one for selectors and one for new band names).\u003c/p\u003e\n"],["\u003cp\u003eThis method returns a new image containing only the selected bands, potentially with renamed bands if specified.\u003c/p\u003e\n"],["\u003cp\u003eRegular expressions provide a powerful way to select multiple bands matching a pattern.\u003c/p\u003e\n"]]],[],null,["# ee.Image.select\n\n\u003cbr /\u003e\n\nSelects bands from an image.\n\n\u003cbr /\u003e\n\nReturns an image with the selected bands.\n\n| Usage | Returns |\n|--------------------------|---------|\n| Image.select`(var_args)` | Image |\n\n| Argument | Type | Details |\n|---------------|-------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `image` | Image | The Image instance. |\n| `var_args` | VarArgs\\\u003cObject\\\u003e | One of two possibilities: - Any number of non-list arguments. All of these will be interpreted as band selectors. These can be band names, regexes, or numeric indices. E.g. selected = image.select('a', 'b', 3, 'd'); - Two lists. The first will be used as band selectors and the second as new names for the selected bands. The number of new names must match the number of selected bands. E.g. selected = image.select(\\['a', 4\\], \\['newA', 'newB'\\]); |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A Sentinel-2 surface reflectance image.\nvar img = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG');\nprint('All band names', img.bandNames());\n\nprint('Select a band by name',\n img.select('B11').bandNames());\n\nprint('Select a band by index',\n img.select(10).bandNames());\n\nprint('Select bands using a list',\n img.select(['B11', 'B8', 'B3']).bandNames());\n\nprint('Select bands by an argument series',\n img.select('B11', 'B8', 'B3').bandNames());\n\nprint('Mixing string and integer selectors is valid',\n img.select(10, 'B8', 2).bandNames());\n\nprint('Rename selected bands using two corresponding lists',\n img.select(['B11', 'B8', 'B3'], ['SWIR1', 'NIR', 'Green']).bandNames());\n\n// Use regular expressions to select bands.\nprint('Match \"QA\" followed by any two characters',\n img.select('QA..').bandNames());\n\nprint('Match \"B\" followed by any character, any number of times',\n img.select('B.*').bandNames());\n\nprint('Match \"B\" followed by any character, and any optional third character',\n img.select('B..?').bandNames());\n\nprint('Match \"B\" followed by a character in the range 6-8',\n img.select('B[6-8]').bandNames());\n\nprint('Match \"B\" followed by a character in the range 1-9 and then 1-2',\n img.select('B[1-9][1-2]').bandNames());\n\nprint('Match \"B\" or \"QA\" each followed by any character, any number of times.',\n img.select('B.*|QA.*').bandNames());\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\n# A Sentinel-2 surface reflectance image.\nimg = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG')\nprint('All band names:', img.bandNames().getInfo())\n\nprint('Select a band by name:', img.select('B11').bandNames().getInfo())\n\nprint('Select a band by index:', img.select(10).bandNames().getInfo())\n\nprint('Select bands using a list:',\n img.select(['B11', 'B8', 'B3']).bandNames().getInfo())\n\nprint('Select bands by an argument series:',\n img.select('B11', 'B8', 'B3').bandNames().getInfo())\n\nprint('Mixing string and integer selectors is valid:',\n img.select(10, 'B8', 2).bandNames().getInfo())\n\nprint('Rename selected bands using two corresponding lists:',\n img.select(['B11', 'B8', 'B3'], ['SWIR1', 'NIR', 'Green'])\n .bandNames().getInfo())\n\n# Use regular expressions to select bands.\nprint('Match \"QA\" followed by any two characters:',\n img.select('QA..').bandNames().getInfo())\n\nprint('Match \"B\" followed by any character, any number of times:',\n img.select('B.*').bandNames().getInfo())\n\nprint('Match \"B\" followed by any character, and any optional third character',\n img.select('B..?').bandNames().getInfo())\n\nprint('Match \"B\" followed by a character in the range 6-8',\n img.select('B[6-8]').bandNames().getInfo())\n\nprint('Match \"B\" followed by a character in the range 1-9 and then 1-2',\n img.select('B[1-9][1-2]').bandNames().getInfo())\n\nprint('Match \"B\" or \"QA\" each followed by any character, any number of times.',\n img.select('B.*|QA.*').bandNames().getInfo())\n```"]]