Informations du fichier de points (Outils 3D Analyst)
Résumé
Crée un polygone ou un multipatch en sortie qui capture l’étendue spatiale et des informations statistiques sur un ou plusieurs fichiers de points au format ASCII ou LAS.
Illustration
Utilisation
Chaque entité obtenue englobe l’étendue x,y d’un fichier en entrée. Les entités peuvent être créées en tant que polygones 2D ou multipatchs qui décrivent la plage z de chaque fichier en entrée. La table attributaire comporte les champs suivants :
FileName—Nom du fichier de points associé à l’entité.
Pt_Count—Nombre total de points dans le fichier de points.
Pt_Spacing—Espacement moyen estimé des points dans les unités linéaires du système de coordonnées spécifié. L’espacement des points est une estimation et cela suppose que les points dans le fichier en entrée sont équidistants sur l’étendue x,y de chaque fichier en entrée.
Z_Min—Valeur z du point le plus bas dans le fichier.
Z_Max—Valeur z du point le plus haut dans le fichier.
Le paramètre Summarize by class code (Récapituler par code de classe) permet de générer une entité en sortie pour chaque code de classe dans un fichier .las ou .zlas en entrée. Les entités en sortie incluent un champ nommé Class qui contient le code de classe récapitulé et chaque attribut associé à l’entité reflète les propriétés de ce code de classe. Ce paramètre n’est pas pris en charge pour les fichiers .laz.
Si la valeur du paramètre Input Point Data (Données ponctuelles en entrée) correspond à un ou plusieurs fichiers .las ou .zlas ou à un dossier de fichiers .las ou .zlas, la référence spatiale par défaut de la sortie provient de la lecture du premier fichier. Si l’entrée est un jeu de données LAS, la référence spatiale par défaut de la sortie est la référence spatiale du jeu de données LAS. Si l’entrée est un fichier .laz, utilisez le paramètre Coordinate System (Système de coordonnées) pour spécifier la référence spatiale de la sortie. Si aucune référence spatiale n’est spécifiée, la sortie n’aura pas de référence spatiale.
Données ponctuelles traitées. Les entrées prises en charge sont les jeux de données LAS, les fichiers .las, .zlas et .laz, ainsi que les fichiers ASCII contenant des enregistrements de points. Il est également possible de spécifier en entrée un ou plusieurs dossiers contenant les fichiers. Si un dossier est inclus, le suffixe des fichiers de points doit être spécifié dans le paramètre File Suffix (Suffixe de fichier).
File; Folder
Classe d’entités en sortie
Classe d’entités qui va être produite.
Feature Class
Format de fichier
Spécifie le format des fichiers en entrée.
LAS format lidar—The format of the input files is LAS format lidar, which includes .las, .zlas, and .laz files.
ASCII file with XYZ—The format of the input files is ASCII files with XYZ.
ASCII file with XYZI—The format of the input files is ASCII files with XYZI.
ASCII file in Generate format—The format of the input files is ASCII files in Generate format.
String
Suffixe de fichier
(Facultatif)
Suffixe des fichiers à importer lorsqu’un dossier est spécifié en entrée.
String
Système de coordonnées
(Facultatif)
Système de coordonnées des données en entrée.
Coordinate System
Inclure les sous-dossiers
(Facultatif)
Spécifie si les données figurant dans les sous-dossiers sont utilisées pour générer les résultats. L’outil passe en revue les sous-dossiers lorsqu’un dossier en entrée contenant des données dans un répertoire de sous-dossiers est sélectionné. La classe d’entités en sortie est générée avec une ligne pour chaque fichier figurant dans la structure de répertoires.
Activé—Any data in the input folder and its subdirectories will be used to generate results.
Décoché—Only the data in the input folder will be used to generate results. This is the default.
Boolean
Extruder des formes géométriques
(Facultatif)
Spécifie si la sortie est générée sous forme d’une classe d’entités surfaciques 2D ou d’une classe d’entités multipatch avec des entités extrudées qui reflètent la plage d’élévation dans chaque fichier.
Activé—The output will be created as a multipatch feature class.
Décoché—The output will be created as a 2D polygon feature class. This is the default.
Boolean
Séparateur décimal
(Facultatif)
Caractère décimal qui sera utilisé dans le fichier texte pour différencier la partie entière d’un nombre de sa partie fractionnaire.
Point—A point will be used as the decimal character. This is the default.
Comma—A comma will be used as the decimal character.
String
Récapituler par code de classe
(Facultatif)
Indique si les résultats récapitulent les fichiers .las ou .zlas par code de classe ou par fichier. Ce paramètre n’est pas disponible pour les fichiers .laz.
Activé—Each output feature will represent a single class code in the input .las or .zlas file. This option will require a complete scan of the input files.
Décoché—Each output feature will represent all the class codes in the .las or .zlas file. This is the default.
Boolean
Améliorer l’estimation de l’espacement des points des fichiers LAS
(Facultatif)
Indique si une estimation améliorée de l’espacement des points dans les fichiers .las est utilisée, ce qui peut limiter la surestimation causée par une distribution irrégulière des données.
Activé—A regular point spacing estimate will be used for .las files in which the extent is equally divided by the number of points. This is the default.
Décoché—Binning will be used to obtain a more precise point spacing estimate for .las files. This option may increase tool run time.
Données ponctuelles traitées. Les entrées prises en charge sont les jeux de données LAS, les fichiers .las, .zlas et .laz, ainsi que les fichiers ASCII contenant des enregistrements de points. Il est également possible de spécifier en entrée un ou plusieurs dossiers contenant les fichiers. Si un dossier est inclus, le suffixe du fichier doit être spécifié dans le paramètre file_suffix.
File; Folder
out_feature_class
Classe d’entités qui va être produite.
Feature Class
in_file_type
Spécifie le format des fichiers en entrée.
LAS—The format of the input files is LAS format lidar, which includes .las, .zlas, and .laz files.
XYZ—The format of the input files is ASCII files with XYZ.
XYZI—The format of the input files is ASCII files with XYZI.
GENERATE—The format of the input files is ASCII files in Generate format.
String
file_suffix
(Facultatif)
Suffixe des fichiers à importer lorsqu’un dossier est spécifié en entrée.
String
input_coordinate_system
(Facultatif)
Système de coordonnées des données en entrée.
Coordinate System
folder_recursion
(Facultatif)
Spécifie si les données figurant dans les sous-dossiers sont utilisées pour générer les résultats. L’outil passe en revue les sous-dossiers lorsqu’un dossier en entrée contenant des données dans un répertoire de sous-dossiers est sélectionné. La classe d’entités en sortie est générée avec une ligne pour chaque fichier figurant dans la structure de répertoires.
RECURSION—Any data in the input folder and its subdirectories will be used to generate results.
NO_RECURSION—Only the data in the input folder will be used to generate results. This is the default.
Boolean
extrude_geometry
(Facultatif)
Spécifie si la sortie est générée sous forme d’une classe d’entités surfaciques 2D ou d’une classe d’entités multipatch avec des entités extrudées qui reflètent la plage d’élévation dans chaque fichier.
EXTRUSION—The output will be created as a multipatch feature class.
NO_EXTRUSION—The output will be created as a 2D polygon feature class. This is the default.
Boolean
decimal_separator
(Facultatif)
Caractère décimal qui sera utilisé dans le fichier texte pour différencier la partie entière d’un nombre de sa partie fractionnaire.
DECIMAL_POINT—A point will be used as the decimal character. This is the default.
DECIMAL_COMMA—A comma will be used as the decimal character.
String
summarize_by_class_code
(Facultatif)
Indique si les résultats récapitulent les fichiers .las ou .zlas par code de classe ou par fichier. Ce paramètre n’est pas disponible pour les fichiers .laz.
SUMMARIZE—Each output feature will represent a single class code in the input .las or .zlas file. This option will require a complete scan of the input files.
NO_SUMMARIZE—Each output feature will represent all the class codes in the .las or .zlas file. This is the default.
Boolean
improve_las_point_spacing
(Facultatif)
Indique si une estimation améliorée de l’espacement des points dans les fichiers .las est utilisée, ce qui peut limiter la surestimation causée par une distribution irrégulière des données.
LAS_SPACING—A regular point spacing estimate will be used for .las files in which the extent is equally divided by the number of points. This is the default.
NO_LAS_SPACING—Binning will be used to obtain a more precise point spacing estimate for .las files. This option may increase tool run time.
Boolean
Sortie dérivée
Nom
Explication
Type de données
min_point_spacing
Espacement moyen des points.
Double
Exemple de code
Exemple 1 d’utilisation de la fonction PointFileInformation (fenêtre Python)
L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre Python :
Exemple 2 d’utilisation de la fonction PointFileInformation (script autonome)
L’exemple suivant illustre l’utilisation de cet outil dans un script Python autonome :
'''****************************************************************************
Name: PointFileInformation Example
Description: This script demonstrates how to use the
PointFileInformation tool to create an output file that contains
all LAS files under a parent folder.
****************************************************************************'''
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
lidarList = arcpy.ListFiles("*.las")
if lidarList:
# Set Local Variables
outputFC = "Test.gdb/output_las_info"
prj = "Coordinate Systems/Geographic Coordinate Systems/World/WGS 1984.prj"
extrudeGeom = True # Indicates whether to create extruded geometry shapes
sumClass = True # Indicates whether to summarize output by class code
decSep = "DECIMAL_POINT" # Identifies the decimal separator
# Run PointFileInformation
arcpy.ddd.PointFileInformation(lidarList, outputFC, "LAS", "las", prj,
"", extrudeGeom, decSep, sumClass)
print("Finished running Point File Information.")
else:
print("There are no LAS files in {0}.".format(arcpy.env.workspace))
