Anúncio: todos os projetos não comerciais registrados para usar o Earth Engine antes de
15 de abril de 2025 precisam
verificar a qualificação não comercial para manter o acesso ao Earth Engine.
ee.Image.stratifiedSample
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Extrai uma amostra aleatória estratificada de pontos de uma imagem. Extrai o número especificado de amostras para cada valor distinto descoberto em "classBand". Retorna um FeatureCollection de um recurso por ponto extraído, com cada recurso tendo uma propriedade por banda na imagem de entrada. Se houver menos amostras disponíveis do que o número especificado para um determinado valor de classe, todos os pontos dessa classe serão incluídos. Exige que o classBand contenha valores inteiros.
| Uso | Retorna |
|---|
Image.stratifiedSample(numPoints, classBand, region, scale, projection, seed, classValues, classPoints, dropNulls, tileScale, geometries) | FeatureCollection |
| Argumento | Tipo | Detalhes |
|---|
isso: image | Imagem | A imagem a ser amostrada. |
numPoints | Número inteiro | O número padrão de pontos a serem amostrados em cada classe. Pode ser substituído por classes específicas usando as propriedades "classValues" e "classPoints". |
classBand | String, padrão: null | O nome do intervalo que contém as classes a serem usadas para estratificação. Se não for especificado, a primeira banda da imagem de entrada será usada. |
region | Geometria, padrão: nulo | A região de onde a amostra será coletada. Se não for especificado, toda a área da imagem de entrada será usada. |
scale | Ponto flutuante, padrão: nulo | Uma escala nominal em metros da projeção para amostragem. O padrão é a escala da primeira banda da imagem de entrada. |
projection | Projeção, padrão: nulo | A projeção em que a amostragem será feita. Se não for especificado, a projeção da primeira banda da imagem de entrada será usada. Se especificado além da escala, será redimensionado para a escala especificada. |
seed | Número inteiro, padrão: 0 | Uma semente de aleatorização a ser usada para subamostragem. |
classValues | Lista, padrão: nulo | Uma lista de valores de classe para substituir o parâmetro "numPoints". Precisa ter o mesmo tamanho que "classPoints" ou ser nulo. |
classPoints | Lista, padrão: nulo | Uma lista do número máximo de pixels por classe a serem amostrados para cada classe na lista "classValues". Precisa ter o mesmo tamanho que "classValues" ou ser nulo. |
dropNulls | Booleano, padrão: verdadeiro | Ignorar pixels em que qualquer banda esteja mascarada. |
tileScale | Ponto flutuante, padrão: 1 | Um fator de escalonamento usado para reduzir o tamanho do bloco de agregação. Usar um tileScale maior (por exemplo, 2 ou 4) podem ativar cálculos que ficam sem memória com o padrão. |
geometries | Booleano, padrão: falso | Se for "true", os resultados vão incluir uma geometria por pixel amostrado. Caso contrário, as geometrias serão omitidas (economizando memória). |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 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). |"]]
