Statistiques d'un jeu de données LAS (Gestion des données)—ArcMap

Disponible avec une licence 3D Analyst.

Disponible avec une licence Spatial Analyst.

Résumé
Utilisation
Syntaxe
Exemple de code
Environnements
Informations de licence

Résumé

Calcule ou met à jour des statistiques pour un jeu de données LAS et génère un rapport de statistiques facultatif.

Utilisation

Le calcul des statistiques génère un index attributaire spatial qui permet d’optimiser les performances d’affichage et d’analyse. Les statistiques fournissent également une estimation plus précise de l’espacement moyen des points et des détails supplémentaires concernant les attributs de point. Les statistiques sont enregistrées dans un fichier avec le même nom que son fichier LAS correspondant, mais se terminant par l’extension .lasx.
Les statistiques permettent aux options de filtre d’une couche de jeu de données LAS d’afficher automatiquement les codes de classes et les valeurs renvoyées disponibles trouvées dans les fichiers LAS. Le jeu de données LAS peut être filtré par l’intermédiaire de la boîte de dialogue Layer Properties (Propriétés de la couche) ou de l’outil Créer une couche de jeu de données LAS.
Le fichier de rapport de statistiques facultatif présente les propriétés LAS de tous les fichiers du jeu de données LAS ou chaque fichier LAS individuel à un format texte qui peut être importé dans un grand nombre d'applications.
En cas de modification des codes de classification ou des indicateurs d’un fichier LAS, ses statistiques restent à valider et doivent être recalculées. De même, si de nouvelles références de fichier LAS ont été ajoutées à un jeu de données LAS, les statistiques doivent être également validées.

Syntaxe

arcpy.management.LasDatasetStatistics(in_las_dataset, {calculation_type}, {out_file}, {summary_level}, {delimiter}, {decimal_separator})

Paramètre	Explication	Type de données
in_las_dataset	Jeu de données LAS à traiter.	LAS Dataset Layer
calculation_type (Facultatif)	Indique si les statistiques sont calculées pour tous les fichiers LIDAR ou uniquement pour ceux qui ne présentent pas de statistiques : SKIP_EXISTING_STATS —Les fichiers LAS possédant des statistiques à jour sont ignorés et les statistiques sont calculées uniquement pour les nouveaux fichiers LAS ou ceux qui ont été mis à jour depuis le calcul initial. Il s’agit de l’option par défaut. OVERWRITE_EXISTING_STATS —Les statistiques sont calculées pour tous les fichiers LAS, y compris ceux possédant déjà des statistiques à jour. Cette option est utile si les fichiers LAS ont été modifiés dans une application externe et qu'ArcGIS n'a pas détecté ces modifications.	Boolean
out_file (Facultatif)	Fichier texte en sortie comportant le résumé des statistiques du jeu de données LAS.	Text File
summary_level (Facultatif)	Indiquez le type de résumé contenu dans le rapport. DATASET —Le rapport récapitule les statistiques de l'ensemble du jeu de données LAS. Il s’agit de l’option par défaut. LAS_FILES —Le rapport récapitule les statistiques des fichiers LAS référencés par le jeu de données LAS.	String
delimiter (Facultatif)	Délimiteur utilisé pour indiquer la séparation des entrées dans les colonnes de la table de fichiers texte. SPACE —Un espace sera utilisé pour délimiter les valeurs de champ. Il s’agit de l’option par défaut. COMMA —Une virgule sera utilisée pour délimiter les valeurs de champ. Cette option n'est pas applicable si le séparateur décimal est également une virgule.	String
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

Sortie dérivée

Nom	Explication	Type de données
derived_las_dataset	Jeu de données LAS mis à jour.	Couche du jeu de données LAS

Exemple de code

Exemple 1 d'utilisation de l'outil LasDatasetStatistics (fenêtre Python)

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

import arcpy
from arcpy import env

env.workspace = "C:/data"
arcpy.LASDatasetStatistics_3d("test.lasd", "NO_FORCE", "LAS_FILE", 
                            "DECIMAL_POINT", "SPACE", "LAS_summary.txt")

Exemple 2 d'utilisation de l'outil LasDatasetStatistics (script autonome)

L'exemple suivant illustre l'utilisation de cet outil dans un script Python autonome.

'''*********************************************************************
Name: Modify Files in LAS Dataset& Calculate Stats for LASD
Description: Adds files & surface constraints to a LAS dataset, then 
             calculates statistics and generates report.
*********************************************************************'''
# Import system modules
import arcpy

try:
    # Script variables
    arcpy.env.workspace = 'C:/data'
    lasd = 'sample.lasd'
    oldLas = ['2006', '2007/file2.las']
    newLas = ['2007_updates_1', '2007_updates_2']
    oldSurfaceConstraints = ['boundary.shp', 'streams.shp']
    newSurfaceConstraints = [['sample.gdb/boundary', '<None>', 
                              'Soft_Clip']
                             ['sample.gdb/streams', 'Shape.Z', 
                              'Hard_Line']]
    arcpy.management.RemoveFilesFromLasDataset(lasd, oldLas, 
                                               oldSurfaceConstraints)
    arcpy.management.AddFilesToLasDataset(lasd, newLas, 'RECURSION', 
                                          newSurfaceConstraints)
    arcpy.management.LasDatasetStatistics(lasd, "UPDATED_FILES", 
                                          "lasd_stats.txt", 
                                          "LAS_FILE", "DECIMAL_POINT", 
                                          "SPACE", "LAS_summary.txt")
except arcpy.ExecuteError:
    print(arcpy.GetMessages())
except Exception as err:
    print(err.args[0])