AI-generated Key Takeaways
-
toBands()
transforms an ImageCollection into a single multi-band image, combining all bands from each image within the collection. -
Band names in the output image are prefixed with the original image ID to identify their source.
-
The band order in the output image reflects the order of images within the input collection, which can be controlled using
sort()
. -
There is a limit of 5000 bands for the output multi-band image.
Usage | Returns |
---|---|
ImageCollection.toBands() | Image |
Argument | Type | Details |
---|---|---|
this: collection | ImageCollection | The input collection. |
Examples
Code Editor (JavaScript)
// A Landsat 8 TOA image collection (2 months of images at a specific point). var col = ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA') .filterBounds(ee.Geometry.Point(-90.70, 34.71)) .filterDate('2020-07-01', '2020-09-01') .select('B[4-5]'); // Get NIR and SWIR1 bands only. print('Collection', col); // Convert the image collection to a single multi-band image. Note that image ID // ('system:index') is prepended to band names to delineate the source images. var img = col.toBands(); print('Collection to bands', img); // Band order is determined by collection order. Here, the collection is // sorted in descending order of the date of observation (reverse of previous). var bandOrder = col.sort('DATE_ACQUIRED', false).toBands(); print('Customized band order', bandOrder);
import ee import geemap.core as geemap
Colab (Python)
# A Landsat 8 TOA image collection (2 months of images at a specific point). col = ( ee.ImageCollection('LANDSAT/LC08/C02/T1_TOA') .filterBounds(ee.Geometry.Point(-90.70, 34.71)) .filterDate('2020-07-01', '2020-09-01') .select('B[4-5]') ) # Get NIR and SWIR1 bands only. print('Collection:', col.getInfo()) # Convert the image collection to a single multi-band image. Note that image ID # ('system:index') is prepended to band names to delineate the source images. img = col.toBands() print('Collection to bands:', img.getInfo()) # Band order is determined by collection order. Here, the collection is # sorted in descending order of the date of observation (reverse of previous). band_order = col.sort('DATE_ACQUIRED', False).toBands() print('Customized band order:', band_order.getInfo())