Raster herunterladen (Data Management)

Zusammenfassung

Lädt die Quelldateien aus einem Image-Service oder Mosaik-Dataset herunter.

Verwendung

  • Die Raster-Datasets, die Sie herunterladen, sind die Quelldateien, außer wenn Sie sie in ein anderes Format konvertieren. Formatkonvertierung kann erzwungen werden, oder sie tritt nur nach Bedarf ein. Heruntergeladene Dateien werden konvertiert, wenn Ausschneiden erfolgt oder die Quelldatei nicht als Raster heruntergeladen werden kann.

  • Sie können ausgewählte Raster oder LAS-Dateien von einem Image-Service oder einem Mosaik-Dataset in einen angegebenen Ordner im Originaldateiformat herunterladen.

  • Wenn eine Ausschneideausdehnung angegeben wird, werden die Raster, die die Ausschneideausdehnung überschneiden, ausgeschnitten und dann in ein angegebenes Format konvertiert.

  • Sie können die Daten auch in der gleichen Ordnerstruktur wie die der Quelle herunterladen.

Parameter

BeschriftungErläuterungDatentyp
Eingabe

Der Image-Service oder das Mosaik-Dataset, der bzw. das heruntergeladen werden soll.

Image Service; Mosaic Layer; Raster Layer; String
Ausgabeordner

Das Ziel für den Image-Service oder das Mosaik-Dataset.

Folder
Abfragedefinition
(optional)

Ein SQL-Ausdruck zum Beschränken des Downloads auf Raster-Datasets, die dem Ausdruck entsprechen.

SQL Expression
Auswahl-Feature
(optional)

Beschränkt den Download auf die Ausdehnung einer Feature-Class oder eines Rahmens. Alle Raster-Datasets, die sich mit der Ausdehnung überschneiden, werden heruntergeladen.

  • Aktuelle Anzeigeausdehnung Kartenansicht: Die Ausdehnung basiert auf der aktiven Karte oder Szene. Diese Option ist nur verfügbar, wenn eine aktive Karte vorhanden ist.
  • Ausdehnung darstellen Ausgleichen und Beenden: Die Ausdehnung basiert auf einem Rechteck, das auf der Karte oder Szene aufgezogen wurde. Bei dieser Option wird eine Feature-Class in der Projekt-Geodatabase erstellt und ein Layer zur Karte hinzugefügt. Das Koordinatensystem der Feature-Class stimmt mit dem der Karte überein.
    Hinweis:

    Diese Option ist im Dialogfeld Umgebungen nicht verfügbar. Sie ist nur über einen Werkzeugparameter mit dem Datentyp "Ausdehnung" oder über die Registerkarte Umgebungen eines Werkzeugdialogfeldes verfügbar.

    Hinweis:

    Wenn die Bearbeitungsoption Bearbeitung über die Registerkarte "Bearbeiten" aktivieren und deaktivieren aktiviert ist, dann müssen Sie auf der Registerkarte Bearbeiten des Menübands die Bearbeitung aktivieren, um die Ausdehnung darzustellen.

  • Ausdehnung eines Layers:Layer Die Ausdehnung basiert auf einem aktiven Karten-Layer. Verwenden Sie die Dropdown-Liste, um einen verfügbaren Layer auszuwählen, oder verwenden Sie die Option Ausdehnung von Daten in allen Layern, um die kombinierte Ausdehnung aller aktiven Karten-Layer mit Ausnahme der Grundkarte zu erhalten. Diese Option ist nur verfügbar, wenn eine aktive Karte mit Layern vorhanden ist.

    Jeder Karten-Layer bietet die folgenden Optionen:

    • Alle Features Alles auswählen: Die Ausdehnung aller Features im Layer.
    • Ausgewählte FeaturesArea from Selected Features: Die Ausdehnung der ausgewählten Features im Layer.
    • Sichtbare Features Extent Indicator: Die Ausdehnung der sichtbaren Features im Layer.
      Hinweis:

      Die Ausdehnungen der Optionen Ausgewählte Features Area from Selected Features und Sichtbare Features Extent Indicator sind nur für Feature-Layer verfügbar.

  • Durchsuchen:Durchsuchen Die Ausdehnung basiert auf einem vorhandenen Dataset.
  • Zwischenablage Einfügen: Die Ausdehnung kann in die Zwischenablage kopiert und aus der Zwischenablage eingefügt werden.
    • Ausdehnung kopieren Kopieren: Kopiert die Ausdehnungskoordinaten und das Ausdehnungskoordinatensystem in die Zwischenablage.
    • Ausdehnung einfügen Einfügen: Fügt die Ausdehnungskoordinaten und optional das Koordinatensystem aus der Zwischenablage ein. Wenn die Werte in der Zwischenablage kein Koordinatensystem beinhalten, wird für die Ausdehnung das Koordinatensystem der Karte verwendet.
    Hinweis:

    Beim Kopieren der Ausdehnungskoordinaten in die und Einfügen aus der Zwischenablage wird dieselbe Formatierung und Reihenfolge wie beim ArcPy-Objekt Extent verwendet: X-Min, Y-Min, X-Max, Y-Max und der Raumbezug.

  • Ausdehnung zurücksetzen: ZurücksetzenDie Ausdehnung wird auf den Standardwert zurückgesetzt.
  • Manuell eingegebene Koordinaten: Die Koordinaten müssen numerische Werte sein und im Koordinatensystem der aktiven Karte liegen.
    Vorsicht:

    Die Karte kann statt der eingegebenen Koordinaten auch andere Anzeigeeinheiten verwenden. Die Verwendung einer Kardinalrichtung (N, S, O, W) wird nicht unterstützt. Verwenden Sie für die Koordinaten in Richtung Süden und Westen Werte mit negativem Vorzeichen.

