Générer les entrées d’un bâtiment (Indoors)

Synthèse

Créer ou mettre à jour des points représentant les emplacements des entrées ou des sorties d’un bâtiment.

Cet outil analyse les entités Unité en entrée pour identifier les segments extérieurs d’un bâtiment et générer des entités ponctuelles pour les portes situées à proximité de ces segments. Le réseau ArcGIS Indoors utilise ces points d’entrée lors du calcul d’itinéraires impliquant d’entrer dans des bâtiments, d’en sortir et de se déplacer entre ces derniers.

Illustration

Utilisation

• Les valeurs des paramètres en entrée suivants peuvent être des couches ou des classes d’entités issues d’un jeu de données Indoor (créé à l’aide de l’outil Créer un jeu de données Indoor) ou d’une géodatabase Indoors (créée à l’aide de l’outil Créer une base de données Indoors) : Entités Niveau en entrée, Entités Unité en entrée et Entités Porte en entrée.

• La valeur du paramètre Entités Niveau en entrée doit être une couche ou une classe d’entités surfaciques conforme au modèle Indoors pour la classe d’entités Niveaux. Il est possible de limiter la génération d’entrées à des niveaux spécifiques en effectuant une sélection sur la couche en entrée ou en fournissant un ensemble de définition. Sans sélection ni ensemble de définition, l’outil crée des entrées pour chaque niveau de la couche en entrée.

• La valeur du paramètre Entités Unité en entrée doit être une couche ou une classe d’entités surfaciques conforme au modèle Indoors pour la classe d’entités Unités. Cet outil utilise les entités Unité pour identifier les segments extérieurs d’un bâtiment.

  Utilisez le paramètre Expression Unité extérieure pour définir les entités Unité en entrée (telles que les patios ou les escaliers extérieurs) à traiter comme étant extérieures à un bâtiment. L’outil identifie toutes les portes ou ouvertures comme entrées entre les entités Unité extérieure et les entités Unité intérieure définies. En outre, cette expression sera appliquée à tout ensemble de définition ou sélection sur la couche en entrée.

• La valeur du paramètre Entités Porte en entrée doit être une couche d’entités polylignes conforme au modèle Indoors pour la classe d’entités Détails. Vous devez sélectionner une ou plusieurs entités Porte sur la couche.

  • Si aucune entité n'est sélectionnée dans la couche choisie, l’outil ne peut pas être exécuté. Utilisez l’outil Sélectionner une couche par attribut pour effectuer une sélection.
  • Cet outil identifiera et traitera plusieurs représentations des portes sous forme d’entités polylignes. Ceci inclut, sans s’y limiter, les portes composées d’entités individuelles ou multiples, les lignes droites traversant une ouverture, les lignes courbes représentant les battants de porte, et les lignes circulaires représentant des portes tournantes.
  • Pour de meilleurs résultats, tout problème de géométrie dans la classe d’entités source doit être résolu avant de sélectionner les entités Porte et d’exécuter cet outil. Par exemple, supprimer les nœuds inutiles et les entités Porte de petite taille ou non pertinentes. Le paquetage d’installation des données du produit ArcGIS Indoors inclut des tâches par lots Data Reviewer qui peuvent vous aider à identifier les entités à corriger.

• Le paramètre Taille de la zone tampon définit la distance que l’outil utilisera pour rechercher des entités Entrée le long du segment extérieur d’un bâtiment. L’outil crée une zone tampon à l’intérieur et à l’extérieur du segment extérieur pour capturer les portes dont l’ouverture se fait vers l’intérieur et celles dont l’ouverture se fait vers l’extérieur. Il n’est pas nécessaire que la zone tampon englobe la totalité de la porte ; il faut seulement qu’elle intersecte au moins une entité de la porte. L’utilisation d’une zone tampon trop grande risque de capturer des entités se trouvant à l’intérieur du bâtiment à proximité du segment extérieur mais ne constituant pas des entrées réelles du bâtiment.

• La valeur du paramètre Type d’utilisation Entrée renseigne le champ USE_TYPE des nouvelles entités Entrée.

• La valeur z de l’entité ponctuelle en sortie est issue de la valeur z du niveau où se trouve la porte.

• Lorsque plusieurs portes sont adjacentes, il est possible que cet outil ne génère qu’un seul point d’entrée pour les représenter. Si un calcul d'itinéraire pour chaque entrée individuelle est requis, dupliquez et positionnez manuellement le point d’entrée généré.

