公告:所有在
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 API 和如何使用 geemap
进行交互式开发,请参阅
Python 环境页面。
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())
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):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```"]]