Informations du fichier de points (3D Analyst)

Niveau de licence :BasicStandardAdvanced

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

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ètreExplicationType 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 en sortie.

Feature Class
in_file_type

Format des fichiers en entrée.

  • LASFormat de données LIDAR aéroporté, défini par l'ASPRS (American Society for Photogrammetry and Remote Sensing).
  • XYZFichier XYZ.
  • XYZIFichier XYZI.
  • GENERATEFichier 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_RECURSIONSeules les données trouvées dans le dossier en entrée permettent de générer les résultats. Il s'agit du paramétrage par défaut.
  • RECURSIONToutes 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_EXTRUSIONLa sortie est créée sous la forme d'une classe d'entités surfaciques 2D Il s'agit du paramétrage par défaut.
  • EXTRUSIONLa 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_POINTUn point sert de caractère décimal. Il s'agit de l'option par défaut.
  • DECIMAL_COMMAUne 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_ SUMMARIZEChaque entité en sortie représente tous les codes de classe recherchés dans un fichier LIDAR. Il s'agit du paramétrage par défaut.
  • SUMMARIZEChaque 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_SPACINGL'é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 du paramétrage par défaut.
  • NO_LAS_SPACINGLa 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)

Environnements

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic: Requis 3D Analyst
ArcGIS for Desktop Standard: Requis 3D Analyst
ArcGIS for Desktop Advanced: Requis 3D Analyst
6/5/2014