Краткая информация
Вычисляет объем и площадь поверхности между полигоном и набором данных Terrain или поверхностью TIN.
Использование
Вычисления возможны только для частей входных полигонов и поверхностей TIN или набора данных Terrain, которые перекрываются.
Границы каждого полигона сначала пересекаются с зоной интерполяции поверхности. Это позволяет определить общие для них участки. Затем вычисляется объем и площадь поверхности для всех треугольников, а также их частей, которые попадают в пределы пересекающего полигона.
Объем представляет собой область между поверхностью и пространством, находящимся выше или ниже полигональных объектов на основе выборки, сделанной в параметре Базовая плоскость (Reference Plane):
- Вычислить над поверхностью (Calculate above the plane) – Вычисляется объем между плоскостью и нижней частью поверхности.
- Вычислить под поверхностью (Calculate below the plane) – Вычисляется объем между плоскостью и верхней частью поверхности. Также вычисляется площадь для данного участка поверхности.
Синтаксис
PolygonVolume_3d (in_surface, in_feature_class, in_height_field, {reference_plane}, {out_volume_field}, {surface_area_field}, {pyramid_level_resolution})| Параметр | Объяснение | Тип данных |
in_surface | Поверхность terrain или TIN, которая будет обрабатываться. | Tin Layer; Terrain Layer |
in_feature_class | Полигональные объекты, определяющие обрабатываемые области поверхности. | Feature Layer |
in_height_field | Поле в таблице атрибутов полигона, определяющее высоту базового плана, используемого при вычислениях объема. | String |
reference_plane (дополнительно) | Определяет способ вычисления объема и площади поверхности.
| String |
out_volume_field (дополнительно) | Указывается имя поля, которое содержит расчет объема. По умолчанию – Volume. | String |
surface_area_field (дополнительно) | Указывается имя поля, которое содержит расчет объема поверхности. По умолчанию – SArea. | String |
pyramid_level_resolution (дополнительно) | z-допуск или разрешение размера окна для уровня пирамидных слоев Terrain, которое будет использоваться этим инструментом. Значением по умолчанию является 0, полное разрешение. | Double |
Пример кода
PolygonVolume, пример 1 (окно Python)
В следующем примере показано использование этого инструмента в окне Python.
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.PolygonVolume_3d("sample.gdb/featuredataset/terrain", "polygon.shp", "<None>", "ABOVE", "Volume", "SArea", "5")
PolygonVolume, пример 2 (автономный скрипт)
В следующем примере показано использование этого инструмента в автономном скрипте Python.
'''****************************************************************************
Name: PolygonVolume Example
Description: This script demonstrates how to use the
PolygonVolume tool.
****************************************************************************'''
# Import system modules
import arcpy
from arcpy import env
# Obtain a license for the ArcGIS 3D Analyst extension
arcpy.CheckOutExtension("3D")
# Set environment settings
env.workspace = "C:/data"
# Set Local Variables
inSurface = "sample.gdb/featuredataset/terrain"
inPoly = "floodplain_100.shp"
zField = "Height"
refPlane = "BELOW"
volFld = "Volume"
sAreaFld = "SArea"
#Execute PolygonVolume
arcpy.PolygonVolume_3d(inSurface, inPoly, zField, refPlane, volFld, sAreaFld)
Параметры среды
Информация о лицензировании
- ArcGIS for Desktop Basic: Требует 3D Analyst
- ArcGIS for Desktop Standard: Требует 3D Analyst
- ArcGIS for Desktop Advanced: Требует 3D Analyst