Polylinie in Raster (Konvertierung)

Mit der Advanced-Lizenz verfügbar.

Zusammenfassung

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

Weitere Informationen zur Funktionsweise des Werkzeugs "Polylinie in Raster"

Verwendung

  • Alle Feature-Classes (Geodatabase, Shapefile oder Coverage) mit Polylinien-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.

  • 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 Polylinien, mit dem Sie ein Raster in eine Polyline-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.

  • 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.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Features

Das in ein Raster zu konvertierende Polylinien-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.

  • Maximale LängeDas Feature mit der größten Länge, das die Zelle überlappt, bestimmt den der Zelle zuzuweisenden Wert.
  • Maximale kombinierte LängeWenn eine Zelle mehrere Features mit demselben Wert enthält, werden die Längen dieser Features zusammengefasst. Das zusammengefasste Feature mit der größten Länge in der Zelle bestimmt den der Zelle zuzuweisenden Wert.
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.

  • Aktiviert: Das Ausgabe-Raster weist eine Raster-Attributtabelle auf. Dies ist die Standardeinstellung.
  • Deaktiviert: Das Ausgabe-Raster weist keine Raster-Attributtabelle auf.
Boolean

arcpy.conversion.PolylineToRaster(in_features, value_field, out_rasterdataset, {cell_assignment}, {priority_field}, {cellsize}, {build_rat})
NameErläuterungDatentyp
in_features

Das in ein Raster zu konvertierende Polylinien-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.

  • MAXIMUM_LENGTHDas Feature mit der größten Länge, das die Zelle überlappt, bestimmt den der Zelle zuzuweisenden Wert.
  • MAXIMUM_COMBINED_LENGTHWenn eine Zelle mehrere Features mit demselben Wert enthält, werden die Längen dieser Features zusammengefasst. Das zusammengefasste Feature mit der größten Länge in der Zelle bestimmt den der Zelle zuzuweisenden Wert.
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

PolylineToRaster: Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.conversion.PolylineToRaster("roads.shp", "CLASS", "c:/output/roads.img",
                                  "MAXIMUM_COMBINED_LENGTH", "LENGTH", 30)
PolylineToRaster: Beispiel 2 (eigenständiges Skript)

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

# Name: PolylineToRaster_Ex_02.py
# Description: Converts polyline features to a raster dataset.

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set local variables
inFeatures = "roads.shp"
valField = "CLASS"
outRaster = "c:/output/roads.tif"
assignmentType = "MAXIMUM_COMBINED_LENGTH"
priorityField = "LENGTH"
cellSize = 30

# Run PolylineToRaster
arcpy.conversion.PolylineToRaster(inFeatures, valField, outRaster, 
                                  assignmentType, priorityField, cellSize)