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è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
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})| Paramètre | Explication | Type de données |
input [input,...] | Un ou plusieurs dossiers ou fichiers de données ponctuelles analysés. 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. | 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.
| 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.
| 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.
| 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.
| String |
summarize_by_class_code (Facultatif) | Indique si les résultats récapitulent les fichiers LAS par code de classe ou fichier LAS.
| 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.
| 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.
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
Informations de licence
- Basic: Requiert 3D Analyst
- Standard: Requiert 3D Analyst
- Advanced: Requiert 3D Analyst