Rasterdaten importieren

Sie können den Asset Manager oder die Befehlszeile (CLI) verwenden, um Bild- oder andere georeferenzierte Raster-Datasets im GeoTIFF- oder TFRecord-Format hochzuladen. (Weitere Informationen zum Importieren von Vektoren mit dem Code-Editor finden Sie unter Vektordaten importieren.)

Bild-Assets hochladen

GeoTIFF

Im Code-Editor können Sie GeoTIFF-Bilddateien mit einer Größe von bis zu 10 GB in Ihren Earth Engine-Nutzerordner hochladen. (Verwenden Sie für größere Dateien die Option Upload über die Befehlszeile.)

Wenn Sie ein GeoTIFF über den Code-Editor hochladen möchten, wählen Sie oben links den Tab „Assets“ aus, klicken Sie auf den Button und wählen Sie dann Bild hochladen aus. In Earth Engine wird ein Dialogfeld zum Hochladen angezeigt, das in etwa wie in Abbildung 1 aussehen sollte. Klicken Sie auf AUSWÄHLEN und rufen Sie ein GeoTIFF in Ihrem lokalen Dateisystem auf.

Geben Sie dem Bild eine geeignete Asset-ID (die noch nicht vorhanden ist) in Ihrem Nutzerordner. Wenn Sie das Bild in einen vorhandenen Ordner oder eine vorhandene Sammlung hochladen möchten, stellen Sie der Asset-ID die Ordner- oder Sammlungs-ID voran, z. B. projects/myproject/folder-or-collection-id/new-asset.

Klicken Sie auf HOCHLADEN, um den Upload zu starten.

Assets
Abbildung 1. Dialogfeld zum Hochladen von Bildern im Asset Manager

Sobald Sie den Upload gestartet haben, wird auf dem Tab „Tasks“ (Aufgaben) rechts im Code-Editor die Aufgabe „Asset ingestion“ (Asset-Aufnahme) angezeigt. Wenn Sie den Mauszeiger im Task-Manager auf die Aufgabe bewegen, wird ein ? angezeigt. -Symbol, mit dem Sie den Uploadstatus prüfen können. Wenn Sie einen Upload abbrechen möchten, klicken Sie auf das sich drehende Symbol  neben der Aufgabe. Nach Abschluss der Aufnahme wird das Asset in Ihrem Nutzerordner mit dem Symbol angezeigt.

GeoTIFF-Komprimierung

GeoTIFF-Dateien können mit DEFLATE, JPEG, JPEG-XL/JXL, LERC, LERC_DEFLATE, LERC_ZSTD, LZMA, LZW, WEBP oder ZSTD komprimiert werden. Cloud Optimized GeoTIFFs (COGs), die von der Earth Engine direkt gelesen und nicht aufgenommen werden, akzeptieren eine kleinere Auswahl. Weitere Informationen finden Sie unter COG-Komprimierung.

Empfehlungen für das Hochladen großer Dateien:

  • Beste Wahl: ZSTD bietet ein gutes Gleichgewicht zwischen Geschwindigkeit und Komprimierung.
  • Vermeiden: LZMA kann trotz guter Komprimierung sehr langsam sein.
  • Unkomprimierte Dateien: Dies führt zu größeren Dateien und längeren Uploadzeiten.
  • Verlustbehaftete Komprimierung (z.B. JPEG): Pixelwerte können sich ändern. Verwenden Sie eine verlustfreie Komprimierung (z.B. DEFLATE, LZMA, LZW, ZSTD) anstelle einer verlustbehafteten, es sei denn, Sie kennen die potenziellen Auswirkungen auf Ihre Daten.

TFRecord

Wenn Sie ein Bild aus einer TFRecord-Datei hochladen möchten, benötigen Sie die zugehörige Mixer-Datei, die beim Exportieren der Bilder generiert wurde, für die Sie die Inferenz durchgeführt haben. Weitere Informationen zur Mixer-Datei finden Sie auf der Exportseite. Genauer gesagt, um Vorhersagen (als Bild) zu importieren, die für exportierte Bilder erstellt wurden,

  1. Exportieren Sie Bilder in eine oder mehrere TFRecord-Dateien.
  2. Führen Sie eine Inferenz für die Bilder aus (z.B. model.predict()).
  3. Schreiben Sie die Ausgabe von model.predict() in eine TFRecord-Datei. Die Vorhersagen sollten in der gleichen Reihenfolge wie die Bildexporte sein, für die Sie die Inferenz durchgeführt haben. Die Reihenfolge kann durch Sortieren der vom Export erzeugten Dateinamen erzwungen werden. Weitere Informationen finden Sie im Abschnitt Export großer Dateien.
  4. Laden Sie die TFRecord-Datei(en) und den zugehörigen Mixer in Earth Engine hoch.

