Informations du fichier de points—Aide

Récapitulatif
Illustration
Utilisation
Syntaxe
Exemple de code
Environnements
Informations de licence

Récapitulatif

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

Illustration

Résultat obtenu par l'outil Informations du fichier de points

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ètent la plage de valeurs d'altitude trouvées 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 simplement 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

PointFileInformation_3d (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,...]	Un ou plusieurs dossiers ou fichiers de données ponctuelles analysés.	Folder; File
out_feature_class	Classe d'entités qui va être produite par cet outil.	Feature Class
in_file_type	Format des fichiers en entrée. LAS —Format de données LIDAR aéroporté, 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)	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 la création 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 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)	Fournit 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. 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

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.

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.PointFileInformation_3d(env.workspace, "Test.gdb/two_las", "LAS", "las", "Coordinate Systems/Projected Coordinate Systems/UTM/NAD 1983/NAD 1983 UTM Zone 17N.prj", True, True, "DECIMAL_POINT", True)

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
from arcpy import env
import exceptions, sys, traceback

try:
    # Obtain a license for the ArcGIS 3D Analyst extension
    arcpy.CheckOutExtension("3D")
    # Set environment settings
    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)

except arcpy.ExecuteError:
    print arcpy.GetMessages()
except:
    # Get the traceback object
    tb = sys.exc_info()[2]
    tbinfo = traceback.format_tb(tb)[0]
    # Concatenate error information into message string
    pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
          .format(tbinfo, str(sys.exc_info()[1]))
    msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
    # Return python error messages for script tool or Python Window
    arcpy.AddError(pymsg)
    arcpy.AddError(msgs)