• La valeur du paramètre Champ ID de niveau est utilisée pour identifier le champ dans lequel indiquer des valeurs d’ID de niveau dans la couche d’entités Entrées cibles. Si la valeur du paramètre Entités Niveau en entrée est une couche tenant compte des étages, le paramètre Champ ID de niveau prend par défaut la valeur Champ Étage de la couche. Sinon, la valeur du champ LEVEL_ID est utilisée par défaut.

  Le champ défini pour le paramètre Champ ID de niveau doit être de type texte, avec une longueur de 255.

• La valeur du paramètre Champ Type d’utilisation est utilisée pour identifier le champ dans lequel indiquer des valeurs Type d’utilisation Entrée pour les nouvelles entités Entrée. Par défaut, il s’agit du champ USE_TYPE. Si le champ défini n’existe pas dans la couche d’entités Entrées cibles, un champ portant le nom indiqué est créé et renseigné avec les valeurs Type d’utilisation Entrée.

  Le champ défini pour le paramètre Champ Type d’utilisation doit être de type texte, avec une longueur de 50.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités Niveau en entrée	Entités surfaciques en entrée représentant un ou plusieurs niveaux dans un ou plusieurs bâtiments. Dans le modèle Indoors, il s’agit de la couche Niveaux. Seuls les niveaux représentés par ces entités sont traités.	Feature Layer
Entités Unité en entrée	Entités surfaciques en entrée représentant les espaces des bâtiments. Dans le modèle Indoors, il s’agit de la couche Unités. L’outil utilise ces entités pour identifier les segments extérieurs d’un bâtiment.	Feature Layer
Entités Porte en entrée	Entités polylignes en entrée représentant les portes. Dans le modèle Indoors, il s’agit d’un sous-ensemble d’entités de la couche Détails. L’outil utilise ces entités pour identifier les entrées le long de l’extérieur d’un bâtiment. Remarque : Une ou plusieurs entités Porte de la couche doivent être sélectionnées pour que l’outil s’exécute. Utilisez l’outil Sélectionner une couche par attribut pour effectuer une sélection.	Feature Layer
Entrées cibles	Classe ou couche d’entités dans laquelle les points d’entrée générés seront écrits.	Feature Layer
Taille de la zone tampon (Facultatif)	Distance, en mètres, utilisée par l’outil pour rechercher les entrées potentielles vers l’intérieur et vers l’extérieur à partir du segment extérieur d’un bâtiment. La valeur doit être supérieure à zéro et inférieure à 10. La valeur par défaut est 0,5.	Double
Type d’utilisation Entrée (Facultatif)	Valeur utilisée pour calculer le champ USE_TYPE pour les nouveaux points d’entrée. La valeur par défaut est Entrée.	String
Expression Unité extérieure (Facultatif)	Expression SQL utilisée pour définir les valeurs Entités Unité en entrée qui représentent les espaces extérieurs d’un bâtiment, tels que les patios ou les escaliers de secours. Les espaces correspondant à cette expression sont traités comme des entités extérieures lors de la génération des entrées.	SQL Expression
Supprimer des entrées existantes (Facultatif)	Détermine si des entités Entrée existantes, pour lesquelles la valeur du champ USE_TYPE correspond à la valeur du paramètre Type d’utilisation Entrée, sont supprimées avant la création de nouveaux points d’entrée. Lors de la suppression d’entrées existantes, l’outil identifie uniquement les entrées des niveaux inclus dans le paramètre Entités Niveau en entrée. Activé : les entités existantes seront supprimées. Désactivé : les entités existantes ne seront pas supprimées. Il s’agit de l’option par défaut.	Boolean
Champ ID de niveau (Facultatif)	Ce champ est mis à jour avec l’ID de niveau associé pour les nouvelles entités Entrée. Si la valeur du paramètre Entités Niveau en entrée est une couche tenant compte des étages, ce paramètre prend par défaut la valeur Champ Étage de la couche. Sinon, la valeur du champ LEVEL_ID est utilisée par défaut. Si le champ défini n’existe pas dans la couche d’entités Entrées cibles, un nouveau champ portant le nom indiqué est créé et renseigné avec les valeurs d’ID de niveau.	Field
Champ Type d’utilisation (Facultatif)	Ce champ est mis à jour avec la valeur Type d’utilisation Entrée pour les nouvelles entités Entrée. Le champ USE_TYPE est utilisé par défaut. Si le champ défini n’existe pas dans la couche d’entités Entrées cibles, un champ portant le nom indiqué est créé et renseigné avec la valeur Type d’utilisation Entrée.	Field

