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

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

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

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

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

Иллюстрация

OutRas = FocalFlow(InRas1)

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

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

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

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

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входная растровая поверхность	Входной растр поверхности, для которого будет рассчитан фокальный сток. Для определения стока оцениваются восемь ячеек, расположенных в ближайшей окрестности от анализируемой ячейки. Входной растр может быть целочисленным, или он может быть представлен числами с плавающей точкой.	Raster Layer
Пороговое значение (Дополнительный)	Устанавливает пороговое значение, которое должно быть достигнуто или превышено до того, как может возникнуть сток. Пороговое значение может быть представлено целым числом или числом с плавающей точкой. Если разница между значением соседней ячейки и значением обрабатываемой ячейки меньше или равна пороговому значению, выходным значением будет 0 (или нет значения).	Double

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

Подпись	Описание	Тип данных
Выходной растр	Выходной растр фокального стока. Выходной растр всегда будет целочисленным.	Raster

Python

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")

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

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

Особые случаи

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

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