ee.Image.stratifiedSample
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Wyodrębnia z obrazu warstwową próbę losową punktów. Wyodrębnia określoną liczbę próbek dla każdej unikalnej wartości wykrytej w kolumnie „classBand”. Zwraca kolekcję FeatureCollection zawierającą 1 obiekt Feature na każdy wyodrębniony punkt, przy czym każdy obiekt Feature ma 1 właściwość na pasmo w obrazie wejściowym. Jeśli dla danej wartości klasy dostępnych jest mniej próbek niż określona liczba, zostaną uwzględnione wszystkie punkty dla tej klasy. Wymaga, aby element classBand zawierał wartości całkowite.
| Wykorzystanie | Zwroty |
|---|
Image.stratifiedSample(numPoints, classBand, region, scale, projection, seed, classValues, classPoints, dropNulls, tileScale, geometries) | FeatureCollection |
| Argument | Typ | Szczegóły |
|---|
to: image | Obraz | Obraz do próbkowania. |
numPoints | Liczba całkowita | Domyślna liczba punktów do próbkowania w każdej klasie. Można ją zastąpić w przypadku poszczególnych klas za pomocą właściwości „classValues” i „classPoints”. |
classBand | Ciąg tekstowy, domyślnie: null | Nazwa pasma zawierającego klasy, które mają być używane do stratyfikacji. Jeśli nie zostanie określony, używany jest pierwszy pas obrazu wejściowego. |
region | Geometria, domyślnie: null | Region, z którego ma pochodzić próbka. Jeśli nie zostanie podany, używany jest cały obszar obrazu wejściowego. |
scale | Liczba zmiennoprzecinkowa, domyślnie: null | Skala nominalna w metrach projekcji, w której ma być przeprowadzane próbkowanie. Domyślnie jest to skala pierwszego pasma obrazu wejściowego. |
projection | Prognoza, domyślnie: null | Projekcja, w której ma być przeprowadzane próbkowanie. Jeśli nie zostanie określona, używana jest projekcja pierwszego pasma obrazu wejściowego. Jeśli jest określony dodatkowo do skali, jest przeskalowywany do określonej skali. |
seed | Liczba całkowita, domyślnie: 0 | Wartość początkowa randomizacji do użycia w próbkowaniu. |
classValues | Lista, domyślna: null | Lista wartości klasy, dla których ma zostać zastąpiony parametr numPoints. Musi mieć taki sam rozmiar jak classPoints lub wartość null. |
classPoints | Lista, domyślna: null | Lista maksymalnej liczby pikseli do próbkowania dla każdej klasy na liście classValues. Musi mieć taki sam rozmiar jak classValues lub mieć wartość null. |
dropNulls | Wartość logiczna, domyślnie: true | Pomiń piksele, w których dowolne pasmo jest zamaskowane. |
tileScale | Liczba zmiennoprzecinkowa, domyślnie: 1 | Współczynnik skalowania używany do zmniejszania rozmiaru kafelka agregacji.Użycie większej wartości tileScale (np. 2 lub 4) może umożliwić obliczenia, które w przypadku domyślnego ustawienia wyczerpują pamięć. |
geometries | Wartość logiczna, domyślnie: false | Jeśli ma wartość „true”, wyniki będą zawierać geometrię dla każdego próbkowanego piksela. W przeciwnym razie geometrie zostaną pominięte (co pozwoli zaoszczędzić pamięć). |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-26 UTC."],[[["\u003cp\u003eExtracts a stratified random sample of points from an image based on distinct class values within a specified band.\u003c/p\u003e\n"],["\u003cp\u003eReturns a FeatureCollection containing one feature per sampled point, each with properties corresponding to the image bands.\u003c/p\u003e\n"],["\u003cp\u003eAllows customization of the number of samples per class, sampling region, scale, projection, and randomization.\u003c/p\u003e\n"],["\u003cp\u003eHandles cases with insufficient samples for a class by including all available points for that class.\u003c/p\u003e\n"],["\u003cp\u003eRequires the class band to contain integer values for proper stratification.\u003c/p\u003e\n"]]],[],null,["# ee.Image.stratifiedSample\n\nExtracts a stratified random sample of points from an image. Extracts the specified number of samples for each distinct value discovered within the 'classBand'. Returns a FeatureCollection of 1 Feature per extracted point, with each feature having 1 property per band in the input image. If there are less than the specified number of samples available for a given class value, then all of the points for that class will be included. Requires that the classBand contain integer values.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|\n| Image.stratifiedSample`(numPoints, `*classBand* `, `*region* `, `*scale* `, `*projection* `, `*seed* `, `*classValues* `, `*classPoints* `, `*dropNulls* `, `*tileScale* `, `*geometries*`)` | FeatureCollection |\n\n| Argument | Type | Details |\n|---------------|---------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `image` | Image | The image to sample. |\n| `numPoints` | Integer | The default number of points to sample in each class. Can be overridden for specific classes using the 'classValues' and 'classPoints' properties. |\n| `classBand` | String, default: null | The name of the band containing the classes to use for stratification. If unspecified, the first band of the input image is used. |\n| `region` | Geometry, default: null | The region to sample from. If unspecified, the input image's whole footprint is used. |\n| `scale` | Float, default: null | A nominal scale in meters of the projection to sample in. Defaults to the scale of the first band of the input image. |\n| `projection` | Projection, default: null | The projection in which to sample. If unspecified, the projection of the input image's first band is used. If specified in addition to scale, rescaled to the specified scale. |\n| `seed` | Integer, default: 0 | A randomization seed to use for subsampling. |\n| `classValues` | List, default: null | A list of class values for which to override the numPoints parameter. Must be the same size as classPoints or null. |\n| `classPoints` | List, default: null | A list of the per-class maximum number of pixels to sample for each class in the classValues list. Must be the same size as classValues or null. |\n| `dropNulls` | Boolean, default: true | Skip pixels in which any band is masked. |\n| `tileScale` | Float, default: 1 | A scaling factor used to reduce aggregation tile size; using a larger tileScale (e.g., 2 or 4) may enable computations that run out of memory with the default. |\n| `geometries` | Boolean, default: false | If true, the results will include a geometry per sampled pixel. Otherwise, geometries will be omitted (saving memory). |"]]
