Panoramica dei grafici

L'editor di codice JavaScript di Earth Engine si integra perfettamente con Google Charts 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 nelle schede del browser autonome.

Grafici: DataTable

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

Grafici degli oggetti Earth Engine

Il widget ui.Chart fornisce metodi di assistenza per creare un DataTable e visualizzare i grafici da 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 arrangiamenti 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 produrre una serie di tipi di grafici, ad esempio grafici a dispersione, a linee, a barre, a torta e istogrammi. In particolare, è possibile generare qualsiasi tipo di grafico disponibile nel pacchetto corechart di Google Charts. Utilizza il metodo ui.Chart.setChartType() per impostare il tipo di grafico. Ogni pagina a cui si fa riferimento nelle sezioni Grafici di 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 di estrazione () nell' углу in alto a destra di un widget ui.Chart visualizzato. La nuova pagina offre una visualizzazione a schermo intero 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 sull'asse sono facoltativi e sono consentiti attivando la funzionalità "esploratore" di un grafico.

Stili

Google Charts è altamente personalizzabile tramite le proprietà di stile. Utilizza il metodo ui.Chart.setOptions() per impostare le proprietà dello stile del grafico. Per informazioni dettagliate, consulta la guida Stile grafico.

Limitazioni

Le funzioni ui.Chart mostreranno solo 5000 elementi. Se il tuo FeatureCollection, ImageCollection, Array o List contiene più elementi, valuta i modi in cui puoi limitare i dati. Se hai una serie temporale lunga con una frequenza elevata, prova a utilizzare un periodo di tempo più breve, il campionamento temporale o a generare composizioni temporali. Se il problema è spaziale, prova a utilizzare un sottoinsieme random. Se utilizzi i pixel in un elenco o in un array, prova a utilizzare una scala leggermente più grande o una regione più piccola.

I calcoli che richiedono molto tempo possono non riuscire a generare un grafico a causa dei limiti di risposta interattiva dell'editor di codice. Se la richiesta del grafico ha esito in timeout, prova a esportare i passaggi intermedi dell'analisi e a rigenerare il grafico dagli asset esportati.