ee.Image.clipToBoundsAndScale

Recorta una imagen según los límites de una geometría y la ajusta a un tamaño o una escala determinados.

Precaución: Si proporcionas una colección grande o compleja como argumento geometry, es posible que el rendimiento sea bajo. La recopilación de la geometría de las colecciones no se adapta bien; usa la colección (o la geometría) más pequeña que se requiera para lograr el resultado deseado.

Uso	Muestra
Image.clipToBoundsAndScale(geometry, width, height, maxDimension, scale)	Imagen

Argumento	Tipo	Detalles
esta: input	Imagen	Imagen para recortar y ajustar su tamaño.
geometry	Geometría, valor predeterminado: nulo	Es la geometría según la cual se recortará la imagen. La imagen se recortará según el cuadro de límite, en la proyección de la imagen, de esta geometría.
width	Número entero, valor predeterminado: nulo	Es el ancho al que se debe escalar la imagen, en píxeles. Se debe proporcionar junto con "height". Es exclusivo con "maxDimension" y "scale".
height	Número entero, valor predeterminado: nulo	Altura a la que se debe escalar la imagen, en píxeles. Se debe proporcionar junto con "width". Es exclusivo con "maxDimension" y "scale".
maxDimension	Número entero, valor predeterminado: nulo	Dimensión máxima a la que se puede ajustar la imagen, en píxeles. Es exclusivo con "width", "height" y "scale".
scale	Número de punto flotante, valor predeterminado: nulo	Si se especifica la escala, la proyección se ajusta dividiendo el valor de escala especificado por el tamaño nominal de un metro en la proyección de la imagen. Es exclusivo con "width", "height" y "maxDimension".

Ejemplos

Editor de código (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)');

Configuración de Python

Consulta la página Entorno de Python para obtener información sobre la API de Python y el uso de geemap para el desarrollo interactivo.

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