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.
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.
No Thinning—No thinning will be applied. This is the default.
Z Tolerance—Only the cells that are required for maintaining a surface within a specified z-range of the input raster will be exported.
Kernel—The raster will be divided into equal-sized tiles based on the Thinning Value parameter value, and one or two cells that meet the Kernel Method parameter value will be exported.
VIP—A roving 3-cell-by-3-cell window will be used to create a three-dimensional best fit plane. Each cell is given a significance score based on its absolute deviation from this plane. A histogram of these scores is then used to determine the cells that will be exported based on the Thinning Value parameter value.
VIP Histogram—A table will be created containing the significance values and the corresponding number of points associated with those values.
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.
Minimum—A point will be created at the cell with the smallest elevation value found in the kernel neighborhood. This is the default.
Maximum—A point will be created at the cell with the largest elevation value found in the kernel neighborhood.
Minimum and Maximum—Two points will be created at the cells with the smallest and largest z-values found in the kernel neighborhood.
Closest to Mean—A point will be created at the cell whose elevation value is closest to the average of the cells in the kernel neighborhood.
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. Dieser 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 Perzentilrangstufe 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.
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_THIN—No thinning will be applied. This is the default.
ZTOLERANCE—Only the cells that are required for maintaining a surface within a specified z-range of the input raster will be exported.
KERNEL—The raster will be divided into equal-sized tiles based on the Thinning Value parameter value, and one or two cells that meet the Kernel Method parameter value will be exported.
VIP—A roving 3-cell-by-3-cell window will be used to create a three-dimensional best fit plane. Each cell is given a significance score based on its absolute deviation from this plane. A histogram of these scores is then used to determine the cells that will be exported based on the Thinning Value parameter value.
VIP_HISTOGRAM—A table will be created containing the significance values and the corresponding number of points associated with those values.
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.
MIN—A point will be created at the cell with the smallest elevation value found in the kernel neighborhood. This is the default.
MAX—A point will be created at the cell with the largest elevation value found in the kernel neighborhood.
MINMAX—Two points will be created at the cells with the smallest and largest z-values found in the kernel neighborhood.
MEAN—A point will be created at the cell whose elevation value is closest to the average of the cells in the kernel neighborhood.
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. Dieser 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 Parameterwert 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 Perzentilrangstufe 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)
Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht:
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
# Run RasterToMultipoint
arcpy.ddd.RasterToMultipoint(raster, "", outTbl, method, "", zfactor)
else:
print("There are no IMG rasters in the " + arcpy.env.workspace + " directory.")