Bearbeitung von Properties

Bearbeiten Sie Asset-Metadaten, indem Sie ein oder mehrere Metadatenattribute angeben. Klicken Sie im Menü Eigenschaften auf Eigenschaft hinzufügen, um einen Eigenschaftsnamen und einen Wert zu definieren (Abbildung 2). Der Wert kann ein String oder eine Zahl sein. Geben Sie Strings ohne Anführungszeichen ein. Wenn Sie eine Zahl als String formatieren möchten, geben Sie vor der Zahl ein einfaches Anführungszeichen (') ein.

Standardmäßig wird ein Attribut system:time_start ohne Wert hinzugefügt. Diese Property wird von Earth Engine verwendet, wenn ImageCollection-Datumsfilter angewendet werden. Geben Sie entweder ein Datum im in Abbildung 2 gezeigten Format oder eine Zahl ein, die die Millisekunden seit dem 1. Januar 1970 darstellt. Weitere Informationen zu Zeitstempeln in Earth Engine finden Sie im Glossar. Der Asset Manager interpretiert eine Zahl, die als Wert für ein Attribut mit dem Namen system:time_start oder system:time_end eingegeben wurde, als Millisekunden und formatiert sie als Datum.

Klicken Sie auf das Symbol , um eine Property zu entfernen.

Erweiterte Optionen

Wählen Sie im Menü Erweitert die Pyramidenrichtlinie und den Maskierungsmodus für Ihre Daten aus.

Die Pyramidenrichtlinie gibt an, wie die Earth Engine Versionen des Bildes mit niedrigerer Auflösung generiert. Weitere Informationen dazu, wie Earth Engine mit mehreren Auflösungen umgeht, finden Sie im Dokument zur Skalierung. Wählen Sie eine Pyramidenrichtlinie „Mittelwert“, „Min“ oder „Max“ aus, um niedrigere Auflösungsstufen der Bildpyramide als Mittelwert, Minimum oder Maximum jeder 2x2-Gruppe von Pixeln mit höherer Auflösung zu berechnen. Dies ist eine geeignete Option für Bilder mit kontinuierlichen Werten. Wählen Sie für kategoriale Daten (z.B. Landbedeckung) oder QA-Daten die Pyramidenrichtlinie „Stichprobe“ (Pixel oben links) oder „Modus“ (am häufigsten vorkommender Wert oder Stichprobe, wenn kein Modus vorhanden ist) aus.

Der Maskierungsmodus gibt an, wie das hochgeladene Bild maskiert wird (falls überhaupt). Wenn Sie einen Wert für „Keine Daten“ angeben möchten, wählen Sie „Wert für ‚Keine Daten‘“ aus und geben Sie den Wert ein. Pixel mit diesem Wert werden im hochgeladenen Bild maskiert. Dieser Wert wird unabhängig auf jedes Band des Bildes angewendet. Wenn Sie das letzte Band Ihres Bildes als Maske für die anderen Bildbänder verwenden möchten, wählen Sie „Letztes Band als Alphaband verwenden“ aus. Das Alphaband sollte ein vorzeichenloses 8-Bit-Band sein, wobei 0 maskierte (vollständig transparente) Daten und 255 vollständig deckende Daten bedeutet.

Uploads in Kacheln

Wenn Sie ein einzelnes Bild als mehrere Kacheln hochladen möchten, wobei jede Kachel in einer anderen Quelldatei gespeichert ist, klicken Sie auf Weitere Datei hinzufügen, um dem Upload weitere Dateien hinzuzufügen. Earth Engine kombiniert die Kacheln zu einem einzigen Bild in Ihrem Nutzerordner.

Es gibt einige Einschränkungen hinsichtlich der Dateitypen, die in ein Bild-Asset hochgeladen werden können. Wichtig ist insbesondere:

  1. Die Bilder müssen dieselbe Anzahl von Bändern, Bittiefe, Projektion, Auflösung und Füllwerte haben.
  2. Der Versatz von einer Datei zur nächsten muss ein ganzzahliges Vielfaches der Pixelgröße sein.
  3. Lücken zwischen Kacheln werden im endgültigen Bild mit maskierten Pixeln gefüllt. Die Kacheln sollten daher idealerweise nebeneinander liegen und nicht weit verstreut sein. Bilder mit Lücken, die mehr als 99 % des Bildbereichs einnehmen, werden nicht aufgenommen.