Convertit des centres de cellule raster en entités multi-points 3D avec des valeurs z qui reflètent la valeur des cellules raster.
Utilisation
Utilisez cet outil si vous possédez des données d’altitude raster et devez accéder aux fonctions fournies par une surface triangulée, car les entités multi-points peuvent être chargées dans un TIN ou un jeu de données de MNT.
Si la valeur de paramètre Input Raster (Raster en entrée) est de très grande taille, envisagez d’utiliser le paramètre Thinning Method (Méthode d’affinage) pour réduire le nombre de cellules exportées vers la classe d’entités multi-points. Les options sont les suivantes :
Z Tolerance (Tolérance Z) : affinez les cellules tout en préservant l’exactitude verticale.
Kernel (Noyau) : affinez les cellules tout en contrôlant la distance d’exemple horizontale.
VIP : utilisez cette option si les multi-points obtenus sont destinés à être principalement utilisés dans des applications de visualisation. Cette méthode est relativement rapide, elle génère un nombre prévisible de points et identifie les sommets et les dépressions locaux. Toutefois, elle est sensible au bruit et peut ignorer des entités topographiques couvrant une étendue supérieure à la zone de trois cellules par trois cellules.
VIP Histogram (Histogramme VIP) : commencez par utiliser cette option afin d’appliquer l’option VIP, car elle génère un histogramme des scores de signification qui reflète le nombre de points sélectionnés avec chaque valeur de centile d’incrémentation.
Table d’histogramme créée si l’option VIP Histogram (Histogramme VIP) est indiquée pour le paramètre Thinning Method (Méthode d’affinage).
Table d’histogramme créée si l’option VIP_HISTOGRAM est indiquée pour le paramètre method.
Table
Méthode d’affinage
(Facultatif)
Indique la méthode d’affinage qui est appliquée au raster en entrée afin de sélectionner un sous-ensemble de cellules qui sont exportées vers la classe d’entités multi-points.
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
Méthode du noyau
(Facultatif)
Indique la méthode de sélection qui est utilisée dans chaque voisinage de noyau lorsque l’affinage du noyau est appliqué au raster en entrée.
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
Facteur Z
(Facultatif)
Facteur par lequel les valeurs z sont multipliées. Il permet généralement de convertir des unités linéaires z afin de les apparier aux unités linéaires x,y. La valeur par défaut est 1, qui laisse les valeurs d'altitude inchangées. Ce paramètre n’est pas disponible si la référence spatiale de la surface en entrée possède un datum z avec une unité linéaire spécifiée.
Double
Valeur d’affinage
(Facultatif)
Valeur d’affinage associée à la valeur du paramètre Thinning Method (Méthode d’affinage).
Z Tolerance (Tolérance Z) : différence maximale autorisée en unités z entre le raster en entrée et la surface créée à partir de la classe d’entités multi-points en sortie. La valeur par défaut correspond à un dixième de la plage z du raster en entrée.
Kernel (Noyau) : nombre de cellules raster le long du tronçon de chaque tuile. La valeur par défaut est de 3, ce qui signifie que le raster est divisé en fenêtres de trois cellules par trois cellules.
VIP : classement en centile de l’histogramme des scores de signification. La valeur par défaut est de 5,0, ce qui signifie que les cellules dont le score se trouve dans les 5 pour cent supérieurs de l’histogramme sont exportées.
Table d’histogramme créée si l’option VIP Histogram (Histogramme VIP) est indiquée pour le paramètre Thinning Method (Méthode d’affinage).
Table d’histogramme créée si l’option VIP_HISTOGRAM est indiquée pour le paramètre method.
Table
method
(Facultatif)
Indique la méthode d’affinage qui est appliquée au raster en entrée afin de sélectionner un sous-ensemble de cellules qui sont exportées vers la classe d’entités multi-points.
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
(Facultatif)
Indique la méthode de sélection qui est utilisée dans chaque voisinage de noyau lorsque l’affinage du noyau est appliqué au raster en entrée.
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
(Facultatif)
Facteur par lequel les valeurs z sont multipliées. Il permet généralement de convertir des unités linéaires z afin de les apparier aux unités linéaires x,y. La valeur par défaut est 1, qui laisse les valeurs d'altitude inchangées. Ce paramètre n’est pas disponible si la référence spatiale de la surface en entrée possède un datum z avec une unité linéaire spécifiée.
Double
thinning_value
(Facultatif)
Valeur d’affinage associée à la valeur du paramètre method.
ZTolerance—Différence maximale autorisée en unités z entre le raster en entrée et la surface créée à partir de la classe d’entités multi-points en sortie. La valeur par défaut correspond à un dixième de la plage z du raster en entrée.
KERNEL—Nombre de cellules raster le long du tronçon de chaque tuile. La valeur par défaut est de 3, ce qui signifie que le raster est divisé en fenêtres de trois cellules par trois cellules.
VIP—Classement en centile de l’histogramme des scores de signification. La valeur par défaut est de 5,0, ce qui signifie que les cellules dont le score se trouve dans les 5 pour cent supérieurs de l’histogramme sont exportées.
Double
Exemple de code
Exemple 1 d’utilisation de l’outil RasterToMultipoint (fenêtre Python)
L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre Python :
Exemple 2 d’utilisation de l’outil RasterToMultipoint (script autonome)
L’exemple suivant illustre l’utilisation de cet outil dans un script Python autonome :
'''*********************************************************************
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.")