Extent
Ausschneiden mit Auswahl-Feature
(optional)

Geben Sie an, ob die heruntergeladenen Bilder basierend auf der Geometrie eines Features ausgeschnitten werden sollen. Jedes Raster, das sich mit der Ausschneidegeometrie überschneidet, wird ausgeschnitten und dann heruntergeladen. Dies ist nützlich, wenn der Interessenbereich kein Rechteck ist. Wenn heruntergeladene Bilder ausgeschnitten werden, müssen Sie ein Ausgabeformat für die ausgeschnittenen Bilder angeben.

  • Deaktiviert: Die Dateien werden basierend auf dem kleinsten umgebenden Rechteck ausgeschnitten, das angegeben wurde. Dies ist die Standardeinstellung.
  • Aktiviert: Die Dateien werden basierend auf der Geometrie des Auswahl-Features ausgeschnitten.
Boolean
Raster konvertieren
(optional)

Wählen Sie aus, ob die Raster immer in das angegebene Format konvertiert werden sollen oder ob nur konvertiert wird, wenn es notwendig ist.

  • Deaktiviert: Die Raster-Datasets werden nicht in ein neues Format konvertiert.
  • Aktiviert: Die heruntergeladenen Raster-Datasets werden in ein anderes Format konvertiert. Wenn Sie Auswahl-Feature zum Beschränken der Ausdehnung verwendet haben, müssen Sie ein Format im Parameter Ausgabeformat festlegen.
Boolean
Ausgabeformat
(optional)

Wählen Sie ein Ausgabeformat für die heruntergeladenen Raster-Datasets aus.

  • TIFFTagged Image File Format. Dies ist die Standardeinstellung.
  • BILEsri Band Interleaved by Line
  • BSQEsri Band Sequential
  • BIPEsri Band Interleaved by Pixel
  • BMPBitmap
  • ENVIENVI DAT-Datei
  • IMAGINE ImageERDAS IMAGINE
  • JPEGJoint Photographics Experts Group Wenn Sie diese Option auswählen, können Sie auch die Komprimierungsqualität angeben. Gültige Werte für die Komprimierungsqualität liegen in einem Bereich von 0 bis 100.
  • GIFGraphics Interchange Format
  • JP2JPEG 2000. Wenn Sie diese Option auswählen, können Sie auch die Komprimierungsqualität angeben. Gültige Werte für die Komprimierungsqualität liegen in einem Bereich von 0 bis 100.
  • PNGPortable Network Graphics
String
Komprimierungsmethode
(optional)

