ee.Image.clipToBoundsAndScale

Przycina obraz do granic obiektu Geometry i skaluje przycięty obraz do określonego rozmiaru lub skali.

Uwaga: podanie dużej lub złożonej kolekcji jako argumentu geometry może spowodować niską wydajność. Łączenie geometrii kolekcji nie jest skalowalne. Używaj najmniejszej kolekcji (lub geometrii), która jest wymagana do osiągnięcia pożądanego rezultatu.

Wykorzystanie	Zwroty
Image.clipToBoundsAndScale(geometry, width, height, maxDimension, scale)	Obraz

Argument	Typ	Szczegóły
to: input	Obraz	Obraz do przycięcia i skalowania.
geometry	Geometria, domyślnie: null	Geometria, do której ma być przycięty obraz. Obraz zostanie przycięty do ramki ograniczającej w projekcji obrazu tej geometrii.
width	Liczba całkowita, domyślnie: null	Szerokość, do której należy przeskalować obraz (w pikselach). Musi być podana razem z parametrem „height”. Wyklucza się z parametrami „maxDimension” i „scale”.
height	Liczba całkowita, domyślnie: null	Wysokość, do której należy przeskalować obraz (w pikselach). Musi być podana razem z parametrem „width”. Wyklucza się z parametrami „maxDimension” i „scale”.
maxDimension	Liczba całkowita, domyślnie: null	Maksymalny wymiar, do którego ma zostać przeskalowany obraz (w pikselach). Wyklucza się z atrybutami „width”, „height” i „scale”.
scale	Liczba zmiennoprzecinkowa, domyślnie: null	Jeśli określono skalę, projekcja jest skalowana przez podzielenie określonej wartości skali przez nominalny rozmiar metra w projekcji obrazu. Wyklucza się z atrybutami „width”, „height” i „maxDimension”.

Przykłady

Edytor kodu (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)');

Konfiguracja Pythona

Informacje o interfejsie Python API i używaniu geemap do interaktywnego programowania znajdziesz na stronie Środowisko Python.

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