Innerhalb 3D (ArcGIS 3D Analyst)

Lizenzstufe:BasicStandardAdvanced

Zusammenfassung

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

Bild

Werkzeug "Innerhalb 3D" (Grafik)

Verwendung

Syntax

Inside3D_3d (in_target_feature_class, in_container_feature_class, out_table, {complex_output})
ParameterErläuterungDatentyp
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 Ausgabe-Tabelle, die eine Liste von 3D-Eingabe-Features bereitstellt, die vollständig oder teilweise in Eingabe-Multipatch-Features liegen, die geschlossen sind. Die Ausgabe-Tabelle enthält die Felder OBJECTID (Objekt-ID), Target_ID und Status. Der 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 Ausgabe-Tabelle 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 Ausgabe-Tabelle 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.

  • COMPLEXDas Multipatch-Feature, das ein Eingabe-Feature enthält, wird angegeben.
  • SIMPLEDas 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:

import arcpy
from arcpy import env

arcpy.CheckOutExtension('3D')
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
import exceptions, sys, traceback
from arcpy import env

try:
    # Obtain a license for the ArcGIS 3D Analyst extension
    arcpy.CheckOutExtension('3D')
    # Set environment settings
    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)

except arcpy.ExecuteError:
    print arcpy.GetMessages()
except:
    # Get the traceback object
    tb = sys.exc_info()[2]
    tbinfo = traceback.format_tb(tb)[0]
    # Concatenate error information into message string
    pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
          .format(tbinfo, str(sys.exc_info()[1]))
    msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
    # Return python error messages for script tool or Python Window
    arcpy.AddError(pymsg)
    arcpy.AddError(msgs)

Umgebung

Verwandte Themen

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Erfordert 3D Analyst
ArcGIS for Desktop Standard: Erfordert 3D Analyst
ArcGIS for Desktop Advanced: Erfordert 3D Analyst
9/11/2013