Wählen Sie die Komprimierungsmethode aus, die mit dem angegebenen Ausgabeformat verwendet werden soll.

  • NONEEs erfolgt keine Komprimierung. Dies ist die Standardeinstellung.
  • JPEGVerlustbehaftete Komprimierung, die den öffentlichen JPEG-Komprimierungsalgorithmus verwendet. Wenn Sie JPEG auswählen, können Sie auch die Komprimierungsqualität angeben. Gültige Werte für die Komprimierungsqualität liegen in einem Bereich von 0 bis 100. Diese Komprimierung kann für JPEG-Dateien und TIFF-Dateien verwendet werden.
  • LZWVerlustfreie Komprimierungsmethode, bei der alle Raster-Zellenwerte erhalten bleiben.
  • PACKBITSPackBits-Komprimierung für TIFF-Dateien.
  • RLERun Length Encoding für IMG-Dateien.
  • CCITT_GROUP3Verlustfreie Komprimierung für 1-Bit-Daten.
  • CCITT_GROUP4Verlustfreie Komprimierung für 1-Bit-Daten.
  • CCITT_1DVerlustfreie Komprimierung für 1-Bit-Daten.
String
Komprimierungsqualität
(optional)

Legen Sie einen Wert zwischen 1 und 100 fest. Je höher der Wert, desto höher die Bildqualität und desto niedriger die Komprimierung.

Long
Ordnerstruktur beibehalten
(optional)

Bestimmt die Ordnerstruktur der heruntergeladenen Raster.

  • Aktiviert: Repliziert die hierarchische Ordnerstruktur, die verwendet wurde, um die Quell-Raster-Datasets zu speichern.
  • Deaktiviert: Raster-Datasets werden in den Ausgabeordner als flache Ordnerstruktur heruntergeladen.

Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisierter Ordner

Der aktualisierte Ausgabeordner.

Ordner

arcpy.management.DownloadRasters(in_image_service, out_folder, {where_clause}, {selection_feature}, {clipping}, {convert_rasters}, {format}, {compression_method}, {compression_quality}, {MAINTAIN_FOLDER})
NameErläuterungDatentyp
in_image_service

Der Image-Service oder das Mosaik-Dataset, der bzw. das heruntergeladen werden soll.

Image Service; Mosaic Layer; Raster Layer; String
out_folder

Das Ziel für den Image-Service oder das Mosaik-Dataset.

Folder
where_clause
(optional)

Ein SQL-Ausdruck zum Beschränken des Downloads auf Raster-Datasets, die dem Ausdruck entsprechen.

SQL Expression
selection_feature
(optional)

Beschränkt den Download auf die Ausdehnung einer Feature-Class oder eines Rahmens. Alle Raster-Datasets, die sich mit der Ausdehnung überschneiden, werden heruntergeladen.

  • MAXOF: Die maximale Ausdehnung aller Eingaben wird verwendet.
  • MINOF: Die minimale gemeinsame Fläche aller Eingaben wird verwendet.
  • DISPLAY: Die Ausdehnung entspricht der sichtbaren Anzeige.
  • Layer-Name: Die Ausdehnung des angegebenen Layers wird verwendet.
  • Extent-Objekt: Die Ausdehnung des angegebenen Objekts wird verwendet.
  • Durch Leerzeichen getrennte Koordinatenzeichenfolge: Die Ausdehnung der angegebenen Zeichenfolge wird verwendet. Die Koordinaten werden in der Reihenfolge X-Min, Y-Min, X-Max, Y-Max ausgedrückt.
Extent
clipping
(optional)

Geben Sie an, ob die heruntergeladenen Bilder basierend auf der Geometrie eines Features ausgeschnitten werden sollen. Jedes Raster, das sich mit der Ausschneidegeometrie überschneidet, wird ausgeschnitten und dann heruntergeladen. Dies ist nützlich, wenn der Interessenbereich kein Rechteck ist. Wenn heruntergeladene Bilder ausgeschnitten werden, müssen Sie ein Ausgabeformat für die ausgeschnittenen Bilder angeben.

  • NO_CLIPPINGDie Dateien werden basierend auf dem kleinsten umgebenden Rechteck ausgeschnitten, das angegeben wurde. Dies ist die Standardeinstellung.
  • CLIPPINGDie Dateien werden basierend auf der Geometrie des "selection:_feature" ausgeschnitten.
Boolean
convert_rasters
(optional)

Wählen Sie aus, ob die Raster immer in das angegebene Format konvertiert werden sollen oder ob nur konvertiert wird, wenn es notwendig ist.

  • CONVERT_AS_REQUIREDRaster-Datasets werden nicht in ein neues Format konvertiert.
  • ALWAYS_CONVERTDie heruntergeladenen Raster-Datasets werden in ein anderes Format konvertiert. Wenn Sie selection_feature zum Beschränken der Ausdehnung verwendet haben, müssen Sie ein Format im Parameter format festlegen.
