Il modulo ui.Chart.image contiene un insieme di funzioni per il rendering dei grafici
dai risultati della riduzione spazio-temporale delle immagini all'interno di un
ImageCollection. La scelta della funzione determina la disposizione dei dati nel grafico, ovvero cosa definisce i valori degli assi x e y e cosa definisce la serie.
Utilizza le descrizioni e gli esempi di funzioni riportati di seguito per determinare la funzione migliore per le tue finalità.
Funzioni di grafico
Utilizza i seguenti diagrammi di rappresentazione come guida visiva per capire in che modo ogni funzione organizza i risultati della riduzione della raccolta di immagini spaziotemporali in un grafico, ovvero quali elementi definiscono i valori x, i valori y e le serie. Tieni presente che
le funzioni ui.Chart.image.doySeries* accettano due riduttori: uno per la riduzione della regione (regionReducer) e un altro per la riduzione del giorno dell'anno coincidente intra-annuale (yearReducer). Gli esempi nelle sezioni seguenti utilizzano
ee.Reducer.mean() come argomento per entrambi questi parametri.
La data dell'immagine viene tracciata sull'asse x in base alla proprietà
system:time_start. Le serie sono definite da bande di immagini. I valori dell'asse Y
rappresentano la riduzione delle immagini, per data, per una singola regione.
La data dell'immagine viene tracciata sull'asse x in base alla proprietà
system:time_start. Le serie sono definite per regione. I valori dell'asse Y
rappresentano la riduzione delle immagini, per data, per una singola banda di immagini.
Il giorno dell'anno dell'immagine viene tracciato sull'asse x in base alla proprietà system:time_start. Le serie sono definite da bande di immagini. I valori dell'asse Y
rappresentano la riduzione dei pixel dell'immagine in una determinata regione, raggruppati per giorno dell'anno.
ui.Chart.image.doySeriesByYear
Il giorno dell'anno dell'immagine viene tracciato sull'asse x in base alla proprietà system:time_start. Le serie sono definite dagli anni presenti in ImageCollection. I valori dell'asse Y corrispondono alla riduzione dei pixel delle immagini in una determinata regione, raggruppati per giorno dell'anno, per una banda di immagini selezionata.
ui.Chart.image.doySeriesByRegion
Il giorno dell'anno dell'immagine viene tracciato sull'asse x in base alla proprietà system:time_start. Le serie sono definite per regione. I valori dell'asse Y rappresentano la riduzione dei pixel dell'immagine in una determinata regione, raggruppati per giorno dell'anno, per una banda di immagini selezionata.
Dati di esempio
I seguenti esempi si basano su un ImageCollection che è una serie temporale di NDVI ed EVI basati su MODIS. La riduzione delle regioni viene eseguita sulle ecoregioni definite dalle funzionalità di un FeatureCollection progettato a scopo dimostrativo (scopri come è stato realizzato).
ui.Chart.image.series
Utilizza ui.Chart.image.series per visualizzare una serie temporale di immagini per una determinata regione. Ogni banda di immagini viene presentata come una serie univoca. È utile per confrontare le serie temporali delle singole bande di immagini. Qui viene tracciata una raccolta di immagini MODIS con bande che rappresentano gli indici di vegetazione NDVI ed EVI. La data di ogni osservazione dell'immagine è inclusa sull'asse x, mentre la riduzione media dei pixel che intersecano un'ecoregione forestale definisce l'asse y.
Editor di codice (JavaScript)
// Import the example feature collection and subset the forest feature. var forest = ee.FeatureCollection('projects/google/charts_feature_example') .filter(ee.Filter.eq('label', 'Forest')); // Load MODIS vegetation indices data and subset a decade of images. var vegIndices = ee.ImageCollection('MODIS/061/MOD13A1') .filter(ee.Filter.date('2010-01-01', '2020-01-01')) .select(['NDVI', 'EVI']); // Define the chart and print it to the console. var chart = ui.Chart.image .series({ imageCollection: vegIndices, region: forest, reducer: ee.Reducer.mean(), scale: 500, xProperty: 'system:time_start' }) .setSeriesNames(['EVI', 'NDVI']) .setOptions({ title: 'Average Vegetation Index Value by Date for Forest', hAxis: {title: 'Date', titleTextStyle: {italic: false, bold: true}}, vAxis: { title: 'Vegetation index (x1e4)', titleTextStyle: {italic: false, bold: true} }, lineWidth: 5, colors: ['e37d05', '1d6b99'], curveType: 'function' }); print(chart);
ui.Chart.image.seriesByRegion
Utilizza ui.Chart.image.seriesByRegion per visualizzare una singola serie temporale di bande di immagini per più regioni. Ogni regione viene presentata come una serie univoca. È utile per confrontare le serie temporali di una singola banda tra più regioni.
Qui, una raccolta di immagini MODIS che rappresenta una serie temporale NDVI è tracciata per tre ecoregioni. La data di ogni osservazione dell'immagine è inclusa sull'asse x, mentre la riduzione media dei pixel che intersecano le ecoregioni di foreste, deserti e praterie definisce la serie sull'asse y.
Editor di codice (JavaScript)
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Load MODIS vegetation indices data and subset a decade of images. var vegIndices = ee.ImageCollection('MODIS/061/MOD13A1') .filter(ee.Filter.date('2010-01-01', '2020-01-01')) .select(['NDVI', 'EVI']); // Define the chart and print it to the console. var chart = ui.Chart.image .seriesByRegion({ imageCollection: vegIndices, band: 'NDVI', regions: ecoregions, reducer: ee.Reducer.mean(), scale: 500, seriesProperty: 'label', xProperty: 'system:time_start' }) .setOptions({ title: 'Average NDVI Value by Date', hAxis: {title: 'Date', titleTextStyle: {italic: false, bold: true}}, vAxis: { title: 'NDVI (x1e4)', titleTextStyle: {italic: false, bold: true} }, lineWidth: 5, colors: ['f0af07', '0f8755', '76b349'], }); print(chart);
ui.Chart.image.doySeries
Utilizza ui.Chart.image.doySeries per visualizzare una serie temporale dei giorni dell'anno per una determinata regione. Ogni banda di immagini viene presentata come una serie univoca. È utile per
ridurre le osservazioni che si verificano nello stesso giorno dell'anno, su più
anni, per confrontare ad esempio i profili annuali medi di NDVI ed EVI di MODIS, come in
questo esempio.
Editor di codice (JavaScript)
// Import the example feature collection and subset the grassland feature. var grassland = ee.FeatureCollection('projects/google/charts_feature_example') .filter(ee.Filter.eq('label', 'Grassland')); // Load MODIS vegetation indices data and subset a decade of images. var vegIndices = ee.ImageCollection('MODIS/061/MOD13A1') .filter(ee.Filter.date('2010-01-01', '2020-01-01')) .select(['NDVI', 'EVI']); // Define the chart and print it to the console. var chart = ui.Chart.image .doySeries({ imageCollection: vegIndices, region: grassland, regionReducer: ee.Reducer.mean(), scale: 500, yearReducer: ee.Reducer.mean(), startDay: 1, endDay: 365 }) .setSeriesNames(['EVI', 'NDVI']) .setOptions({ title: 'Average Vegetation Index Value by Day of Year for Grassland', hAxis: { title: 'Day of year', titleTextStyle: {italic: false, bold: true} }, vAxis: { title: 'Vegetation index (x1e4)', titleTextStyle: {italic: false, bold: true} }, lineWidth: 5, colors: ['e37d05', '1d6b99'], }); print(chart);
ui.Chart.image.doySeriesByYear
Utilizza ui.Chart.image.doySeriesByYear per visualizzare una serie temporale relativa al giorno dell'anno per una determinata regione e una determinata banda di immagini, in cui ogni anno distinto nella raccolta di immagini viene presentato come una serie univoca. È utile per confrontare le serie temporali annuali tra gli anni. Ad esempio, in questo esempio, i profili NDVI annuali ricavati da MODIS per un'ecoregione di prateria sono tracciati per gli anni 2012 e 2019, fornendo una comoda interpretazione su base annua.
Editor di codice (JavaScript)
// Import the example feature collection and subset the grassland feature. var grassland = ee.FeatureCollection('projects/google/charts_feature_example') .filter(ee.Filter.eq('label', 'Grassland')); // Load MODIS vegetation indices data and subset years 2012 and 2019. var vegIndices = ee.ImageCollection('MODIS/061/MOD13A1') .filter(ee.Filter.or( ee.Filter.date('2012-01-01', '2013-01-01'), ee.Filter.date('2019-01-01', '2020-01-01'))) .select(['NDVI', 'EVI']); // Define the chart and print it to the console. var chart = ui.Chart.image .doySeriesByYear({ imageCollection: vegIndices, bandName: 'NDVI', region: grassland, regionReducer: ee.Reducer.mean(), scale: 500, sameDayReducer: ee.Reducer.mean(), startDay: 1, endDay: 365 }) .setOptions({ title: 'Average NDVI Value by Day of Year for Grassland', hAxis: { title: 'Day of year', titleTextStyle: {italic: false, bold: true} }, vAxis: { title: 'NDVI (x1e4)', titleTextStyle: {italic: false, bold: true} }, lineWidth: 5, colors: ['39a8a7', '9c4f97'], }); print(chart);
ui.Chart.image.doySeriesByRegion
Utilizza ui.Chart.image.doySeriesByRegion per visualizzare una singola serie temporale del giorno dell'anno per più regioni, dove ogni regione distinta è presentata come una serie unica. È utile per confrontare le serie temporali annuali a banda singola tra le regioni. Ad esempio, in questo esempio vengono tracciati i profili annuali dell'NDVI ricavati da MODIS per le ecoregioni di foreste, deserti e praterie, offrendo un comodo confronto della risposta dell'NDVI in base alla regione. Tieni presente che le osservazioni intra-annuali che si verificano nello stesso giorno dell'anno vengono ridotte in base alla media.
Editor di codice (JavaScript)
// Import the example feature collection. var ecoregions = ee.FeatureCollection('projects/google/charts_feature_example'); // Load MODIS vegetation indices data and subset a decade of images. var vegIndices = ee.ImageCollection('MODIS/061/MOD13A1') .filter(ee.Filter.date('2010-01-01', '2020-01-01')) .select(['NDVI', 'EVI']); // Define the chart and print it to the console. var chart = ui.Chart.image .doySeriesByRegion({ imageCollection: vegIndices, bandName: 'NDVI', regions: ecoregions, regionReducer: ee.Reducer.mean(), scale: 500, yearReducer: ee.Reducer.mean(), seriesProperty: 'label', startDay: 1, endDay: 365 }) .setOptions({ title: 'Average NDVI Value by Day of Year', hAxis: { title: 'Day of year', titleTextStyle: {italic: false, bold: true} }, vAxis: { title: 'NDVI (x1e4)', titleTextStyle: {italic: false, bold: true} }, lineWidth: 5, colors: ['f0af07', '0f8755', '76b349'], }); print(chart);