Разница поверхностей (3D Analyst)

Сводка

Вычисляет смещение между двумя поверхностями и идентифицирует поверхность, лежащую выше, ниже или совпадающую с базовой поверхностью.

Дополнительные сведения о работе инструмента Разность поверхностей

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

  • Выходные данные представляют перекрывающиеся участки входных поверхностей.

  • Выберите в качестве выходного набора данных растр или TIN, если вы хотите оценить разницу значений Z между входной и базовой поверхностью.

  • Лучше всего, если горизонтальная и вертикальная системы координат входных поверхностей одинаковы.

  • В выходном классе будут полигональные объекты, разделяющие регионы входной поверхности в зависимости от того, находятся ли они над, под базовой плоскостью или совпадают с ней. Атрибутивная таблица выходных объектов будет иметь следующие поля:

    • Volume – вычисленный объем между входной и базовой поверхностью, в пределах границ полигона. Если входная и базовая поверхности совпадают, значение объема будет равно 0.
    • SArea – площадь входной поверхности в пределах границ полигона.
    • Code – числовое значение, описывающее пространственное отношение между поверхностью и базовой плоскостью. Значение -1 указывает на то, что поверхность лежит ниже базовой плоскости, 0 – поверхность совпадает с базовой плоскостью, а 1 говорит о том, что поверхность лежит выше базовой плоскости.

Синтаксис

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)
ParameterОбъяснениеТип данных
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. Полученные точки можно использовать для построения триангулированной поверхности.

  • CLOSEST_TO_MEANБудет использована точка LAS, значение которой является ближайшим к среднему значению для всех точек LAS в окне анализа. Используется по умолчанию.
  • MINТочка LAS с наименьшим z-значением среди всех точек LAS в окне анализа.
  • MAXТочка LAS с наибольшим z-значением среди всех точек LAS в окне анализа.
String
reference_method

Метод, использующийся для выбора точки LAS в каждом окне анализа при применении разрешения анализа для прореживания входной поверхности набора LAS. Полученные точки можно использовать для построения триангулированной поверхности.

  • CLOSEST_TO_MEANБудет использована точка LAS, значение которой является ближайшим к среднему значению для всех точек LAS в окне анализа. Используется по умолчанию.
  • MINТочка LAS с наименьшим z-значением среди всех точек LAS в окне анализа.
  • MAXТочка LAS с наибольшим z-значением среди всех точек LAS в окне анализа.
String
extent
(Дополнительный)

Указывает экстент данных, который будет обработан этим инструментом.

Extent
boundary

Полигональный объект, определяющий область интереса, которая будет обрабатываться этим инструментом.

Feature Layer

Пример кода

SurfaceDifference, пример 1 (Окно Python)

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

arcpy.env.workspace = "C:/data"
arcpy.SurfaceDifference_3d("sample.gdb/lidar/terrain", "flood_tin", "surface_diff.shp")
SurfaceDifference, пример 2 (автономный скрипт)

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

'''****************************************************************************
Name: SurfaceDifference Example
Description: This script demonstrates how to use the
             SurfaceDifference tool.
****************************************************************************'''

# Import system modules
import arcpy

# Set environment settings
arcpy.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)

Информация о лицензиях

  • Basic: Требуется 3D Analyst
  • Standard: Требуется 3D Analyst
  • Advanced: Требуется 3D Analyst

Связанные разделы