Справка

Фокальный сток

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

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

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

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

Рисунок

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

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

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

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

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

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

Синтаксис

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 

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

# Execute FocalFlow
outFocalFlow = FocalFlow(inRaster, threshold)

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

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

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

Отзыв по этому разделу?