Etiqueta | Explicación | Tipo de datos |
Malla integrada de entrada | Servicio I3S de mallas integradas o paquete de capas de escena que se procesarán. | Scene Layer; File |
Nube de puntos de entrada | Dataset LAS, nube de puntos I3S o paquete de capas de escenas de nubes de punto con puntos que se utilizarán para extraer entidades de la malla integrada. | LAS Dataset Layer; Scene Layer; File |
Entidades multiparche de salida | Entidades multiparche de salida que representa los objetos detectados de la malla integrada. | Feature Class |
Códigos de clase para extraer | Valores de código de clase de la nube de puntos que se utilizarán para identificar los objetos de la malla integrada. Cada código tendrá un Id. de grupo predeterminado del mismo valor. Se puede asignar un Id. de grupo común para garantizar que esos puntos de varios códigos de clase se puedan agrupar en un objeto. | Value Table |
Umbral de distancia entre puntos | Distancia máxima entre los centros de los triángulos de malla subdivididos y los puntos que representan un objeto determinado. Los elementos de malla que estén dentro de esta distancia se crearán como un objeto en la clase de entidad de salida. | Linear Unit |
Área máxima del triángulo (Opcional) | Área máxima de los triángulos de malla subdivididos. Los triángulos de malla de entrada se subdividen para optimizar la calidad de la salida. | Areal Unit |
Distancia del clúster (Opcional) | Distancia que se utilizará para agrupar los puntos en cada grupo de objetos. Cuando no se especifica ningún valor, se utilizará el valor del parámetro Umbral de distancia entre puntos como distancia de clustering. | Linear Unit |
Área de clúster mínima (Opcional) | Área de superficie mínima de los triángulos de malla que están dentro de la proximidad especificada de un clúster de objetos determinado. Se ignorará cualquier clúster de objetos de malla que sea menor que el valor especificado. De forma predeterminada, no se utiliza ningún valor, lo que dará lugar a que todos los clústeres de objetos se traten como objetos válidos. | Areal Unit |
Límite de extracción (Opcional) | Límite que representa el área 2D que se procesará. Cuando los datos previstos están en un subconjunto de la malla integrada, proporcionar una entidad de límite puede optimizar el rendimiento de la herramienta limitando el área que se avaluará. | Feature Layer |
Resumen
Extrae entidades multiparche que representan objetos en una malla integrada basada en una nube de puntos clasificados.
Uso
Esta herramienta utiliza puntos clasificados en una nube de puntos para identificar los objetos correspondientes de la malla integrada. Por esta razón, la nube de puntos que se ha clasificado debería crearse desde la malla integrada. La herramienta Malla para LAS puede utilizarse para crear una nube de puntos que pueda clasificarse para la extracción de objetos desde la malla.
Cada código de clase tendrá un Id. de grupo correspondiente. Se puede asignar un Id. de grupo común a varios códigos de clase para garantizar que los puntos que describen los elementos del mismo objeto pueden tratarse como un objeto.
El proceso de extracción de objetos agrega puntos clasificados en clústeres e identifica los objetos en la malla integrada basándose en la proximidad al conjunto agrupado de puntos. Los puntos que más se acercan al valor del parámetro Distancia del clúster se considerarán como pertenecientes al mismo objeto. El valor de este parámetro debería ser mayor que el espaciado de datos promedio de los datos.
El parámetro Área máxima del triángulo subdivide los triángulos de malla para admitir casos en los que pueda haber varios objetos en un triángulo determinado. Por consiguiente, los triángulos multiparche no coincidirán con los triángulos de la malla.
Si la nube de puntos o la malla integrada proceden de un servicio de capas de escenas 3D indexadas, el servicio debe tener la función de exportación habilitada para utilizarse como entradas de esta herramienta.
Parámetros
arcpy.ddd.ExtractMeshFeaturesUsingPointCloud(in_mesh, in_point_cloud, out_feature_class, class_codes, point_distance_threshold, {maximum_triangle_area}, {cluster_distance}, {minimum_cluster_area}, {boundary})
Nombre | Explicación | Tipo de datos |
in_mesh | Servicio I3S de mallas integradas o paquete de capas de escena que se procesarán. | Scene Layer; File |
in_point_cloud | Dataset LAS, nube de puntos I3S o paquete de capas de escenas de nubes de punto con puntos que se utilizarán para extraer entidades de la malla integrada. | LAS Dataset Layer; Scene Layer; File |
out_feature_class | Entidades multiparche de salida que representa los objetos detectados de la malla integrada. | Feature Class |
class_codes [class_codes,...] | Valores de código de clase de la nube de puntos que se utilizarán para identificar los objetos de la malla integrada. Cada código tendrá un Id. de grupo predeterminado del mismo valor. Se puede asignar un Id. de grupo común para garantizar que esos puntos de varios códigos de clase se puedan agrupar en un objeto. | Value Table |
point_distance_threshold | Distancia máxima entre los centros de los triángulos de malla subdivididos y los puntos que representan un objeto determinado. Los elementos de malla que estén dentro de esta distancia se crearán como un objeto en la clase de entidad de salida. | Linear Unit |
maximum_triangle_area (Opcional) | Área máxima de los triángulos de malla subdivididos. Los triángulos de malla de entrada se subdividen para optimizar la calidad de la salida. | Areal Unit |
cluster_distance (Opcional) | Distancia que se utilizará para agrupar los puntos en cada grupo de objetos. Cuando no se especifica ningún valor, se utilizará el valor del parámetro point_distance_threshold como distancia de clustering. | Linear Unit |
minimum_cluster_area (Opcional) | Área de superficie mínima de los triángulos de malla que están dentro de la proximidad especificada de un clúster de objetos determinado. Se ignorará cualquier clúster de objetos de malla que sea menor que el valor especificado. De forma predeterminada, no se utiliza ningún valor, lo que dará lugar a que todos los clústeres de objetos se traten como objetos válidos. | Areal Unit |
boundary (Opcional) | Límite que representa el área 2D que se procesará. Cuando los datos previstos están en un subconjunto de la malla integrada, proporcionar una entidad de límite puede optimizar el rendimiento de la herramienta limitando el área que se avaluará. | Feature Layer |
Muestra de código
En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.
import arcpy
arcpy.env.workspace = "C:/data"
lidar = "lidar/NE_neighborhood.lasd"
clusterDist = arcpy.Describe(lidar).pointSpacing * 2.5
arcpy.ddd.ExtractMeshFeaturesUsingPointCloud(in_mesh="NorthEast_Neighborhood_mesh.slpk",
in_point_cloud=lidar,
out_feature_class="NE_data.gdb/trees",
class_codes=[[4, 5], [5, 5]],
point_distance_threshold="25 centimeters",
maximum_triangle_area="",
clustering_distance=clusterDist,
boundary="NE_data.gdb/parks")
)