Краткая информация
Вычисляет разницу объемов между двумя моделями поверхности, сохраненными в качестве нерегулярных триангуляционных сетей (TIN) или наборов данных terrain.
Дополнительные сведения о работе инструмента Разность поверхностей
Использование
- Выходные данные представляют участки перекрывающегося экстента с входных поверхностей.
 Треугольники первой поверхности классифицируются, как находящиеся полностью над или под второй (базовой) поверхностью, либо как пересекающиеся с ней.
- Дополнительно для отображения результата можно создать выходной растр или один или несколько наборов данных TIN.
 Если требуется выходной растр разницы, инструмент преобразует TIN интегрированной разницы, которая была вычислена в процессе геометрического сравнения, в растр с использованием линейной интерполяции.
- Лучше всего, если горизонтальная и вертикальная системы координат входных поверхностей одинаковы.
 
Синтаксис
SurfaceDifference_3d (in_surface, in_reference_surface, out_feature_class, {pyramid_level_resolution}, {reference_pyramid_level_resolution}, {raster_cell_size}, {out_raster}, {out_tin_folder}, {out_tin_basename})| Параметр | Объяснение | Тип данных | 
in_surface  | Входной набор данных terrain или TIN.  | Terrain Layer; TIN Layer | 
in_reference_surface  | Базовый набор данных terrain или TIN.  | Terrain Layer; TIN Layer | 
out_feature_class  | Выходной класс объектов, в котором содержатся непрерывные треугольники и части треугольников с одинаковой классификацией, сгруппированные в полигоны. Разница объемов для каждого из участков перечислена в таблице атрибутов.  | Feature Class | 
pyramid_level_resolution (дополнительно)  | Уровень пирамидных слоев входного набора данных terrain. Значением по умолчанию является 0, полное разрешение.  | Double | 
reference_pyramid_level_resolution (дополнительно)  | Уровень пирамидных слоев базового набора данных terrain. Значением по умолчанию является 0, полное разрешение.  | Double | 
raster_cell_size (дополнительно)  | Размер ячейки выходного набора растровых данных.  | Double | 
out_raster (дополнительно)  | Выходной набор растровых данных разницы. Растр преобразуется из TIN интегрированной разницы с использованием метода линейной интерполяции.  | Raster Dataset | 
out_tin_folder (дополнительно)  | Расположение папки для записи данных TIN.  | Folder | 
out_tin_basename (дополнительно)  | Базовое имя для каждой поверхности выходной TIN. Если один набор данных TIN не достаточен для представления данных, создается последовательность наборов данных TIN с тем же базовым именем.  | String | 
Пример кода
SurfaceDifference, пример 1 (Окно Python)
В следующем примере показано использование этого инструмента в окне Python.
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.SurfaceDifference_3d("sample.gdb/featuredataset/terrain", "sample.gdb/featuredataset/terrain2", "surface_diff.shp")
SurfaceDifference, пример 2 (автономный скрипт)
В следующем примере показано использование этого инструмента в автономном скрипте Python.
'''****************************************************************************
Name: SurfaceDifference Example
Description: This script demonstrates how to use the 
             SurfaceDifference tool.
****************************************************************************'''
# Import system modules
import arcpy
from arcpy import env
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# Set environment settings
env.workspace = "C:/data"
# Set Local Variables
inSurface = "flood_tin"
inReference = "elev_tin"
# Ensure output name is unique
outPoly = arcpy.CreateUniqueName("difference.shp")
#Execute SurfaceDifference
arcpy.SurfaceDifference_3d(inSurface, inReference, outPoly)
del arcpy, inSurface, inReference, outPoly
Параметры среды
- Текущая рабочая область (Current Workspace)
 - Временная рабочая область (Scratch Workspace)
 - Экстент (Extent)
 - Выходная система координат (Output Coordinate System)
 - Географические преобразования (Geographic Transformations)
 - Разрешение XY (XY Resolution)
 - Допуск XY (XY Tolerance)
 - Выходной XY домен (Output XY Domain)
 - Выходное ключевое слово CONFIG (Output CONFIG Keyword)
 - Автоподтверждение (Auto Commit)
 - Использование памяти Terrain (Terrain Memory Usage)
 
Информация о лицензировании
- ArcGIS for Desktop Basic: Требует 3D Analyst
 - ArcGIS for Desktop Standard: Требует 3D Analyst
 - ArcGIS for Desktop Advanced: Требует 3D Analyst