Beschriftung | Erläuterung | Datentyp |
Eingabe-Raster | Das Raster, das verarbeitet wird. | Raster Layer; Mosaic Layer |
Ausgabe-Feature-Class | Die Feature-Class, die erstellt wird. | Feature Class |
Ausgabe-VIP-Tabelle (optional) | Die Histogrammtabelle, die erstellt wird, wenn für den Parameter Ausdünnungsmethode die Option VIP-Histogramm angegeben wird. Die Histogrammtabelle, die erstellt wird, wenn für den Parameter method die Option VIP_HISTOGRAM angegeben wird. | Table |
Ausdünnungsmethode (optional) | Gibt die Ausdünnungsmethode an, die auf das Eingabe-Raster angewendet wird, um eine Teilmenge der Zellen auszuwählen, die in die Multipoint-Feature-Class exportiert werden.
| String |
Kernel-Methode (optional) | Gibt die Auswahlmethode an, die in jeder Kernel-Nachbarschaft verwendet wird, wenn die Kernel-Ausdünnung auf das Eingabe-Raster angewendet wird.
| String |
Z-Faktor (optional) | Der Faktor, mit dem Z-Werte multipliziert werden. Dieser wird in der Regel verwendet, um lineare Z-Einheiten zu konvertieren, sodass sie den linearen XY-Einheiten entsprechen. Der Standardwert ist 1, wodurch die Höhenwerte unverändert bleiben. Der Parameter ist nicht verfügbar, wenn der Raumbezug der Eingabe-Oberfläche über ein Z-Datum mit einer angegebenen linearen Einheit verfügt. | Double |
Ausdünnungswert (optional) | Der dem Parameter Ausdünnungsmethode zugeordnete Ausdünnungswert.
| Double |
Zusammenfassung
Konvertiert Raster-Zellenmittelpunkte in 3D-Multipoint-Features, deren Z-Werte den Raster-Zellenwert darstellen.
Verwendung
Verwenden Sie dieses Werkzeug, wenn Sie über Raster-Höhendaten verfügen und Zugriff auf die Funktionen benötigen, die von einer triangulierten Oberfläche bereitgestellt werden, da Multipoint-Features in ein TIN oder Terrain-Dataset geladen werden können.
Wenn der Parameterwert für Eingabe-Raster sehr groß ist, können Sie den Parameter Ausdünnungsmethode verwenden, um die Anzahl der Zellen zu reduzieren, die in die Multipoint-Feature-Class exportiert werden. Die folgenden Optionen sind verfügbar:
- Z-Toleranz: Die Zellen werden ausgedünnt, wobei die vertikale Genauigkeit beibehalten wird.
- Kernel: Die Zellen werden ausgedünnt, wobei die horizontale Abtastschrittweite reguliert wird.
- VIP: Verwenden Sie diese Option, falls die resultierenden Multipoints hauptsächlich für Visualisierungsanwendungen genutzt werden. Diese Methode ist relativ schnell, gibt eine vorhersagbare Anzahl von Punkten aus und erkennt lokale Spitzen und Vertiefungen. Sie ist jedoch gegen Rauschen empfindlich und ignoriert möglicherweise topografische Features, deren Ausdehnung größer als der Bereich von 3 mal 3 Zellen ist.
- VIP-Histogramm: Verwenden Sie diese Option als ersten Schritt bei der Anwendung der Option VIP, da ein Histogramm der Signifikanzwerte erstellt wird, das die Anzahl der Punkte widergespiegelt, die für jeden inkrementellen Perzentilwert ausgewählt wird.
Parameter
arcpy.ddd.RasterToMultipoint(in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor}, {thinning_value})
Name | Erläuterung | Datentyp |
in_raster | Das Raster, das verarbeitet wird. | Raster Layer; Mosaic Layer |
out_feature_class | Die Feature-Class, die erstellt wird. | Feature Class |
out_vip_table (optional) | Die Histogrammtabelle, die erstellt wird, wenn für den Parameter Ausdünnungsmethode die Option VIP-Histogramm angegeben wird. Die Histogrammtabelle, die erstellt wird, wenn für den Parameter method die Option VIP_HISTOGRAM angegeben wird. | Table |
method (optional) | Gibt die Ausdünnungsmethode an, die auf das Eingabe-Raster angewendet wird, um eine Teilmenge der Zellen auszuwählen, die in die Multipoint-Feature-Class exportiert werden.
| String |
kernel_method (optional) | Gibt die Auswahlmethode an, die in jeder Kernel-Nachbarschaft verwendet wird, wenn die Kernel-Ausdünnung auf das Eingabe-Raster angewendet wird.
| String |
z_factor (optional) | Der Faktor, mit dem Z-Werte multipliziert werden. Dieser wird in der Regel verwendet, um lineare Z-Einheiten zu konvertieren, sodass sie den linearen XY-Einheiten entsprechen. Der Standardwert ist 1, wodurch die Höhenwerte unverändert bleiben. Der Parameter ist nicht verfügbar, wenn der Raumbezug der Eingabe-Oberfläche über ein Z-Datum mit einer angegebenen linearen Einheit verfügt. | Double |
thinning_value (optional) | Der dem Parameter method zugeordnete Ausdünnungswert.
| Double |
Codebeispiel
Im folgenden Beispiel wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.
arcpy.env.workspace = "C:/data"
arcpy.ddd.RasterToMultipoint("elevation.tif", out_vip_table="elev_VIP.dbf",
method="VIP_HISTOGRAM", z_factor=1)
Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht.
'''*********************************************************************
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
# Set default workspace
arcpy.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:
print("There are no IMG rasters in the " + env.workspace + " directory.")