<br />

Select bands from each image in a collection.

<br />

Returns the image collection with selected bands.

| Usage | Returns |
|---|---|
| `ImageCollection.select(selectors, *names*)` | ImageCollection |

| Argument | Type | Details |
|---|---|---|
| this: `imagecollection` | ImageCollection | The ImageCollection instance. |
| `selectors` | List\[Object\] | A list of names, regexes or numeric indices specifying the bands to select. |
| `names` | List\[String\], optional | A list of new names for the output bands. Must match the number of bands selected. |

## Examples

### Code Editor (JavaScript)

```javascript
// A Sentinel-2 surface reflectance image collection.
var col = ee.ImageCollection('COPERNICUS/S2_SR_HARMONIZED')
    .filterBounds(ee.Geometry.Point(-122.152, 37.336))
    .filterDate('2021-01-01', '2021-02-01');
print('All band names', col.first().bandNames());

print('Select a band by name',
      col.select('B11').first().bandNames());

print('Select a band by index',
      col.select(10).first().bandNames());

print('Select bands using a list',
      col.select(['B11', 'B8', 'B3']).first().bandNames());

print('Select bands by an argument series',
      col.select('B11', 'B8', 'B3').first().bandNames());

print('Mixing string and integer selectors is valid',
      col.select(10, 'B8', 2).first().bandNames());

print('Rename selected bands using two corresponding lists',
      col.select(['B11', 'B8', 'B3'], ['SWIR1', 'NIR', 'Green'])
      .first().bandNames());

// Use regular expressions to select bands.
print('Match "QA" followed by any two characters',
      col.select('QA..').first().bandNames());

print('Match "B" followed by any character, any number of times',
      col.select('B.*').first().bandNames());

print('Match "B" followed by any character, and any optional third character',
      col.select('B..?').first().bandNames());

print('Match "B" followed by a character in the range 6-8',
      col.select('B[6-8]').first().bandNames());

print('Match "B" followed by a character in the range 1-9 and then 1-2',
      col.select('B[1-9][1-2]').first().bandNames());

print('Match "B" or "QA" each followed by any character, any number of times.',
      col.select('B.*|QA.*').first().bandNames());
```
Python setup

See the [Python Environment](https://developers.google.com/earth-engine/guides/python_install) page for information on the Python API and using
`geemap` for interactive development.

```python
import ee
import geemap.core as geemap
```

### Colab (Python)

```python
# A Sentinel-2 surface reflectance image collection.
col = ee.ImageCollection('COPERNICUS/S2_SR_HARMONIZED').filterBounds(
    ee.Geometry.Point(-122.152, 37.336)
    ).filterDate('2021-01-01', '2021-02-01')
display('All band names', col.first().bandNames())

display('Select a band by name:',
        col.select('B11').first().bandNames())

display('Select a band by index:',
        col.select(10).first().bandNames())

display('Select bands using a list:',
        col.select(['B11', 'B8', 'B3']).first().bandNames())

display('Select bands by an argument series:',
        col.select('B11', 'B8', 'B3').first().bandNames())

display('Mixing string and integer selectors is valid:',
        col.select(10, 'B8', 2).first().bandNames())

display('Rename selected bands using two corresponding lists:',
        col.select(['B11', 'B8', 'B3'], ['SWIR1', 'NIR', 'Green'])
        .first().bandNames())

# Use regular expressions to select bands.
display('Match "QA" followed by any two characters:',
        col.select('QA..').first().bandNames())

display('Match "B" followed by any character, any number of times:',
        col.select('B.*').first().bandNames())

display('Match "B" followed by any character, and any optional third character:',
        col.select('B..?').first().bandNames())

display('Match "B" followed by a character in the range 6-8:',
        col.select('B[6-8]').first().bandNames())

display('Match "B" followed by a character in the range 1-9 and then 1-2:',
        col.select('B[1-9][1-2]').first().bandNames())

display('Match "B" or "QA" each followed by any character, any number of times:',
        col.select('B.*|QA.*').first().bandNames())
```