Сводка
Вычисляет смещение между двумя поверхностями и идентифицирует поверхность, лежащую выше, ниже или совпадающую с базовой поверхностью.
Дополнительные сведения о работе инструмента Разность поверхностей
Использование
Выходные данные представляют перекрывающиеся участки входных поверхностей.
Выберите в качестве выходного набора данных растр или TIN, если вы хотите оценить разницу значений Z между входной и базовой поверхностью.
Лучше всего, если горизонтальная и вертикальная системы координат входных поверхностей одинаковы.
В выходном классе будут полигональные объекты, разделяющие регионы входной поверхности в зависимости от того, находятся ли они над, под базовой плоскостью или совпадают с ней. Атрибутивная таблица выходных объектов будет иметь следующие поля:
- Volume – вычисленный объем между входной и базовой поверхностью, в пределах границ полигона. Если входная и базовая поверхности совпадают, значение объема будет равно 0.
- SArea – площадь входной поверхности в пределах границ полигона.
- Code – числовое значение, описывающее пространственное отношение между поверхностью и базовой плоскостью. Значение -1 указывает на то, что поверхность лежит ниже базовой плоскости, 0 – поверхность совпадает с базовой плоскостью, а 1 говорит о том, что поверхность лежит выше базовой плоскости.
Синтаксис
arcpy.ddd.SurfaceDifference(in_surface, in_reference_surface, out_feature_class, {pyramid_level_resolution}, {reference_pyramid_level_resolution}, {out_raster}, {raster_cell_size}, {out_tin_folder}, {out_tin_basename}, method, reference_method, {extent}, boundary)| Параметр | Объяснение | Тип данных |
in_surface | Триангулированная поверхность, относительное смещение которой от базовой поверхности вычисляется. | LAS Dataset Layer; Terrain Layer; TIN Layer |
in_reference_surface | Триангулированная поверхность, которая будет использоваться в качестве основы определения относительного смещения входной поверхности. | LAS Dataset Layer; Terrain Layer; TIN Layer |
out_feature_class | Выходной класс объектов, в котором содержатся непрерывные треугольники и части треугольников с одинаковой классификацией, сгруппированные в полигоны. Разница объемов для каждого из участков перечислена в таблице атрибутов. | Feature Class |
pyramid_level_resolution (Дополнительный) | Разрешение, которое будет использоваться для создания входной поверхности. Для набора данных Terrain это соответствует определениям пирамидных слоев, где 0 соответствует полному разрешению. Для набора данных LAS это значение соответствует длине каждой стороны квадрата, используемого для прореживания точек LAS. | Double |
reference_pyramid_level_resolution (Дополнительный) | Разрешение, которое будет использоваться для создания базовой поверхности. Для набора данных Terrain это соответствует определениям пирамидных слоев, где 0 соответствует полному разрешению. Для набора данных LAS это значение соответствует длине каждой стороны квадрата, используемого для прореживания точек LAS. | Double |
out_raster (Дополнительный) | Выходная растровая поверхность, значений которой представляют входную поверхность, нормированную по отношению к базовой поверхности. Положительные значения обозначают области, в которых входная поверхность расположена выше базовой поверхности, а отрицательные ― области, в которых входная поверхность расположена ниже базовой. Значения растра получены из поверхности TIN с использованием линейной интерполяции. | Raster Dataset |
raster_cell_size (Дополнительный) | Размер ячейки выходного растра. | Double |
out_tin_folder (Дополнительный) | Папка для хранения одного или нескольких поверхностей TIN, значения которых отображают разницу между входной и базовой поверхностями. | Folder |
out_tin_basename (Дополнительный) | Базовое имя для каждой поверхности выходной TIN. Если один набор данных TIN не достаточен для представления данных, создается последовательность наборов данных TIN с тем же базовым именем. | String |
method | Метод, использующийся для выбора точки LAS в каждом окне анализа при применении разрешения анализа для прореживания входной поверхности набора LAS. Полученные точки можно использовать для построения триангулированной поверхности.
| String |
reference_method | Метод, использующийся для выбора точки LAS в каждом окне анализа при применении разрешения анализа для прореживания входной поверхности набора LAS. Полученные точки можно использовать для построения триангулированной поверхности.
| String |
extent (Дополнительный) | Указывает экстент данных, который будет обработан этим инструментом. | Extent |
boundary | Полигональный объект, определяющий область интереса, которая будет обрабатываться этим инструментом. | Feature Layer |
Пример кода
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
Параметры среды
Информация о лицензиях
- Basic: Требуется 3D Analyst
- Standard: Требуется 3D Analyst
- Advanced: Требуется 3D Analyst