Raster in Multipoint (3D Analyst)

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

BeschriftungErläuterungDatentyp
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.

  • Keine AusdünnungEs wird keine Ausdünnung angewendet. Dies ist die Standardeinstellung.
  • Z-ToleranzEs werden nur die Zellen exportiert, die erforderlich sind, um eine Oberfläche innerhalb eines angegebenen Z-Bereichs des Eingabe-Rasters beizubehalten.
  • KernelDas Raster wird auf Grundlage des Parameters Ausdünnungswert in gleich große Kacheln unterteilt. Ein oder zwei Zellen, die dem Wert des Parameters Kernelmethode entsprechen, werden exportiert.
  • VIPEin bewegliches Fenster aus drei Mal drei Zellen wird zum Erstellen einer dreidimensionalen Ebene zur optimalen Anpassung verwendet. Jeder Zelle wird ein Signifikanzwert basierend auf ihrer absoluten Abweichung von dieser Ebene zugewiesen. Anschließend wird ein Histogramm dieser Punktzahlen herangezogen, um die Zellen zu bestimmen, die auf Grundlage des Parameters Ausdünnungswert exportiert werden.
  • VIP-HistogrammEs wird eine Tabelle mit den Signifikanzwerten und der entsprechenden Anzahl an Punkten, die mit diesen Werten verknüpft sind, erstellt.
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.

  • MinimumEin Punkt wird bei der Zelle mit dem kleinsten Höhenwert, der in der Kernel-Nachbarschaft gefunden wurde, erstellt. Dies ist die Standardeinstellung.
  • MaximumEin Punkt wird bei der Zelle mit dem größten Höhenwert, der in der Kernel-Nachbarschaft gefunden wurde, erstellt.
  • Minimum und MaximumEs werden zwei Punkte bei den Zellen mit den kleinsten und größten Z-Werten erstellt, die in der Kernel-Nachbarschaft gefunden wurden.
  • Am nächsten zum Mittelwert gelegenEin Punkt wird bei der Zelle erstellt, deren Höhenwert dem Durchschnitt der Zellen in der Kernel-Nachbarschaft am nächsten ist.
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.

  • 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. Der Standardwert beträgt 1/10 des Z-Wertebereichs des Eingabe-Rasters.
  • Kernel: Die Anzahl der Raster-Zellen an der Kante jeder Kachel. Der Standardwert ist 3, was bedeutet, dass das Raster in Fenster aus drei Mal drei Zellen unterteilt wird.
  • VIP: Die Pezentilrangstufe des Histogramms der Signifikanzwerte. Der Standardwert lautet 5,0, was bedeutet, dass die Zellen, deren Punktzahl innerhalb des Bereichs der oberen 5 % des Histogramms liegt, exportiert werden.
Double

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

  • 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.
  • KERNELDas Raster wird auf Grundlage des Parameters Ausdünnungswert in gleich große Kacheln unterteilt. Ein oder zwei Zellen, die dem Wert des Parameters Kernelmethode entsprechen, werden exportiert.
  • VIPEin bewegliches Fenster aus drei Mal drei Zellen wird zum Erstellen einer dreidimensionalen Ebene zur optimalen Anpassung verwendet. Jeder Zelle wird ein Signifikanzwert basierend auf ihrer absoluten Abweichung von dieser Ebene zugewiesen. Anschließend wird ein Histogramm dieser Punktzahlen herangezogen, um die Zellen zu bestimmen, die auf Grundlage des Parameters Ausdünnungswert exportiert werden.
  • VIP_HISTOGRAMEs wird eine Tabelle mit den Signifikanzwerten und der entsprechenden Anzahl an Punkten, die mit diesen Werten verknüpft sind, erstellt.
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.

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

  • ZTolerance: 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. Der Standardwert beträgt 1/10 des Z-Wertebereichs des Eingabe-Rasters.
  • KERNEL: Die Anzahl der Raster-Zellen an der Kante jeder Kachel. Der Standardwert ist 3, was bedeutet, dass das Raster in Fenster aus drei Mal drei Zellen unterteilt wird.
  • VIP: Die Pezentilrangstufe des Histogramms der Signifikanzwerte. Der Standardwert lautet 5,0, 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)

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

Verwandte Themen