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. Se você não fizer a verificação até 26 de setembro de 2025, seu acesso poderá ser suspenso.
Envie comentários
ee.ImageCollection.aggregate_sample_var
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Agrega uma determinada propriedade dos objetos em uma coleção, calculando a variância de amostra dos valores da propriedade selecionada.
Uso Retorna ImageCollection. aggregate_sample_var (property)
Número
Argumento Tipo Detalhes isso: collection
FeatureCollection A coleção para agregar. property
String A propriedade a ser usada de cada elemento da coleção.
Exemplos
Editor de código (JavaScript)
// A Lansat 8 TOA image collection for a specific year and location.
var col = ee . ImageCollection ( "LANDSAT/LC08/C02/T1_TOA" )
. filterBounds ( ee . Geometry . Point ([ - 122.073 , 37.188 ]))
. filterDate ( '2018' , '2019' );
// An image property of interest, percent cloud cover in this case.
var prop = 'CLOUD_COVER' ;
// Use ee.ImageCollection.aggregate_* functions to fetch information about
// values of a selected property across all images in the collection. For
// example, produce a list of all values, get counts, and calculate statistics.
print ( 'List of property values' , col . aggregate_array ( prop ));
print ( 'Count of property values' , col . aggregate_count ( prop ));
print ( 'Count of distinct property values' , col . aggregate_count_distinct ( prop ));
print ( 'First collection element property value' , col . aggregate_first ( prop ));
print ( 'Histogram of property values' , col . aggregate_histogram ( prop ));
print ( 'Min of property values' , col . aggregate_min ( prop ));
print ( 'Max of property values' , col . aggregate_max ( prop ));
// The following methods are applicable to numerical properties only.
print ( 'Mean of property values' , col . aggregate_mean ( prop ));
print ( 'Sum of property values' , col . aggregate_sum ( prop ));
print ( 'Product of property values' , col . aggregate_product ( prop ));
print ( 'Std dev (sample) of property values' , col . aggregate_sample_sd ( prop ));
print ( 'Variance (sample) of property values' , col . aggregate_sample_var ( prop ));
print ( 'Std dev (total) of property values' , col . aggregate_total_sd ( prop ));
print ( 'Variance (total) of property values' , col . aggregate_total_var ( prop ));
print ( 'Summary stats of property values' , col . aggregate_stats ( prop ));
// Note that if the property is formatted as a string, min and max will
// respectively return the first and last values according to alphanumeric
// order of the property values.
var propString = 'LANDSAT_SCENE_ID' ;
print ( 'List of property values (string)' , col . aggregate_array ( propString ));
print ( 'Min of property values (string)' , col . aggregate_min ( propString ));
print ( 'Max of property values (string)' , col . aggregate_max ( propString ));
Configuração do Python
Consulte a página
Ambiente Python para informações sobre a API Python e como usar
geemap
para desenvolvimento interativo.
import ee
import geemap.core as geemap
Colab (Python)
from pprint import pprint
# A Lansat 8 TOA image collection for a specific year and location.
col = ee . ImageCollection ( "LANDSAT/LC08/C02/T1_TOA" ) . filterBounds (
ee . Geometry . Point ([ - 122.073 , 37.188 ])) . filterDate ( '2018' , '2019' )
# An image property of interest, percent cloud cover in this case.
prop = 'CLOUD_COVER'
# Use ee.ImageCollection.aggregate_* functions to fetch information about
# values of a selected property across all images in the collection. For
# example, produce a list of all values, get counts, and calculate statistics.
print ( 'List of property values:' , col . aggregate_array ( prop ) . getInfo ())
print ( 'Count of property values:' , col . aggregate_count ( prop ) . getInfo ())
print ( 'Count of distinct property values:' ,
col . aggregate_count_distinct ( prop ) . getInfo ())
print ( 'First collection element property value:' ,
col . aggregate_first ( prop ) . getInfo ())
print ( 'Histogram of property values:' )
pprint ( col . aggregate_histogram ( prop ) . getInfo ())
print ( 'Min of property values:' , col . aggregate_min ( prop ) . getInfo ())
print ( 'Max of property values:' , col . aggregate_max ( prop ) . getInfo ())
# The following methods are applicable to numerical properties only.
print ( 'Mean of property values:' , col . aggregate_mean ( prop ) . getInfo ())
print ( 'Sum of property values:' , col . aggregate_sum ( prop ) . getInfo ())
print ( 'Product of property values:' , col . aggregate_product ( prop ) . getInfo ())
print ( 'Std dev (sample) of property values:' ,
col . aggregate_sample_sd ( prop ) . getInfo ())
print ( 'Variance (sample) of property values:' ,
col . aggregate_sample_var ( prop ) . getInfo ())
print ( 'Std dev (total) of property values' ,
col . aggregate_total_sd ( prop ) . getInfo ())
print ( 'Variance (total) of property values:' ,
col . aggregate_total_var ( prop ) . getInfo ())
print ( 'Summary stats of property values:' )
pprint ( col . aggregate_stats ( prop ) . getInfo ())
# Note that if the property is formatted as a string, min and max will
# respectively return the first and last values according to alphanumeric
# order of the property values.
prop_string = 'LANDSAT_SCENE_ID'
print ( 'List of property values (string):' ,
col . aggregate_array ( prop_string ) . getInfo ())
print ( 'Min of property values (string):' ,
col . aggregate_min ( prop_string ) . getInfo ())
print ( 'Max of property values (string):' ,
col . aggregate_max ( prop_string ) . getInfo ())
Envie comentários
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.
Quer enviar seu feedback?
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-26 UTC."],[],["The provided code demonstrates how to use `aggregate_*` functions on an `ImageCollection` to derive information about a specified property. Actions include listing all property values, getting counts, finding the first element's property value, creating histograms, and calculating statistical measures like min, max, mean, sum, product, standard deviation, and variance. These methods work on numeric properties, while string property methods are restricted to min and max (alphanumeric order).\n"]]