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

Gráfico de la herramienta Dentro de 3D

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

  • 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: Id. único de la entidad de entrada.
    • Status: indica si la identidad 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

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

El multiparche de entrada o clase de entidad de punto 3D, línea o polígono.

Feature Layer
Entidades multiparche de entrada

Las entidades de multiparche cerrado que se utilizarán como contenedores para las entidades de entrada.

Feature Layer
Tabla de salida

Tabla de salida que proporciona una lista de Entidades de entrada 3D que están dentro o parcialmente dentro de las Entidades multiparche de entrada que están cerradas. La tabla de salida contiene un OBJECTID (Id. de objeto), Target_ID y el campo Status. El campo Status indicará si la entidad de entrada (Target_ID) está dentro o parcialmente dentro de un multiparche.

Table
Tabla compuesta de salida
(Opcional)

Especifica si la tabla de salida identificará la relación entre las Entidades de entrada y las Entidades multiparche de entrada mediante la creación de un campo Contain_ID que identifique la entidad multiparche que contiene la entidad de entrada.

  • Activado: se identificará la entidad multiparche que contiene una entidad de entrada.
  • Desactivado: no se identificará la entidad multiparche que contiene una entidad de entrada. Esta es la opción predeterminada.
Boolean

arcpy.ddd.Inside3D(in_target_feature_class, in_container_feature_class, out_table, {complex_output})
NombreExplicaciónTipo 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

Tabla de salida que proporciona una lista de Entidades de entrada 3D que están dentro o parcialmente dentro de las Entidades multiparche de entrada que están cerradas. La tabla de salida contiene un OBJECTID (Id. de objeto), Target_ID y el campo Status. El campo Status indicará 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 multiparche de entrada mediante la creación de un campo Contain_ID que identifique la entidad multiparche que contiene la entidad de entrada.

  • Activado: se identificará la entidad multiparche que contiene una entidad de entrada.
  • Desactivado: 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 multiparche de entrada mediante la creación de un campo Contain_ID que identifique la entidad multiparche que contiene la entidad de entrada.

  • COMPLEXSe identificará la entidad multiparche que contiene una entidad de entrada.
  • SIMPLENo se identificará la entidad multiparche que contiene una entidad de entrada. Esta es la opción predeterminada.
Boolean

Muestra de código

Ejemplo 1 de Inside3D (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.Inside3D_3d('inFeature.shp', 'sample.gdb/multipatch', 'sample.gdb/output_table')
Ejemplo 2 de Inside3D (secuencia de comandos independiente)

En el siguiente ejemplo se muestra cómo usar esta herramienta en un script independiente de Python.

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

# Set environment settings
arcpy.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)

Información de licenciamiento

  • Basic: Requiere 3D Analyst
  • Standard: Requiere 3D Analyst
  • Advanced: Requiere 3D Analyst

Temas relacionados