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

Illustration de l’outil Informations du fichier de points

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.
  • Utilisez le paramètre Récapituler par code de classe pour produire 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. Cette option n’est pas prise en charge pour les fichiers .laz.

Paramètres

ÉtiquetteExplicationType 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, .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. 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 LASLes fichiers en entrée sont au format lidar LAS, qui inclut les fichiers .las, .zlas et .laz.
  • Fichier ASCII avec XYZLes fichiers en entrée sont au format ASCII avec XYZ.
  • Fichier ASCII avec XYZILes fichiers en entrée sont au format ASCII avec XYZI.
  • Fichier ASCII au format GenerateLes 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 figurant dans la structure de répertoires.

  • Désactivé : seules les données du 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 du dossier en entrée et de 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 de 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.

  • 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
Récapituler par code de classe
(Facultatif)

Indique si la sortie récapitule les fichiers .las ou .zlas par codes de classe ou par fichier. Ce paramètre n’est pas pris en charge pour les fichiers .laz.

  • Désactivé : chaque entité en sortie représente toutes les données dans le fichier .las ou .zlas. Il s’agit de l’option par défaut.
  • Activé : chaque entité en sortie représente un code de classe unique dans le fichier .las ou .zlas en entrée. Cette option requiert un balayage complet des fichiers en entrée.
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 option est susceptible de prolonger le temps d’exécution de l’outil.
Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Espacement moyen des points

Espacement moyen des points.

Double

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})
NomExplicationType 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, .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. Lorsqu’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.

  • LASLes fichiers en entrée sont au format lidar LAS, qui inclut les fichiers .las, .zlas et .laz.
  • XYZLes fichiers en entrée sont au format ASCII avec XYZ.
  • XYZILes fichiers en entrée sont au format ASCII avec XYZI.
  • GENERATELes 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 figurant dans la structure de répertoires.

  • NO_RECURSIONSeules les données du dossier en entrée sont utilisées pour générer les résultats. Il s’agit de l’option par défaut.
  • RECURSIONToutes les données du dossier en entrée et de ses sous-répertoires sont utilisées pour 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’élévation de chaque fichier.

  • NO_EXTRUSIONLa sortie est créée sous la forme d’une classe d’entités surfaciques 2D. Il s’agit de l’option 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 qui est 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 ou .zlas par code de classe ou par fichier. Cette option n’est pas disponible pour les fichiers .laz.

  • NO_SUMMARIZEChaque entité en sortie représente tous les codes de classe dans le fichier .las ou .las. Il s’agit de l’option par défaut.
  • SUMMARIZEChaque entité en sortie représente un code de classe unique dans le fichier .las ou .zlas en entrée. Cette option requiert un balayage complet des fichiers en entrée.
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_SPACINGUne 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_SPACINGLe regroupement est utilisé pour obtenir une estimation plus précise de l’espacement des points pour les fichiers .las. Cette option est susceptible de prolonger le temps d’exécution de l’outil.
Boolean

Sortie obtenue

NomExplicationType 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))

Rubriques connexes