Raster in Multipoint (3D Analyst)

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

arcpy.3d.RasterToMultipoint(in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor}, {thinning_value})
ParameterErklärungDatentyp
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.

  • NO_THINEs wird keine Ausdünnung angewendet. Dies ist die Standardeinstellung.
  • ZTOLERANCEEs werden nur die Zellen exportiert, die erforderlich sind, um eine Oberfläche innerhalb eines angegebenen Z-Bereichs des Eingabe-Rasters beizubehalten.
  • KERNELUnterteilt das Raster in gleich große Kacheln basierend auf dem angegebenen Ausdünnungswert, und wählt anschließend ein oder zwei Zellen aus, die den in der angegebenen Kernel-Methode definierten Kriterien entsprechen.
  • VIPVerwendet ein bewegliches Fenster aus drei Mal drei Zellen, das eine dreidimensionale Ebene zur optimalen Anpassung erstellt. Jeder Zelle wird ein Signifikanzwert basierend auf ihrer absoluten Abweichung von dieser Ebene zugewiesen. Anschließend wird ein Histogramm dieser Ergebnisse herangezogen, um die Zellen zu bestimmen, die auf Grundlage des im Parameter Ausdünnungswert festgelegten Perzentils exportiert werden.
  • VIP_HISTOGRAMErstellt eine Tabelle, in der die tatsächlichen Signifikanzwerte und die entsprechende Anzahl von zugeordneten Punkten angezeigt 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.

  • MINEin Punkt wird bei der Zelle mit dem kleinsten Höhenwert, der in der Nähe des Kernels gefunden wurde, erstellt. Dies ist die Standardeinstellung.
  • MAXEin Punkt wird bei der Zelle mit dem größten Höhenwert, der in der Nähe des Kernels gefunden wurde, erstellt.
  • MINMAXEs werden zwei Punkte bei den Zellen mit den kleinsten und größten Z-Werten erstellt, die in der Nähe des Kernels gefunden wurden.
  • MEANEin Punkt wird bei der Zelle erstellt, deren Höhenwert dem Durchschnitt der Zellen in der Nähe des Kernels am nächsten ist.
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.

  • Z-Toleranz – Die maximal zulässige Abweichung in Z-Einheiten zwischen dem Eingabe-Raster und der Oberfläche, die aus der Ausgabe-Multipoint-Feature-Class erstellt wurde. Bei Auswahl dieser Methode wird der Ausdünnungswert standardmäßig auf ein Zehntel des Z-Bereichs des Eingabe-Rasters festgelegt.
  • Kernel – Die Anzahl der Rasterzellen an der Kante jeder Kachel. Dieser Wert wird standardmäßig auf 3 festgelegt, was bedeutet, dass das Raster in Fenster aus drei Mal drei Zellen unterteilt wird.
  • VIP – Die Pezentilrangstufe des Histogramms der Signifikanzwerte. Dieser Wert wird standardmäßig auf 5,0 festgelegt, was bedeutet, dass die Zellen, deren Punktzahl innerhalb des Bereichs der oberen 5 % des Histogramms liegt, exportiert werden.
Double

Codebeispiel

RasterToMultipoint – Beispiel 1 (Python-Fenster)

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)
RasterToMultipoint – Beispiel 2 (eigenständiges Skript)

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.")

Lizenzinformationen

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