ee.Image.clipToBoundsAndScale

Découpe une image selon les limites d'une géométrie et la met à l'échelle selon une taille ou une échelle spécifiques.

Attention : Fournir une collection volumineuse ou complexe comme argument geometry peut entraîner de mauvaises performances. La collation de la géométrie des collections n'est pas bien adaptée à la mise à l'échelle. Utilisez la plus petite collection (ou géométrie) requise pour obtenir le résultat souhaité.

Utilisation	Renvoie
Image.clipToBoundsAndScale(geometry, width, height, maxDimension, scale)	Image

Argument	Type	Détails
ceci : input	Image	Image à rogner et à redimensionner.
geometry	Géométrie, valeur par défaut : null	Géométrie à laquelle rogner l'image. L'image sera découpée selon le cadre de délimitation, dans la projection de l'image, de cette géométrie.
width	Entier, valeur par défaut : null	Largeur à laquelle l'image doit être mise à l'échelle, en pixels. Doit être fourni avec "height". Exclusif avec "maxDimension" et "scale".
height	Entier, valeur par défaut : null	Hauteur à laquelle l'image doit être mise à l'échelle, en pixels. Doit être fourni avec "width". Exclusif avec "maxDimension" et "scale".
maxDimension	Entier, valeur par défaut : null	Dimension maximale à laquelle l'image doit être mise à l'échelle, en pixels. Exclusif avec "width", "height" et "scale".
scale	Float, valeur par défaut : null	Si une échelle est spécifiée, la projection est mise à l'échelle en divisant la valeur d'échelle spécifiée par la taille nominale d'un mètre dans la projection de l'image. Exclusif avec "width", "height" et "maxDimension".

Exemples

Éditeur de code (JavaScript)

// A digital elevation model.
var dem = ee.Image('NASA/NASADEM_HGT/001');
var demVis = {bands: 'elevation', min: 0, max: 2000};
print('DEM', dem);
Map.setCenter(-121.38, 46.51, 8);
Map.addLayer(dem, demVis, 'DEM');

// Clip DEM by a single polygon geometry, specify width and height parameters.
var geom1 = ee.Geometry.BBox(-123.55, 46.61, -122.57, 46.98);
var demClip1 = dem.clipToBoundsAndScale({
  geometry: geom1,
  width: 20,  // pixels
  height: 10  // pixels
});
print('Clipped image retains metadata and band names', demClip1);
Map.addLayer(demClip1, demVis, 'Single geometry clip (width, height)');
Map.addLayer(geom1, {color: 'red'}, 'Single geometry (width, height)');

// Clip DEM by a single polygon geometry, specify maxDimension parameter.
var geom2 = ee.Geometry.BBox(-120.79, 46.58, -120.16, 46.81);
var demClip2 = dem.clipToBoundsAndScale({
  geometry: geom2,
  maxDimension: 5,  // pixels
});
Map.addLayer(demClip2, demVis, 'Single polygon clip (maxDimension)');
Map.addLayer(geom2, {color: 'yellow'}, 'Single polygon (maxDimension)');

// Clip DEM by a single polygon geometry, specify scale parameter.
var geom3 = ee.Geometry.BBox(-120.79, 46.18, -120.16, 46.41);
var demClip3 = dem.clipToBoundsAndScale({
  geometry: geom3,
  scale: 1e4,  // meters
});
Map.addLayer(demClip3, demVis, 'Single polygon clip (scale)');
Map.addLayer(geom3, {color: 'blue'}, 'Single polygon (scale)');

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 digital elevation model.
dem = ee.Image('NASA/NASADEM_HGT/001')
dem_vis = {'bands': 'elevation', 'min': 0, 'max': 2000}
display('DEM', dem)
m = geemap.Map()
m.set_center(-121.38, 46.51, 8)
m.add_layer(dem, dem_vis, 'DEM')

# Clip DEM by a single polygon geometry, specify width and height parameters.
geom_1 = ee.Geometry.BBox(-123.55, 46.61, -122.57, 46.98)
dem_clip_1 = dem.clipToBoundsAndScale(geometry=geom_1, width=20, height=10)
display('Clipped image retains metadata and band names', dem_clip_1)
m.add_layer(dem_clip_1, dem_vis, 'Single geometry clip (width, height)')
m.add_layer(geom_1, {'color': 'red'}, 'Single geometry (width, height)')

# Clip DEM by a single polygon geometry, specify maxDimension parameter.
geom_2 = ee.Geometry.BBox(-120.79, 46.58, -120.16, 46.81)
dem_clip_2 = dem.clipToBoundsAndScale(geometry=geom_2, maxDimension=5)
m.add_layer(dem_clip_2, dem_vis, 'Single polygon clip (maxDimension)')
m.add_layer(geom_2, {'color': 'yellow'}, 'Single polygon (maxDimension)')

# Clip DEM by a single polygon geometry, specify scale parameter.
geom_3 = ee.Geometry.BBox(-120.79, 46.18, -120.16, 46.41)
dem_clip_3 = dem.clipToBoundsAndScale(geometry=geom_3, scale=1e4)
m.add_layer(dem_clip_3, dem_vis, 'Single polygon clip (scale)')
m.add_layer(geom_3, {'color': 'blue'}, 'Single polygon (scale)')
m