Étiquette | Explication | Type 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.
| 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.
| 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 d’apparier les 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.
| Double |
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
arcpy.ddd.RasterToMultipoint(in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor}, {thinning_value})
Nom | Explication | Type 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.
| 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.
| 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 d’apparier les 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.
| Double |
Exemple de code
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)
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: Nécessite 3D Analyst
- Standard: Nécessite 3D Analyst
- Advanced: Nécessite 3D Analyst
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?