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

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

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

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

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

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

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входная поверхность

Триангулированная поверхность, относительное смещение которой от базовой поверхности вычисляется.

LAS Dataset Layer; Terrain Layer; TIN Layer
Базовая поверхность

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

LAS Dataset Layer; Terrain Layer; TIN Layer
Выходной класс объектов

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

Feature Class
Разрешение анализа
(Дополнительный)

Разрешение, которое будет использоваться для создания входной поверхности. Для набора данных Terrain это соответствует определениям пирамидных слоев, где 0 соответствует полному разрешению. Для набора данных LAS это значение соответствует длине каждой стороны квадрата, используемого для прореживания точек LAS.

Double
Разрешение анализа
(Дополнительный)

Разрешение, которое будет использоваться для создания базовой поверхности. Для набора данных Terrain это соответствует определениям пирамидных слоев, где 0 соответствует полному разрешению. Для набора данных LAS это значение соответствует длине каждой стороны квадрата, используемого для прореживания точек LAS.

Double
Выходной растр
(Дополнительный)

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

Raster Dataset
Размер ячейки растра
(Дополнительный)

Размер ячейки выходного растра.

Double
Выходная папка TIN
(Дополнительный)

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

Folder
Выходное базовое имя TIN
(Дополнительный)

Базовое имя для каждой поверхности выходной TIN. Если один набор данных TIN не достаточен для представления данных, создается последовательность наборов данных TIN с тем же базовым именем.

String
Метод прореживания LAS

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

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

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

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

Экстент данных, который будет оцениваться.

  • Текущий экстент отображения Current Display Extent — Экстент будет основан на активной карте или сцене. Эта опция доступна только при наличии активной карты.
  • Нарисовать экстент Draw Extent - экстент будет основан прямоугольнике, нарисованном на карте или сцене. Эта опция создает класс пространственных объектов в базе геоданных проекта и добавляет слой на карту. Класс объектов будет иметь ту же систему координат, что и карта.
    Примечание:

    Данная опция не доступна в диалоговом окне Параметры среды. Он доступен только из параметра инструмента, с экстентом в качестве типа данных, или на вкладке Параметры среды диалогового окна инструмента.

    Примечание:

    Если включена опция Включать и отключать редактирование на вкладке Редактирование, вы должны включить редактирование на вкладке ленты Редактирование, чтобы нарисовать экстент.

  • Экстент слоя Layer — Экстент будет основан на активном слое карты. Используйте раскрывающийся список, чтобы выбрать доступный слой, или используйте опцию Экстент данных во всех слоях, чтобы получить объединенный экстент всех активных слоев карты, за исключением базовой карты. Эта опция доступна только при наличии активной карты со слоями.

    У каждого слоя карте есть следующие опции:

    • Все объекты Select All - экстент всех объектов слоя.
    • Выбранные объектыArea from Selected Features - экстент всех выбранных объектов слоя.
    • Отображаемые объекты Extent Indicator - экстент всех отображаемых объектов слоя.
      Примечание:

      Экстенты опций Выбранные объекты Area from Selected Features и Отображаемые объекты Extent Indicator доступны только для векторных слоев.

  • Обзор Browse — Экстент будет основан на существующем наборе данных.
  • Пересечение входных данных Intersect — Экстент будет основан на минимальном или пересекающемся экстенте всех входных данных. Если никакие входные данные не перекрываются, получится пустой экстент со всеми нулями.
  • Объединение входных данных Union — Экстент будет основан на максимальном или объединенном экстенте всех входных данных.
  • Буфер обмена Paste - экстент может быть скопирован в буфер обмена и из него.
    • Копировать экстент Copy - копирует координаты экстента и систему координат в буфер обмена.
    • Вставить экстент Paste - вставляет координаты экстента и, дополнительно, систему координат из буфера обмена. Если значения буфера обмена не содержат систему координат, экстент будет использовать систему координат карты.
    Примечание:

    Координаты экстента копируются в буфер обмена и вставляются из него с использованием того же форматирования и порядка, что и для объекта ArcPy Extent: x-min, y-min, x-max, y-max и пространственная привязка.

  • Сбросить экстент Reset — Экстент будет сброшен до значения по умолчанию.
  • Координаты, введенные вручную – Координаты должны быть числовыми значениями и находиться в системе координат активной карты.
    Внимание:

    На карте могут использоваться единицы отображения, отличные от введенных координат. Использование направления по сторонам света (N, S, E, W) не поддерживается. Используйте знак отрицательного значения для координат юга и запада.

Extent
Обработка границ

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

Feature Layer

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

  • 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.ddd.SurfaceDifference("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.ddd.SurfaceDifference(inSurface, inReference, outPoly)

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