Informations du fichier de points (3D Analyst)

Synthèse

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.

• Lorsqu’un ensemble de fichiers .las est traité, il est possible de créer la sortie de manière à récapituler les informations sur chaque code de classe présent dans chaque fichier. La sortie obtenue reflète la plage z de chaque code de classe. Lorsque le paramètre Récapituler par code de classe est utilisé, la sortie inclut 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.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Données ponctuelles	Données ponctuelles traitées. Les entrées prises en charge sont les jeux de données LAS, les fichiers .las, les fichiers .zlas et 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. Lorsqu’un dossier est inclus, le suffixe des fichiers de points doit être spécifié dans le paramètre 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. Format lidar LAS—Les fichiers en entrée sont au format lidar LAS. Fichier ASCII avec XYZ—Les fichiers en entrée sont au format ASCII avec XYZ. Fichier ASCII avec XYZI—Les fichiers en entrée sont au format ASCII avec XYZI. Fichier ASCII au format Generate—Les fichiers en entrée sont des fichiers ASCII au format Generate.	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 détecté dans la structure de répertoires. Désactivé : seules les données trouvées dans le dossier en entrée sont utilisées pour générer les résultats. Il s’agit de l’option par défaut. Activé : toutes les données trouvées dans le dossier en entrée et ses sous-répertoires sont utilisées pour générer les résultats.	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 multipatch avec des entités extrudées qui reflètent la plage d’élévation trouvée dans chaque fichier. Désactivé : la sortie est créée sous la forme d’une classe d’entités surfaciques 2D. Il s’agit de l’option par défaut. Activé : la sortie est créée sous la forme d’une classe d’entités multipatch.	Boolean
Séparateur décimal (Facultatif)	Le caractère décimal qui est utilisé dans le fichier texte pour différencier la partie entière d’un nombre de sa partie fractionnaire. Point—Un point sert de caractère décimal. Il s’agit de l’option par défaut. Virgule—Une virgule sert de caractère décimal.	String
Récapituler par code de classe (Facultatif)	Indique si la sortie récapitule les fichiers .las par codes de classe ou par fichier. Ce paramètre est disponible uniquement pour les données au format LAS et requiert une analyse complète de chaque fichier en entrée. Désactivé : chaque entité en sortie représente toutes les données trouvées dans un fichier .las. Il s’agit de l’option par défaut. Activé : chaque entité en sortie représente un code de classe unique trouvé dans un fichier .las.	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. Désactivé : une estimation standard de l’espacement des points est utilisée pour les fichiers .las dans lesquels l’étendue est divisée de manière égale par le nombre de points. Il s’agit de l’option par défaut. Activé : le regroupement est utilisé pour obtenir une estimation plus précise de l’espacement des points pour les fichiers .las. Cette opération est susceptible de prolonger le temps d’exécution de l’outil.	Boolean

Sortie obtenue

Étiquette	Explication	Type de données
Espacement moyen des points	Espacement moyen des points.	Double

Python

arcpy.ddd.PointFileInformation(input, out_feature_class, in_file_type, {file_suffix}, {input_coordinate_system}, {folder_recursion}, {extrude_geometry}, {decimal_separator}, {summarize_by_class_code}, {improve_las_point_spacing})

Nom	Explication	Type de données
input [input,...]	Données ponctuelles traitées. Les entrées prises en charge sont les jeux de données LAS, les fichiers .las, les fichiers .zlas et 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. Lorsqu’un dossier est inclus, le suffixe des fichiers de points 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—Les fichiers en entrée sont au format lidar LAS. XYZ—Les fichiers en entrée sont au format ASCII avec XYZ. XYZI—Les fichiers en entrée sont au format ASCII avec XYZI. GENERATE—Les fichiers en entrée sont des fichiers ASCII au format Generate.	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 détecté dans la structure de répertoires. NO_RECURSION—Seules les données trouvées dans le dossier en entrée sont utilisées pour générer les résultats. Il s’agit de l’option par défaut. RECURSION—Toutes les données trouvées dans le dossier en entrée et ses sous-répertoires sont utilisées pour générer les résultats.	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 multipatch avec des entités extrudées qui reflètent la plage d’élévation trouvée dans chaque fichier. NO_EXTRUSION—La sortie est créée sous la forme d’une classe d’entités surfaciques 2D. Il s’agit de l’option par défaut. EXTRUSION—La sortie est créée sous la forme d’une classe d’entités multipatch.	Boolean
decimal_separator (Facultatif)	Le caractère décimal qui est utilisé dans le fichier texte pour différencier la partie entière d’un nombre de sa partie fractionnaire. DECIMAL_POINT—Un point sert de caractère décimal. Il s’agit de l’option par défaut. DECIMAL_COMMA—Une virgule sert de caractère décimal.	String
summarize_by_class_code (Facultatif)	Indique si les résultats récapitulent les fichiers .las par code de classe ou par fichier. NO_SUMMARIZE—Chaque entité en sortie représente tous les codes de classe trouvés dans un fichier .las. Il s’agit de l’option par défaut. SUMMARIZE—Chaque entité en sortie représente un code de classe unique trouvé dans un fichier .las.	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—Une estimation standard de l’espacement des points est utilisée pour les fichiers .las dans lesquels l’étendue est divisée de manière égale par le nombre de points. Il s’agit de l’option par défaut. NO_LAS_SPACING—Le regroupement est utilisé pour obtenir une estimation plus précise de l’espacement des points pour les fichiers .las. Cette opération est susceptible de prolonger le temps d’exécution de l’outil.	Boolean

Sortie obtenue

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.

arcpy.env.workspace = "C:/data"
arcpy.ddd.PointFileInformation('las_files', "Test.gdb/two_las", 
                              in_file_type="LAS", file_suffix="las", 
                              input_coordinate_system="NAD 1983 UTM Zone 17N.prj", 
                              decimal_separator="DECIMAL_POINT")

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
    
    #Execute PointFileInformation
    arcpy.ddd.PointFileInformation(lidarList, outputFC, "LAS", "las", prj, 
                                "", extrudeGeom, decSep, sumClass)
    print("Finished executing Point File Information.")
else:
    print("There are no LAS files in {0}.".format(env.workspace))

Environnements

Espace de travail courant, Espace de travail temporaire, Système de coordonnées en sortie, Étendue, Résolution XY, Tolérance XY, Résolution Z, Tolérance Z, Mot-clé CONFIG en sortie, Validation automatique, Domaine XY en sortie, Domaine Z en sortie

Informations de licence

• Basic: Nécessite 3D Analyst
• Standard: Nécessite 3D Analyst
• Advanced: Nécessite 3D Analyst