Ausschneiden (Data Management)
Zusammenfassung
Erstellt eine räumliche Teilmenge eines Rasters, einschließlich eines Raster-Datasets, Mosaik-Datasets oder Image-Service-Layers.
Bild
 |
Verwendung
-
Mit diesem Werkzeug können Sie Teile eines Raster-Datasets auf Basis einer Ausgabeausdehnung extrahieren. Die Ausgabe des Ausschneidevorgangs enthält alle Pixel, die die Ausgabeausdehnung schneiden. Wenn Sie einen Teil eines Feature-Datasets extrahieren möchten, verwenden Sie das Werkzeug Ausschneiden, das sich in der Toolbox "Analysis" befindet.
-
Die ausgeschnittene Fläche wird entweder durch einen rechteckigen Envelope unter Verwendung von minimalen und maximalen X- und Y-Koordinaten oder über die Verwendung einer Ausgabeausdehnungsdatei festgelegt. Falls die angegebene Ausdehnung zum Ausschneiden nicht am Eingabe-Raster-Dataset ausgerichtet ist, stellt dieses Werkzeug sicher, dass die richtige Ausrichtung verwendet wird. Dies kann dazu führen, dass die Ausgabe eine etwas andere Ausdehnung aufweist, als im Werkzeug angegeben wurde.
-
Sie können einen vorhandenen Raster- oder Vektor-Layer als Ausdehnung zum Ausschneiden verwenden. Wenn Sie als Ausgabeausdehnung eine Feature-Class verwenden, können Sie das Raster über das kleinste umgebende Rechteck der Feature-Class oder über die Polygon-Geometrie der Features ausschneiden. Falls Sie die Geometrie zum Ausschneiden verwenden, wird die Pixeltiefe der Ausgabe ggf. heraufgestuft. Aus diesem Grund müssen Sie sicherstellen, dass das Ausgabeformat die richtige Pixeltiefe unterstützen kann.
-
Beim Verwenden von ArcMap können Sie außerdem die ausgewählten Features als Ausdehnung zum Ausschneiden nutzen. Falls in der Feature-Class ein Feature ausgewählt ist und die Option Eingabe-Features als Geometrie zum Ausschneiden verwenden aktiviert ist (clipping_geometry auf "ClippingGeometry" festgelegt), dann schneidet die Ausgabe die ausgewählten Bereiche aus. Falls in der Feature-Class ein Feature ausgewählt ist, die Option Eingabe-Features als Geometrie zum Ausschneiden verwenden jedoch nicht aktiviert ist, schneidet die Ausgabe das kleinste umgebende Rechteck für das Feature aus.
-
Sie können die Ausgabe in den Formaten BIL, BIP, BMP, BSQ, DAT, GIF, Esri Grid, IMG, JPEG, JPEG 2000, PNG, TIFF oder einem beliebigen Geodatabase-Raster-Dataset speichern.
-
Die Werte der Ausdehnung müssen innerhalb derselben räumlichen Koordinaten und in denselben Einheiten vorliegen wie das Raster-Dataset.
Syntax
| Parameter | Erläuterung | Datentyp |
in_raster |
Das Eingabe-Raster-Dataset. | Mosaic Dataset; Mosaic Layer; Raster Dataset; Raster Layer |
rectangle |
Die vier Koordinaten, die das kleinste umgebende Rechteck definieren, das ausgeschnitten wird, sind in der folgenden Reihenfolge festgelegt: X-Minimum, Y-Minimum, X-Maximum, Y-Maximum. Falls die angegebene Ausdehnung zum Ausschneiden nicht am Eingabe-Raster-Dataset ausgerichtet ist, stellt das Werkzeug "Ausschneiden" sicher, dass die richtige Ausrichtung verwendet wird. Dies kann dazu führen, dass die Ausgabe eine etwas andere Ausdehnung aufweist, als im Werkzeug angegeben wurde. | Envelope |
out_raster |
Das Ausgabe-Raster-Dataset. Stellen Sie sicher, dass dieses Ausgabeformat die richtige Pixeltiefe unterstützen kann. Wenn Sie das Raster-Dataset in einem Dateiformat speichern, müssen Sie die Dateierweiterung angeben:
Beim Speichern eines Raster-Datasets in einer Geodatabase darf dem Namen des Raster-Datasets keine Dateierweiterung hinzugefügt werden. Beim Speichern des Raster-Datasets als JPEG-, JPEG 2000- oder TIFF-Datei bzw. in einer Geodatabase können Sie einen Komprimierungstyp und eine Komprimierungsqualität festlegen. | Raster Dataset |
in_template_dataset (optional) |
Ein vorhandener Raster- oder Vektor-Layer, der als Ausdehnung zum Ausschneiden verwendet werden kann. Die Ausgabe des Ausschneidevorgangs enthält alle Pixel, die das kleinste umgebende Rechteck schneiden. Wenn Sie als Ausgabeausdehnung eine Feature-Class verwenden und das Raster basierend auf den Polygon-Features ausschneiden möchten, verwenden Sie die Option clipping_geometry. Wenn die Option aktiviert ist, wird die Pixeltiefe der Ausgabe ggf. heraufgestuft. Aus diesem Grund müssen Sie sicherstellen, dass das Ausgabeformat die richtige Pixeltiefe unterstützen kann. | Raster Layer; Feature Layer |
nodata_value (optional) |
Alle Pixel mit dem angegebenen Wert werden im Ausgabe-Raster-Dataset auf NoData gesetzt. | String |
clipping_geometry (optional) |
Wenn Sie als Ausgabeausdehnung eine Feature-Class verwenden, können Sie das Raster über die Ausdehnung der Feature-Class oder über den Polygonumfang ausschneiden.
Falls Sie die Geometrie zum Ausschneiden verwenden, wird die Pixeltiefe der Ausgabe ggf. heraufgestuft. Aus diesem Grund müssen Sie sicherstellen, dass das Ausgabeformat die richtige Pixeltiefe unterstützen kann. | Boolean |
Codebeispiel
Dies ist ein Python-Beispiel für das Werkzeug "Ausschneiden".
import arcpy
arcpy.Clip_management("c:/data/image.tif","1952602 294196 1953546 296176",
"c:/data/clip.gdb/clip01", "#", "#", "NONE")
Dies ist ein Python-Skriptbeispiel für das Werkzeug "Ausschneiden".
##====================================
##Clip
##Usage: Clip_management in_raster rectangle out_raster {in_template_dataset} {nodata_value} {NONE | ClippingGeometry}
try:
import arcpy
arcpy.env.workspace = r"C:/Workspace"
##Clip Raster Dataset by known extent - Left Bottom Right Top
arcpy.Clip_management("image.tif","1952602.23 294196.279 1953546.23 296176.279","clip.gdb/clip", "#", "#", "NONE")
##Clip Raster Dataset with feature geometry
arcpy.Clip_management("image.tif", "#", "clip.tif","feature.shp", "0", "ClippingGeometry")
except:
print "Clip example failed."
print arcpy.GetMessages()