ee.Image.addBands

Renvoie une image contenant toutes les bandes copiées à partir de la première entrée et les bandes sélectionnées à partir de la deuxième entrée, en écrasant éventuellement les bandes de la première image portant le même nom. La nouvelle image comporte les métadonnées et l'empreinte de la première image d'entrée.

UtilisationRenvoie
Image.addBands(srcImg, names, overwrite)Image
ArgumentTypeDétails
ceci : dstImgImageImage dans laquelle copier les bandes.
srcImgImageImage contenant les bandes à copier.
namesListe, valeur par défaut : nullListe facultative des noms de groupes à copier. Si le paramètre "names" est omis, toutes les bandes de srcImg seront copiées.
overwriteBooléen, valeur par défaut : falseSi la valeur est "true", les bandes de `srcImg` remplaceront les bandes portant le même nom dans `dstImg`. Sinon, la nouvelle bande sera renommée avec un suffixe numérique ("foo" deviendra "foo_1", sauf si "foo_1" existe déjà, puis "foo_2", etc.).

Exemples

Éditeur de code (JavaScript)

// A Sentinel-2 surface reflectance image.
var img = ee.Image('COPERNICUS/S2_SR/20210109T185751_20210109T185931_T10SEG');
print('Original image', img);

// Scale reflectance bands and overwrite the original bands.
var reflBands = img.select('B.*').divide(10000);
img = img.addBands({
  srcImg: reflBands,
  overwrite: true
});

// Compute and add a single band (NDVI).
var ndvi = img.normalizedDifference(['B8', 'B4']).rename('NDVI');
img = img.addBands(ndvi);

// Compute and add multiple bands (NDWI and NBR).
var ndwi = img.normalizedDifference(['B3', 'B8']).rename('NDWI');
var nbr = img.normalizedDifference(['B8', 'B12']).rename('NBR');
var newBands = ee.Image([ndwi, nbr]);
img = img.addBands(newBands);

print('Image with added/modified bands', img);

Configuration de Python

Consultez la page Environnement Python pour en savoir plus sur l'API Python et sur l'utilisation de geemap pour le développement interactif.

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('Original image:', img.getInfo())

# Scale reflectance bands and overwrite the original bands.
refl_bands = img.select('B.*').divide(10000)
img = img.addBands(srcImg=refl_bands, overwrite=True)

# Compute and add a single band (NDVI).
ndvi = img.normalizedDifference(['B8', 'B4']).rename('NDVI')
img = img.addBands(ndvi)

# Compute and add multiple bands (NDWI and NBR).
ndwi = img.normalizedDifference(['B3', 'B8']).rename('NDWI')
nbr = img.normalizedDifference(['B8', 'B12']).rename('NBR')
new_bands = ee.Image([ndwi, nbr])
img = img.addBands(new_bands)

print('Image with added/modified bands:', img.getInfo())