Найти понижения (Инструменты Spatial Analyst)

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

Позволяет выявить области, которые лежат ниже окружающей местности, на основе пространственных характеристик.

Подробнее о работе инструмента Найти понижения

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

Значение параметра Входной растр поверхности (in_surface_raster в Python) может быть цифровой моделью рельефа (ЦМР). Внутренне понижения определяются на основе разницы между заполненной и исходной ЦМР.
Только понижения, соответствующие всем требованиям, заданным дополнительными параметрами анализа, будут включены в значение параметра Выходные полигоны понижений (out_depressions_polygons в Python).
Значение параметра Выходные точки соединений (out_connection_points в Python) включает в себя точку с самой низкой высотой в пределах понижения для всех понижений, включенных в значение параметра Выходные полигоны понижений.

Также будет включена точка соединения ниже по течению для каждого понижения, если указано значение параметра Максимальное расстояние до соединения (max_connection_distance в Python).
Указание значения параметра Единицы Z (z_unit в Python) обеспечивает правильный расчет глубины понижения.

Если единицы измерения z-значения имеются в вертикальной системе координат входного растра поверхности, то они будут применяться автоматически. Рекомендуется задать единицы z входного растра, если они отсутствуют. Вы можете использовать инструмент Определить проекцию для указания z-значений. Если значение не указано, по умолчанию будет использоваться метр.
Параметр Максимальное расстояние до соединения будет считать соединением ниже по течению ближайшую найденную ячейку, имеющую более низкую высоту, чем самая низкая ячейка в пределах понижения. Если этим критериям удовлетворяет несколько ячеек, будет возвращена первая найденная.
Параметр Максимальное расстояние до дорог (max_road_distance в Python) можно применить только в том случае, если указан параметр Входной растр или Объекты дорог (in_road_data в Python).
Единицы карты пространственной привязки значения параметра Входной растр поверхности используется для заполнения единиц по умолчанию для параметров Минимальная площадь, Максимальное расстояние до соединения и Максимальное расстояние до дорог. Если единица измерения, определенная значением параметра Входной растр поверхности, не совпадает ни с доступной единицей площади, ни с линейной единицей, то по умолчанию будут использоваться Квадратные метры и Метры, соответственно.
Этот инструмент поддерживает параллельную обработку. Если ваш компьютер имеет несколько процессоров или процессор с несколькими ядрами, то его производительность будет более высокой, особенно на больших наборах данных. Раздел справки Параллельная обработка с Spatial Analyst содержит более подробные сведения об этой возможности и способах ее настройки.

По умолчанию этот инструмент будет использовать до 50 процентов доступных ядер. Можно задавать число используемых инструментом ядер в среде Коэффициент параллельной обработки.
См. Параметры среды анализа и Spatial Analyst для получения дополнительной информации о параметрах среды геообработки, применимых к этому инструменту.

