Zusammenfassung
Interpoliert ein Raster aus einem Terrain-Dataset.
Verwendung
Der Auflösungsparameter gibt an, welche Pyramidenebene des Terrains Sie für die Konvertierung verwenden sollen. Pyramidenebenen werden anhand der Pyramidentypen "Z-Toleranz" oder "Kachelung" definiert. Weitere Informationen zu Terrain-Pyramiden finden Sie unter Terrain-Pyramiden.
Definieren Sie die Ausdehnung mit der Umgebungseinstellung zur Verarbeitungsausdehnung, um eine Teilmenge des Terrains zu extrahieren.
Die Interpolationsoptionen Linear und Natürlicher Nachbar werden anhand der triangulierten Terrain-Oberfläche angewendet. Bei der linearen Option umgibt das Dreieck jede Zellenmitte und wendet einen gewichteten Durchschnitt der Knoten des Dreiecks für die Interpolation eines Wertes an. Die Option Natürliche Nachbarn verwendet flächenbasierte Gewichtungen für die Voronoi-Nachbarn.
Syntax
TerrainToRaster_3d (in_terrain, out_raster, {data_type}, {method}, {sample_distance}, {pyramid_level_resolution})
Parameter | 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) | Der Datentyp des Ausgabe-Rasters kann durch die folgenden Schlüsselwörter definiert werden:
| String |
method (optional) | Die Interpolationsmethode zum Berechnen von Zellenwerten.
| String |
sample_distance sampling_method distance (optional) | Die Stichprobenmethode und Entfernung, die zum Definieren der Zellengröße des Ausgabe-Rasters verwendet werden. | String |
pyramid_level_resolution (optional) | Die Auflösung der Z-Toleranz oder der Kachelung der Terrain-Pyramidenebene, die von diesem Werkzeug verwendet wird. Der Standardwert ist 0, also volle Auflösung. | Double |
Codebeispiel
TerrainToRaster – Beispiel 1 (Python-Fenster)
Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.TerrainToRaster_3d("sample.gdb/featuredataset/terrain", "terrain.img", "INT", "LINEAR", "CELLSIZE 10", 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
from arcpy import env
import exceptions, sys, traceback
try:
arcpy.CheckOutExtension("3D")
# Set environment setting
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)
arcpy.CheckInExtension("3D")
except arcpy.ExecuteError:
print arcpy.GetMessages()
except:
# Get the traceback object
tb = sys.exc_info()[2]
tbinfo = traceback.format_tb(tb)[0]
# Concatenate error information into message string
pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
.format(tbinfo, str(sys.exc_info()[1]))
msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
# Return python error messages for script tool or Python Window
arcpy.AddError(pymsg)
arcpy.AddError(msgs)
Umgebung
Lizenzierungsinformationen
- ArcGIS for Desktop Basic: Erfordert 3D Analyst
- ArcGIS for Desktop Standard: Erfordert 3D Analyst
- ArcGIS for Desktop Advanced: Erfordert 3D Analyst