Инструмент Насыпи/выемки (Cut Fill) (Spatial Analyst)

Уровень лицензии:BasicStandardAdvanced

Резюме

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

Более подробно об инструменте Насыпи/выемки (Cut Fill)

Рисунок

Иллюстрация инструмента Насыпи/выемки (Cut Fill)
OutRas = CutFill(Before_Ras, After_Ras)
Иллюстрация полей инструмента Насыпи/выемки (Cut Fill)
При выполнении операции Насыпи/Выемки, по умолчанию к слою применяется специализированная шкала, которая позволяет выделить участки насыпей и участки выемок. Определяющий фактор - это таблица атрибутов выходного растра, которая рассматривает положительный объем как участки, где была произведена выемка (удаление) материала, а отрицательный объем - как участки, где материал был насыпан (добавлен).

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

Синтаксис

CutFill (in_before_surface, in_after_surface, {z_factor})
ПараметрОбъяснениеТип данных
in_before_surface

Входная поверхность "до".

Raster Layer
in_after_surface

Входная поверхность "после".

Raster Layer
z_factor
(дополнительно)

Количество наземных единиц измерения координат x,y в одной единице измерения z-значения поверхности.

Коэффициент z (z-factor) приводит в соответствие единицы измерения z-значений в том случае, если они отличаются от единиц измерения координат x,y входной поверхности. При вычислении результирующей выходной поверхности z-значения входной поверхности умножаются на коэффициент по z.

Если координаты x,y и z-значения приведены в одной и той же системе координат, коэффициент z равен 1. Это значение используется по умолчанию.

Если координаты x,y и z-значения приведены в отличающихся единицах измерения, для коэффициента по z должно быть задано соответствующее значение, или же результаты будут некорректными. Например, если единицы измерения для z-значений – футы, а координаты x,y приведены в метрах, для преобразования z-значений из футов в метры вы должны использовать коэффициент по z, равный 0,3048 (1 фут = 0,3048 метра).

Double

Возвращено значение

ИмяОбъяснениеТип данных
out_raster

Выходной растр, определяющий регионы для насыпей и выемок.

Значения показывают местоположения на поверхности, где зафиксированы изменения и объём насыпи или выемки.

Raster

Пример кода

Насыпи/Выемки. Пример 1 (окно Python)

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCutFill = CutFill("elevation01", "elevation02", 1)
outCutFill.save("C:/sapyexamples/output/outcutfill01")
Насыпи/Выемки. Пример 2 (автономный скрипт)

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

# Name: Cutfill_Ex_02.py
# Description: Calculates the volume and area of cut and 
#              fill locations.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

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

# Set local variables
inBeforeRaster = "elevation01"
inAfterRaster =  "elevation02"
zFactor = 0.5

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute CutFill
outCutFill = CutFill(inBeforeRaster, inAfterRaster, zFactor)

# Save the output 
outCutFill.save("C:/sapyexamples/output/outcutfill02")

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

Связанные темы

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

ArcGIS for Desktop Basic: Требует Spatial Analyst или 3D Analyst
ArcGIS for Desktop Standard: Требует Spatial Analyst или 3D Analyst
ArcGIS for Desktop Advanced: Требует Spatial Analyst или 3D Analyst
9/11/2013