Importer des données raster

Vous pouvez utiliser l'Asset Manager ou la ligne de commande (CLI) pour importer des images ou d'autres ensembles de données raster géoréférencés au format GeoTIFF ou TFRecord. (Pour en savoir plus sur l'importation de vecteurs à l'aide de l'éditeur de code, consultez la section Importer des données vectorielles.)

Importer des composants Image

GeoTIFF

Dans l'éditeur de code, vous pouvez importer des fichiers image GeoTIFF d'une taille maximale de 10 Go dans votre dossier utilisateur Earth Engine. (Pour les fichiers plus volumineux, utilisez l'option Importation par ligne de commande.)

Pour importer un GeoTIFF à l'aide de l'éditeur de code, sélectionnez l'onglet "Composants" en haut à gauche, cliquez sur le bouton , puis sélectionnez Importer une image. Earth Engine affiche une boîte de dialogue d'importation qui devrait ressembler à la figure 1. Cliquez sur le bouton SELECT (SÉLECTIONNER) et accédez à un fichier GeoTIFF sur votre système de fichiers local.

Attribuez à l'image un ID d'élément approprié (qui n'existe pas encore) dans votre dossier utilisateur. Si vous souhaitez importer l'image dans un dossier ou une collection existant, ajoutez un préfixe à l'ID du composant, par exemple projects/myproject/folder-or-collection-id/new-asset.

Cliquez sur IMPORTER pour lancer l'importation.

éléments
Figure 1. Boîte de dialogue d'importation d'images du gestionnaire d'assets

Une fois l'importation lancée, une tâche "Ingestion d'assets" s'affiche dans l'onglet "Tâches", à droite de l'éditeur de code. Lorsque vous pointez sur la tâche dans le gestionnaire de tâches, un ? s'affiche. qui vous permet de vérifier l'état de l'importation. Pour annuler une importation, cliquez sur l'icône en forme de roue dentée  à côté de la tâche. Une fois l'ingestion terminée, l'élément s'affiche dans votre dossier utilisateur avec une icône .

Compression GeoTIFF

Les fichiers GeoTIFF peuvent être compressés avec DEFLATE, JPEG-XL/JXL, LERC, LERC_DEFLATE, LERC_ZSTD, LZM, LZW, WEBP ou ZSTD.

Recommandations pour une expérience d'importation optimale pour les fichiers volumineux:

  • Meilleur choix:ZSTD offre un bon équilibre entre vitesse et compression.
  • À éviter:LZMA peut être très lent malgré une bonne compression.
  • Fichiers non compressés:les fichiers sont plus volumineux et les temps d'importation sont plus longs.
  • Compression avec perte (par exemple, JPEG) : peut modifier les valeurs des pixels. Utilisez une compression sans perte (par exemple, DEFLATE, LZMA, LZW, ZSTD) plutôt que des méthodes avec perte, sauf si vous comprenez l'impact potentiel sur vos données.

TFRecord

Pour importer une image à partir d'un fichier TFRecord, vous devez disposer du fichier de mélangeur associé généré lorsque vous avez exporté les images sur lesquelles vous avez effectué l'inférence. Pour en savoir plus sur le fichier de mixeur, consultez la page d'exportation. Plus précisément, pour importer des prédictions (sous forme d'image) effectuées sur des images exportées :

  1. Exporter des images dans un ou plusieurs fichiers TFRecord
  2. Effectuez des inférences sur les images (par exemple, model.predict()).
  3. Écrivez la sortie de model.predict() dans un fichier TFRecord. Les prédictions doivent être dans le même ordre que les exportations d'images sur lesquelles vous avez effectué l'inférence. L'ordre peut être appliqué en triant les noms de fichiers générés par l'exportation. Pour en savoir plus, consultez la section sur les exportations de fichiers volumineux.
  4. Importez le ou les fichiers TFRecord et le mélangeur associé dans Earth Engine.

Modification des propriétés

Modifiez les métadonnées d'un élément en spécifiant une ou plusieurs propriétés de métadonnées. Dans le menu Properties (Propriétés), cliquez sur Add property (Ajouter une propriété) pour définir un nom et une valeur de propriété (figure 2). La valeur peut être une chaîne ou un nombre. Saisissez les chaînes sans guillemets. Pour mettre en forme un nombre en tant que chaîne, saisissez un guillemet simple (') avant le nombre.

Par défaut, une propriété system:time_start est ajoutée sans valeur. Cette propriété est utilisée par Earth Engine lors de l'application de filtres de date ImageCollection. Saisissez une date au format indiqué dans la figure 2 ou un nombre représentant les millisecondes écoulées depuis le 1er janvier 1970. (Pour en savoir plus sur les codes temporels dans Earth Engine, consultez le glossaire.) Le Gestionnaire d'éléments interprète un nombre saisi comme valeur d'une propriété nommée system:time_start ou system:time_end en millisecondes et le met en forme en tant que date.

Cliquez sur l'icône pour supprimer une propriété.

Options avancées

Dans le menu Avancé, choisissez la stratégie de pyramidage et le mode de masquage pour vos données.

La stratégie de pyramidisation spécifie comment Earth Engine génère des versions de l'image à résolution inférieure. Pour en savoir plus sur la façon dont Earth Engine gère plusieurs résolutions, consultez le document sur l'échelle. Choisissez une règle de pyramidage "Moyenne", "Min" ou "Max" pour calculer les niveaux de résolution inférieurs de la pyramide d'images en tant que moyenne, minimum ou maximum de chaque groupe de 2 x 2 pixels de résolution supérieure. Cette option convient aux images à valeurs continues. Pour les données catégorielles (par exemple, l'occupation des sols) ou de contrôle qualité, choisissez une règle de pyramidage "Échantillon" (pixel en haut à gauche) ou "Mode" (valeur la plus fréquente ou échantillon si aucun mode n'est défini).

Le mode de masquage indique comment l'image importée est masquée (le cas échéant). Pour spécifier une valeur sans données, sélectionnez "Valeur sans données", puis saisissez la valeur. Les pixels ayant cette valeur seront masqués dans l'image importée. Cette valeur est appliquée indépendamment à chaque bande de l'image. Pour utiliser la dernière bande de votre image comme masque pour les autres bandes de l'image, sélectionnez "Utiliser la dernière bande comme bande alpha". La bande alpha doit être une bande de 8 bits non signée, où 0 correspond aux données masquées (totalement transparentes) et 255 aux données totalement opaques.

Importations en mosaïque

Pour importer une seule image sous forme de plusieurs tuiles, où chaque tuile est stockée dans un fichier source différent, cliquez sur Ajouter un autre fichier pour ajouter des fichiers à l'importation. Earth Engine combine les tuiles pour créer une seule image dans votre dossier utilisateur.

Il existe quelques contraintes concernant les types de fichiers pouvant être importés dans un composant Image. En particulier :

  1. Les images doivent avoir le même nombre de bandes, la même profondeur de bits, la même projection, la même résolution et les mêmes valeurs de remplissage.
  2. Le décalage d'un fichier à l'autre doit être un multiple entier de la taille en pixels.
  3. Les espaces entre les tuiles seront remplis de pixels masqués dans l'image finale. Il est donc préférable que les tuiles soient adjacentes et non espacées. Les images comportant des espaces occupant plus de 99% de la zone de l'image ne seront pas ingérées.