Informations du fichier de points (3D Analyst)

Résumé

Génère des informations statistiques sur un ou plusieurs fichiers de points dans un polygone ou un multipatch en sortie.

Illustration

Utilisation

• Lorsqu'un dossier contenant des fichiers de données ponctuelles est sélectionné en entrée, la valeur Suffixe de fichier doit être entrée. Elle n'est toutefois pas requise pour les entrées de fichiers.

• Si l’option de récapitulation n’est pas utilisée, les informations statistiques présentées dans la table attributaire d’entités comportent le nombre de points, l’espacement moyen des points, le Z minimum et le Z maximum de chaque fichier de points entré. Une ligne distincte est créée pour chaque fichier en entrée rencontré. L'espacement des points est une estimation et cela suppose que les points dans les fichiers en entrée sont équidistants sur l'étendue XY de chaque fichier en entrée.

• Chaque entité résultante englobe l'étendue XY d'un fichier en entrée. Les entités peuvent être créées sous forme de polygones 2D ou d’entités multipatch extrudées qui fournissent une emprise 3D dont les valeurs z à la base et au sommet reflétant la plage de valeurs d’altitude se trouvent dans le fichier. Il est possible de visualiser le multipatch en 3D dans ArcScene ou ArcGlobe.

• L’option de récapitulation permet d’effectuer des résumés statistiques des informations pour chaque code de classe dans le fichier en entrée, mais représente un coût important, car chaque fichier doit être numérisé, puis analysé.

• L'espacement des points indiqué par l'outil Informations du fichier de points n'est pas exact : il s'agit d'une estimation. Il fait office de récapitulatif lors de la recherche de tendances des ensembles de fichiers. L’outil utilise une évaluation grossière qui compare la surface de l’emprise du fichier au nombre de points. Il présente une précision maximale lorsque l'étendue rectangulaire du fichier examiné est remplie de données. Les fichiers comportant des nombres significatifs de points exclus sur des plans d'eau importants ou sur le périmètre d'une zone d'étude, partiellement occupée par des données uniquement, ne produisent pas d'évaluations précises.

Syntaxe

arcpy.3d.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})

Paramètre	Explication	Type de données
input [input,...]	Toute combinaison de dossiers et de fichiers stockant des enregistrements de points sera analysée. Dans la boîte de dialogue de l'outil, vous pouvez également spécifier un dossier en entrée en le sélectionnant dans l'Explorateur Windows et en le faisant glisser vers la zone de saisie du paramètre.	File; Folder
out_feature_class	Classe d'entités qui va être produite par cet outil.	Feature Class
in_file_type	Spécifie le format des fichiers en entrée. LAS —Format de stockage des données Lidar, défini par l’ASPRS (American Society for Photogrammetry and Remote Sensing). XYZ —Fichier XYZ. XYZI —Fichier XYZI. GENERATE —Fichier GENERATE.	String
file_suffix (Facultatif)	Suffixe des fichiers à importer lorsqu’un dossier est spécifié en entrée. Ce paramètre est requis lorsqu'un dossier en entrée est fourni.	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 est sélectionné dans un répertoire de sous-dossiers. La classe d'entités en sortie est générée avec une ligne pour chaque fichier rencontré dans la structure de répertoires. NO_RECURSION —Seules les données trouvées dans le dossier en entrée permettent de 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 permettent de générer des 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’altitude 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 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 LAS. NO_SUMMARIZE —Chaque entité en sortie représente tous les codes de classe recherchés dans un fichier LIDAR. Il s’agit de l’option par défaut. SUMMARIZE —Chaque entité en sortie représente un code de classe unique recherché dans un fichier LIDAR.	Boolean
improve_las_point_spacing (Facultatif)	Indique si une estimation améliorée de l’espacement des points dans les fichiers LAS, qui peut limiter la surestimation causée par la distribution irrégulière des données, est utilisée. LAS_SPACING —L'évaluation de l'espacement des points standard est utilisée pour les fichiers LAS, où l'étendue est divisée de manière équitable par le nombre de points. Il s’agit de l’option par défaut. NO_LAS_SPACING —La classification par fenêtres permet d'obtenir une évaluation plus précise de l'espacement des points pour les fichiers LAS. Cette opération peut prolonger le temps d'exécution de l'outil.	Boolean

Sortie dérivée

Nom	Explication	Type de données
min_point_spacing	Espacement moyen des points.	Double

Exemple de code

1er exemple d'utilisation de l'outil PointFileInformation (fenêtre Python)

L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre Python.

arcpy.env.workspace = "C:/data"
arcpy.PointFileInformation_3d('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")

2e exemple d'utilisation de l'outil 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.PointFileInformation_3d(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, Etendue, Résolution XY, Tolérance XY, Résolution Z, Tolérance Z, Mot-clé de configuration en sortie, Validation automatique, Domaine XY en sortie, Domaine Z en sortie

Informations de licence

• Basic: Requiert 3D Analyst
• Standard: Requiert 3D Analyst
• Advanced: Requiert 3D Analyst