Boolean
format
(optional)

Wählen Sie ein Ausgabeformat für die heruntergeladenen Raster-Datasets aus.

  • TIFFTagged Image File Format. Dies ist die Standardeinstellung.
  • BILEsri Band Interleaved by Line
  • BSQEsri Band Sequential
  • BIPEsri Band Interleaved by Pixel
  • BMPBitmap
  • ENVIENVI DAT-Datei
  • IMAGINE ImageERDAS IMAGINE
  • JPEGJoint Photographics Experts Group Wenn Sie diese Option auswählen, können Sie auch die Komprimierungsqualität angeben. Gültige Werte für die Komprimierungsqualität liegen in einem Bereich von 0 bis 100.
  • GIFGraphics Interchange Format
  • JP2JPEG 2000. Wenn Sie diese Option auswählen, können Sie auch die Komprimierungsqualität angeben. Gültige Werte für die Komprimierungsqualität liegen in einem Bereich von 0 bis 100.
  • PNGPortable Network Graphics
String
compression_method
(optional)

Wählen Sie die Komprimierungsmethode aus, die mit dem angegebenen Ausgabeformat verwendet werden soll.

  • NONEEs erfolgt keine Komprimierung. Dies ist die Standardeinstellung.
  • JPEGVerlustbehaftete Komprimierung, die den öffentlichen JPEG-Komprimierungsalgorithmus verwendet. Wenn Sie JPEG auswählen, können Sie auch die Komprimierungsqualität angeben. Gültige Werte für die Komprimierungsqualität liegen in einem Bereich von 0 bis 100. Diese Komprimierung kann für JPEG-Dateien und TIFF-Dateien verwendet werden.
  • LZWVerlustfreie Komprimierungsmethode, bei der alle Raster-Zellenwerte erhalten bleiben.
  • PACKBITSPackBits-Komprimierung für TIFF-Dateien.
  • RLERun Length Encoding für IMG-Dateien.
  • CCITT_GROUP3Verlustfreie Komprimierung für 1-Bit-Daten.
  • CCITT_GROUP4Verlustfreie Komprimierung für 1-Bit-Daten.
  • CCITT_1DVerlustfreie Komprimierung für 1-Bit-Daten.
String
compression_quality
(optional)

Legen Sie einen Wert zwischen 1 und 100 fest. Je höher der Wert, desto höher die Bildqualität und desto niedriger die Komprimierung.

Long
MAINTAIN_FOLDER
(optional)

Bestimmt die Ordnerstruktur der heruntergeladenen Raster.

  • MAINTAIN_FOLDERRepliziert die hierarchische Ordnerstruktur, die verwendet wurde, um die Quell-Raster-Datasets zu speichern.
  • NO_MAINTAIN_FOLDERRaster-Datasets werden in den out_folder als flache Ordnerstruktur heruntergeladen.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
derived_out_folder

Der aktualisierte Ausgabeordner.

Ordner

Codebeispiel

DownloadRasters – Beispiel 1 (Python-Fenster)

Dies ist ein Python-Beispiel für das Werkzeug DownloadRasters.

import arcpy
DownloadRasters_management(
     "http://srv/arcgis/services/Ext/MDpan/ImageServer?", "c:/dload/", 
     "AcquisitionDate = date '1999-08-18'", "", 
     "c:/workspace/clippingfeat.shp", "TIFF", "JPEG", "75", 
     "MAINTAIN_FOLDER", "CONVERT_AS_REQUIRED")
DownloadRasters - Beispiel 2 (eigenständiges Skript)

Dies ist ein Python-Skriptbeispiel für das Werkzeug DownloadRasters.

##Download Rasters from image services URL
##Maintain the original sensor data folder structure

import arcpy
arcpy.env.workspace = r"\\myworkstation\Workspace\downloadras"
    
arcpy.DownloadRasters_management(
     "http://serv1/arcgis/services/Ext/MD_LS_pan/ImageServer?",
     "downloadFolder", "AcquisitionDate = date '1999-08-18 00:00:00'",
     "", "", "", "", "", "MAINTAIN_FOLDER")

Umgebungen

Verwandte Themen