Clasificar edificio de LAS (3D Analyst)

Resumen

Clasifica los tejados y laterales de edificios en datos LAS.

Ilustración

Uso

• Los puntos que representan los muros, las fachadas verticales y las entidades pequeñas de los tejados, como buhardillas y chimeneas, no pueden incluirse en la clasificación de los edificios. Si se necesitan tales puntos, plantéese ejecutar la herramienta con las opciones para clasificar los puntos que están por encima y por debajo del tejado.

• Los datos LAS deben tener puntos de suelo clasificados antes de clasificar los puntos de tejado de los edificios. Considere el uso de la herramienta Clasificar el terreno LAS si los puntos de suelo no se han clasificado. Los puntos de suelo deben tener un valor de código de clase de 2. Si los puntos de suelo tienen un valor de código de clase distinto de 2, utilice la herramienta Cambiar códigos de clase LAS para reasignar los códigos de clase según corresponda.

• Los puntos LAS con valores de código de clase de 0, 1 y 6 se evaluarán para determinar si encajan en las características de los tejados de edificios. Los puntos clasificados como edificios que no cumplan estos criterios se reasignarán a un valor de código de clase de 1, a menos que se haya especificado la opción de reutilizar los puntos clasificados de edificios existentes.

• El parámetro Método no se utiliza cuando se especifica la opción Son datos fotogramétricos.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Dataset LAS de entrada	El dataset LAS que se va a clasificar.	LAS Dataset Layer
Altura mínima de tejado (Opcional)	La altura desde el suelo que define el punto más bajo a partir del cual se identificarán los puntos del tejado.	Linear Unit
Área mínima	El área más pequeña del tejado del edificio.	Areal Unit
Calcular estadísticas (Opcional)	Especifica si las estadísticas se calcularán para los archivos .las a los que hace referencia el dataset LAS. Calcular estadísticas proporciona un índice espacial para cada archivo .las, lo que mejora el análisis y el rendimiento de la visualización. Las estadísticas también mejoran la experiencia de filtrado y simbología al limitar la visualización de los atributos LAS, como los códigos de clasificación y la información de retorno, a los valores presentes en el archivo .las. Activado: se calcularán las estadísticas. Esta es la opción predeterminada. Desactivada: no se calcularán las estadísticas.	Boolean
Extensión de procesamiento (Opcional)	La extensión de los datos que se evaluarán. Extensión de visualización actual : la extensión se basará en el mapa o la escena activa. La opción solo está disponible cuando haya un mapa activo. Extensión de dibujo : la extensión se basará en un rectángulo dibujado en el mapa o la escena. Esta opción creará una clase de entidad en la geodatabase del proyecto y agregará una capa al mapa. La clase de entidad tendrá el mismo sistema de coordenadas que el mapa. Nota: Esta opción no está disponible en el cuadro de diálogo Entornos. Solo está disponible desde un parámetro de herramienta con un tipo de datos de extensión o desde la pestaña Entornos de un cuadro de diálogo de herramienta. Nota: Cuando la opción de edición Habilitar y deshabilitar edición en la pestaña Editar está activada, es preciso habilitar la edición en la pestaña Editar de la cinta para dibujar la extensión. Extensión de mapa : la extensión se basará en una capa de mapa activa. Use la lista desplegable para seleccionar una capa disponible o use la opción Extensión de datos en todas las capas para obtener la extensión combinada de todas las capas de mapas activos, excepto el mapa base. Esta opción solo está disponible cuando haya un mapa activo con capas. Cada capa de mapas tiene las opciones siguientes: Todas las entidades : extensión de todas las entidades en una capa. Entidades seleccionadas: extensión de las entidades seleccionadas en la capa. Entidades visibles : extensión de las entidades visibles en la capa. Nota: Las extensiones de las opciones Entidades seleccionadas y Entidades visibles solo están disponibles para capas de entidades. Examinar : la extensión se basará en un dataset existente. Intersección de entradas : la extensión se basará en la extensión mínima o en común de todas las entradas. Si ninguna de las entradas se solapa, podría generarse una extensión nula con todos los valores igual a cero. Combinación de entradas : la extensión se basa en la extensión máxima o combinada de todas las entradas. Portapapeles : la extensión puede copiarse en y desde el portapapeles. Copiar extensión : copia las coordenadas de la extensión y el sistema de coordenadas en el portapapeles. Pegar extensión : pega las coordenadas de la extensión y, si se desea, el sistema de coordenadas desde el portapapeles. Si los valores del portapapeles no incluyen un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del mapa. Nota: Las coordenadas de la extensión se copian del portapapeles y se pegan con el mismo formato y orden que el objeto Extent de ArcPy: x-min, y-min, x-max, y-max y referencia espacial. Restablecer extensión : la extensión se restablecerá al valor predeterminado. Coordenadas introducidas de forma manual: las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo. Precaución: El mapa podría utilizar unidades de visualización distintas de las coordenadas introducidas. No se admite el uso de una dirección cardinal (N, S, E, O). Utilice un valor de signo negativo para las coordenadas sur y oeste.	Extent
Límite de procesamiento	Una entidad poligonal que definirá el área de interés que se va a procesar.	Feature Layer
Procesar todos los archivos LAS que intersequen la extensión (Opcional)	Especifica cómo se va a utilizar el área de interés para determinar el modo de procesar los archivos .las. El área de interés está definida por el valor del parámetro Extensión de procesamiento, el valor del parámetro Límite de procesamiento, o una combinación de ambos. Desactivado: solo se procesarán los puntos LAS que intersequen el área de interés. Esta es la opción predeterminada. Activado: si alguna parte del archivo .las interseca el área de interés, se procesarán todos los puntos de ese archivo, incluidos los que queden fuera del área de interés.	Boolean
Espaciado de punto promedio	El espaciado promedio de los puntos LAS. Este parámetro ya no se utiliza.	Linear Unit
Reutilizar puntos clasificados de edificios existentes (Opcional)	Especifica si los puntos clasificados de edificios existentes se reutilizarán o reevaluarán. Desactivado: los puntos clasificados de edificios existentes se reevaluarán para satisfacer los criterios de la detección de plano y a los puntos que no encajen en el área y la altura especificados se les asignará un valor de 1. Esta es la opción predeterminada. Activado: los puntos clasificados de edificios existentes contribuirán al proceso de detección de plano, pero no se reclasificarán si no satisfacen los criterios especificados en la ejecución de la herramienta. Utilice esta opción si la clasificación existente es necesaria.	Boolean
Son datos fotogramétricos (Opcional)	Especifica si los puntos del archivo .las se derivaron con técnicas fotogramétricas. Desactivado: los puntos del archivo .las se obtuvieron de una prospección LIDAR, y no de una técnica fotogramétrica para producir nubes de puntos. Esta es la opción predeterminada. Activado: los puntos del archivo .las se obtuvieron mediante una técnica fotogramétrica para producir nubes de puntos a partir de imágenes superpuestas.	Boolean
Método de clasificación (Opcional)	Especifica el método de clasificación que se utilizará. Agresiva—Se detectarán puntos que se ajustan a las características de tejado planar con una tolerancia relativamente alta para valores atípicos. Use este método si los puntos no están bien calibrados. Estándar—Se detectarán puntos que se ajustan a las características de tejado planar con una tolerancia relativamente moderada para puntos irregulares. Esta es la configuración predeterminada Conservador—Se detectarán puntos que se ajustan a las características de tejado planar con una tolerancia relativamente baja para puntos irregulares. Use este método si los puntos de edificio son coplanares a los puntos de los objetos que no son edificios.	String
Clasificar puntos sobre el tejado (Opcional)	Especifica si se clasifican los puntos sobre los planos detectados del tejado. Desactivado: los puntos detectados sobre los planos no se clasificarán. Esta es la opción predeterminada. Activado: los puntos detectados sobre los planos se clasificarán.	Boolean
Altura máxima sobre tejado (Opcional)	La altura máxima de los puntos sobre el tejado del edificio que se clasificará según el valor designado en el parámetro Código de clase sobre tejado.	Linear Unit
Código de clase sobre tejado (Opcional)	El código de clase que se asignará a los puntos sobre el tejado.	Long
Clasificar puntos bajo el tejado (Opcional)	Especifica si los puntos entre el tejado y el suelo se clasificarán. Desactivado: los puntos entre el tejado y el suelo no se clasificarán. Esta es la opción predeterminada. Activado: los puntos entre el tejado y el suelo se clasificarán.	Boolean
Código de clase bajo tejado (Opcional)	El código de clase que se asignará a los puntos entre el suelo y el tejado.	Long
Actualizar pirámide (Opcional)	Especifica si la pirámide de dataset LAS se actualizará después de modificar los códigos de clase. Activado: se actualizará la pirámide de dataset LAS. Esta es la opción predeterminada. Desactivado: no se actualizará la pirámide de dataset LAS.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Dataset LAS derivado	El dataset LAS clasificado para los tejados de los edificios.	LAS Dataset Layer