Подпись	Объяснение	Тип данных
Растр входной поверхности	Входной растр поверхности.	Raster Layer
Выходные полигоны понижений	Выходной класс объектов, который будет содержать идентифицированные понижения. Каждый полигон понижения имеет уникальный номер. В дополнительных полях таблицы атрибутов хранится специфическая информация о понижении. Это следующие поля: `AREA`—Площадь понижения в квадратных метрах. `VOLUME`—Объем понижения в кубических метрах. `DIST_CON`—Расстояние до точки соединения ниже по течению. Это поле будет создано только при условии указания параметра Максимальное расстояние до соединения . `DIST_ROAD`—Расстояние до ближайшей дороги в метрах. Это поле создается только в том случае, если для дополнительно входного параметра данных о дорогах указан набор данных.	Feature Class
Входной растр или объекты дорог (Дополнительный)	Дополнительный набор растровых данных или набор классов объектов, определяющий дороги. Дороги могут быть определены целочисленным растром или растром с плавающей точкой, либо точечным, линейным или полигональным объектом.	Raster Layer; Feature Layer
Выходные точки соединений (Дополнительный)	Дополнительные выходные точки, определяющие самую низкую точку в понижении и соответствующую точку соединения ниже по течению. Соединение ниже по течению определяется как ближайшая ячейка с высотой ниже самой низкой ячейки в пределах понижения. Точка соединения ниже по течению и связанные поля включаются в выходные данные только в том случае, если для параметра Максимальное расстояние до соединения указано значение. Каждая точка имеет уникальный номер. В дополнительных полях таблицы атрибутов хранится специфическая информация о точке. Это следующие поля: `DEP_ID`—Идентификатор понижения, с которым связана точка. `POINT_TYPE`—Указывает, является ли точка самой низкой точкой в понижении (= 0) или точкой соединения ниже по течению (= 1). `POINT_ELEV`—Высота точки. `DIST_EDGE`—Расстояние до границы понижения в метрах. `DIST_POINT`—Расстояние до соответствующей точки в метрах.	Feature Class
Минимальная глубина (Дополнительный)	Минимальная допустимая глубина для понижения. В итоговый результат не будут включены понижения с максимальной глубиной, меньшей этого значения. По умолчанию 0,05 метра или эквивалент в указанных z-единицах.	Linear Unit
Z-единицы (Дополнительный)	Задает линейные единицы измерения, которые будет использоваться для вертикальных z-значений. Они определяется вертикальной системой координат, если она указана. Если вертикальной системы координат нет, то единицы измерения z-значений необходимо указать в списке единиц, чтобы обеспечить точный геодезический расчет. По умолчанию метры. Дюйм–Линейными единицами измерения будут дюймы. Фут–Линейными единицами измерения будут футы. Футы США–Линейными единицами измерения будут геодезические футы США. Ярд–Линейными единицами измерения будут ярды. Мили США–Линейными единицами измерения будут геодезические мили США. Морская миля–Линейными единицами измерения будут морские мили. Миллиметр–Линейными единицами измерения будут миллиметры. Сантиметр–Линейными единицами измерения будут сантиметры. Метр–Линейными единицами измерения будут метры. Километр–Линейными единицами измерения будут километры. Дециметр–Линейными единицами измерения будут дециметры.	String
Минимальная площадь (Дополнительный)	Минимальная допустимая площадь для понижения. Площадь поверхности верхней части понижения. В итоговый результат не будут включены понижения с площадью, меньшей этого значения. По умолчанию общая площадь трех ячеек или эквивалент в квадратных единицах карты пространственной привязки для значения параметра Входной растр поверхности.	Areal Unit
Максимальное расстояние до соединения (Дополнительный)	Максимально допустимое расстояние от границы понижения до точки соединения ниже по течению. Соединение ниже по течению определяется как ближайшая ячейка с высотой ниже самой низкой ячейки в пределах понижения. Если расстояние до соединения ниже по течению больше этого значения, то понижение не будет включено в итоговый результат. Этот параметр будет применяться только в том случае, если для него указано значение.	Linear Unit
Максимальное расстояние до дорог (Дополнительный)	Максимально допустимое расстояние от границы понижения до ближайшей дороги. Если расстояние от понижения до дороги больше этого значения, оно не будет включено в итоговый результат. Параметр доступен только в том случае, если указано значение параметра Входной растр или Объекты дорог. По умолчанию 30 метров или эквивалент в единицах карты пространственной привязки для значения параметра Входной растр поверхности.	Linear Unit

LocateDepressions(in_surface_raster, out_depressions_polygons, {in_road_data}, {out_connection_points}, {min_depth}, {z_unit}, {min_area}, {max_connection_distance}, {max_road_distance})

