Terrain in Raster (3D Analyst)

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

BeschriftungErläuterungDatentyp
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.

  • GleitkommaDas 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.
  • IntegerDas 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.

  • LinearWendet 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 NachbarnWendet 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.

  • MessungenDefiniert 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ößeDefiniert 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)
NameErlä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)

Gibt den Typ der im Ausgabe-Raster gespeicherten numerischen Werte an.

  • FLOATDas 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.
  • INTDas 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.

  • LINEARWendet 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_NEIGHBORSWendet 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.

  • OBSERVATIONSDefiniert die Anzahl von Zellen, die die längste Seite des Ausgabe-Rasters teilen. Standardmäßig wird für diese Methode der Wert 250 verwendet.
  • CELLSIZEDefiniert 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.ddd.TerrainToRaster("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)

Lizenzinformationen

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

Verwandte Themen