Intérieur 3D (Outils 3D Analyst)

Résumé

Détermine si les entités 3D d’une classe d’entités en entrée se trouvent dans un multipatch fermé, et écrit une table en sortie qui enregistre les entités se trouvant partiellement ou entièrement dans le multipatch.

Illustration

! Graphique de l’outil 3D

Utilisation

Des informations Z doivent être stockées dans la géométrie de toutes les entités en entrée. Si des mesures de hauteur basées sur des champs sont présentes dans une classe d’entités 2D, l’outil Feature To 3D By Attribute (Entité en 3D par attribut) peut être utilisé pour créer une classe d’entités 3D.
La géométrie multipatch fermée est requise pour cette analyse. L’outil Is Closed 3D (Fermeture 3D) permet de déterminer si une classe d’entités multipatch contient des entités fermées et l’outil Enclose Multipatch (Inclure un multipatch) permet d’éliminer les interruptions dans les entités multipatch.
Si l’option Complex Output Table (Table en sortie complexe) est sélectionnée, un enregistrement est créé pour chaque multipatch qu’une entité en entrée donnée intersecte. Une entité peut se trouver dans plusieurs entités multipatch fermées et comporter plusieurs entrées dans la table en sortie.
La table en sortie comporte les champs suivants :
- Target_ID—L’ID unique de l’entité en entrée.
- Status—Indique si l’entité identifiée par le champ Target_ID se trouve entièrement ou partiellement à l’intérieur d’un multipatch.
- Contain_ID—Identifie l’ID unique du multipatch qui intersecte les entités en entrée qui sont entièrement ou partiellement à l’intérieur du multipatch. Inclus uniquement si l’option Complex Output Table (Table en sortie complexe) est sélectionnée

Etiqueter	Explication	Type de données
Entités en entrée	Multipatch ou classe d’entités 3D ponctuelles, linéaires ou surfaciques en entrée.	Feature Layer
Entités multipatch en entrée	Entités multipatch fermées à utiliser en tant que conteneurs pour les entités en entrée.	Feature Layer
Table en sortie	Table en sortie fournissant dans la valeur du paramètre Input Features (Entités en entrée) la liste des entités 3D qui se trouvent entièrement ou partiellement à l’intérieur de la valeur du paramètre Input Multipatch Features (Entités multipatch en entrée), qui correspond à des entités fermées. La table en sortie contient les champs `OBJECTID` (ID d’objet), `Target_ID` et `Status`. Le champ `Status` indique si l’entité en entrée (Target-ID) se trouve entièrement ou partiellement à l’intérieur d’un multipatch.	Table
Table en sortie complexe (Facultatif)	Spécifie si la table en sortie identifie la relation entre les valeurs des paramètres Input Features (Entités en entrée) et Input Multipatch Features (Entités multipatch en entrée) via la création d’un champ `Contain_ID` qui identifie l’entité multipatch contenant l’entité en entrée. Activé—The multipatch feature that contains an input feature will be identified. Décoché—The multipatch feature that contains an input feature will not be identified. This is the default.	Boolean

arcpy.3d.Inside3D(in_target_feature_class, in_container_feature_class, out_table, {complex_output})

Nom	Explication	Type de données
in_target_feature_class	Multipatch ou classe d’entités 3D ponctuelles, linéaires ou surfaciques en entrée.	Feature Layer
in_container_feature_class	Entités multipatch fermées à utiliser en tant que conteneurs pour les entités en entrée.	Feature Layer
out_table	Table en sortie fournissant dans la valeur du paramètre `in_target_feature_class` la liste des entités 3D qui se trouvent entièrement ou partiellement à l’intérieur de la valeur du paramètre `in_container_feature_class`, qui correspond à des entités fermées. La table en sortie contient les champs `OBJECTID` (ID d’objet), `Target_ID` et `Status`. Le champ `Status` indique si l’entité en entrée (Target-ID) se trouve entièrement ou partiellement à l’intérieur d’un multipatch.	Table
complex_output (Facultatif)	Spécifie si la table en sortie identifie la relation entre les valeurs des paramètres `in_target_feature_class` et `in_container_feature_class` via la création d’un champ `Contain_ID` qui identifie l’entité multipatch contenant l’entité en entrée. `COMPLEX`—The multipatch feature that contains an input feature will be identified. `SIMPLE`—The multipatch feature that contains an input feature will not be identified. This is the default.	Boolean

Exemple de code

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

L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre Python :

arcpy.env.workspace = 'C:/data'
arcpy.ddd.Inside3D('inFeature.shp', 'sample.gdb/multipatch', 'sample.gdb/output_table')

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

L’exemple suivant illustre l’utilisation de cet outil dans un script Python autonome :

'''****************************************************************************
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')

# Run Inside3D
arcpy.ddd.Inside3D(inFC, inMP, outTbl)

Environnements

Espace de travail courant, Mot-clé CONFIG en sortie, Validation automatique, Étendue

Informations de licence

Basic: Nécessite 3D Analyst
Standard: Nécessite 3D Analyst
Advanced: Nécessite 3D Analyst