Información de archivo de puntos (3D Analyst)

Resumen

Genera información estadística sobre un archivo de puntos o más en una salida de multiparche o polígono.

Ilustración

Uso

• Cuando se selecciona una carpeta que contiene archivos de datos de punto como entrada, se debe introducir el Sufijo del archivo. Sin embargo, esto no es necesario para las entradas del archivo.

• Cuando no se utiliza la opción de resumen, la información estadística presentada en la tabla de atributos de entidades consiste en conteo de puntos, espaciado de punto promedio, mínimo z y máximo z de cada archivo de puntos 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.

• Cada entidad resultante abarcará la extensión XY de un archivo de entrada. Las entidades se pueden crear como polígonos 2D o entidades multiparche extruidas que proporcionan un cuadro de delimitación 3D con valores z en la base y parte superior que reflejan el rango de valores de elevación que se encuentran en el archivo. El multiparche se puede visualizar en 3D utilizando 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 es costosa ya que debe escanearse y analizarse cada uno de los archivos.

• El espaciado de puntos informado por Información de archivo de puntos no es exacto; es una estimación. El espaciado de puntos dado es un resumen cuando se observan las tendencias de conjuntos de archivos. Esta herramienta utiliza una estimación aproximada que compara el área del cuadro de delimitación del archivo con el recuento 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 solo parcialmente por datos, no darán lugar a estimaciones exactas.

Sintaxis

arcpy.3d.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})

Parámetro	Explicación	Tipo de datos
input [input,...]	Cualquier combinación de carpetas y archivos que almacenan registros de puntos que se analizarán. En la ventana del cuadro de diálogo de la herramienta, también se puede especificar una carpeta como entrada seleccionando la carpeta deseada en el Explorador de Windows y arrastrándola al cuadro de entrada del parámetro.	File; Folder
out_feature_class	La clase de entidad que generará esta herramienta.	Feature Class
in_file_type	Especifica el formato de los archivos de entrada. LAS —Formato de almacenamiento de datos LIDAR definido por la American Society for Photogrammetry and Remote Sensing (ASPRS, por sus siglas en inglés), la Sociedad americana de fotogrametría y teledetección. XYZ —Archivo XYZ. XYZI —Archivo XYZI. GENERATE —Archivo GENERATE.	String
file_suffix (Opcional)	El sufijo de los archivos que se importarán cuando se especifique una carpeta en la entrada. Este parámetro es necesario si se proporciona una carpeta de entrada.	String
input_coordinate_system (Opcional)	El sistema de coordenadas de los datos de entrada	Coordinate System
folder_recursion (Opcional)	Especifica si se utilizarán los datos de subcarpetas para generar resultados. La herramienta 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 —Solo los datos que se encuentran en la carpeta de entrada se utilizarán para generar resultados. Esta es la opción predeterminada. RECURSION —Cualquier dato en la carpeta de entrada y sus subdirectorios se utilizarán para generar resultados.	Boolean
extrude_geometry (Opcional)	Especifica si la salida se creará como una clase de entidad multiparche o entidad poligonal 2D con entidades extruidas que reflejan el rango de elevación que se encuentra en cada archivo. NO_EXTRUSION —La salida se creará como una clase de entidad poligonal 2D. Esta es la opción predeterminada. EXTRUSION —La salida se creará como una clase de entidad multiparche.	Boolean
decimal_separator (Opcional)	El carácter decimal usado en el archivo de texto para diferenciar al entero de un número de su parte fraccionaria. DECIMAL_POINT —Se usa un punto como carácter decimal. Esta es la opción predeterminada. DECIMAL_COMMA —Se usa una coma como carácter decimal.	String
summarize_by_class_code (Opcional)	Especifica si los resultados resumirán los archivos LAS según el código de clase o archivo LAS. NO_SUMMARIZE —Cada entidad de salida representará todos los códigos de clase en un archivo LIDAR. Esta es la opción predeterminada. SUMMARIZE —Cada entidad de salida representará un código de clase único encontrado en un archivo LIDAR.	Boolean
improve_las_point_spacing (Opcional)	Especifica si se utilizará la evaluación mejorada del espaciado de puntos en los archivos LAS, que puede reducir la sobre estimación ocasionada por la distribución irregular de datos. LAS_SPACING —La estimación del espaciado de punto regular se usa para los archivos LAS, en donde la extensión se divide por igual entre el número de puntos. Esta es la opción predeterminada. NO_LAS_SPACING —La colocación en bin se utilizará para obtener una estimación de espaciado de punto más precisa para los archivos LAS. Esto puede aumentar el tiempo de ejecución de la herramienta.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
min_point_spacing	El espaciado de punto promedio.	Doble

Muestra de código

Ejemplo 1 de PointFileInformation (ventana de Python)

En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.

arcpy.env.workspace = "C:/data"
arcpy.PointFileInformation_3d('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")

Ejemplo 2 de PointFileInformation (script independiente)

En el siguiente ejemplo se muestra cómo usar esta herramienta en un script independiente de Python.

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

Entornos

Espacio de trabajo actual, Espacio de trabajo temporal, Sistema de coordenadas de salida, Extensión, Resolución XY, Tolerancia XY, Resolución Z, Tolerancia Z, Palabra clave CONFIG de salida, Auto ejecución, Dominio XY de salida, Dominio Z de salida

Información de licenciamiento

• Basic: Requiere 3D Analyst
• Standard: Requiere 3D Analyst
• Advanced: Requiere 3D Analyst