Panoramica dei grafici

L'editor di codice JavaScript di Earth Engine si integra perfettamente con Grafici Google per una comoda visualizzazione dei dati tabulari tramite le funzioni ui.Chart. I grafici possono essere visualizzati in modo interattivo nella console dell'editor di codice, nei widget ui.Panel e in schede del browser autonome.

Grafici: DataTable

Earth Engine utilizza l'API di visualizzazione Google per supportare i grafici. L'API accetta un DataTable, ovvero una tabella bidimensionale in cui le righe sono osservazioni e le colonne sono attributi di osservazione. Tutti i grafici in Earth Engine sono derivati da un DataTable; il widget ui.Chart ti consente di fornire direttamente un DataTable. Offre la massima opportunità di personalizzazione dei grafici, ma potrebbe essere meno comodo rispetto ai metodi per la creazione di grafici di oggetti Earth Engine specifici (consulta la sezione seguente). Scopri di più sulla creazione di grafici da un DataTable:

Grafici degli oggetti di Earth Engine

Il widget ui.Chart fornisce metodi di supporto per creare un DataTable e eseguire il rendering dei grafici dagli oggetti Image, ImageCollection Feature, FeatureCollection, Array e List. Ogni funzione accetta un tipo di dati specifico e include metodi per ridurre i dati in formato tabulare in una serie di disposizioni che determinano l'assegnazione dei dati alle serie e agli assi del grafico.

Visita i seguenti link per scoprire come generare un grafico per ogni tipo di dati:

Tipi di grafici

È possibile generare vari tipi di grafici, ad esempio a dispersione, a linee, a barre, a torta e istogrammi. In particolare, è possibile generare qualsiasi tipo di grafico disponibile nel pacchetto corechart di Grafici Google. Utilizza il metodo ui.Chart.setChartType() per impostare il tipo di grafico. Ogni pagina collegata nelle sezioni Grafici degli oggetti Earth Engine e Grafici DataTable include esempi per la generazione di diversi tipi di grafici.

Utilizza le seguenti stringhe come input per il metodo ui.Chart.setChartType():

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

Ecco un esempio:

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

Visualizzazione e download

I widget ui.Chart possono essere visualizzati in tre modi:

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);
  • In una scheda del browser separata, fai clic sull'icona Separa () nell'angolo in alto a destra di un widget ui.Chart visualizzato. La nuova pagina offre una visualizzazione a finestra intera e opzioni per scaricare il grafico come immagine (PNG o SVG) o come file CSV dei dati sottostanti.

Interattività

I grafici sono interattivi per impostazione predefinita. Passa il mouse sopra punti, linee, barre e così via per visualizzare i rispettivi valori x, y e delle serie. Lo zoom e la panoramica degli assi sono consentiti facoltativamente attivando la funzionalità "Explorer" di un grafico.

Stile del grafico

I grafici Google sono altamente personalizzabili tramite le proprietà di stile. Utilizza il metodo ui.Chart.setOptions() per impostare le proprietà di stile del grafico. Per informazioni dettagliate, consulta la guida Stile dei grafici.

Limitazioni

Le funzioni ui.Chart eseguiranno il rendering di soli 5000 elementi. Se FeatureCollection, ImageCollection, Array o List contiene più elementi, valuta i modi in cui potresti limitare i dati. Se hai una serie temporale lunga con una frequenza di cadenza elevata, prova a utilizzare un periodo di tempo più breve, un campionamento temporale o a generare compositi temporali. Se il problema è spaziale, prova a utilizzare un sottoinsieme casuale. Se lavori con i pixel in un elenco o un array, prova a utilizzare una scala leggermente più grande o una regione più piccola.

I calcoli a lunga esecuzione potrebbero non riuscire a generare un grafico a causa dei limiti di risposta interattiva dell'editor di codice. Se la richiesta del grafico scade, prova a esportare i passaggi intermedi dell'analisi e a rigenerare il grafico dagli asset esportati.