Raster herunterladen (Data Management)—ArcGIS Pro

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

Beschriftung	Erläuterung	Datentyp
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. Default: Die Ausdehnung basiert auf der maximalen Ausdehnung aller beteiligten Layer. Dies ist die Standardeinstellung. Aktuelle Anzeigeausdehnung: Die Ausdehnung entspricht dem Datenrahmen oder der sichtbaren Anzeige. Die Option ist nicht verfügbar, wenn keine aktive Karte vorhanden ist. Wie unten angegeben: Die Ausdehnung basiert auf den angegebenen Minimal- und Maximalwerten der Ausdehnung. Durchsuchen: Die Ausdehnung basiert auf einem vorhandenen Dataset.	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. TIFF—Tagged Image File Format. Dies ist die Standardeinstellung. BIL—Esri Band Interleaved by Line BSQ—Esri Band Sequential BIP—Esri Band Interleaved by Pixel BMP—Bitmap ENVI Dat—ENVI DAT-Datei Imagine-Bild—ERDAS IMAGINE JPEG—Joint 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. GIF—Graphics Interchange Format JP2—JPEG 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. PNG—Portable Network Graphics	String
Komprimierungsmethode (optional)	Wählen Sie die Komprimierungsmethode aus, die mit dem angegebenen Ausgabeformat verwendet werden soll. Keine—Es erfolgt keine Komprimierung. Dies ist die Standardeinstellung. JPEG—Verlustbehaftete 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. LZW—Verlustfreie Komprimierungsmethode, bei der alle Raster-Zellenwerte erhalten bleiben. Packbits—PackBits-Komprimierung für TIFF-Dateien. RLE—Run Length Encoding für IMG-Dateien. CCITT Group 3—Verlustfreie Komprimierung für 1-Bit-Daten. CCITT Group 4—Verlustfreie Komprimierung für 1-Bit-Daten. CCITT 1D—Verlustfreie 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

Beschriftung	Erläuterung	Datentyp
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})

Name	Erläuterung	Datentyp
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 kleinste 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_CLIPPING—Die Dateien werden basierend auf dem kleinsten umgebenden Rechteck ausgeschnitten, das angegeben wurde. Dies ist die Standardeinstellung. CLIPPING—Die 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_REQUIRED—Raster-Datasets werden nicht in ein neues Format konvertiert. ALWAYS_CONVERT—Die 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. TIFF—Tagged Image File Format. Dies ist die Standardeinstellung. BIL—Esri Band Interleaved by Line BSQ—Esri Band Sequential BIP—Esri Band Interleaved by Pixel BMP—Bitmap ENVI—ENVI DAT-Datei IMAGINE Image—ERDAS IMAGINE JPEG—Joint 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. GIF—Graphics Interchange Format JP2—JPEG 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. PNG—Portable Network Graphics	String
compression_method (optional)	Wählen Sie die Komprimierungsmethode aus, die mit dem angegebenen Ausgabeformat verwendet werden soll. NONE—Es erfolgt keine Komprimierung. Dies ist die Standardeinstellung. JPEG—Verlustbehaftete 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. LZW—Verlustfreie Komprimierungsmethode, bei der alle Raster-Zellenwerte erhalten bleiben. PACKBITS—PackBits-Komprimierung für TIFF-Dateien. RLE—Run Length Encoding für IMG-Dateien. CCITT_GROUP3—Verlustfreie Komprimierung für 1-Bit-Daten. CCITT_GROUP4—Verlustfreie Komprimierung für 1-Bit-Daten. CCITT_1D—Verlustfreie 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_FOLDER—Repliziert die hierarchische Ordnerstruktur, die verwendet wurde, um die Quell-Raster-Datasets zu speichern. NO_MAINTAIN_FOLDER—Raster-Datasets werden in den out_folder als flache Ordnerstruktur heruntergeladen.	Boolean

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
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")

Zusammenfassung

Verwendung

Parameter

Abgeleitete Ausgabe

Abgeleitete Ausgabe

Codebeispiel

Umgebungen

Sonderfälle

Lizenzinformationen

Verwandte Themen

In diesem Thema