Raster vers multi-points (3D Analyst)

Synthèse

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.

  • Lorsque la valeur de paramètre Raster en entrée est de très grande taille, appliquez le paramètre Méthode d’affinage pour réduire le nombre de cellules qui sont exportées vers la classe d’entités multi-points. Les options sont les suivantes :

    • Tolérance Z : affinez les cellules tout en préservant l’exactitude verticale. 
    • 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 risque d'ignorer les entités topographiques dont l'étendue est supérieure à la surface de 3 cellules sur 3 cellules.
    • 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 pourcentage d’incrémentation.

Paramètres

ÉtiquetteExplicationType de données
Raster en entrée

Le raster qui est traité.

Raster Layer; Mosaic Layer
Classe d’entités en sortie

Classe d’entités qui va être produite.

Feature Class
Tableau VIP en sortie
(Facultatif)

La table d’histogramme qui est créée lorsque Histogramme VIP est indiqué pour le paramètre Méthode d’affinage.

La table d’histogramme qui est créée lorsque VIP_HISTOGRAM est indiqué 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.

  • Aucun affinageAucun affinage ne sera appliqué. Il s’agit de l’option par défaut.
  • Tolérance ZSeules 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 sont exportées.
  • NoyauLe raster est divisé en tuiles de taille égale en fonction du paramètre Valeur d’affinage, puis une ou deux cellules qui correspondent à la valeur du paramètre Méthode du noyau sont exportées.
  • VIPUne fenêtre mobile de 3 cellules sur 3 cellules est utilisée pour créer un plan de meilleur ajustement en trois 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 sont exportées en fonction de la valeur du paramètre Valeur d’affinage.
  • Histogramme VIPUne table contenant les valeurs de signification et le nombre correspondant de points associés à ces valeurs est créée.
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.

  • MinimumUn 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.
  • MaximumUn point est créé au niveau de la cellule présentant la plus grande valeur d’altitude recherchée dans le voisinage de noyau.
  • Minimum et maximumDeux 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.
  • La plus proche de la moyenneUn 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
Facteur Z
(Facultatif)

Facteur par lequel les valeurs z sont multipliées. Cette option permet généralement de convertir les unités linéaires z afin qu’elles correspondent 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 dont l’unité linéaire est spécifiée.

Double
Valeur d’affinage
(Facultatif)

Valeur d’affinage associée à la valeur du paramètre Méthode d’affinage.

  • 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. La valeur par défaut correspond à 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. La valeur par défaut est de 3, ce qui signifie que le raster est divisé en fenêtres de 3 cellules par 3 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

arcpy.ddd.RasterToMultipoint(in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor}, {thinning_value})
NomExplicationType de données
in_raster

Le raster qui est traité.

Raster Layer; Mosaic Layer
out_feature_class

Classe d’entités qui va être produite.

Feature Class
out_vip_table
(Facultatif)

La table d’histogramme qui est créée lorsque Histogramme VIP est indiqué pour le paramètre Méthode d’affinage.

La table d’histogramme qui est créée lorsque VIP_HISTOGRAM est indiqué 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_THINAucun affinage ne sera appliqué. Il s’agit de l’option par défaut.
  • ZTOLERANCESeules 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 sont exportées.
  • KERNELLe raster est divisé en tuiles de taille égale en fonction du paramètre Valeur d’affinage, puis une ou deux cellules qui correspondent à la valeur du paramètre Méthode du noyau sont exportées.
  • VIPUne fenêtre mobile de 3 cellules sur 3 cellules est utilisée pour créer un plan de meilleur ajustement en trois 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 sont exportées en fonction de la valeur du paramètre Valeur d’affinage.
  • VIP_HISTOGRAMUne table contenant les valeurs de signification et le nombre correspondant de points associés à ces valeurs est créée.
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.

  • 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. Cette option permet généralement de convertir les unités linéaires z afin qu’elles correspondent 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 dont l’unité linéaire est spécifiée.

Double
thinning_value
(Facultatif)

Valeur d’affinage associée à la valeur du paramètre method.

  • ZTolerance : 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. 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 3 cellules par 3 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

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.ddd.RasterToMultipoint("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.")

Rubriques connexes