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

Résumé

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 Create Indoor Dataset (Créer un jeu de données Indoor)) ou d’une géodatabase Indoors (créée à l’aide de l’outil Create Indoors Database (Créer une base de données Indoors)) : Input Level Features (Entités Niveau en entrée), Input Unit Features (Entités Unité en entrée) et Input Door Features (Entités Porte en entrée).
La valeur du paramètre Input Level Features (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 Input Unit Features (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 Exterior Unit Expression (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 Input Door Features (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. Gardez à l’esprit les points suivants en ce qui concerne les entités Porte :
- Si aucune entité n’est sélectionnée dans la couche choisie, l’outil ne peut pas être exécuté. Utilisez l’outil Select Layer By Attribute (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 package d’installation des données produit ArcGIS Indoors inclut des tâches par lots ArcGIS Data Reviewer qui peuvent aider à identifier les fonctionnalités à corriger.
Le paramètre Buffer Size (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 Entryway Use Type (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 Level ID Field (Champ ID de niveau) est utilisée pour identifier le champ dans lequel indiquer des valeurs d’ID de niveau dans la valeur du paramètre Target Entryways (Entrées cibles). Si la valeur du paramètre Input Level Features (Entités Niveau en entrée) est une couche tenant compte des étages, le paramètre Level ID Field (Champ ID de niveau) prend par défaut la valeur Floor Field (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 Level ID Field (Champ ID de niveau) doit être de type texte, avec une longueur de 255.
La valeur du paramètre Use Type Field (Champ Type d’utilisation) est utilisée pour identifier le champ dans lequel indiquer des valeurs Entryway Use Type (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 valeur du paramètre Target Entryways (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 Use Type Field (Champ Type d’utilisation) doit être de type texte, avec une longueur de 50.

Etiqueter	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 Select Layer By Attribute (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 issues de la valeur du paramètre Input Unit Features (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 Entryway Use Type (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 la valeur du paramètre Input Level Features (Entités Niveau en entrée). Activé—Les entités existantes seront supprimées. Décoché—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 Input Level Features (Entités Niveau en entrée) est une couche tenant compte des étages, ce paramètre prend par défaut la valeur Floor Field (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 valeur du paramètre Target Entryways (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 Entryway Use Type (Type d’utilisation Entrée) pour les nouvelles entités Entrée. Par défaut, c’est le champ `USE_TYPE`. Si le champ défini n’existe pas dans la valeur du paramètre Target Entryways (Entrées cibles), un champ portant le nom indiqué est créé et renseigné avec la valeur Entryway Use Type (Type d’utilisation Entrée).	Field

Sortie dérivée

Etiqueter	Explication	Type de données
Entrées mises à jour	Couche ou classe d’entités Entrées cibles mise à jour.	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})

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 Select Layer By Attribute (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 issues de la valeur du paramètre `in_unit_features` 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 la valeur du 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 Floor Field (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 valeur du paramètre `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. Par défaut, c’est le champ `USE_TYPE`. Si le champ défini n’existe pas dans la valeur du paramètre `target_entryways`, un champ portant le nom indiqué est créé et renseigné avec la valeur `entryway_use_type`.	Field

Sortie dérivée

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 de fenêtre Python ci-après 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-après 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: Requiert ArcGIS Indoors Pro ou ArcGIS Indoors Maps et 3D‏ Analyst

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

Résumé

Illustration

Utilisation

Paramètres

Remarque :

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes