Desktop Help 10.0 - Información de archivo de punto (3D Analyst)

Resumen

Genera una clase de entidad de salida nueva que contiene información estadística sobre un archivo de punto o más.

Ilustración

Uso

Los archivos de entrada deben tener un formato LAS, XYZ, XYZI o GENERATE.
Cuando se selecciona una carpeta que contiene archivos de datos de punto como entrada, se debe introducir el sufijo. Si selecciona un archivo único como entrada, el sufijo no es un requisito.
Cuando no se utiliza la opción de resumen, la información estadística presentada en la tabla de atributos de la entidad consiste en conteo de puntos, espaciado de punto promedio, mínimo z y máximo z de cada archivo de punto introducido. Se crea una fila separada para cada archivo de entrada encontrado. El espaciado de puntos es una estimación que supone que los puntos dentro del archivo de entrada están espaciados uniformemente sobre la extensión XY de cada archivo de entrada.
Se crea una clase de entidad poligonal de salida con las extensiones XY de los archivos de entrada. Como alternativa, se pueden generar entidades multiparche al utilizar la información de extensión de z mínimo y z máximo para cada archivo de entrada. Estas entidades proporcionan una representación de cuadro de delimitación 3D que se puede verse en ArcScene o ArcGlobe.
La opción de resumen es útil para resumir estadísticamente la información para cada código de clase en el archivo de entrada pero puede ser costosa ya que debe escanearse y analizarse cada uno de los archivos.
El espaciado de puntos informado por Información del archivo de puntos no es exacto, es una estimación. El espaciado de puntos dado es un resumen de cuando se observan las tendencias de conjuntos de archivos. Esta herramienta utiliza una estimación aproximada que se limita a comparar el área del cuadro de delimitación del archivo con el conteo de puntos. Es más exacto cuando la extensión rectangular del archivo que se examina está rellena de datos. Los archivos con puntos sobre grandes masas de agua o en el perímetro de un área de estudio, ocupados sólo parcialmente por datos, no darán lugar a estimaciones exactas.

Sintaxis

PointFileInformation_3d (input, out_feature_class, in_file_type, file_suffix, {input_coordinate_system}, {summarize_by_class_code}, {folder_recursion}, {extrude_geometry}, {decimal_separator})

Parámetro	Explicación	Tipo de datos
input	Un archivo o una carpeta de datos de puntos o más.	File; Folder
out_feature_class	La clase de entidad de salida.	Feature Class
in_file_type	El formato de los archivos de entrada. Los archivos de entrada deben tener un formato LAS, XYZ, XYZI o GENERATE.	String
file_suffix	El sufijo de los archivos que se importarán cuando se especifique una carpeta en la entrada.	String
input_coordinate_system (Opcional)	El sistema de coordenadas de los datos de entrada	Coordinate System
summarize_by_class_code (Opcional)	Escanea los archivos LAS y analiza el valor del código de clase. La tabla de atributos de la clase de entidad de salida contendrá información estadística para cada código de clase encontrado. NO_ SUMMARIZE —Los archivos LAS no serán análisis basados en los valores de código de clase. Esta es la opción predeterminada. SUMMARIZE —Los archivos LAS serán análisis basados en los valores de código de clase. La tabla de atributos de la clase de entidad de salida contendrá información estadística para cada código de clase encontrado.	Boolean
folder_recursion (Opcional)	Escanea todas las subcarpetas cuando se selecciona una carpeta de entrada que contenga datos en un directorio de subcarpetas. La clase de entidad de salida se generará con una fila para cada archivo encontrado en la estructura del directorio. NO_RECURSION —No se escanearán las subcarpetas de la carpeta de entrada seleccionada y los archivos de datos encontrados se utilizarán para generar los resultados. Esta es la opción predeterminada. RECURSION —Se escanearán las subcarpetas de la carpeta de entrada seleccionada y los archivos de datos encontrados se utilizarán para generar los resultados.	Boolean
extrude_geometry (Opcional)	Se generará una clase de entidad multiparche 3D basada en los valores z mínimo/máximo de cada archivo de entrada. NO_EXTRUSION —No se generará una clase de entidad multiparche 3D como salida. Esta es la opción predeterminada. EXTRUSION —Se generará una clase de entidad multiparche 3D como salida.	Boolean
decimal_separator (Opcional)	Símbolo separador utilizado en archivos ASCII. El valor predeterminado es punto decimal. Permite al usuario declarar si el símbolo decimal utilizado en los archivos es un punto o una coma.	String

Ejemplo de código

Ejemplo 1 de Información del archivo de puntos (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función Información del archivo de puntos en el modo inmediato.

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)

Ejemplo 2 de Información del archivo de puntos (secuencia de comandos independiente)

La siguiente secuencia de comandos de Python muestra cómo utilizar la función Información del archivo de puntos en una secuencia de comandos independiente.

'''****************************************************************************
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)