Zusammenfassung
Konvertiert Raster-Zellenmittelpunkte in 3D-Multipoint-Features, deren Z-Werte den Raster-Zellenwert wiedergeben.
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 das Eingabe-Raster sehr groß ist, können Sie eine Ausdünnungsmethode verwenden, um die Anzahl der Zellen zu reduzieren, die in die Multipoint-Feature-Class exportiert werden.
- Verwenden Sie die Ausdünnungsmethode Z-Toleranz, wenn es wichtig ist, dass die vertikale Genauigkeit beibehalten wird.
- Verwenden Sie die Ausdünnungsmethode Kernel, wenn die horizontale Abtastschrittweite gesteuert werden soll.
- Verwenden Sie die Ausdünnungsmethode VIP, falls die resultierenden Multipoints hauptsächlich für Visualisierungsanwendungen angewendet werden. Diese Methode ist relativ schnell, gibt eine vorhersagbare Anzahl von Punkten aus und ist ideal dafür geeignet, lokale Spitzen und Vertiefungen auszuwählen. 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.
- Verwenden Sie die Option VIP-Histogramm als ersten Schritt bei der Anwendung der VIP-Ausdünnungsmethode, da ein Histogramm der Signifikanzwerte erstellt wird, dem Sie die Anzahl der Punkte entnehmen können, die für jeden inkrementellen Perzentilwert ausgewählt wird.
Syntax
RasterToMultipoint(in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor}, {thinning_value})
Parameter | Erklärung | Datentyp |
in_raster | Das zu verarbeitende Raster. | Raster Layer; Mosaic Layer |
out_feature_class | Die Feature-Class, die von diesem Werkzeug erstellt wird. | Feature Class |
out_vip_table (optional) | Die Histogrammtabelle, die erzeugt werden soll, wenn für den Parameter Methode "VIP_HISTOGRAM" angegeben wird. | Table |
method (optional) | Die Ausdünnungsmethode, die auf das Eingabe-Raster angewendet wird, um eine Teilmenge der Zellen auszuwählen, die in die Multipoint-Feature-Classe exportiert werden.
| String |
kernel_method (optional) | Die Auswahlmethode, 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 deaktiviert, wenn der Raumbezug der Eingabe-Oberfläche über ein Z-Datum mit einer angegebenen linearen Einheit verfügt. | Double |
thinning_value (optional) | Die Bedeutung dieses Wertes hängt von der angegebenen Ausdünnungsmethode ab.
| Double |
Codebeispiel
Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.
arcpy.env.workspace = "C:/data"
arcpy.RasterToMultipoint_3d("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.")
Umgebungen
Lizenzinformationen
- Basic: Erfordert 3D Analyst
- Standard: Erfordert 3D Analyst
- Advanced: Erfordert 3D Analyst