Información de archivo de puntos (Herramientas de 3D Analyst)
Resumen
Crea una salida de polígono o multiparche que captura la extensión espacial e información estadística sobre uno o más archivos de puntos con formato ASCII o LAS.
Ilustración
Uso
Cada entidad de salida abarcará la extensión x,y de un archivo de entrada. Las entidades se pueden crear como polígonos o multiparches 2D que representan el rango z de cada archivo de entrada. La tabla de atributos contendrá los siguientes campos:
FileName—El nombre del archivo de puntos asociado con la entidad.
Pt_Count—La cantidad total de puntos del archivo de puntos.
Pt_Spacing—El espaciado promedio estimado de los puntos en las unidades lineales del sistema de coordenadas especificado. El espaciado de puntos es una estimación que presupone que los puntos dentro del archivo de entrada están espaciados uniformemente sobre la extensión x,y de cada archivo de entrada.
Z_Min—El valor z del punto más bajo del archivo.
Z_Max—El valor z del punto más alto del archivo.
Utilice el parámetro Resumir por código de clase para generar una entidad de salida correspondiente a cada código de clase en un archivo .las o .zlas de entrada. La salida incluirá un campo denominado Class que contenga el código de clase que se resume y cada atributo asociado a la entidad reflejará las propiedades de dicho código de clase. Este parámetro no es compatible con los archivos .laz.
Cuando el valor del parámetro Datos de punto de entrada es uno o varios archivos .las o .zlas, o una carpeta de archivos .las o .zlas, la referencia espacial predeterminada de la salida procede de la lectura del primer archivo. Cuando la entrada es un dataset LAS, la referencia espacial predeterminada de la salida se configura en la referencia espacial del dataset LAS. Si la entrada es un archivo .laz, utilice el parámetro Sistema de coordenadas para especificar la referencia espacial de la salida. Si no se especifica ninguna referencia espacial, la salida no tendrá ninguna referencia espacial.
Los datos de puntos que se procesarán. Entre las entradas admitidas se incluyen datasets LAS, archivos .las, .zlas y .laz, y archivos ASCII que contienen registros de puntos. También se pueden especificar como entrada una o más carpetas que contengan los archivos. Cuando se incluye una carpeta, el sufijo de archivo de los archivos de puntos se debe especificar en el parámetro Sufijo del archivo.
File; Folder
Clase de entidad de salida
Clase de entidad que se generará.
Feature Class
Formato de archivo
Especifica el formato de los archivos de entrada.
LAS format lidar—The format of the input files is LAS format lidar, which includes .las, .zlas, and .laz files.
ASCII file with XYZ—The format of the input files is ASCII files with XYZ.
ASCII file with XYZI—The format of the input files is ASCII files with XYZI.
ASCII file in Generate format—The format of the input files is ASCII files in Generate format.
String
Sufijo del archivo
(Opcional)
El sufijo de los archivos que se importarán cuando se especifique una carpeta en la entrada.
String
Sistema de coordenadas
(Opcional)
El sistema de coordenadas de los datos de entrada
Coordinate System
Incluir subcarpetas
(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 de la estructura del directorio.
Activado—Any data in the input folder and its subdirectories will be used to generate results.
Desactivado—Only the data in the input folder will be used to generate results. This is the default.
Boolean
Extrudir formas de geometría
(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 de cada archivo.
Activado—The output will be created as a multipatch feature class.
Desactivado—The output will be created as a 2D polygon feature class. This is the default.
Boolean
Separador decimal
(Opcional)
Carácter decimal que se va a utilizar en el archivo de texto para diferenciar al entero de un número de su parte fraccionaria.
Point—A point will be used as the decimal character. This is the default.
Comma—A comma will be used as the decimal character.
String
Resumir por código de clase
(Opcional)
Especifica si los resultados resumirán los archivos .las o .zlas por código de clase o por archivo. Este parámetro no está disponible para archivos .laz.
Activado—Each output feature will represent a single class code in the input .las or .zlas file. This option will require a complete scan of the input files.
Desactivado—Each output feature will represent all the class codes in the .las or .zlas file. This is the default.
Boolean
Mejorar la estimación de espaciado de puntos de archivos LAS
(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.
Activado—A regular point spacing estimate will be used for .las files in which the extent is equally divided by the number of points. This is the default.
Desactivado—Binning will be used to obtain a more precise point spacing estimate for .las files. This option may increase tool run time.
Los datos de puntos que se procesarán. Entre las entradas admitidas se incluyen datasets LAS, archivos .las, .zlas y .laz, y archivos ASCII que contienen registros de puntos. También se pueden especificar como entrada una o más carpetas que contengan los archivos. Cuando se incluye una carpeta, el sufijo de archivo se debe especificar en el parámetro file_suffix.
File; Folder
out_feature_class
Clase de entidad que se generará.
Feature Class
in_file_type
Especifica el formato de los archivos de entrada.
LAS—The format of the input files is LAS format lidar, which includes .las, .zlas, and .laz files.
XYZ—The format of the input files is ASCII files with XYZ.
XYZI—The format of the input files is ASCII files with XYZI.
GENERATE—The format of the input files is ASCII files in Generate format.
String
file_suffix
(Opcional)
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
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 de la estructura del directorio.
RECURSION—Any data in the input folder and its subdirectories will be used to generate results.
NO_RECURSION—Only the data in the input folder will be used to generate results. This is the default.
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 de cada archivo.
EXTRUSION—The output will be created as a multipatch feature class.
NO_EXTRUSION—The output will be created as a 2D polygon feature class. This is the default.
Boolean
decimal_separator
(Opcional)
Carácter decimal que se va a utilizar en el archivo de texto para diferenciar al entero de un número de su parte fraccionaria.
DECIMAL_POINT—A point will be used as the decimal character. This is the default.
DECIMAL_COMMA—A comma will be used as the decimal character.
String
summarize_by_class_code
(Opcional)
Especifica si los resultados resumirán los archivos .las o .zlas por código de clase o por archivo. Este parámetro no está disponible para archivos .laz.
SUMMARIZE—Each output feature will represent a single class code in the input .las or .zlas file. This option will require a complete scan of the input files.
NO_SUMMARIZE—Each output feature will represent all the class codes in the .las or .zlas file. This is the default.
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—A regular point spacing estimate will be used for .las files in which the extent is equally divided by the number of points. This is the default.
NO_LAS_SPACING—Binning will be used to obtain a more precise point spacing estimate for .las files. This option may increase tool run time.
Boolean
Salida derivada
Nombre
Explicación
Tipo de datos
min_point_spacing
El espaciado de punto promedio.
Double
Muestra de código
Ejemplo 1 de
PointFileInformation (ventana de Python)
El siguiente ejemplo muestra cómo usar esta herramienta en la ventana de Python:
Ejemplo 2 de PointFileInformation (script independiente)
El siguiente ejemplo 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
# Run PointFileInformation
arcpy.ddd.PointFileInformation(lidarList, outputFC, "LAS", "las", prj,
"", extrudeGeom, decSep, sumClass)
print("Finished running Point File Information.")
else:
print("There are no LAS files in {0}.".format(arcpy.env.workspace))