Имя	Объяснение	Тип данных
in_surface_raster	Входной растр поверхности.	Raster Layer
out_depressions_polygons	Выходной класс объектов, который будет содержать идентифицированные понижения. Каждый полигон понижения имеет уникальный номер. В дополнительных полях таблицы атрибутов хранится специфическая информация о понижении. Это следующие поля: `AREA`—Площадь понижения в квадратных метрах. `VOLUME`—Объем понижения в кубических метрах. `DIST_CON`—Расстояние до точки соединения ниже по течению. Это поле будет создано только при условии указания параметра `max_connection_distance`. `DIST_ROAD`—Расстояние до ближайшей дороги в метрах. Это поле создается только в том случае, если для дополнительно входного параметра данных о дорогах указан набор данных.	Feature Class
in_road_data (Дополнительный)	Дополнительный набор растровых данных или набор классов объектов, определяющий дороги. Дороги могут быть определены целочисленным растром или растром с плавающей точкой, либо точечным, линейным или полигональным объектом.	Raster Layer; Feature Layer
out_connection_points (Дополнительный)	Дополнительные выходные точки, определяющие самую низкую точку в понижении и соответствующую точку соединения ниже по течению. Соединение ниже по течению определяется как ближайшая ячейка с высотой ниже самой низкой ячейки в пределах понижения. Точка соединения ниже по течению и связанные поля включаются в выходные данные только в том случае, если для параметра `max_connection_distance`. Каждая точка имеет уникальный номер. В дополнительных полях таблицы атрибутов хранится специфическая информация о точке. Это следующие поля: `DEP_ID`—Идентификатор понижения, с которым связана точка. `POINT_TYPE`—Указывает, является ли точка самой низкой точкой в понижении (= 0) или точкой соединения ниже по течению (= 1). `POINT_ELEV`—Высота точки. `DIST_EDGE`—Расстояние до границы понижения в метрах. `DIST_POINT`—Расстояние до соответствующей точки в метрах.	Feature Class
min_depth (Дополнительный)	Минимальная допустимая глубина для понижения. В итоговый результат не будут включены понижения с максимальной глубиной, меньшей этого значения. По умолчанию 0,05 метра или эквивалент в указанных z-единицах.	Linear Unit
z_unit (Дополнительный)	Задает линейные единицы измерения, которые будет использоваться для вертикальных z-значений. Они определяется вертикальной системой координат, если она указана. Если вертикальной системы координат нет, то единицы измерения z-значений необходимо указать в списке единиц, чтобы обеспечить точный геодезический расчет. По умолчанию метры. `INCH`–Линейными единицами измерения будут дюймы. `FOOT`–Линейными единицами измерения будут футы. `FOOT_US`–Линейными единицами измерения будут геодезические футы США. `YARD`–Линейными единицами измерения будут ярды. `MILE_US`–Линейными единицами измерения будут геодезические мили США. `NAUTICAL_MILE`–Линейными единицами измерения будут морские мили. `MILLIMETER`–Линейными единицами измерения будут миллиметры. `CENTIMETER`–Линейными единицами измерения будут сантиметры. `METER`–Линейными единицами измерения будут метры. `KILOMETER`–Линейными единицами измерения будут километры. `DECIMETER`–Линейными единицами измерения будут дециметры.	String
min_area (Дополнительный)	Минимальная допустимая площадь для понижения. Площадь поверхности верхней части понижения. В итоговый результат не будут включены понижения с площадью, меньшей этого значения. По умолчанию общая площадь трех ячеек или эквивалент в квадратных единицах карты пространственной привязки для значения параметра `in_surface_raster`.	Areal Unit
max_connection_distance (Дополнительный)	Максимально допустимое расстояние от границы понижения до точки соединения ниже по течению. Соединение ниже по течению определяется как ближайшая ячейка с высотой ниже самой низкой ячейки в пределах понижения. Если расстояние до соединения ниже по течению больше этого значения, то понижение не будет включено в итоговый результат. Этот параметр будет применяться только в том случае, если для него указано значение.	Linear Unit
max_road_distance (Дополнительный)	Максимально допустимое расстояние от границы понижения до ближайшей дороги. Если расстояние от понижения до дороги больше этого значения, оно не будет включено в итоговый результат. Параметр доступен только в том случае, если указано значение параметра `in_road_data`. По умолчанию 30 метров или эквивалент в единицах карты пространственной привязки для значения параметра `in_surface_raster`.	Linear Unit

Пример кода

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

В этом примере показано, как использовать Locate Depressions для обнаружения понижений на основе входного растра поверхности без предварительного заполнения локальных понижений.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/arcpyexamples/data.gdb"
outDepressions = LocateDepressions("elevation", "outdepressions01.shp", "",
                                    "outpoints01.shp", "", "", "", "", "")

LocateDepressions пример 2 (автономный скрипт)

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

# Name: LocateDepressions_standalone.py
# Description: Locates depressions that meet the specified criteria.
# Requirements: Spatial Analyst extension

# Import system modules
import arcpy
from arcpy.sa import *

# Set environment settings
arcpy.env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "elevation.tif"
inRoadData = "roads.tif"
inMinDepth = "2 Meters"
inZUnit = "METERS"
inMinArea = "5 SquareMeters"
inMaxConnectionDist = "40 Meters"
inMaxRoadDist = "20 Meters"

# Run the tool
outDepressions = LocateDepressions(inRaster, "", inRoadData, "", inMinDepth,
                                    inZUnit, inMinArea, inMaxConnectionDist,
                                    inMaxRoadDist)

# Save the output
outDepressions.save("C:/sapyexamples/output.gdb/outdepressions02")

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

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

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