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

Сводка

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

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

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

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

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

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

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

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

Синтаксис

arcpy.3d.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
(Дополнительный)

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

  • MAXOF - будет использоваться максимальный экстент всех входных данных.
  • MINOF - будет использоваться минимальная область, общая для всех входных данных.
  • DISPLAY– экстент будет равен видимому отображению.
  • Имя слоя - будет использоваться тот же экстент, что и в указанном слое.
  • Объект Extent - будет использоваться тот же экстент, что и в указанном объекте.
  • Строка координат, разделенных пробелами – будет использоваться экстент из заданной строки. Координаты должны быть выражены в таком порядке: x-min, y-min, x-max, y-max.
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

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