Насыпи/Выемки (Spatial Analyst)

Доступно с лицензией Spatial Analyst.

Доступно с лицензией 3D Analyst.

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

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

Более подробно об инструменте Насыпи/Выемки

Иллюстрация

OutRas = CutFill(Before_Ras, After_Ras)

Когда выполняется операция Насыпи/Выемки, по умолчанию к слою применяется специализированный метод отображения, который выделяет места насыпи или выемки. Определитель находится в таблице атрибутов выходного растра, которая учитывает положительный объем там, где материал был удален (участкам выемок), а отрицательный объем соответствует участкам, где материал был добавлен (участкам насыпей).

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

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

• Обе входные растровые поверхности должны быть совпадающими. Это означает, что у них должна быть одна и та же начальная точка, одинаковое число строк и столбцов ячеек и один и тот же размер ячеек.

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

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

• Таблица атрибутов выходного растра представляет изменения в объемах поверхности, вычисленные в результате выполнения операции Насыпи/Выемки. Положительные значения в разнице объемов указывают на участки растра "до события", где была проведена выемка материала. Отрицательные значения указывают на участки, на которые материал был добавлен (участки насыпей).

  Более подробно о том, производятся вычисления, см. в разделе Как работает инструмент Насыпи/Выемки.

• Когда операция Насыпи/Выемки запускается через инструмент, по умолчанию применяется специализированная шкала, которая выделяет участки насыпей и выемок. В соответствии с этой шкалой участки выемок отображаются синим цветом, а участки насыпей – красным цветом. Участки, которые не изменились, будут показаны серым цветом.

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

• См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

Диалог

Подпись	Описание	Тип данных
Входные данные поверхности растра перед	Входные данные, представляющие поверхность перед операцией Насыпи/Выемки.	Raster Layer
Входные данные поверхности растра после	Входные данные, представляющие поверхность после операции Насыпи/Выемки.	Raster Layer
Z коэффициент (Дополнительный)	Количество единиц x,y в одной единице поверхности z. Коэффициент z приводит в соответствие единицы измерения 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

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

Подпись	Описание	Тип данных
Выходной растр	Выходной растр, определяющий регионы для насыпей и выемок. Значения показывают местоположения на поверхности, где зафиксированы изменения и объём насыпи или выемки.	Raster

Python

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-значений в том случае, если они отличаются от единиц измерения координат 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

Пример кода

CutFill пример 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")

CutFill пример 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

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

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

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

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

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

• Basic: Обязательно Spatial Analyst или 3D Analyst
• Standard: Обязательно Spatial Analyst или 3D Analyst
• Advanced: Обязательно Spatial Analyst или 3D Analyst