Raster vers multi-points (3D Analyst)

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

arcpy.3d.RasterToMultipoint(in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor}, {thinning_value})
ParamètreExplicationType 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.

  • NO_THINAucun affinage ne sera appliqué. Il s'agit de l'option par défaut.
  • ZTOLERANCEExporte uniquement les cellules qui sont nécessaires à la conservation d'une surface au sein d'une plage Z spécifiée du raster en entrée.
  • KERNELDivise le raster en tuiles de taille égale en fonction de la valeur d'affinage spécifiée, puis sélectionne une ou deux cellules qui répondent aux critères définis par la méthode du noyau désignée.
  • VIPEmploie une fenêtre mobile de 3 cellules sur 3 cellules qui permet de créer un plan de compromis en 3 dimensions. Un score de signification est attribué à chaque cellule en fonction de son écart absolu par rapport à ce plan. Un histogramme de ces scores est ensuite utilisé pour identifier les cellules qui seront exportées en fonction du pourcentage désigné dans le paramètre Valeur d'affinage.
  • VIP_HISTOGRAMCrée une table pour afficher les valeurs d'importance réelles et le nombre correspondant de points associés à ces valeurs.
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.

  • MINUn point est créé au niveau de la cellule présentant la plus petite valeur d'altitude recherchée dans le voisinage de noyau. Il s'agit de l'option par défaut.
  • MAXUn point est créé au niveau de la cellule présentant la plus grande valeur d'altitude recherchée dans le voisinage de noyau.
  • MINMAXDeux points sont créés au niveau des cellules présentant la plus petite valeur Z et la plus grande valeur Z dans le voisinage de noyau.
  • MEANUn point est créé au niveau de la cellule dont la valeur d'altitude est la plus proche de la moyenne des cellules dans le voisinage de noyau.
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.

  • Tolérance Z : représente la différence maximum 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. Lorsque vous sélectionnez cette méthode, la valeur d'affinage utilise par défaut un dixième de la plage Z du raster en entrée.
  • Noyau : nombre de cellules raster le long du tronçon de chaque tuile. Cette valeur est de 3 par défaut, ce qui signifie que le raster est divisé en fenêtres de 3 cellules sur 3 cellules.
  • VIP : classement en pourcentage de l'histogramme des scores de signification. Cette valeur est de 5,0 par défaut, ce qui signifie que les cellules dont le score se trouve dans les 5 % supérieurs de l'histogramme seront exportées.
Double

Exemple de code

1er exemple d'utilisation de l'outil RasterToMultipoint (fenêtre Python)

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)
2e exemple 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
        #Execute RasterToMultipoint
        arcpy.ddd.RasterToMultipoint(raster, "",outTbl, method, "", zfactor)
else:
    print("There are no IMG rasters in the " + env.workspace + " directory.")

Informations de licence

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