Python

arcpy.ddd.ClassifyLasBuilding(in_las_dataset, {min_height}, min_area, {compute_stats}, {extent}, boundary, {process_entire_files}, point_spacing, {reuse_building}, {photogrammetric_data}, {method}, {classify_above_roof}, {above_roof_height}, {above_roof_code}, {classify_below_roof}, {below_roof_code}, {update_pyramid})

Nombre	Explicación	Tipo de datos
in_las_dataset	El dataset LAS que se va a clasificar.	LAS Dataset Layer
min_height (Opcional)	La altura desde el suelo que define el punto más bajo a partir del cual se identificarán los puntos del tejado.	Linear Unit
min_area	El área más pequeña del tejado del edificio.	Areal Unit
compute_stats (Opcional)	Especifica si las estadísticas se calcularán para los archivos .las a los que hace referencia el dataset LAS. Calcular estadísticas proporciona un índice espacial para cada archivo .las, lo que mejora el análisis y el rendimiento de la visualización. Las estadísticas también mejoran la experiencia de filtrado y simbología al limitar la visualización de los atributos LAS, como los códigos de clasificación y la información de retorno, a los valores presentes en el archivo .las. COMPUTE_STATS—Se calcularán las estadísticas. Esta es la opción predeterminada. NO_COMPUTE_STATS—No se calcularán las estadísticas.	Boolean
extent (Opcional)	La extensión de los datos que se evaluarán. MAXOF: se usará la extensión máxima de todas las entradas. MINOF: se usará el área mínima común a todas las entradas. DISPLAY: la extensión es igual a la visualización visible. Nombre de capa: se utilizará la extensión de la capa especificada. Objeto de Extent: se utilizará la extensión del objeto especificado. Cadena de coordenadas delimitada por espacios: se utilizará la extensión de la cadena especificada. Las coordenadas se expresan como x-min, y-min, x-max, y-max.	Extent
boundary	Una entidad poligonal que definirá el área de interés que se va a procesar.	Feature Layer
process_entire_files (Opcional)	Especifica cómo se va a aplicar la extensión de procesamiento. PROCESS_EXTENT—Solo se procesarán los puntos LAS que intersequen el área de interés. Esta es la opción predeterminada. PROCESS_ENTIRE_FILES—Si alguna parte del archivo .las interseca el área de interés, se procesarán todos los puntos de ese archivo, incluidos los que queden fuera del área de interés.	Boolean
point_spacing	El espaciado promedio de los puntos LAS. Este parámetro ya no se utiliza.	Linear Unit
reuse_building (Opcional)	Especifica si los puntos clasificados de edificios existentes se reutilizarán o reevaluarán. Especifica si los puntos clasificados de edificios existentes se reutilizarán o reevaluarán. RECLASSIFY_BUILDING—Los puntos clasificados de edificios existentes se reevaluarán para satisfacer los criterios de la detección de plano y a los puntos que no encajen en el área y la altura especificados se les asignará un valor de 1. Esta es la opción predeterminada. REUSE_BUILDING—Los puntos clasificados de edificios existentes contribuirán al proceso de detección de plano, pero no se reclasificarán si no satisfacen los criterios especificados en la ejecución de la herramienta. Utilice esta opción si la clasificación existente es necesaria.	Boolean
photogrammetric_data (Opcional)	Especifica si los puntos del archivo .las se derivaron con técnicas fotogramétricas. Especifica si los puntos del archivo .las se derivaron con técnicas fotogramétricas. NOT_PHOTOGRAMMETRIC_DATA—Los puntos del archivo .las se obtuvieron de una prospección LIDAR, y no de una técnica fotogramétrica para producir nubes de puntos. Esta es la opción predeterminada. PHOTOGRAMMETRIC_DATA—Los puntos del archivo .las se obtuvieron mediante una técnica fotogramétrica para producir nubes de puntos a partir de imágenes superpuestas.	Boolean
method (Opcional)	Especifica el método de clasificación que se utilizará. AGGRESSIVE—Se detectarán puntos que se ajustan a las características de tejado planar con una tolerancia relativamente alta para valores atípicos. Use este método si los puntos no están bien calibrados. STANDARD—Se detectarán puntos que se ajustan a las características de tejado planar con una tolerancia relativamente moderada para puntos irregulares. Esta es la configuración predeterminada CONSERVATIVE—Se detectarán puntos que se ajustan a las características de tejado planar con una tolerancia relativamente baja para puntos irregulares. Use este método si los puntos de edificio son coplanares a los puntos de los objetos que no son edificios.	String
classify_above_roof (Opcional)	Especifica si se clasifican los puntos sobre los planos detectados del tejado. NO_CLASSIFY_ABOVE_ROOF—Los puntos detectados sobre los planos no se clasificarán. Esta es la opción predeterminada. CLASSIFY_ABOVE_ROOF—Los puntos detectados sobre los planos se clasificarán.	Boolean
above_roof_height (Opcional)	La altura máxima de los puntos sobre el tejado del edificio que se clasificará según el valor designado en el parámetro Código de clase sobre tejado.	Linear Unit
above_roof_code (Opcional)	El código de clase que se asignará a los puntos sobre el tejado.	Long
classify_below_roof (Opcional)	Especifica si los puntos entre el tejado y el suelo se clasificarán. NO_CLASSIFY_BELOW_ROOF—Los puntos entre el tejado y el suelo no se clasificarán. Esta es la opción predeterminada. CLASSIFY_BELOW_ROOF—Los puntos entre el tejado y el suelo se clasificarán.	Boolean
below_roof_code (Opcional)	El código de clase que se asignará a los puntos entre el suelo y el tejado.	Long
update_pyramid (Opcional)	Especifica si la pirámide de dataset LAS se actualizará después de modificar los códigos de clase. UPDATE_PYRAMID—Se actualizará la pirámide de dataset LAS. Esta es la opción predeterminada. NO_UPDATE_PYRAMID—No se actualizará la pirámide de dataset LAS.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
derived_las_dataset	El dataset LAS clasificado para los tejados de los edificios.	LAS Dataset Layer

