Terrain in Raster—Hilfe

Zusammenfassung
Verwendung
Syntax
Codebeispiel
Umgebungen
Lizenzinformationen

Zusammenfassung

Interpoliert mithilfe von Z-Werten 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(in_terrain, out_raster, {data_type}, {method}, {sample_distance}, {pyramid_level_resolution})

Parameter	Erklärung	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.	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)

Umgebungen

Lizenzinformationen

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

ArcMap

Terrain in Raster