Насыпи/Выемки (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-коэффициент 0.3048, чтобы конвертировать z из футов в метры (1 фут = 0.3048 метра).

Double

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

ПодписьОписаниеТип данных
Выходной растр

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

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

Raster

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-коэффициент 0.3048, чтобы конвертировать z из футов в метры (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")

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

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

Связанные разделы