Zusammenfassung
Unterteilt ein Raster-Dataset in kleinere Teile, nach Kacheln oder Features aus einem Polygon.
Verwendung
Die meisten der Eigenschaften des Eingabequell-Rasters, z. B. Raumbezug, Quelltyp, Pixeltyp, Pixeltiefe und Zellengröße, gelten auch für die Ausgabedateien.
Anhand der Kachelmethode wird bestimmt, mit welchen der optionalen Parameter die Dimensionen und die Position der Ausgabekacheln ermittelt werden. In beiden Fällen werden NoData-Werte verwendet, um die Kacheln aufzufüllen, wenn es keine entsprechenden Quelldaten gibt. Das Datenformat hängt von den Einschränkungen der einzelnen Formatangaben und vom Datentyp des Quellbildes ab. Ungültige Kombinationen führen zu einer Fehlermeldung.
Wenn bereits eine Kachel vorhanden ist (wenn eine Datei mit dem gleichen Namen vorhanden ist), wird sie nicht überschrieben.
Wenn eine Kachel nur NoData-Pixelwerte enthält, wird sie nicht erstellt.
Syntax
arcpy.management.SplitRaster(in_raster, out_folder, out_base_name, split_method, format, {resampling_type}, {num_rasters}, {tile_size}, {overlap}, {units}, {cell_size}, {origin}, {split_polygon_feature_class}, {clip_type}, {template_extent}, {nodata_value})| Parameter | Erklärung | Datentyp |
in_raster | Das zu teilende Raster. | Mosaic Dataset; Mosaic Layer; Raster Layer |
out_folder | Das Ziel für die neuen Raster-Datasets. | Folder |
out_base_name | Das Präfix der einzelnen Raster-Datasets, die Sie erstellen. Jedem Präfix wird eine Zahl beginnend mit 0 angehängt. | String |
split_method | Legt fest, wie das Raster-Dataset geteilt werden soll.
| String |
format | Das Format des Ausgabe-Raster-Datasets.
| String |
resampling_type (optional) | Legt eine geeignete Methode basierend auf dem Typ Ihrer Daten fest.
| String |
num_rasters (optional) | Die Anzahl der Spalten (x) und Zeilen (y), in die das Raster-Dataset unterteilt werden soll. Dies ist ein Punkt, dessen X- und Y-Koordinaten die Anzahl der Zeilen und Spalten definieren. Die X-Koordinate ist die Anzahl der Spalten und die Y-Koordinate ist die Anzahl der Zeilen. | Point |
tile_size (optional) | Die X- und die Y-Dimension der Ausgabekacheln. Die Standardmaßeinheit ist Pixel. Dies kann mit dem Parameter units geändert werden. Dies ist ein Punkt, dessen X- und Y-Koordinaten die Bemaßungen von Ausgabekacheln definieren. Die X-Koordinate ist die horizontale Bemaßung der Ausgabe und die Y-Koordinate ist die vertikale Bemaßung der Ausgabe. | Point |
overlap (optional) | Die Kacheln müssen nicht perfekt ausgerichtet sein; die Menge an Überschneidungen wird mit diesem Parameter festgelegt. Die Standardmaßeinheit ist Pixel. Dies kann mit dem Parameter units geändert werden. | Double |
units (optional) | Legt die Maßeinheit für die Parameter tile_size und overlap fest.
| String |
cell_size (optional) | Die räumliche Auflösung des Ausgabe-Rasters. Wenn die Option leer gelassen wird, stimmt die Ausgabe-Zellengröße mit dem Eingabe-Raster überein. Wenn Sie die Zellengrößenwerte ändern, wird die Kachelgröße auf die Bildgröße zurückgesetzt und die Kachelanzahl auf 1. | Point |
origin (optional) | Ändert die Koordinaten des linken unteren Ursprungspunktes, an dem das Kachelschema beginnt. Wenn die Option leer bleibt, ist der linke untere Ursprung standardmäßig mit dem Eingabe-Raster identisch. | Point |
split_polygon_feature_class (optional) | Eine Feature-Class, die zum Teilen des Raster-Datasets verwendet wird. | Feature Layer |
clip_type (optional) | Begrenzt die Ausdehnung des Raster-Datasets, bevor Sie es teilen.
| String |
template_extent (optional) | Eine Ausdehnung oder ein Dataset zum Definieren der Ausschneidebegrenzung. Das Dataset kann ein Raster oder eine Feature-Class sein. | Extent |
nodata_value (optional) | Alle Pixel mit dem angegebenen Wert werden im Ausgabe-Raster-Dataset auf NoData gesetzt. | String |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| derived_out_folder | Der Ausgabeordner. | Ordner |
Codebeispiel
SplitRaster - Beispiel 1 (Python-Fenster)
Dies ist ein Python-Beispiel für das Werkzeug SplitRaster.
import arcpy
arcpy.SplitRaster_management("c:/source/large.tif", "c:/output/splitras",
"ras", "NUMBER_OF_TILES", "TIFF", "NEAREST",
"2 2", "#", "10", "PIXELS", "#", "#")
SplitRaster - Beispiel 2 (eigenständiges Skript)
Dies ist ein Python-Skriptbeispiel für das Werkzeug SplitRaster.
##====================================
##Split Raster
##Usage: SplitRaster_management in_raster out_folder out_base_name SIZE_OF_TILE
## | NUMBER_OF_TILES | TIFF | BMP | ENVI | ESRI BIL |
## ESRI BIP | ESRI BSQ | GIF | GRID | IMAGINE IMAGE |
## JP2 | JPG | PNG {NEAREST | BILINEAR | CUBIC |
## MAJORITY} {num_rasters} {tile_size} {overlap}
## {PIXELS | METERS | FEET | DEGREES | KILOMETERS |
## MILES} {cell_size} {origin}
import arcpy
arcpy.env.workspace = r"\\myServer\PrjWorkspace\RasGP"
##Equally split a large TIFF image by number of images
arcpy.SplitRaster_management("large.tif", "splitras", "number", "NUMBER_OF_TILES",\
"TIFF", "NEAREST", "2 2", "#", "4", "PIXELS",\
"#", "#")
##Equally split a large TIFF image by size of images
arcpy.SplitRaster_management("large.tif", "splitras", "size2", "SIZE_OF_TILE",\
"TIFF", "BILINEAR", "#", "3500 3500", "4", "PIXELS",\
"#", "-50 60")
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja