Разница 3D—Справка

Краткая информация
Рисунок
Использование
Синтаксис
Пример кода
Параметры среды
Информация о лицензировании

Краткая информация

Исключает участки объектов-мультипатч в целевом классе объектов, которые перекрываются значениями объектов-мультипатч в классе вычитаемых пространственных объектов.

Рисунок

Использование

Для такого анализа требуется замкнутая геометрия мультипатч. Инструмент Замкнутые 3D можно использовать, чтобы определить, содержит ли класс объектов-мультипатчей замкнутые объекты. А инструмент Замкнуть мультипатч (Enclose Multipatch) можно использовать для устранения разрывов в объектах-мультипатчей.
Входные объекты, которые целиком попадают в вычитаемые объекты, будут полностью удалены на выходе.
Работа этого инструмента может занять много времени, поэтому следует внимательно выбирать входные наборы данных.
Выходные объекты не будут обладать атрибутами входных объектов. Если необходимо, может быть построено пространственное соединение к исходным пространственным объектам или класс отношений к дополнительной таблице для переноса атрибутов карты из входных пространственных объектов в выходной набор данных.
Этот инструмент – это оператор, предоставляющий аналитические функции для 3D объектов. Дополнительные сведения об операциях пересечения 3D объектов и их использовании см. в разделе Работа с операциями пересечения 3D объектов.

Синтаксис

Difference3D_3d (in_features_minuend, in_features_subtrahend, out_feature_class, {out_table})

Параметр	Объяснение	Тип данных
in_features_minuend	Объекты-мультипатч, из которых объекты будут удалены путем вычитания объектов.	Feature Layer
in_features_subtrahend	Объекты-мультипатч, которые будут вычитаться из входных.	Feature Layer
out_feature_class	Выходной класс объектов-мультипатч, который будет содержать результирующие объекты.	Feature Class
out_table (дополнительно)	Дополнительная таблица, которая хранит информацию об отношениях между входными пространственными объектами и разность выходных данных. В таблице присутствуют следующие поля: Output_ID – Идентификатор выходного объекта. Minuend_ID – Идентификатор входного объекта. Subtrahend – Идентификатор вычитаемого объекта.	Table

Пример кода

Difference3D пример 1 (окно Python)

В следующем примере показано использование этого инструмента в окне Python.

import arcpy
from arcpy import env

arcpy.CheckOutExtension('3D')
env.workspace = 'C:/data'
arcpy.Difference3D_3d('input_mp.shp', 'erase_mp.shp', 'difference_mp.shp')

Difference3D, пример 2 (автономный скрипт)

В следующем примере показано использование этого инструмента в автономном скрипте Python.

'''****************************************************************************
Name: Difference3D Example
Description: This script demonstrates how to create 
             shadow volumes that fall along a specified surface using the
             Difference3D 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
    inMP = 'buildings.shp'
    eraseMP = 'bldg_extensions.shp'
    outMP = arcpy.CreateUniqueName('bldgs_without_extensions.shp')
    # Execute Difference3D
    arcpy.Difference3D_3d(inMP, eraseMP, outMP)

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)