Innerhalb 3D (3D Analyst Tools)

Zusammenfassung

Ermittelt, ob in einem geschlossenen Multipatch 3D-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

Grafik: Werkzeug "Innerhalb 3D"

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 in 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 überschneidet, 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 überschneidet, die vollständig oder teilweise darin liegen. Diese Option ist nur enthalten, wenn die Option Komplexe Ausgabetabelle aktiviert ist.

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die Eingabe für eine Multipatch-, 3D-Point-, Line- oder Polygon-Feature-Class.	Feature Layer
Eingabe-Multipatch-Features	Die geschlossenen Multipatch-Features, die als Container für die Eingabe-Features verwendet werden.	Feature Layer
Ausgabetabelle	Die Ausgabetabelle enthält eine Liste der 3D-Features aus dem Parameterwert Eingabe-Features, die sich vollständig oder teilweise innerhalb des Parameterwerts Eingabe-Multipatch-Features befinden und geschlossen sind. Die Ausgabetabelle enthält eine `OBJECTID` (Objekt-ID), eine `Target_ID`, und ein `Status`-Feld. Das `Status`-Feld gibt an, ob das Eingabe-Feature (`Target_ID`) vollständig oder teilweise in einem Multipatch enthalten ist.	Table
Komplexe Ausgabetabelle (Optional)	Gibt an, ob die Ausgabetabelle die Beziehung zwischen den Parameterwerten Eingabe-Features und Eingabe-Multipatch-Features durch Erstellen eines `Contain_ID`-Feldes identifiziert, in dem das Multipatch-Feature identifiziert wird, das das Eingabe-Feature enthält. Aktiviert—The multipatch feature that contains an input feature will be identified. Deaktiviert—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})

Name	Erläuterung	Datentyp
in_target_feature_class	Die Eingabe für eine Multipatch-, 3D-Point-, Line- 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 enthält eine Liste der 3D-Features aus dem Parameterwert `in_target_feature_class`, die sich vollständig oder teilweise innerhalb des Parameterwerts `in_container_feature_class` befinden und geschlossen sind. Die Ausgabetabelle enthält eine `OBJECTID` (Objekt-ID), eine `Target_ID`, und ein `Status`-Feld. Das `Status`-Feld gibt an, ob das Eingabe-Feature (`Target_ID`) vollständig oder teilweise in einem Multipatch enthalten ist.	Table
complex_output (Optional)	Gibt an, ob die Ausgabetabelle die Beziehung zwischen den Parameterwerten `in_target_feature_class` und `in_container_feature_class` durch Erstellen eines `Contain_ID`-Feldes identifiziert, in dem das Multipatch-Feature identifiziert wird, das das Eingabe-Feature enthält. `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

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.ddd.Inside3D('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')

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

Umgebungen

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

Lizenzierungsinformationen

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