Beschriftung | Erläuterung | Datentyp |
Eingabe-Features | Das in ein Raster zu konvertierende Polygon-Eingabe-Feature-Dataset. | Feature Layer |
Wertfeld | Das Feld für die Zuweisung von Werten zum Ausgabe-Raster. Dieses Feld kann ein beliebiges Feld der Attributtabelle des Eingabe-Feature-Datasets sein. | Field |
Ausgabe-Raster-Dataset | Das zu erstellende Ausgabe-Raster-Dataset. Wenn das Ausgabe-Raster nicht in einer Geodatabase gespeichert wird, müssen Sie beim TIFF-Dateiformat die Erweiterung .tif angeben, beim CRF-Dateiformat die Erweiterung .CRF, beim ERDAS IMAGINE-Dateiformat die Erweiterung .img und beim Esri Grid-Raster-Format keine Erweiterung. | Raster Dataset |
Zellenzuweisungstyp (optional) | Mit der Methode wird festgelegt, wie der Zelle ein Wert zugewiesen wird, wenn sich mehrere Features in einer Zelle befinden.
| String |
Prioritätsfeld (optional) | Mithilfe dieses Feldes wird ermittelt, welches Feature Vorrang vor einem anderen Feature hat, das über einer Zelle liegt. Bei Verwendung dieses Feldes wird für die Konvertierung immer das Feature mit der höchsten positiven Priorität ausgewählt, unabhängig davon, welcher Zellenzuweisungstyp ausgewählt wurde. | Field |
Zellengröße (optional) | Die Zellengröße des Ausgabe-Rasters, das erstellt wird. Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit als Parameterwert angegeben wurde, wird der Zellengrößenwert der Umgebung verwendet, sofern dieser angegeben wurde. Andernfalls werden zusätzliche Regeln verwendet, um ihn aus anderen Eingaben zu berechnen. Weitere Informationen finden Sie in den Verwendungsmöglichkeiten. | Analysis Cell Size |
Raster-Attributtabelle erstellen (optional) | Gibt an, ob das Ausgabe-Raster eine Raster-Attributtabelle aufweist. Dieser Parameter gilt nur für Integer-Raster.
| Boolean |
Mit der Advanced-Lizenz verfügbar.
Zusammenfassung
Hiermit werden Polygon-Features in ein Raster-Dataset konvertiert.
Informationen zur Funktionsweise des Werkzeugs "Polygon in Raster"
Verwendung
Alle Feature-Classes (Geodatabase, Shapefile oder Coverage) mit Polygon-Features können in ein Raster-Dataset konvertiert werden.
Der Typ des Ausgabe-Rasters wird anhand des Eingabefeldtyps bestimmt. Wenn das Eingabefeld ganzzahlig ist, ist das Ausgabe-Raster ebenfalls ganzzahlig; wenn es vom Typ "Gleitkomma" ist, weist die Ausgabe auch den Typ "Gleitkomma" auf.
Wenn das Eingabefeld Zeichenfolgenwerte enthält, enthält das Ausgabe-Raster ein Ganzzahlwertfeld und ein Zeichenfolgenfeld.
Wenn das Feld jedoch vom Typ Gleitkomma ist und die Werte als Ganzzahlen ausgedrückt sind, ist das Ausgabe-Raster ganzzahlig.
Die Zellengröße kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wird die Zellengröße nicht explizit über den Parameterwert angegeben, wird sie aus der Umgebung Zellengröße abgeleitet, falls diese angegeben wurde. Wenn weder der Parameter noch die Umgebung "Zellengröße" angegeben wurden, aber die Umgebung Fang-Raster festgelegt wurde, wird die Zellengröße des Fang-Rasters verwendet. Wurde kein Wert angegeben, wird die Zellengröße aus der Breite oder Höhe der Ausdehnung (je nachdem was kürzer ist) berechnet, indem der Wert durch 250 dividiert wird. Dabei wird die Ausdehnung im Ausgabekoordinatensystem der Umgebung angegeben.
Wurde die Zellengröße mit einem numerischen Wert angegeben, wird dieser vom Werkzeug direkt für das Ausgabe-Raster verwendet.
Wenn die Zellengröße mit einem Raster-Dataset angegeben wurde, zeigt der Parameter anstelle des Zellengrößenwerts den Pfad des Raster-Datasets an. Die Zellengröße dieses Raster-Datasets wird direkt in der Analyse verwendet, vorausgesetzt der Raumbezug stimmt mit dem Ausgabe-Raumbezug überein. Wenn der Raumbezug des Datasets nicht übereinstimmt, wird er basierend auf der ausgewählten Projektionsmethode für Zellengröße projiziert.
Dieses Werkzeug ist das Gegenstück zum Werkzeug Raster in Polygon, mit dem Sie ein Raster in eine Polygon-Feature-Class konvertieren können.
Wenn in einer Ausgabezelle mehr als ein Feature vorhanden ist, ermöglicht dieses Werkzeug eine bessere Kontrolle über die Zuweisung von Zellenwerten als das Werkzeug Feature in Raster.
Bei Streifenbildung oder "Ausläufen" im Ausgabe-Raster korrigieren Sie die Eingabe-Feature-Daten mit den Werkzeugen Geometrie überprüfen und Geometrie reparieren.
Beim Konvertieren von überlappenden Polygonen ist es meist ratsam, die Polygone mit der kleinsten Fläche einer Zelle zuzuweisen. Dies erreichen Sie auf einfache Weise, indem Sie der Eingabe-Feature-Class ein weiteres Feld hinzufügen und die Kehrwerte der Polygonflächen berechnen. Verwenden Sie dieses Feld anschließend beim Ausführen des Werkzeugs als Prioritätsfeld.
Bei Datenformaten mit Unterstützung für NULL-Werte wie beispielsweise File-Geodatabase-Feature-Classes werden als Eingabe verwendete NULL-Werte ignoriert.
Für dieses Werkzeug sind bestimmte Raster-Speicherumgebungen verfügbar.
Bei der Umgebungseinstellung Pyramide wird lediglich die Einstellung Pyramiden berechnen berücksichtigt. Die verbleibenden Umgebungseinstellungen für die Pyramide werden ignoriert. Eine bessere Kontrolle über die Art der Pyramiden kann in einem weiteren Schritt durch Verwendung des Werkzeugs Pyramiden berechnen erlangt werden.
Bei der Umgebungseinstellung Komprimierung kann nur der Komprimierungstyp berücksichtigt werden. Dies gilt für alle Raster-Formate außer Esri Grid.
Parameter
arcpy.conversion.PolygonToRaster(in_features, value_field, out_rasterdataset, {cell_assignment}, {priority_field}, {cellsize}, {build_rat})
Name | Erläuterung | Datentyp |
in_features | Das in ein Raster zu konvertierende Polygon-Eingabe-Feature-Dataset. | Feature Layer |
value_field | Das Feld für die Zuweisung von Werten zum Ausgabe-Raster. Dieses Feld kann ein beliebiges Feld der Attributtabelle des Eingabe-Feature-Datasets sein. | Field |
out_rasterdataset | Das zu erstellende Ausgabe-Raster-Dataset. Wenn das Ausgabe-Raster nicht in einer Geodatabase gespeichert wird, müssen Sie beim TIFF-Dateiformat die Erweiterung .tif angeben, beim CRF-Dateiformat die Erweiterung .CRF, beim ERDAS IMAGINE-Dateiformat die Erweiterung .img und beim Esri Grid-Raster-Format keine Erweiterung. | Raster Dataset |
cell_assignment (optional) | Mit der Methode wird festgelegt, wie der Zelle ein Wert zugewiesen wird, wenn sich mehrere Features in einer Zelle befinden.
| String |
priority_field (optional) | Mithilfe dieses Feldes wird ermittelt, welches Feature Vorrang vor einem anderen Feature hat, das über einer Zelle liegt. Bei Verwendung dieses Feldes wird für die Konvertierung immer das Feature mit der höchsten positiven Priorität ausgewählt, unabhängig davon, welcher Zellenzuweisungstyp ausgewählt wurde. | Field |
cellsize (optional) | Die Zellengröße des Ausgabe-Rasters, das erstellt wird. Dieser Parameter kann über einen numerischen Wert definiert oder aus einem vorhandenen Raster-Dataset abgerufen werden. Wenn die Zellengröße nicht explizit als Parameterwert angegeben wurde, wird der Zellengrößenwert der Umgebung verwendet, sofern dieser angegeben wurde. Andernfalls werden zusätzliche Regeln verwendet, um ihn aus anderen Eingaben zu berechnen. Weitere Informationen finden Sie in den Verwendungsmöglichkeiten. | Analysis Cell Size |
build_rat (optional) | Gibt an, ob das Ausgabe-Raster eine Raster-Attributtabelle aufweist. Dieser Parameter gilt nur für Integer-Raster.
| Boolean |
Codebeispiel
Hiermit werden Polygon-Features in ein Raster-Dataset konvertiert.
import arcpy
arcpy.env.workspace = "c:/data"
arcpy.conversion.PolygonToRaster("ca_counties.shp", "NAME",
"c:/output/ca_counties.img",
"MAXIMUM_AREA", "MALES", 0.25)
Hiermit werden Polygon-Features in ein Raster-Dataset konvertiert.
# Name: PolygonToRaster_Ex_02.py
# Description: Converts polygon features to a raster dataset.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
inFeatures = "ca_counties.shp"
valField = "NAME"
outRaster = "c:/output/ca_counties"
assignmentType = "MAXIMUM_AREA"
priorityField = "MALES"
cellSize = 0.5
# Run PolygonToRaster
arcpy.conversion.PolygonToRaster(inFeatures, valField, outRaster,
assignmentType, priorityField, cellSize)
Umgebungen
Lizenzinformationen
- Basic: Erfordert Spatial Analyst oder 3D Analyst
- Standard: Erfordert Spatial Analyst oder 3D Analyst
- Advanced: Ja