Sortie obtenue

Étiquette	Explication	Type de données
Entrées mises à jour	Couche ou classe d’entités Entrées cibles mise à jour.	Feature Class

Python

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})

Nom	Explication	Type de données
in_level_features	Entités surfaciques en entrée représentant un ou plusieurs niveaux dans un ou plusieurs bâtiments. Dans le modèle Indoors, il s’agit de la couche Niveaux. Seuls les niveaux représentés par ces entités sont traités.	Feature Layer
in_unit_features	Entités surfaciques en entrée représentant les espaces des bâtiments. Dans le modèle Indoors, il s’agit de la couche Unités. L’outil utilise ces entités pour identifier les segments extérieurs d’un bâtiment.	Feature Layer
in_door_features	Entités polylignes en entrée représentant les portes. Dans le modèle Indoors, il s’agit d’un sous-ensemble d’entités de la couche Détails. L’outil utilise ces entités pour identifier les entrées le long de l’extérieur d’un bâtiment. Remarque : Une ou plusieurs entités Porte de la couche doivent être sélectionnées pour que l’outil s’exécute. Utilisez l’outil Sélectionner une couche par attribut pour effectuer une sélection.	Feature Layer
target_entryways	Classe ou couche d’entités dans laquelle les points d’entrée générés seront écrits.	Feature Layer
buffer_size (Facultatif)	Distance, en mètres, utilisée par l’outil pour rechercher les entrées potentielles vers l’intérieur et vers l’extérieur à partir du segment extérieur d’un bâtiment. La valeur doit être supérieure à zéro et inférieure à 10. La valeur par défaut est 0,5.	Double
entryway_use_type (Facultatif)	Valeur utilisée pour calculer le champ USE_TYPE pour les nouveaux points d’entrée. La valeur par défaut est Entrée.	String
exterior_unit_exp (Facultatif)	Expression SQL utilisée pour définir les valeurs Entités Unité en entrée qui représentent les espaces extérieurs d’un bâtiment, tels que les patios ou les escaliers de secours. Les espaces correspondant à cette expression sont traités comme des entités extérieures lors de la génération des entrées.	SQL Expression
delete_existing_entryways (Facultatif)	Détermine si des entités Entrée existantes, pour lesquelles la valeur du champ USE_TYPE correspond à la valeur du paramètre entryway_use_type, sont supprimées avant la création de nouveaux points d’entrée. Lors de la suppression d’entrées existantes, l’outil identifie uniquement les entrées des niveaux inclus dans le paramètre in_level_features. DELETE_FEATURES—Les entités existantes seront supprimées. NO_DELETE_FEATURES—Les entités existantes ne seront pas supprimées. Il s’agit de l’option par défaut.	Boolean
level_id_field (Facultatif)	Ce champ est mis à jour avec l’ID de niveau associé pour les nouvelles entités Entrée. Si la valeur du paramètre in_level_features est une couche tenant compte des étages, ce paramètre prend par défaut la valeur Champ Étage de la couche. Sinon, la valeur du champ LEVEL_ID est utilisée par défaut. Si le champ défini n’existe pas dans la couche d’entités target_entryways, un champ portant le nom indiqué est créé et renseigné avec les valeurs d’ID de niveau.	Field
use_type_field (Facultatif)	Ce champ est mis à jour avec la valeur entryway_use_type pour les nouvelles entités Entrée. Le champ USE_TYPE est utilisé par défaut. Si le champ défini n’existe pas dans la couche d’entités target_entryways, un champ portant le nom indiqué est créé et renseigné avec la valeur entryway_use_type.	Field

Sortie obtenue

Nom	Explication	Type de données
updated_entryways	Couche ou classe d’entités target_entryways mise à jour.	Feature Class

Exemple de code

Exemple 1 d’utilisation de la fonction GenerateFacilityEntryways (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l'utilisation de la fonction GenerateFacilityEntryways en mode immédiat.

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")

Exemple 2 d’utilisation de la fonction GenerateFacilityEntryways (script autonome)

Le script autonome ci-dessous illustre l’utilisation de la fonction 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.management.SelectLayerByAttribute(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)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

• Basic: Non
• Standard: Non
• Advanced: Nécessite ArcGIS Indoors Pro ou ArcGIS Indoors Maps et 3D Analyst