Combinación 3D (3D Analyst)

Resumen

Fusiona entidades multiparche cerradas superpuestas desde una clase de entidad de entrada.

Ilustración

Ilustración de la herramienta Combinación 3D

Uso

  • Para este análisis se requiere una geometría cerrada de multiparche. La herramienta Es 3D cerrado se puede utilizar para determinar si una clase de entidad multiparche contiene entidades cerradas, y la herramienta Incluir multiparche se puede utilizar para eliminar huecos en entidades multiparche.

  • Esta herramienta combina elementos multiparche que se cruzan y abarcan volúmenes superpuestos manteniendo las partes más externas de los elementos de entrada y eliminando la geometría que se encuentra en el interior del elemento combinado. Se puede crear una tabla independiente para identificar las entidades de origen que se han fusionado para crear cada salida combinada.

  • Puede utilizarse un campo de agrupación para identificar las entidades que deben unirse, por ejemplo, cuando varias entidades representan partes de un mismo edificio. Esto puede mejorar significativamente el rendimiento al reducir el número de veces que la herramienta tiene que iterar el dataset. En lugar de comparar una entidad con todas las entidades, solo se compara con las que participan en su grupo.

  • Cuando la optimización está habilitada, la herramienta intenta automáticamente clasificar las entidades en grupos mediante el análisis del cuadro de delimitación de cada entidad. Deshabilitar la optimización puede aumentar el rendimiento de la herramienta si se ha especificado un campo de agrupación. La optimización también se puede deshabilitar en la ausencia de un campo de agrupación si la salida deseada es combinar todas las entidades superpuestas en un solo multiparche. Tenga cuidado al decidir cuántas entidades agregar, ya que es posible que las entidades muy grandes y complejas sean creadas en la clase de entidad de salida, lo que puede mostrar un rendimiento de visualización deficiente.

  • Si dos o más entidades multiparche comparten solo un borde o un vértice, se genera una advertencia que indica que la entidad resultante no es sencilla y no se pudo crear. Este mensaje indica que las entidades no se han fusionado porque no compartían un volumen de espacio.

  • Las texturas y los colores de las entidades multiparche de entrada no se conservarán en la salida.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades multiparche de entrada

Las entidades multiparche que se combinarán.

Feature Layer
Clase de entidad de salida

La clase de entidad multiparche de salida que almacenará las entidades agregadas.

Feature Class
Agrupar campo
(Opcional)

El campo que se utilizará para identificar las entidades que se van a agrupar.

Field
Deshabilitar optimización
(Opcional)

Especifica si se realizará una optimización en los datos de entrada. La optimización preprocesará los datos de entrada agrupándolos para mejorar el rendimiento y crear salidas únicas para cada conjunto de entidades superpuestas.

  • Desactivado: se realizará la optimización en los datos de entrada. El campo de agrupación se ignorará. Esta es la opción predeterminada.
  • Activado: la optimización no se realizará en los datos de entrada. Las entidades se almacenarán en una sola entidad de salida o se combinarán de acuerdo con su campo de agrupación, si se ha facilitado uno.
Boolean
Todos sólidos de salida
(Opcional)

Especifica si la clase de entidad de salida contendrá todas las entidades o solamente las entidades solapadas que se fueron combinadas.

  • Activado: todas las entidades de entrada se escribirán en la salida. Esta es la opción predeterminada.
  • Desactivado: solo las entidades combinadas se escribirán en la salida. Las entidades que no se superpongan se ignorarán.
Boolean
Tabla de Salida
(Opcional)

Una tabla múltiple que identifica las entidades de entrada que contribuyen a cada salida.

Table

arcpy.ddd.Union3D(in_feature_class, out_feature_class, {group_field}, {disable_optimization}, {output_all}, {out_table})
NombreExplicaciónTipo de datos
in_feature_class

Las entidades multiparche que se combinarán.

Feature Layer
out_feature_class

La clase de entidad multiparche de salida que almacenará las entidades agregadas.

Feature Class
group_field
(Opcional)

El campo que se utilizará para identificar las entidades que se van a agrupar.

Field
disable_optimization
(Opcional)

Especifica si se realizará una optimización en los datos de entrada. La optimización preprocesará los datos de entrada agrupándolos para mejorar el rendimiento y crear salidas únicas para cada conjunto de entidades superpuestas.

  • ENABLELa optimización se realizará en los datos de entrada. El campo de agrupación se ignorará. Esta es la opción predeterminada.
  • DISABLELa optimización no se realizará en los datos de entrada. Las entidades se almacenarán en una sola entidad de salida o se combinarán de acuerdo con su campo de agrupación, si se ha facilitado uno.
Boolean
output_all
(Opcional)

Especifica si la clase de entidad de salida contendrá todas las entidades o solamente las entidades solapadas que se fueron combinadas.

  • ENABLETodas las entidades de entrada se escribirán en la salida. Esta es la opción predeterminada.
  • DISABLESolo las entidades combinadas se escribirán en la salida. Las entidades que no se superpongan se ignorarán.
Boolean
out_table
(Opcional)

Una tabla múltiple que identifica las entidades de entrada que contribuyen a cada salida.

Table

Muestra de código

Ejemplo 1 de Union3D (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

env.workspace = 'C:/data'
arcpy.Union3D_3d('multipatch.shp', 'union_output.shp', 'GROUP_FIELD', 
                'DISABLE', 'ENABLE', 'UnionTable.dbf')
Ejemplo 2 de Union3D (script independiente)

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

'''****************************************************************************
Name: Union3D Example
Description: This script demonstrates how to use the 
             Union3D tool.
****************************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/data'

# Set Local Variables
inMP = "multipatch.shp"

# Ensure output multipatch has a unique name
outMP = arcpy.CreateUniqueName("union_output.shp")
outTbl = arcpy.CreateUniqueName("UnionTable.dbf")
GroupField = "Type"
optimize = "DISABLE"
solids = "ENABLE"

# Execute Union3D
arcpy.ddd.Union3D(inMP, outMP, GroupField, optimize, solids, outTbl)

Temas relacionados