Présentation des graphiques

L'éditeur de code JavaScript d'Earth Engine s'intègre parfaitement à Google Charts pour une visualisation pratique des données sous forme de tableaux via les fonctions ui.Chart. Les graphiques peuvent être affichés de manière interactive dans la console de l'éditeur de code, les widgets ui.Panel et les onglets de navigateur autonomes.

DataTable graphique(s)

Earth Engine utilise l'API Google Visualization pour créer des graphiques. L'API accepte un DataTable, qui est un tableau à deux dimensions dont les lignes correspondent aux observations et les colonnes aux attributs d'observation. Tous les graphiques d'Earth Engine sont dérivés d'un DataTable. Le widget ui.Chart vous permet de fournir directement un DataTable. Il offre la plus grande opportunité de personnalisation des graphiques, mais peut être moins pratique que les méthodes de création de graphiques pour des objets Earth Engine spécifiques (voir la section suivante). En savoir plus sur la création de graphiques à partir d'un DataTable:

Graphiques d'objets Earth Engine

Le widget ui.Chart fournit des méthodes d'assistance pour créer un DataTable et afficher des graphiques à partir d'objets Image, ImageCollection, Feature, FeatureCollection, Array et List. Chaque fonction accepte un type de données spécifique et inclut des méthodes permettant de réduire les données au format tabulaire dans différents arrangements qui dictent l'attribution des données aux séries et aux axes du graphique.

Consultez les liens suivants pour découvrir comment générer un graphique pour chaque type de données:

Types de graphiques

Vous pouvez créer différents types de graphiques, par exemple: graphiques à nuage de points, graphiques linéaires, graphiques à barres, graphiques à secteurs et histogrammes. Plus précisément, vous pouvez générer n'importe quel type de graphique disponible dans le package corechart de Google Charts. Utilisez la méthode ui.Chart.setChartType() pour définir le type de graphique. Chaque page associée aux sections Graphiques d'objets Earth Engine et Graphiques DataTable inclut des exemples de génération de plusieurs types de graphiques.

Utilisez les chaînes suivantes comme entrée pour la méthode ui.Chart.setChartType():

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

Voici un exemple :

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

Affichage et téléchargement

Les widgets ui.Chart peuvent s'afficher de trois manières:

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);
  • Dans un autre onglet du navigateur, cliquez sur l'icône de fenêtre pop-up () en haut à droite d'un widget ui.Chart affiché. La nouvelle page offre un affichage plein écran et des options pour télécharger le graphique sous forme de graphique (PNG ou SVG) ou de fichier CSV des données sous-jacentes.

Interactivité

Les graphiques sont interactifs par défaut. Pointez sur les points, les lignes, les barres, etc. pour afficher les valeurs X, Y et de la série respectives. Le zoom et le panoramique sur les axes sont facultatifs. Pour les activer, activez la fonctionnalité "Explorer " d'un graphique.

Attribuer un style

Les graphiques Google sont hautement personnalisables via les propriétés de style. Utilisez la méthode ui.Chart.setOptions() pour définir les propriétés de style du graphique. Pour en savoir plus, consultez le guide Styler les graphiques.

Limites

Les fonctions ui.Chart n'affichent que 5 000 éléments géographiques. Si votre FeatureCollection, ImageCollection, Array ou List contient plus d'éléments, envisagez de limiter les données. Si vous disposez d'une longue série temporelle avec une fréquence élevée, essayez d'utiliser une période plus courte, un échantillonnage temporel ou de générer des composites temporels. Si le problème est spatial, essayez d'utiliser un sous-ensemble aléatoire. Si vous travaillez avec des pixels dans une liste ou un tableau, essayez d'utiliser une échelle légèrement plus grande ou une région plus petite.

Les calculs de longue durée peuvent ne pas générer de graphique en raison des limites de réponse interactive de l'éditeur de code. Si votre requête de graphique expire, essayez d'exporter les étapes intermédiaires de votre analyse et de générer à nouveau le graphique à partir des éléments exportés.