Résumé
Convertit des centres de cellule raster en entités multi-points 3D dont les valeurs Z 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.
Lorsque le raster en entrée est de très grande taille, appliquez une méthode d'affinage en vue de réduire le nombre de cellules qui sont exportées vers la classe d'entités multi-points.
- Utilisez la méthode d'affinage Tolérance Z lorsqu'il est important de conserver la précision verticale.
- Utilisez la méthode d'affinage Noyau lorsqu'il est important de contrôler la distance d'échantillonnage horizontal.
- Utilisez la méthode d'affinage VIP 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 sélectionne efficacement les sommets et les dépressions locaux. Toutefois, elle est sensible au bruit et risque d'ignorer les entités topographiques dont l'étendue est supérieure à la surface de 3 cellules sur 3 cellules.
- Commencez pas utiliser l'option Histogramme VIP afin d'appliquer la méthode d'affinage VIP, car elle génère un histogramme des scores de signification qui vous permet de connaître le nombre de points sélectionnés avec chaque valeur de pourcentage d'incrémentation.
Syntaxe
RasterToMultipoint(in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor}, {thinning_value})
Paramètre | Explication | Type de données |
in_raster | Raster à traiter. | Raster Layer; Mosaic Layer |
out_feature_class | Classe d'entités qui va être produite par cet outil. | Feature Class |
out_vip_table (Facultatif) | Table d'histogramme à fournir lorsque Histogramme VIP est indiqué pour le paramètre Méthode. | Table |
method (Facultatif) | Méthode d'affinage 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.
| String |
kernel_method (Facultatif) | Méthode de sélection utilisée au sein de chaque voisinage de noyau lorsque l'affinage du noyau est appliqué au raster en entrée.
| 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 d'apparier les unités linéaires XY. La valeur par défaut est de 1, ce qui laisse les valeurs d’altitude inchangées. Ce paramètre est désactivé 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) | La signification de cette valeur dépend de la méthode d'affinage spécifiée.
| Double |
Exemple de code
L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre Python.
arcpy.env.workspace = "C:/data"
arcpy.RasterToMultipoint_3d("elevation.tif", out_vip_table="elev_VIP.dbf",
method="VIP_HISTOGRAM", z_factor=1)
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
#Execute RasterToMultipoint
arcpy.ddd.RasterToMultipoint(raster, "",outTbl, method, "", zfactor)
else:
print("There are no IMG rasters in the " + env.workspace + " directory.")
Environnements
Informations de licence
- Basic: Requiert 3D Analyst
- Standard: Requiert 3D Analyst
- Advanced: Requiert 3D Analyst
Vous avez un commentaire à formuler concernant cette rubrique ?