Terrain in Raster (3D Analyst)—ArcGIS Pro

Zusammenfassung

Interpoliert mithilfe von Z-Werten ein Raster aus einem Terrain-Dataset.

Verwendung

Definieren Sie die Ausdehnung mit der Umgebungseinstellung zur Verarbeitungsausdehnung, um eine Teilmenge des Terrains zu extrahieren.

Parameter

Beschriftung	Erläuterung	Datentyp
Eingabe-Terrain	Das zu verarbeitende Terrain-Dataset.	Terrain Layer
Ausgabe-Raster	Der Speicherort und Name des Ausgabe-Rasters. Bei der Speicherung eines Raster-Datasets in einer Geodatabase oder in einem Ordner wie z. B. einem Esri Grid darf dem Namen des Raster-Datasets keine Dateierweiterung hinzugefügt werden. Eine Dateierweiterung kann bereitgestellt werden, um das Format des Rasters zu definieren, wenn es in einem Ordner gespeichert wird, z. B. .tif zum Erstellen einer Datei im GeoTIFF- oder .img zum Erstellen einer Datei im ERDAS IMAGINE-Format. Beim Speichern des Rasters in einer TIFF-Datei oder einer Geodatabase können Raster-Komprimierungstyp und -qualität in den Einstellungen für die Geoverarbeitungsumgebung angegeben werden.	Raster Dataset
Ausgabedatentyp (optional)	Gibt den Typ der im Ausgabe-Raster gespeicherten numerischen Werte an. Gleitkomma—Das Ausgabe-Raster verwendet eine 32-Bit-Gleitkommazahl, durch die Werte im Bereich von -3.402823466e+38 bis 3.402823466e+38 unterstützt werden. Dies ist die Standardeinstellung. Integer—Das Ausgabe-Raster verwendet eine geeignete ganzzahlige Bittiefe. Mit dieser Option werden Z-Werte auf die nächste ganze Zahl gerundet, und in jeder Raster-Zelle wird ein ganzzahliger Wert eingegeben.	String
Methode (optional)	Die Interpolationsmethode zum Berechnen von Zellenwerten. Linear—Wendet eine entfernungsbasierte Gewichtung auf den Z-Wert jedes Knotens in dem Dreieck an, das den Mittelpunkt einer angegebenen Zelle umgibt, und addiert anschließend die gewichteten Werte, um den Zellenwert zuzuweisen. Dies ist die Standardeinstellung. Natürliche Nachbarn—Wendet ein flächenbasiertes Gewichtungsschema an, das Voronoi-Polygone zur Bestimmung von Zellenwerten verwendet.	String
Abtastschrittweite (optional)	Die Stichprobenmethode und Entfernung, die zum Definieren der Zellengröße des Ausgabe-Rasters verwendet werden. Messungen—Definiert die Anzahl von Zellen, die die längste Seite des Ausgabe-Rasters teilen. Standardmäßig wird für diese Methode der Wert 250 verwendet. Zellengröße—Definiert die Zellengröße des Ausgabe-Rasters.	String
Auflösung der Pyramidenebene (optional)	Die verwendete Auflösung der Z-Toleranz oder der Kachelung der Terrain-Pyramidenebene. Der Standardwert ist 0, also volle Auflösung.	Double
Abtastwert	Der Wert, der der Abtastschrittweite zum Festlegen der Zellengröße des Ausgabe-Rasters entspricht.	Double

arcpy.ddd.TerrainToRaster(in_terrain, out_raster, {data_type}, {method}, {sample_distance}, {pyramid_level_resolution}, sample_value)

