Generar entradas a instalaciones (Indoors)

Disponible para una organización de ArcGIS con licencia de la extensión Indoors.

Resumen

Crea o actualiza puntos que representan las ubicaciones de entrada y salida de un edificio.

Esta herramienta analiza las entidades de unidad de entrada para identificar los bordes exteriores de una instalación y genera entidades de punto para las puertas ubicadas cerca de dichos bordes. La red de ArcGIS Indoors usa estos puntos de entrada al generar rutas a un edificio, desde él o entre edificios.

Ilustración

Ejemplo de la herramienta Generar entradas a instalaciones para puertas batientes de una hoja
Ejemplo de la herramienta Generar entradas a instalaciones para puertas batientes de dos hojas
Ejemplo de la herramienta Generar entradas a instalaciones para puertas giratorias

Uso

  • Los siguientes parámetros de entrada pueden ser capas de entidades o clases de entidad de un dataset de interiores (creado con la herramienta Crear dataset de interiores) o geodatabase de Indoors (creada con la herramienta Crear base de datos de Indoors): Entidades de nivel de entrada, Entidades de unidad de entrada y Entidades de puerta de entrada.

  • El valor del parámetro Entidades de nivel de entrada debe ser una capa de entidades o clase de entidad poligonal según el modelo de Indoors para la clase de entidad Levels. La generación de entradas se puede limitar a niveles específicos realizando una selección en la capa de entrada o proporcionando una consulta de definición. Sin una selección o una consulta de definición, la herramienta creará entradas para todos los niveles de la capa de entrada.

  • El valor del parámetro Entidades de unidad de entrada debe ser una capa de entidades o clase de entidad poligonal según el modelo de Indoors para la clase de entidad Units. Esta herramienta utiliza las entidades de unidad para identificar los bordes exteriores de una instalación.

    Use el parámetro Expresión de unidad exterior para definir qué entidades de unidad de entrada (como patios o escaleras exteriores) se tratarán como el exterior de una instalación. La herramienta identifica cualquier puerta o apertura como entrada entre las entidades de unidad exterior y las entidades de unidad interior definidas. Esta expresión se aplicará junto con cualquier consulta de definición o selección de la capa de entrada.

  • El valor del parámetro Entidades de puerta de entrada debe ser una capa de entidades de polilínea según el modelo de Indoors para la clase de entidad Details. La capa debe tener una o varias entidades de puerta seleccionadas.

    • Si no hay ninguna entidad seleccionada en la capa elegida, la herramienta no se ejecutará. Utilice la herramienta Seleccionar capa por atributo para realizar una selección.
    • Esta herramienta identificará y procesará distintas representaciones de entidad de polilínea de puertas. Se incluyen, entre otras, puertas compuestas por una o varias entidades, líneas rectas a través de aberturas, líneas curvas que representan puertas que se abren y líneas circulares que representan puertas giratorias.
    • Para obtener mejores resultados, resuelva los problemas de geometría en la clase de entidad de origen antes de seleccionar entidades de puerta y ejecutar esta herramienta. Por ejemplo, elimine los nodos innecesarios y elimine las entidades de puerta pequeñas o extrañas. El paquete de instalación de datos del producto de ArcGIS Indoors incluye trabajos por lotes de Data Reviewer que pueden ayudar a identificar las entidades que hay que corregir.

  • El parámetro Tamaño de zona de influencia define la distancia que usará la herramienta para buscar entidades de entrada a lo largo del borde exterior de un edificio. La herramienta crea zonas de influencia fuera y dentro del borde exterior para capturar tanto puertas que se abren hacia dentro como hacia fuera. No es necesario que la zona de influencia abarque toda la puerta, sino solo que se interseque al menos a una entidad de ella. Usar una zona de influencia demasiado grande podría capturar entidades dentro del edificio que estén cerca del borde exterior pero que realmente no son entradas del edificio.

  • El valor del parámetro Tipo de uso de entrada rellena el campo USE_TYPE de las nuevas entidades de entrada.

  • Si está utilizando un dataset interior, el valor z de la entidad de puntos de salida se deriva del valor z del nivel en el que se encuentra la puerta. Si está utilizando una geodatabase Indoors, el valor z se deriva del campo ELEVATION_RELATIVE de las entidades de puerta de entrada.

  • Si hay varias puertas adyacentes entre sí, esta herramienta podría generar un único punto de entrada para representarlas. Si se requiere la generación de rutas a través de cada puerta individual, duplique y coloque manualmente el punto de entrada generado.

  • El valor del parámetro Campo de Id. de nivel se utiliza para determinar qué campo se debe rellenar con valores de Id. de nivel en la capa de entidades Entradas de destino. Si el valor del parámetro Entidades de nivel de entrada es una capa que tiene en cuenta las plantas, el parámetro Campo de Id. de nivel adoptará de forma predeterminada el valor de Campo de planta configurado de la capa. De lo contrario, el parámetro tendrá como valor predeterminado el campo LEVEL_ID.

    El campo establecido para el parámetro Campo de Id. de nivel debe ser del tipo de datos de texto y debe tener una longitud de campo de 255.

  • El valor del parámetro Campo de tipo de uso se utiliza para determinar qué campo se debe rellenar con valores de Tipo de uso de entrada para las nuevas entidades de entradas. De forma predeterminada, será el campo USE_TYPE. Si el campo definido no existe en la capa de entidades Entradas de destino, se creará un campo con el nombre que proporcione y se rellenará con los valores de Tipo de uso de entrada.

    El campo definido para el parámetro Campo de tipo de uso debe ser del tipo de datos de texto y debe tener una longitud de campo de 50.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de nivel de entrada

