Visão geral do gráfico

O Editor de código do JavaScript do Earth Engine se integra perfeitamente ao Google Charts para uma visualização conveniente de dados tabulares usando funções ui.Chart. Os gráficos podem ser mostrados de forma interativa no console do Editor de código, nos widgets ui.Panel e nas guias independentes do navegador.

DataTable gráficos

O Earth Engine usa a API Google Visualization para oferecer suporte a gráficos. A API aceita uma DataTable, que é uma tabela 2D em que as linhas são observações e as colunas são atributos de observação. Todos os gráficos no Earth Engine são derivados de um DataTable. O widget ui.Chart permite fornecer um DataTable diretamente. Ele oferece a maior oportunidade de personalização de gráficos, mas pode ser menos conveniente do que os métodos para representar objetos específicos do Earth Engine (consulte a próxima seção). Saiba mais sobre como criar gráficos com um DataTable:

Gráficos de objetos do Earth Engine

O widget ui.Chart fornece métodos auxiliares para construir uma DataTable e renderizar gráficos de objetos Image, ImageCollection Feature, FeatureCollection, Array e List. Cada função aceita um tipo de dados específico e inclui métodos para reduzir os dados a um formato tabular em vários arranjos que determinam a atribuição de dados a séries e eixos do gráfico.

Acesse os links a seguir para saber como gerar um gráfico para cada tipo de dados:

Tipos de gráficos

Vários tipos de gráficos podem ser produzidos, por exemplo: dispersão, linha, barra, pizza e histograma. Especificamente, qualquer tipo de gráfico disponível no pacote corechart do Google Charts pode ser gerado. Use o método ui.Chart.setChartType() para definir o tipo de gráfico. Cada página vinculada nas seções Gráficos de objetos do Earth Engine e Gráficos de DataTable inclui exemplos para gerar vários tipos de gráfico.

Use as seguintes strings como entrada para o método ui.Chart.setChartType():

'ScatterChart'
'LineChart'
'ColumnChart'
'BarChart'
'PieChart'
'AreaChart'

Exemplo:

var data = ee.List([0, 1, 2, 3, 4, 5]);
var chart = ui.Chart.array.values(data, 0, data)
  .setChartType('ColumnChart');
print(chart);

Exibir e fazer o download

Os widgets ui.Chart podem ser mostrados de três maneiras:

var data = ee.List([0, 1, 2, 3, 4, 5]);
var chart = ui.Chart.array.values(data, 0, data);
print(chart);

var data = ee.List([0, 1, 2, 3, 4, 5]);
var chart = ui.Chart.array.values(data, 0, data);
var chartPanel = ui.Panel(chart);
Map.add(chartPanel);
  • Em uma guia separada do navegador, clique no ícone de separação () no canto superior direito de um widget ui.Chart exibido. A nova página oferece uma exibição em tela cheia e opções para fazer o download do gráfico como um gráfico (PNG ou SVG) ou um arquivo CSV dos dados subjacentes.

Interatividade

Os gráficos são interativos por padrão. Passe o cursor sobre pontos, linhas, barras etc. para conferir os valores x, y e da série. O zoom e a movimentação do eixo são permitidos opcionalmente ao ativar a funcionalidade "Explorer" de um gráfico.

Estilo

Os gráficos do Google são altamente personalizáveis usando propriedades de estilo. Use o método ui.Chart.setOptions() para definir as propriedades de estilo do gráfico. Consulte o guia Estilização de gráficos para mais detalhes.

Limitações

As funções ui.Chart renderizam apenas 5.000 elementos. Se o FeatureCollection, ImageCollection, Array ou List tiver mais elementos, considere maneiras de limitar os dados. Se você tiver uma série temporal longa com uma taxa de cadência alta, tente usar um período de tempo mais curto, amostragem temporal ou gerar composições temporais. Se o problema for espacial, tente usar um subconjunto aleatório. Se você estiver trabalhando com pixels em uma lista ou matriz, tente usar uma escala um pouco maior ou uma região menor.

Cálculos de longa duração podem falhar ao gerar um gráfico devido aos limites de resposta interativa do editor de código. Se o tempo limite da solicitação do gráfico expirar, tente exportar etapas intermediárias da análise e regenerar o gráfico com os recursos exportados.