Visão geral do gráfico

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

DataTable gráficos

O Earth Engine usa a API Google Visualization para oferecer suporte a gráficos. A API aceita um DataTable, que é uma tabela bidimensional 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 criar gráficos de objetos específicos do Earth Engine (consulte a seção a seguir). Saiba mais sobre como criar gráficos de um DataTable:

Gráficos de objetos do Earth Engine

O widget ui.Chart fornece métodos auxiliares para criar um 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 ao formato tabular em uma variedade de arranjos que determinam a atribuição de dados a séries e eixos de gráficos.

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

Tipos de gráficos

É possível produzir vários tipos de gráficos, como de dispersão, de linhas, de barras, de pizza e histograma. Especificamente, qualquer tipo de gráfico disponível no pacote corechart do Gráficos Google 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 do DataTable inclui exemplos para gerar vários tipos de gráficos.

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

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

Confira um 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 do ui.Chart podem ser exibidos 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 pop-out () no canto superior direito de um widget ui.Chart exibido. A nova página oferece uma exibição em janela cheia e opções para fazer o download do gráfico como uma imagem (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 ver os respectivos valores de x, y e série. O zoom e a movimentação do eixo são permitidos opcionalmente ativando a funcionalidade "explorer" de um gráfico.

Estilo de gráfico

Os Gráficos Google são altamente personalizáveis com propriedades de estilo. Use o método ui.Chart.setOptions() para definir as propriedades de estilo do gráfico. Consulte o guia Estilo de gráfico 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 alta taxa de cadência, tente usar um período mais curto, amostragem temporal ou gerar compostos 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.

As computações de longa duração podem não gerar um gráfico devido aos limites de resposta interativa do editor de código. Se a solicitação do gráfico expirar, tente exportar as etapas intermediárias da análise e gerar o gráfico novamente com base nos recursos exportados.