Las entidades poligonales de entrada representan uno o varios niveles de una o varias instalaciones. En el modelo de Indoors, será la capa Levels. La herramienta solo procesa los niveles que representan estas entidades.

Feature Layer
Entidades de unidad de entrada

Las entidades poligonales de entrada que representan espacios de edificios. En el modelo de Indoors, será la capa Units. La herramienta usa estas entidades al identificar los bordes exteriores de una instalación.

Feature Layer
Entidades de puerta de entrada

Las entidades de polilínea de entrada que representan puertas. En el modelo de Indoors, será un subconjunto de entidades de la capa Details. La herramienta usa estas entidades al identificar entradas a lo largo del exterior de una instalación.

Nota:

La capa debe tener una o varias entidades de puerta seleccionadas para que la herramienta se ejecute. Utilice la herramienta Seleccionar capa por atributo para realizar una selección.

Feature Layer
Entradas de destino

La capa de entidades o clase de entidad donde se escribirán los puntos de entrada que se generen.

Feature Layer
Tamaño de zona de influencia
(Opcional)

La distancia, en metros, en la que la herramienta buscará hacia dentro o hacia fuera desde el borde exterior de una instalación para identificar posibles entradas. El valor predeterminado es 0,5 y debe ser mayor que 0 y menor que 10.

Double
Tipo de uso de entrada
(Opcional)

El valor utilizado para calcular el campo USE_TYPE para nuevos puntos de entrada. El valor predeterminado es Entrada.

String
Expresión de unidad exterior
(Opcional)

Una expresión SQL utilizada para definir qué valores de Entidades de unidad de entrada representan los espacios exteriores de una instalación, como patios o escaleras de incendios. Los espacios que coincidan con esta expresión se tratarán como exteriores durante la generación de entradas.

SQL Expression
Eliminar entradas existentes
(Opcional)

Especifica si se eliminarán las entidades de entrada existentes con un valor de campo USE_TYPE que coincide con el valor del parámetro Tipo de uso de entrada antes de crear nuevos puntos de entrada. Al eliminar las entradas existentes, la herramienta solo identifica las entradas de niveles que se incluyen en el parámetro Entidades de nivel de entrada.

  • Activado: se eliminarán las entidades existentes.
  • Desactivado: no se eliminarán las entidades existentes. Esta es la opción predeterminada.
Boolean
Campo de Id. de nivel
(Opcional)

El campo que se actualizará con el Id. de nivel asociado para las nuevas entidades de entrada. Si el valor del parámetro Entidades de nivel de entrada es una capa que tiene en cuenta las plantas, este parámetro adoptará de forma predeterminada el valor de Campo de planta configurado de la capa. De lo contrario, el parámetro tendrá como valor predeterminado el campo LEVEL_ID. Si el campo definido no existe en la capa de entidades Entradas de destino, se creará un nuevo campo con el nombre que proporcione y se rellenará con los valores del Campo de Id. de nivel.

Field
Campo de tipo de uso
(Opcional)

El campo que se actualizará con el valor de Tipo de uso de entrada para las nuevas entidades de entrada. La opción predeterminada es el campo USE_TYPE. Si el campo definido no existe en la capa de entidades Entradas de destino, se creará un campo con el nombre que proporcione y se rellenará con el valor de Tipo de uso de entrada.

Field

Salida derivada

EtiquetaExplicaciónTipo de datos
Entradas actualizadas

La capa de entidades o clase de entidad Entradas de destino actualizada.

Feature Class

arcpy.indoors.GenerateFacilityEntryways(in_level_features, in_unit_features, in_door_features, target_entryways, {buffer_size}, {entryway_use_type}, {exterior_unit_exp}, {delete_existing_entryways}, {level_id_field}, {use_type_field})
NombreExplicaciónTipo de datos
in_level_features

Las entidades poligonales de entrada representan uno o varios niveles de una o varias instalaciones. En el modelo de Indoors, será la capa Levels. La herramienta solo procesa los niveles que representan estas entidades.

Feature Layer
in_unit_features

Las entidades poligonales de entrada que representan espacios de edificios. En el modelo de Indoors, será la capa Units. La herramienta usa estas entidades al identificar los bordes exteriores de una instalación.

Feature Layer
in_door_features

Las entidades de polilínea de entrada que representan puertas. En el modelo de Indoors, será un subconjunto de entidades de la capa Details. La herramienta usa estas entidades al identificar entradas a lo largo del exterior de una instalación.

