Фокальный сток (Spatial Analyst)

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

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

Определяет сток значений на входном растре в непосредственной окрестности каждой ячейки.

Более подробно о том, как работает инструмент Фокальный сток

Иллюстрация

Иллюстрация инструмента Фокальный сток
OutRas = FocalFlow(InRas1)

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

  • Для определения стока инструмент Фокальный сток оценивает восемь соседних ячеек в ближайшей окрестности каждой ячейки.

  • Результирующие значения этого инструмента измеряют сток в ячейку, а не из ячейки.

  • Выходные значения извлекаются из бинарного представления результатов анализа.

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

Параметры

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

Входной растр поверхности, для которого будет рассчитан фокальный сток.

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

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

Raster Layer
Пороговое значение
(Дополнительный)

Устанавливает пороговое значение, которое должно быть достигнуто или превышено до того, как может возникнуть сток.

Пороговое значение может быть представлено целым числом или числом с плавающей точкой.

Если разница между значением соседней ячейки и значением обрабатываемой ячейки меньше или равна пороговому значению, выходным значением будет 0 (или нет значения).

Double

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

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

Выходной растр фокального стока.

Выходной растр всегда будет целочисленным.

Raster

FocalFlow(in_surface_raster, {threshold_value})
ИмяОписаниеТип данных
in_surface_raster

Входной растр поверхности, для которого будет рассчитан фокальный сток.

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

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

Raster Layer
threshold_value
(Дополнительный)

Устанавливает пороговое значение, которое должно быть достигнуто или превышено до того, как может возникнуть сток.

Пороговое значение может быть представлено целым числом или числом с плавающей точкой.

Если разница между значением соседней ячейки и значением обрабатываемой ячейки меньше или равна пороговому значению, выходным значением будет 0 (или нет значения).

Double

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

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

Выходной растр фокального стока.

Выходной растр всегда будет целочисленным.

Raster

Пример кода

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

В этом примере определяется бинарное представление стока для входного растра с пороговым значением 10.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
focalFlowOut = FocalFlow("elevation", 10)
focalFlowOut.save("C:/sapyexamples/output/flowout")
FocalFlow, пример 2 (автономный скрипт)

В этом примере определяется бинарное представление стока для входного растра с пороговым значением 5.

# Name: FocalFlow_Ex_02.py
# Description: Determines the flow of the values in the 
#    input raster within each cell's immediate neighborhood.
# 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
inRaster = "elevation"
threshold = 5 

# Execute FocalFlow
outFocalFlow = FocalFlow(inRaster, threshold)

# Save the output 
outFocalFlow.save("C:/sapyexamples/output/focalflow")

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

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

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