Разность поверхностей (Инструменты 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–The LAS point whose value is closest to the mean of all LAS points in the analysis window will be used. This is the default. Minimum–The LAS point with the smallest z-value among all the LAS points in the analysis window. Maximum–The LAS point with the highest z-value among all the LAS points in the analysis window.	String
Метод прореживания LAS	Метод, использующийся для выбора точки LAS в каждом окне анализа при применении разрешения анализа для прореживания входной поверхности набора LAS. Полученные точки можно использовать для построения триангулированной поверхности. Closest to mean–The LAS point whose value is closest to the mean of all LAS points in the analysis window will be used. This is the default. Minimum–The LAS point with the smallest z-value among all the LAS points in the analysis window. Maximum–The LAS point with the highest z-value among all the LAS points in the analysis window.	String
Экстент обработки (Дополнительный)	Эстент данных, который будет обработан. Текущий экстент отображения — Экстент будет основан на активной карте или сцене. Нарисовать экстент - Экстент будет основан на прямоугольнике, нарисованном на карте или в сцене. Экстент слоя — Экстент будет основан на активном слое карты. Выберите доступный слой или воспользуйтесь опцией Экстент данных во всех слоях. У каждого слоя карте есть следующие опции: Все объекты - Экстент всех объектов. Выбранные объекты - используйте экстент выбранных объектов. Отображаемые объекты - Экстент отображаемых объектов. Обзор — Экстент будет основан на наборе данных. Пересечение входных данных - Экстент будет основан на пересекающемся экстенте всех входных данных. Объединение входных данных - Экстент будет комбинацией экстентов всех входных данных. Буфер обмена - Экстент может быть скопирован в буфер обмена и вставлен из него. Копировать экстент - Копирует координаты экстента и систему координат в буфер обмена. Вставить экстент - Вставляет экстент и систему координат из буфера обмена. Если буфер обмена не содержит систему координат, экстент будет использовать систему координат карты. Сбросить экстент — Экстент будет сброшен до значения по умолчанию. Если координаты заданы вручную, они должны быть числовыми значениями в системе координат активной карты. На карте могут использоваться единицы отображения, отличные от введенных координат. Используйте знак отрицательного значения для координат юга и запада.	Extent
Граница обработки	Полигональный элемент или элементы, которые будут задавать обрабатываемую область.	Feature Layer

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)

Имя	Объяснение	Тип данных
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`–The LAS point whose value is closest to the mean of all LAS points in the analysis window will be used. This is the default. `MIN`–The LAS point with the smallest z-value among all the LAS points in the analysis window. `MAX`–The LAS point with the highest z-value among all the LAS points in the analysis window.	String
reference_method	Метод, использующийся для выбора точки LAS в каждом окне анализа при применении разрешения анализа для прореживания входной поверхности набора LAS. Полученные точки можно использовать для построения триангулированной поверхности. `CLOSEST_TO_MEAN`–The LAS point whose value is closest to the mean of all LAS points in the analysis window will be used. This is the default. `MIN`–The LAS point with the smallest z-value among all the LAS points in the analysis window. `MAX`–The LAS point with the highest z-value among all the LAS points in the analysis window.	String
extent (Дополнительный)	Эстент данных, который будет обработан. `MAXOF` – Будет использоваться максимальный экстент всех входных данных. `MINOF` – Будет использоваться минимальная область, которая является общей для всех входных данных. `DISPLAY` — Экстент равен видимому отображению. Имя слоя — Будет использоваться экстент указанного слоя. `Extent` Объект — будет использоваться экстент указанного объекта. Строка координат, разделенная пробелами – Будет использоваться экстент указанной строки. Координаты выражаются в порядке x-мин, y-мин, x-макс, y-макс.	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")

# Run SurfaceDifference
arcpy.ddd.SurfaceDifference(inSurface, inReference, outPoly)

Параметры среды

Текущая рабочая область, Экстент, Выходная система координат, Географические преобразования, Разрешение XY, Допуск XY, Выходной XY домен, Выходное ключевое слово конфигурации, Автоподтверждение, Минимизировать ресурсы памяти, используемые в процессе анализа terrain.

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

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