Nota:

La capa debe tener una o varias entidades de puerta seleccionadas para que la herramienta se ejecute. Utilice la herramienta Seleccionar capa por atributo para realizar una selección.

Feature Layer
target_entryways

La capa de entidades o clase de entidad donde se escribirán los puntos de entrada que se generen.

Feature Layer
buffer_size
(Opcional)

La distancia, en metros, en la que la herramienta buscará hacia dentro o hacia fuera desde el borde exterior de una instalación para identificar posibles entradas. El valor predeterminado es 0,5 y debe ser mayor que 0 y menor que 10.

Double
entryway_use_type
(Opcional)

El valor utilizado para calcular el campo USE_TYPE para nuevos puntos de entrada. El valor predeterminado es Entrada.

String
exterior_unit_exp
(Opcional)

Una expresión SQL utilizada para definir qué valores de Entidades de unidad de entrada representan los espacios exteriores de una instalación, como patios o escaleras de incendios. Los espacios que coincidan con esta expresión se tratarán como exteriores durante la generación de entradas.

SQL Expression
delete_existing_entryways
(Opcional)

Especifica si se eliminarán las entidades de entrada existentes con un valor de campo USE_TYPE que coincide con el valor del parámetro entryway_use_type antes de crear nuevos puntos de entrada. Al eliminar las entradas existentes, la herramienta solo identifica las entradas de niveles que se incluyen en el parámetro in_level_features.

  • DELETE_FEATURESSe eliminarán las entidades existentes.
  • NO_DELETE_FEATURESNo se eliminarán las entidades existentes. Esta es la opción predeterminada.
Boolean
level_id_field
(Opcional)

El campo que se actualizará con el Id. de nivel asociado para las nuevas entidades de entrada. Si el valor del parámetro in_level_features es una capa que tiene en cuenta las plantas, este parámetro adoptará de forma predeterminada el valor de Campo de planta configurado de la capa. De lo contrario, el parámetro tendrá como valor predeterminado el campo LEVEL_ID. Si el campo definido no existe en la capa de entidades target_entryways, se creará un campo con el nombre que proporcione y se rellenará con los valores del Campo de Id. de nivel.

Field
use_type_field
(Opcional)

El campo que se actualizará con el valor de entryway_use_type para las nuevas entidades de entrada. La opción predeterminada es el campo USE_TYPE. Si el campo definido no existe en la capa de entidades target_entryways, se creará un campo con el nombre que proporcione y se rellenará con el valor de entryway_use_type.

Field

Salida derivada

NombreExplicaciónTipo de datos
updated_entryways

La capa de entidades o clase de entidad target_entryways actualizada.

Feature Class

Muestra de código

Ejemplo 1 de GenerateFacilityEntryways (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función GenerateFacilityEntryways de modo inmediato.

import arcpy
arcpy.indoors.GenerateFacilityEntryways("C:/Indoors/ExampleCampus.gdb/Indoor/Levels", 
                                        "C:/Indoors/ExampleCampus.gdb/Indoor/Units", 
                                        "DoorDetails", 
                                        "C:/Indoors/ExampleCampus.gdb/Indoor/PointsOfInterest",  
                                        0.25, "Entry", 
                                        "USE_TYPE IN ('Fire Escape', 'Patio')",
                                        "NO_DELETE FEATURES",
                                        "LEVEL_ID", "USE_TYPE")
Ejemplo 2 de GenerateFacilityEntryways (script independiente)

La siguiente secuencia de comandos independiente muestra cómo utilizar la función GenerateFacilityEntryways.

# Name: Indoors_GenerateFacilityEntryways_example2
# Description: Creates entryway point features for selected door features

import arcpy

in_level_features = "C:/Indoors/ExampleCampus.gdb/Indoor/Levels"
in_unit_features = "C:/Indoors/ExampleCampus.gdb/Indoor/Units"
door_details_feature_class = "C:/Indoors/ExampleCampus.gdb/Indoor/Details"

# Select just the door detail features
in_door_features = arcpy.SelectLayerByAttribute_management(door_details_feature_class, 
                                                           'NEW_SELECTION', 
                                                           "USE_TYPE = 'A-DOOR'")   

target_entryways = "C:/Indoors/ExampleCampus.gdb/Indoor/PointsOfInterest"

buffer_size = 0.5
entryway_use_type = "Entry"
exterior_unit_exp = "USE_TYPE IN ('Fire Escape', 'Patio')"
delete_existing_entryways = "NO_DELETE_FEATURES"
level_id_field = "LEVEL_ID"
use_type_field = "USE_TYPE"


arcpy.indoors.GenerateFacilityEntryways(in_level_features, 
                                        in_unit_features, 
                                        in_door_features, target_entryways, 
                                        buffer_size, entryway_use_type, 
                                        exterior_unit_exp, 
                                        delete_existing_entryways,
                                        level_id_field,
                                        use_type_field)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

  • Basic: No
  • Standard: No
  • Advanced: Requiere Indoors and 3D Analyst

Temas relacionados