Объем для поверхности (Инструменты 3D Analyst)

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

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

Иллюстрация

Иллюстрация инструмента Объем поверхности

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

Используйте параметр Коэффициент Z для обеспечения точности вычисления объема, когда значения z для поверхности выражены в единицах измерения, отличных от единиц измерения x,y. Параметр Коэффициент Z не влияет на исходные данные. Инструмент автоматически определяет соответствующее значение коэффициена z при задании систем координат x, y и z.

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


Набор данных	Высота плоскости	Ссылки	Коэффициент Z	2D площадь	3D площадь	Объем
C:\data\tin	100.00	Над	1	15984467.82	16354331.40	1886012931.05
C:\data\raster.tif	250.5	Под	3.28084	0	0	0
C:\data.gdb\fd\terrain	1250	Над	0.3048	1854238.36	1970550.88	1099221466.89

Если область для вычислений не имеет прямоугольного экстента, используйте полигон для задания области. Затем используйте инструмент Объем полигона для вычислений.
Растровая поверхность оценивается с использованием экстента центральной точки каждой ячейки, в противоположность экстенту всей площади ячейки. В готовом анализе область данных растра будет уменьшена на половину ячейки, по сравнению с областью данных, отображаемой для этого растра.

Подпись	Объяснение	Тип данных
Входная поверхность	Растр, поверхность TIN или terrain, которые будут обработаны.	Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
Выходной текстовой файл (Дополнительный)	Текстовой ASCII-файл с разделителями-запятыми, содержащий вычисления площади и объема. Если файл уже существует, результаты будут добавлены в него.	File
Базовая плоскость (Дополнительный)	Задает направление с базовой плоскости, в котором вычисляются результаты. Above the Plane–Volume and area calculations will represent the region of space between the specified plane height and the portions of the surface that are above the plane. This is the default. Below the Plane–Volume and area calculations will represent the region of space between the specified plane height and the portions of the surface that are below the plane.	String
Высота плоскости (Дополнительный)	Z-значение плоскости, которая будет использоваться для вычисления площади и объема.	Double
Коэффициент Z (Дополнительный)	Коэффициент, на который будут умножаться z-значения. Этот способ обычно используется при конвертации линейных z-единиц для соответствия линейным единицам x,y. Значение по умолчанию равно 1, при нем значения высоты не изменяются. Этот параметр не доступен, если пространственная привязка входной поверхности имеет z-датум с заданными линейными единицами измерения.	Double
Уровень пирамидных слоев (Дополнительный)	Z-допуск или разрешение размера окна для уровня пирамидных слоев Terrain, которое будет использоваться. Значением по умолчанию является 0, полное разрешение.	Double

arcpy.3d.SurfaceVolume(in_surface, {out_text_file}, {reference_plane}, {base_z}, {z_factor}, {pyramid_level_resolution})

Имя	Объяснение	Тип данных
in_surface	Растр, поверхность TIN или terrain, которые будут обработаны.	Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer
out_text_file (Дополнительный)	Текстовой ASCII-файл с разделителями-запятыми, содержащий вычисления площади и объема. Если файл уже существует, результаты будут добавлены в него.	File
reference_plane (Дополнительный)	Задает направление с базовой плоскости, в котором вычисляются результаты. `ABOVE`–Volume and area calculations will represent the region of space between the specified plane height and the portions of the surface that are above the plane. This is the default. `BELOW`–Volume and area calculations will represent the region of space between the specified plane height and the portions of the surface that are below the plane.	String
base_z (Дополнительный)	Z-значение плоскости, которая будет использоваться для вычисления площади и объема.	Double
z_factor (Дополнительный)	Коэффициент, на который будут умножаться z-значения. Этот способ обычно используется при конвертации линейных z-единиц для соответствия линейным единицам x,y. Значение по умолчанию равно 1, при нем значения высоты не изменяются. Этот параметр не доступен, если пространственная привязка входной поверхности имеет z-датум с заданными линейными единицами измерения.	Double
pyramid_level_resolution (Дополнительный)	Z-допуск или разрешение размера окна для уровня пирамидных слоев Terrain, которое будет использоваться. Значением по умолчанию является 0, полное разрешение.	Double

Пример кода

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

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

arcpy.env.workspace = "C:/data"
arcpy.ddd.SurfaceVolume("sample.gdb/featuredataset/terrain", "surf_vol.txt",
                       reference_plane="ABOVE", base_z=300, z_factor=3.24,
                       pyramid_level_resolution=5)

SurfaceVolume, пример 2 (автономный скрипт)

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

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

****************************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set Local Variables
inSurface = "elevation_tin"

# Run SurfaceVolume
result = arcpy.ddd.SurfaceVolume(inSurface, "", "ABOVE", "300", "1", "5")
print(result.getMessages())

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

Текущая рабочая область

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

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