Información de archivo de puntos (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

Ilustración de la herramienta Información de archivo de puntos

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. Esta opción no es compatible con archivos .laz.

Parámetros

EtiquetaExplicaciónTipo de datos
Datos de puntos

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

La clase de entidad que generará.

Feature Class
Formato de archivo

Especifica el formato de los archivos de entrada.

  • LIDAR con formato LASEl formato de los archivos de entrada es LIDAR con formato LAS, que incluye archivos .las, .zlas y .laz.
  • Archivo ASCII con XYZEl formato de los archivos de entrada es archivos ASCII con XYZ.
  • Archivo ASCII con XYZIEl formato de los archivos de entrada es archivos ASCII con XYZI.
  • Archivo ASCII con formato GenerarEl formato de los archivos de entrada es archivos ASCII con formato Generate.
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.

  • Desactivado: solo los datos de la carpeta de entrada se utilizarán para generar resultados. Esta es la opción predeterminada.
  • Activado: cualquier dato de la carpeta de entrada y sus subdirectorios se utilizarán para generar resultados.
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.

  • Desactivado: la salida se creará como una clase de entidad poligonal 2D. Esta es la opción predeterminada.
  • Activado: la salida se creará como una clase de entidad multiparche.
Boolean
Separador decimal
(Opcional)

El carácter decimal que se usará en el archivo de texto para diferenciar el entero de un número de su parte fraccionaria.

  • DECIMAL_POINTSe utilizará un punto como carácter decimal. Esta es la opción predeterminada.
  • DECIMAL_COMMASe utilizará una coma como carácter decimal.
String
Resumir por código de clase
(Opcional)

Especifica si la salida resumirá los archivos .las o .zlas por códigos de clase o por archivo. Este parámetro no es compatible con los archivos .laz.

  • Desactivado: cada entidad de salida representará todos los datos del archivo .las o .zlas. Esta es la opción predeterminada.
  • Activado: cada entidad de salida representará un código de clase único del archivo .las o .zlas de entrada. Esta opción requerirá un barrido completo de los archivos de entrada.
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.

  • Desactivado: se utilizará la estimación del espaciado de punto regular para los archivos .las, donde la extensión se divide por igual entre el número de puntos. Esta es la opción predeterminada.
  • Activado: la agrupación en bins se utilizará para obtener una estimación de espaciado de puntos más precisa para los archivos .las. Esta opción puede aumentar el tiempo de ejecución de la herramienta.
Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Espaciado de punto promedio

El espaciado de punto promedio.

Double

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})
NombreExplicaciónTipo de datos
input
[input,...]

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

La clase de entidad que generará.

Feature Class
in_file_type

Especifica el formato de los archivos de entrada.

  • LASEl formato de los archivos de entrada es LIDAR con formato LAS, que incluye archivos .las, .zlas y .laz.
  • XYZEl formato de los archivos de entrada es archivos ASCII con XYZ.
  • XYZIEl formato de los archivos de entrada es archivos ASCII con XYZI.
  • GENERATEEl formato de los archivos de entrada es archivos ASCII con formato Generate.
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.

  • NO_RECURSIONSolo los datos de la carpeta de entrada se utilizarán para generar resultados. Esta es la opción predeterminada.
  • RECURSIONCualquier dato de 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 de cada archivo.

  • NO_EXTRUSIONLa salida se creará como una clase de entidad poligonal 2D. Esta es la opción predeterminada.
  • EXTRUSIONLa salida se creará como una clase de entidad multiparche.
Boolean
decimal_separator
(Opcional)

El carácter decimal que se usará en el archivo de texto para diferenciar el entero de un número de su parte fraccionaria.

  • DECIMAL_POINTSe utilizará un punto como carácter decimal. Esta es la opción predeterminada.
  • DECIMAL_COMMASe utilizará una coma como carácter decimal.
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. Esta opción no está disponible para archivos .laz.

  • NO_SUMMARIZECada entidad de salida representará todos los códigos de clases del archivo .las o .las. Esta es la opción predeterminada.
  • SUMMARIZECada entidad de salida representará un código de clase único del archivo .las o .zlas de entrada. Esta opción requerirá un barrido completo de los archivos de entrada.
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_SPACINGSe utilizará la estimación del espaciado de punto regular para los archivos .las, donde la extensión se divide por igual entre el número de puntos. Esta es la opción predeterminada.
  • NO_LAS_SPACINGLa agrupación en bins se utilizará para obtener una estimación de espaciado de puntos más precisa para los archivos .las. Esta opción puede aumentar el tiempo de ejecución de la herramienta.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
min_point_spacing

El espaciado de punto promedio.

Double

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.ddd.PointFileInformation('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 una secuencia de comandos 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.ddd.PointFileInformation(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))

Temas relacionados