Polygon in Raster (Conversion)

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.

  • In Datenformaten, die NULL-Werte unterstützen (z. B. Feature-Classes in File-Geodatabases), wird ein als Eingabe verwendeter NULL-Wert 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.

Syntax

arcpy.conversion.PolygonToRaster(in_features, value_field, out_rasterdataset, {cell_assignment}, {priority_field}, {cellsize}, {build_rat})
ParameterErklärungDatentyp
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.

  • CELL_CENTERDas Attribut, das der Zelle zugewiesen wird, stammt von dem Polygon, das den Mittelpunkt der Zelle überlappt.
  • MAXIMUM_AREADas Attribut, das der Zelle zugewiesen wird, stammt von dem Feature mit dem größten Bereich in der Zelle.
  • MAXIMUM_COMBINED_AREAWenn eine Zelle mehrere Features mit demselben Wert enthält, werden die Flächen dieser Features zusammengefasst. Das zusammengefasste Feature mit der größten Fläche in der Zelle legt den der Zelle zuzuweisenden Wert fest.
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.

  • BUILDDas Ausgabe-Raster weist eine Raster-Attributtabelle auf. Dies ist die Standardeinstellung.
  • DO_NOT_BUILDDas Ausgabe-Raster weist keine Raster-Attributtabelle auf.
Boolean

Codebeispiel

PolygonToRaster – Beispiel 1 (Python-Fenster)

Hiermit werden Polygon-Features in ein Raster-Dataset konvertiert.

import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.PolygonToRaster_conversion("ca_counties.shp", "NAME", 
                                 "c:/output/ca_counties.img", 
                                 "MAXIMUM_AREA", "MALES", 0.25)
PolygonToRaster – Beispiel 2 (eigenständiges Skript)

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
from arcpy import env

# Set environment settings
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

# Execute PolygonToRaster
arcpy.PolygonToRaster_conversion(inFeatures, valField, outRaster, 
                                 assignmentType, priorityField, cellSize)

Lizenzinformationen

  • Basic: Erfordert Spatial Analyst oder 3D Analyst
  • Standard: Erfordert Spatial Analyst oder 3D Analyst
  • Advanced: Ja

Verwandte Themen