ArcMap

Terrain in Raster

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})
ParameterErläuterungDatentyp
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:

  • 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 Ganzzahl-Bittiefe. Mit dieser Option werden Z-Werte auf die nächste Ganzzahl gerundet, und in jeder Raster-Zelle wird ein Ganzzahlwert 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

  • ArcGIS Desktop Basic: Erfordert 3D Analyst
  • ArcGIS Desktop Standard: Erfordert 3D Analyst
  • ArcGIS Desktop Advanced: Erfordert 3D Analyst

Verwandte Themen