Raster zu Multipoint (3D Analyst)
Zusammenfassung
Konvertiert Raster-Zellenmittelpunkte in Multipoint-Features, deren Z-Werte den Raster-Zellenwert wiedergeben.
Verwendung
Dieses Werkzeug ist für Raster-Datasets bestimmt, die Oberflächeneigenschaften wie z. B. Höhe modellieren.
-
Dieses Werkzeug ist nützlich, um ein Raster-DEM in Punkte einzubinden, die als Hilfsdaten zum Erstellen eines Terrain-Datasets oder TINs verwendet werden können.
Mit der Option NO_THIN können alle Zellenmittelpunkte konvertiert werden; zudem können auch Filter angewendet werden, um weniger signifikante Zellen auszuschließen. Die Ausdünnungsoptionen umfassen ZTOLERANCE, KERNEL und VIP.
- Die Ausdünnungsmethode ZTOLERANCE stellt die maximal zulässige Abweichung (in Z-Einheiten) zwischen der Höhe des Eingabe-Rasters und der Höhe der Ausgabe-Multipoint-Feature-Class dar. Standardmäßig beträgt die Z-Toleranz 1/10 des Z-Bereichs des Eingabe-Rasters. Je größer die Toleranz, umso höher ist die Ausdünnung und umso weniger Punkte werden ausgegeben.
- Die Ausdünnungsmethode KERNEL definiert die Anzahl der Zellen in einem Fenster. Die Standardeinstellung ist 3, was im Eingabe-Raster in Fenster von drei auf drei Zellen umgesetzt wird. Die einzelnen Zellenwerte in jedem dieser Fenster werden ausgewertet. Dann werden abhängig von der KERNEL-Auswahlmethode nur eine oder zwei Zellen ausgewählt. Mit zunehmender Kernel-Größe erhöht sich die Ausdünnung, und es werden weniger Punkte ausgegeben.
- Die VIP-Methode wird verwendet, um einen Prozentsatz der Punkte basierend auf der Signifikanz aus dem Eingabe-Raster auszuwählen. Die Signifikanz wird mithilfe eines beweglichen Fensters mit 3 auf 3 Zellen bewertet. Sie können die Option VIP_HISTOGRAM auswählen, um eine Tabelle zu schreiben, in der die tatsächlich signifikanten Werte und die entsprechende Anzahl der mit diesen Werten verknüpften Punkte angezeigt werden.
-
Verwenden Sie die Ausdünnungsmethode ZTOLERANCE, wenn es wichtig ist, dass die vertikale Genauigkeit beibehalten wird. Verwenden Sie die Ausdünnungsmethode KERNEL, wenn die horizontale Abtastschrittweite gesteuert werden soll.
-
Sie können eine Ausdünnungsmethode anwenden, wenn Sie Raster in Multipoints konvertieren. Es gibt zwei Ausdünnungsmethoden, mit denen eine neue Multipoint-Feature-Class erstellt werden kann: ZTOLERANCE und KERNEL. Wenn NO_THIN ausgewählt ist, werden die Daten mit voller Auflösung in eine neue Multipoint-Feature-Class ausgegeben.
-
Die Methode VIP ist relativ schnell, gibt eine vorhersagbare Anzahl von Punkten aus und ist gut dafür geeignet, lokale Spitzen und Vertiefungen auszuwählen. Sie ist jedoch gegen Rauschen empfindlich und reagiert nicht auf topographische Features, die größer als das Fenster mit seinen 3 auf 3 Zellen sind.
Syntax
| Parameter | Erläuterung | Datentyp |
in_raster |
The input raster. | Raster Layer |
out_feature_class |
The output feature class. | Feature Class |
out_vip_table (optional) |
Die Histogrammtabelle, die erzeugt werden soll, wenn für den Parameter Methode "VIP-Histogramm" angegeben wird. | Table |
method (optional) |
Die Ausdünnungsmethode für das Generieren der Multipoint-Feature-Class.
| String |
kernel_method (optional) |
Die Auswahlmethode für das Erstellen von Punkten, wenn im Parameter Methode "Kernel-Ausdünnung" angegeben wird.
| String |
z_factor (optional) |
Der Faktor, der zum Multiplizieren der Höhe des Rasters verwendet wird. Diese Option wird im Allgemeinen verwendet, um Einheiten zwischen Fuß und Meter umzurechnen. | 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.RasterToMultipoint_3d("elevation.tif", "","elev_VIP.dbf", "VIP_HISTOGRAM", "", "1")
The following sample demonstrates the use of this tool in a stand-alone Python script:
'''*********************************************************************
Name: RasterToMultipoint Example
Description: This script demonstrates how to use
the RasterToMultipoint tool to create multipoint datasets
fot all IMG rasters in a target workspace.
**********************************************************************'''
# Import system modules
import arcpy
from arcpy import env
import exceptions
try:
arcpy.CheckOutExtension("3D")
# Set default workspace
env.workspace = "C:/data"
# Create the list of IMG rasters
rasterList = arcpy.ListRasters("*", "IMG")
# Loop the process for each raster
if rasterList:
for raster in rasterList:
# Set Local Variables
# [:-4] strips the last 4 characters (.img) from the raster name
outTbl = "VIP_" + raster[:-4] + ".dbf"
method = "VIP_HISTOGRAM"
zfactor = 1
#Execute RasterToMultipoint
arcpy.ddd.RasterToMultipoint(raster, "",outTbl, method, "", zfactor)
else:
"There are no IMG rasters in the " + env.workspace + " directory."
except Exception as e:
# Returns any other error messages
print e.message