Terrain zu Raster (3D Analyst)
Zusammenfassung
Hiermit wird ein Terrain-Dataset in ein Raster konvertiert.
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 verfügbaren Interpolationsmethoden sind LINEAR und NATURAL_NEIGHBORS. Dabei handelt es sich um TIN-basierte Methoden, die anhand der triangulierten Terrain-Oberfläche angewendet werden. 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.
-
Das Ausgabe-Raster kann dateibasiert oder als Raster-Dataset in einer Geodatabase erstellt werden. Ein dateibasiertes Raster-Format wird durch die Erweiterung des Rasters bestimmt. Wenn zum Beispiel die Erweiterungen ".img" und ".tif" verwendet werden, werden IMAGINE- oder TIFF-Dateien erstellt. Wenn das Raster keine Dateierweiterung aufweist, wird ein Esri GRID erstellt.
Syntax
| Parameter | Erläuterung | Datentyp |
in_terrain |
The input terrain dataset. | Terrain Layer |
out_raster |
The location and name of the output raster. When storing a raster dataset in a geodatabase or in a folder such as an Esri Grid, no file extension should be added to the name of the raster dataset. A file extension can be provided to define the raster's format when storing it in a folder:
If the raster is stored as a TIFF file or in a geodatabase, its raster compression type and quality can be specified using geoprocessing environment settings. | Raster Dataset |
data_type (optional) |
The data type of the output raster can be defined by the following keywords:
| String |
method (optional) |
Wählen Sie eine Interpolationsmethode. Standardmäßig werden Zellenwerte mit der Methode LINEAR berechnet.
| String |
sample_distance sampling_method distance (optional) |
The sampling method and distance used to define the cell size of the output raster.
| String |
pyramid_level_resolution (optional) |
The z-tolerance or window size resolution of the terrain pyramid level that will be used by this tool. The default is 0, or full resolution. | Double |
Codebeispiel
The following sample demonstrates the use of this tool in the Python window:
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)
The following sample demonstrates the use of this tool in a stand-alone Python script:
'''*********************************************************************
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)