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 cuyos valores z en la base y parte superior 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 del archivo de entrada, pero es costosa, ya que se debe escanear y analizar cada uno de los archivos.
El espaciado de puntos indicado por Información del 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 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}, {folder_recursion}, {extrude_geometry}, {decimal_separator}, {summarize_by_class_code}, {improve_las_point_spacing})| Parámetro | Explicación | Tipo de datos |
input [input,...] | Un archivo o una carpeta de datos de punto o más que se analizará. | Folder; File |
out_feature_class | La clase de entidad que generará esta herramienta. | Feature Class |
in_file_type | El formato de los archivos de entrada.
| 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) |
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.
| Boolean |
extrude_geometry (Opcional) |
Especifica si se debe crear 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.
| 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.
| 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.
| Boolean |
improve_las_point_spacing (Opcional) | Proporciona la evaluación mejorada del espaciado de punto en los archivo LAS que pueden reducir la sobre estimación ocasionada por la distribución irregular de datos.
| Boolean |
Ejemplo 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.
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 PointFileInformation (secuencia de comandos 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
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)
Entornos
Información sobre licencias
- ArcGIS for Desktop Basic: Requiere 3D Analyst
- ArcGIS for Desktop Standard: Requiere 3D Analyst
- ArcGIS for Desktop Advanced: Requiere 3D Analyst