Raster vers multi-points—Aide

Résumé
Utilisation
Syntaxe
Exemple de code
Environnements
Informations de licence

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_3d (in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor})

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. NO_THIN —Aucun affinage ne sera appliqué. Il s'agit de l'option par défaut. ZTOLERANCE <value> —Exporte uniquement les cellules qui sont nécessaires à la conservation d'une surface au sein de la plage Z spécifiée du raster en entrée. La valeur correspondante reflète 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. KERNEL <value> —Divise le raster en tuiles de taille égale en fonction de la valeur d'affinage, puis sélectionne une ou deux cellules qui répondent aux critères définis par la méthode du noyau désignée. La valeur correspondante est de 3 par défaut, ce qui signifie que le raster est divisé en fenêtres de 3 cellules sur 3 cellules. VIP <value> —Emploie 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. La valeur correspondante reflète le classement en pourcentage dans 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. VIP_HISTOGRAM —Cré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. MIN —Un 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. MAX —Un point est créé au niveau de la cellule présentant la plus grande valeur d'altitude recherchée dans le voisinage de noyau. MINMAX —Deux 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. MEAN —Un 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

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.

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.RasterToMultipoint_3d("elevation.tif", "","elev_VIP.dbf", "VIP_HISTOGRAM", "", "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
from arcpy import env
import exceptions

try:
    arcpy.CheckOutExtension("3D")
    # Set default workspace
    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:
        "There are no IMG rasters in the " + env.workspace + " directory."
except Exception as e:
    # Returns any other error messages
    print e.message

Environnements

Informations de licence

ArcGIS Desktop Basic: Requiert 3D Analyst
ArcGIS Desktop Standard: Requiert 3D Analyst
ArcGIS Desktop Advanced: Requiert 3D Analyst

ArcMap

Raster vers multi-points