Raster in Multipoint

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.ddd.RasterToMultipoint(in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor})

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. NO_THIN —Es wird keine Ausdünnung angewendet. Dies ist die Standardeinstellung. ZTOLERANCE <value> —Es werden nur die Zellen exportiert, die erforderlich sind, um eine Oberfläche innerhalb des angegebenen Z-Bereichs des Eingabe-Rasters beizubehalten. Der entsprechende Wert zeigt die maximal zulässige Abweichung in Z-Einheiten zwischen dem Eingabe-Raster und der Oberfläche an, 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 <value> —Unterteilt das Raster in gleich große Kacheln basierend auf dem Ausdünnungswert und wählt anschließend ein oder zwei Zellen aus, die den in der angegebenen Kernel-Methode definierten Kriterien entsprechen. Der entsprechende Wert wird standardmäßig auf 3 festgelegt, was bedeutet, dass das Raster in Fenster aus drei Mal drei Zellen unterteilt wird. VIP <value> —Verwendet 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 anhand eines Histogramms dieser Ergebnisse festgelegt, welche Zellen exportiert werden. Der entsprechende Wert spiegelt die Perzentilrangstufe im Histogramm der Signifikanzwerte wider. 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. VIP_HISTOGRAM —Erstellt 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. MIN —Ein Punkt wird bei der Zelle mit dem kleinsten Höhenwert, der in der Nähe des Kernels gefunden wurde, erstellt. Dies ist die Standardeinstellung. MAX —Ein Punkt wird bei der Zelle mit dem größten Höhenwert, der in der Nähe des Kernels gefunden wurde, erstellt. MINMAX —Es werden zwei Punkte bei den Zellen mit den kleinsten und größten Z-Werten erstellt, die in der Nähe des Kernels gefunden wurden. MEAN —Ein 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

Codebeispiel

RasterToMultipoint – Beispiel 1 (Python-Fenster)

Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.RasterToMultipoint_3d("elevation.tif", "","elev_VIP.dbf", "VIP_HISTOGRAM", "", "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
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

Umgebungen

• Aktueller Workspace
• Ausgabe-Koordinatensystem
• Ausdehnung
• Geographische Transformationen
• XY-Auflösung
• XY-Toleranz
• Z-Auflösung
• Z-Toleranz
• Ausgabe-XY-Domäne
• Ausgabe-Z-Domäne
• Ausgabe-CONFIG-Schlüsselwort
• Auto-Commit

Lizenzinformationen

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