Dentro de 3D (3D Analyst)

Resumen

Determina si las entidades 3D de una clase de entidad de entrada están contenidas en un multiparche cerrado, y escribe una tabla de salida que registra las entidades que están total y parcialmente dentro del multiparche.

Ilustración

Uso

• Todas las entidades de entrada deben tener la información Z almacenada como parte de su geometría. Si existen las mediciones de altura con base en el campo en una clase de entidad 2D, la herramienta Entidad a 3D por atributo se puede utilizar para crear una clase de entidad 3D.

• 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 se puede utilizar la herramienta Incluir multiparche para eliminar los espacios en las entidades multiparche.

• Esta herramienta es un operador de conjuntos 3D que provee funciones analíticas sobre entidades 3D. Consulte Trabajar con operadores de conjuntos 3D para obtener más información sobre qué operadores de conjuntos existen y cómo se utilizan.

• Si se selecciona la opción Tabla de salida compuesta, se crea un registro para cada multiparche con el que se interseca una entidad de entrada dada. Una entidad puede caer dentro de varias entidades multiparche cerradas y tener diversas entradas en la tabla de salida.

• Los siguientes campos se incluyen en la tabla de salida:

  • Target_ID: el ID único de la entidad de entrada.
  • Estado: indica si la entidad identificada por el campo Target_ID está dentro o parcialmente dentro de un multiparche.
  • Contain_ID: identifica si el ID único del multiparche que se interseca con las entidades de entrada está dentro o parcialmente dentro. Solo se incluye si está seleccionada la opción Tabla de salida compuesta

Sintaxis

Inside3D_3d (in_target_feature_class, in_container_feature_class, out_table, {complex_output})

Parámetro	Explicación	Tipo de datos
in_target_feature_class	El multiparche de entrada o clase de entidad de punto 3D, línea o polígono.	Feature Layer
in_container_feature_class	Las entidades de multiparche cerrado que se utilizarán como contenedores para las entidades de entrada.	Feature Layer
out_table	La tabla de salida que proporciona una lista de Entidades de entrada 3D que están dentro o parcialmente dentro de las Entidades de multiparche de entrada que están cerradas. La tabla de salida contiene un OBJECTID (Object ID), Target_ID y Estado. El Estado expondrá si la entidad de entrada (Target_ID) está dentro o parcialmente dentro de un multiparche.	Table
complex_output (Opcional)	Especifica si la tabla de salida identificará la relación entre las Entidades de entrada y las Entidades de multiparche de entrada mediante la creación de un campo Contain_ID que identifique la entidad multiparche que contiene la entidad de entrada. Marcado: se identificará la entidad multiparche que contiene una entidad de entrada. Desmarcado: no se identificará la entidad multiparche que contiene una entidad de entrada. Esta es la opción predeterminada. Especifica si la tabla de salida identificará la relación entre las Entidades de entrada y las Entidades de multiparche de entrada mediante la creación de un campo Contain_ID que identifique la entidad multiparche que contiene la entidad de entrada. COMPLEX —Se identificará la entidad multiparche que contiene una entidad de entrada. SIMPLE —No se identificará la entidad multiparche que contiene una entidad de entrada. Esta es la opción predeterminada.	Boolean

Ejemplo de código

Ejemplo 1 de Inside3D (ventana de Python)

El siguiente ejemplo muestra cómo usar de esta herramienta en la ventana Python:

import arcpy
from arcpy import env

arcpy.CheckOutExtension('3D')
env.workspace = 'C:/data'
arcpy.Inside3D_3d('inFeature.shp', 'sample.gdb/multipatch', 'sample.gdb/output_table')

Ejemplo 2 de Inside3D (secuencia de comandos independiente)

El siguiente ejemplo muestra cómo usar esta herramienta en una secuencia de comandos independiente de Python:

'''****************************************************************************
Name: Inside3D Example
Description: This script demonstrates how to use the
             Inside3D tool.
****************************************************************************'''
# Import system modules
import arcpy
import exceptions, sys, traceback
from arcpy import env

try:
    # Obtain a license for the ArcGIS 3D Analyst extension
    arcpy.CheckOutExtension('3D')
    # Set environment settings
    env.workspace = 'C:/data'
    # Set Local Variables
    inFC = 'Points_3D.shp' # the input feature
    inMP = 'Buildings.shp' # the input multi-patch
    # Ensure output has a unique name
    outTbl = arcpy.CreateUniqueName('Output_Table.dbf')
    
    # Execute Inside 3D
    arcpy.Inside3D_3d(inFC, inMP, outTbl)

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

Palabra clave CONFIG de salida, Auto ejecución, Extensión