Innerhalb 3D (3D Analyst)

Zusammenfassung

Ermittelt, ob in einem geschlossenen Multipatch dreidimensionale Features aus einer Eingabe-Feature-Class enthalten sind, und schreibt eine Ausgabetabelle mit den Features, die sich teilweise oder vollständig im Multipatch befinden.

Abbildung

Verwendung

• Für alle Eingabe-Features müssen als Teil ihrer Geometrie Z-Informationen gespeichert werden. Wenn auf Feldern basierende Höhenmessungen in einer 2D-Feature-Class vorhanden sind, kann das Werkzeug Feature zu 3D nach Attribut verwendet werden, um eine 3D-Feature-Class zu erstellen.

• Für diese Analyse ist eine geschlossene Multipatch-Geometrie erforderlich. Mit dem Werkzeug Ist geschlossen 3D kann ermittelt werden, ob eine Multipatch-Feature-Class geschlossene Features enthält, und mit dem Werkzeug Multipatch einschließen können Lücken in Multipatch-Features ausgeschlossen werden.

• Wenn die Option Komplexe Ausgabetabelle ausgewählt ist, wird für jedes Multipatch, das ein bestimmtes Eingabe-Feature schneidet, ein Datensatz erstellt. Ein Feature kann in mehreren geschlossenen Multipatch-Features liegen und mehrere Einträge in der Ausgabetabelle aufweisen.

• Die Ausgabetabelle enthält die folgenden Felder:

  • Target_ID – Die eindeutige ID des Eingabe-Features.
  • Status – Gibt an, ob das Feature, das durch das Feld Target_ID identifiziert ist, vollständig oder teilweise in einem Multipatch liegt.
  • Contain_ID – Identifiziert die eindeutige ID des Multipatch, das die Eingabe-Features schneidet, die vollständig oder teilweise darin liegen. Diese Option ist nur enthalten, wenn die Option Komplexe Ausgabetabelle aktiviert ist.

Syntax

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

Parameter	Erklärung	Datentyp
in_target_feature_class	Die Eingabe für eine Multipatch-, 3D Punkt-, Linien- oder Polygon-Feature-Class.	Feature Layer
in_container_feature_class	Die geschlossenen Multipatch-Features, die als Container für die Eingabe-Features verwendet werden.	Feature Layer
out_table	Die Ausgabetabelle, die eine Liste von 3D-Eingabe-Features bereitstellt, die vollständig oder teilweise in Eingabe-Multipatch-Features liegen, die geschlossen sind. Die Ausgabetabelle enthält eine OBJECTID (Objekt-ID), Target_ID und das Feld Status. Das Feld Status gibt an, ob das Eingabe-Feature (Target_ID) vollständig oder teilweise in einem Multipatch liegt.	Table
complex_output (optional)	Gibt an, ob die Ausgabetabelle die Beziehung zwischen den Eingabe-Features und den Eingabe-Multipatch-Features durch Erstellen eines Contain_ID-Feldes beschreibt, in dem das Multipatch-Feature identifiziert wird, das das Eingabe-Feature enthält. Aktiviert – Das Multipatch-Feature, das ein Eingabe-Feature enthält, wird angegeben. Deaktiviert – Das Multipatch-Feature, das ein Eingabe-Feature enthält, wird nicht angegeben. Dies ist die Standardeinstellung. Gibt an, ob die Ausgabetabelle die Beziehung zwischen den Eingabe-Features und den Eingabe-Multipatch-Features durch Erstellen eines Contain_ID-Feldes beschreibt, in dem das Multipatch-Feature identifiziert wird, das das Eingabe-Feature enthält. COMPLEX —Das Multipatch-Feature, das ein Eingabe-Feature enthält, wird angegeben. SIMPLE —Das Multipatch-Feature, das ein Eingabe-Feature enthält, wird nicht angegeben. Dies ist die Standardeinstellung.	Boolean

Codebeispiel

Inside3D – Beispiel 1 (Python-Fenster)

Anhand des folgenden Beispiels wird die Verwendung dieses Werkzeugs im Python-Fenster veranschaulicht.

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

Inside3D – Beispiel 2 (eigenständiges Skript)

Im folgenden Beispiel wird die Verwendung dieses Werkzeugs in einem eigenständigen Python-Skript veranschaulicht.

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

Umgebungen

Aktueller Workspace, Ausgabe-CONFIG-Schlüsselwort, Auto-Commit, Ausdehnung

Lizenzinformationen

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