Muestra de código

Ejemplo 1 de ClassifyLasBuilding (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.ClassifyLasBuilding('Highland.lasd', minHeight='9 feet', 
                              minArea='30 Square Feet', compute_stats=True)

Ejemplo 2 de ClassifyLasBuilding (script independiente)

En el siguiente ejemplo se muestra cómo usar esta herramienta en una secuencia de comandos independiente de Python.

'''****************************************************************************
       Name: Tile & Classify LAS Files
Description: Creates & classifies tiled LAS files.
****************************************************************************'''
# Import system modules
import arcpy
import tempfile
import math

in_las = arcpy.GetParameterAsText(1) # The LAS files that need to be tiled
out_folder = arcpy.GetParameterAsText(2) # folder for LAS files
basename = arcpy.GetParameterAsText(3) # basename for output files
out_lasd = arcpy.GetParameterAsText(4) # output LAS dataset


try:
    # Create temp LAS dataset to reference LAS files that will be tiled
    temp_lasd = arcpy.CreateUniqueName('temp.lasd', tempfile.gettempdir())
    arcpy.management.CreateLasDataset(in_las, temp_lasd)
    arcpy.ddd.TileLas(temp_lasd, out_folder, basename, out_lasd, las_version=1.4, 
                      point_format=7, file_size=300)
    arcpy.management.Delete(temp_lasd)
    arcpy.ddd.ClassifyLasGround(out_lasd, method='AGGRESSIVE')
    arcpy.ddd.ClassifyLasBuilding(out_lasd, min_height='3 Meters', min_area='4 Meters')
    arcpy.ddd.ClassifyLasByHeight(out_lasd, height_classification=[(3, 6), (4,20), (5,70)],
                                  noise='All Noise', compute_stats='COMPUTE_STATS')

except arcpy.ExecuteError:
    print(arcpy.GetMessages())

Entornos

Extensión, Factor de procesamiento en paralelo