Name	Erläuterung	Datentyp
in_terrain	Das zu verarbeitende Terrain-Dataset.	Terrain Layer
out_raster	Der Speicherort und Name des Ausgabe-Rasters. Bei der Speicherung eines Raster-Datasets in einer Geodatabase oder in einem Ordner wie z. B. einem Esri Grid darf dem Namen des Raster-Datasets keine Dateierweiterung hinzugefügt werden. Eine Dateierweiterung kann bereitgestellt werden, um das Format des Rasters zu definieren, wenn es in einem Ordner gespeichert wird, z. B. .tif zum Erstellen einer Datei im GeoTIFF- oder .img zum Erstellen einer Datei im ERDAS IMAGINE-Format. Beim Speichern des Rasters in einer TIFF-Datei oder einer Geodatabase können Raster-Komprimierungstyp und -qualität in den Einstellungen für die Geoverarbeitungsumgebung angegeben werden.	Raster Dataset
data_type (optional)	Gibt den Typ der im Ausgabe-Raster gespeicherten numerischen Werte an. FLOAT—Das Ausgabe-Raster verwendet eine 32-Bit-Gleitkommazahl, durch die Werte im Bereich von -3.402823466e+38 bis 3.402823466e+38 unterstützt werden. Dies ist die Standardeinstellung. INT—Das Ausgabe-Raster verwendet eine geeignete ganzzahlige Bittiefe. Mit dieser Option werden Z-Werte auf die nächste ganze Zahl gerundet, und in jeder Raster-Zelle wird ein ganzzahliger Wert eingegeben.	String
method (optional)	Die Interpolationsmethode zum Berechnen von Zellenwerten. LINEAR—Wendet eine entfernungsbasierte Gewichtung auf den Z-Wert jedes Knotens in dem Dreieck an, das den Mittelpunkt einer angegebenen Zelle umgibt, und addiert anschließend die gewichteten Werte, um den Zellenwert zuzuweisen. Dies ist die Standardeinstellung. NATURAL_NEIGHBORS—Wendet ein flächenbasiertes Gewichtungsschema an, das Voronoi-Polygone zur Bestimmung von Zellenwerten verwendet.	String
sample_distance sampling_method distance (optional)	Die Stichprobenmethode und Entfernung, die zum Definieren der Zellengröße des Ausgabe-Rasters verwendet werden. OBSERVATIONS—Definiert die Anzahl von Zellen, die die längste Seite des Ausgabe-Rasters teilen. Standardmäßig wird für diese Methode der Wert 250 verwendet. CELLSIZE—Definiert die Zellengröße des Ausgabe-Rasters.	String
pyramid_level_resolution (optional)	Die verwendete Auflösung der Z-Toleranz oder der Kachelung der Terrain-Pyramidenebene. Der Standardwert ist 0, also volle Auflösung.	Double
sample_value	Der Wert, der der Abtastschrittweite zum Festlegen der Zellengröße des Ausgabe-Rasters entspricht.	Double

Codebeispiel

TerrainToRaster – Beispiel 1 (Python-Fenster)

Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.

arcpy.env.workspace = "C:/data"
arcpy.TerrainToRaster_3d("sample.gdb/featuredataset/terrain", "terrain.tif", 
                         data_type="FLOAT", method="LINEAR", 
                         sample_distance="CELLSIZE 10", pyramid_level_resolution=2.5)

TerrainToRaster – Beispiel 2 (eigenständiges Skript)

Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht.

'''*********************************************************************
Name: TerrainToRaster Example
Description: This script demonstrates how to use the 
             TerrainToRaster tool.
             
**********************************************************************'''
# Import system modules
import arcpy

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

# Set Local Variables
terrain = "sample.gdb/featuredataset/terrain"
bitType = "INT"
method = "LINEAR"
sampling = "CELLSIZE 10"
pyrLvl = 2.5
outRas = arcpy.CreateUniqueName("terrain_level.img")

#Execute TerrainToRaster
arcpy.ddd.TerrainToRaster(terrain, outRas, bitType, 
                          method, sampling, pyrLvl)

Umgebungen

Aktueller Workspace, Ausgabe-Koordinatensystem, Ausdehnung, Fang-Raster, Pyramide, Komprimierung, Ausgabe-CONFIG-Schlüsselwort, Auto-Commit, Raster-Statistiken, Terrain-Speicherauslastung

Sonderfälle

Lizenzinformationen

Basic: Erfordert 3D Analyst
Standard: Erfordert 3D Analyst
Advanced: Erfordert 3D Analyst