Найти понижения (Spatial Analyst)—ArcGIS Pro

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

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

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

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

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

Значение параметра Входной растр поверхности (in_surface_raster в Python) может быть цифровой моделью рельефа (ЦМР). Внутренне понижения определяются на основе разницы между заполненной и исходной ЦМР.
Только понижения, соответствующие всем требованиям, заданным дополнительными параметрами анализа, будут включены в значение параметра Выходные полигоны понижений (out_depressions_polygons в Python).
Значение параметра Выходные точки соединений (out_connection_points в Python) включает в себя точку с самой низкой высотой в пределах понижения и точку соединения ниже по течению для всех понижений, включенных в значение параметра Выходные полигоны понижений.
Указание значения параметра Единицы Z (z_unit в Python) обеспечивает правильный расчет глубины понижения.
Если единицы измерения z-значения имеются в вертикальной системе координат входного растра поверхности, то они будут применяться автоматически. Рекомендуется задать единицы измерения z для входного растра, если они утрачены. Вы можете использовать инструмент Определить проекцию для указания z-значения. Если значение не указано, по умолчанию будет использоваться метр.
Параметр Максимальное расстояние до соединения (max_connection_distance в Python) будет считать соединением ниже по течению ближайшую найденную ячейку, имеющую более низкую высоту, чем самая низкая ячейка в пределах понижения. Если этим критериям удовлетворяет несколько ячеек, будет возвращена первая найденная.
Параметр Максимальное расстояние до дорог (max_road_distance в Python) можно применить только в том случае, если указан параметр Входной растр или Объекты дорог (in_road_data в Python).
Единицы карты пространственной привязки значения параметра Входной растр поверхности используется для заполнения единиц по умолчанию для параметров Минимальная площадь, Максимальное расстояние до соединения и Максимальное расстояние до дорог. Если единица измерения, определенная значением параметра Входной растр поверхности, не совпадает ни с доступной единицей площади, ни с линейной единицей, то по умолчанию будут использоваться Квадратные метры и Метры соответственно.
Этот инструмент поддерживает параллельную обработку. Если ваш компьютер имеет несколько процессоров или процессор с несколькими ядрами, то его производительность будет более высокой, особенно на больших наборах данных. Раздел справки Параллельная обработка в Spatial Analyst содержит более подробные сведения об этой возможности и способах ее настройки.
По умолчанию этот инструмент будет использовать до 50 процентов доступных ядер. Можно задавать число используемых инструментом ядер в среде Коэффициент параллельной обработки.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

Подпись	Описание	Тип данных
Входной растр поверхности	Входной растр поверхности.	Raster Layer
Выходные полигоны понижений	Выходной класс объектов, который будет содержать идентифицированные понижения. Каждый полигон понижения имеет уникальный номер. В дополнительных полях таблицы атрибутов хранится специфическая информация о понижении. Это следующие поля: AREA— площадь понижения в квадратных метрах. VOLUME— объем понижения в кубических метрах. DIST_CON— расстояние до точки соединения ниже по течению. DIST_DEP— расстояние до ближайшего понижения в метрах. 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
Максимальное расстояние до соединения (Дополнительный)	Максимально допустимое расстояние от границы понижения до точки соединения ниже по течению. Соединение ниже по течению определяется как ближайшая ячейка с высотой ниже самой низкой ячейки в пределах понижения. Если расстояние до соединения ниже по течению больше этого значения, то понижение не будет включено в итоговый результат. По умолчанию 30 метров или эквивалент в единицах карты пространственной привязки для значения параметра Входной растр поверхности.	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— расстояние до точки соединения ниже по течению. DIST_DEP— расстояние до ближайшего понижения в метрах. DIST_ROAD— расстояние до ближайшей дороги в метрах. Это поле создается только в том случае, если для дополнительно входного параметра данных о дорогах указан набор данных.	Feature Class
in_road_data (Дополнительный)	Дополнительный набор растровых данных или набор классов объектов, определяющий дороги. Дороги могут быть определены целочисленным растром или растром с плавающей точкой, либо точечным, линейным или полигональным объектом.	Raster Layer; Feature Layer
out_connection_points (Дополнительный)	Дополнительные выходные точки, определяющие самую низкую точку в понижении и соответствующую точку соединения ниже по течению. Соединение ниже по течению определяется как ближайшая ячейка с высотой ниже самой низкой ячейки в пределах понижения. Каждая точка имеет уникальный номер. В дополнительных полях таблицы атрибутов хранится специфическая информация о точке. Это следующие поля: 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—Линейными единицами измерения могут быть футы. YARD—Линейными единицами измерения могут быть ярды. MILE_US—Линейными единицами измерения могут быть мили. NAUTICAL_MILE—Линейными единицами измерения могут быть морские мили. MILLIMETER—Линейными единицами измерения могут быть миллиметры. CENTIMETER—Линейными единицами измерения могут быть сантиметры. METER—Линейными единицами измерения могут быть метры. KILOMETER—Линейными единицами измерения могут быть километры. DECIMETER—Линейными единицами измерения могут быть дециметры.	String
min_area (Дополнительный)	Минимальная допустимая площадь для понижения. Площадь поверхности верхней части понижения. В итоговый результат не будут включены понижения с площадью, меньшей этого значения. По умолчанию общая площадь трех ячеек или эквивалент в квадратных единицах карты пространственной привязки для значения параметра in_surface_raster.	Areal Unit
max_connection_distance (Дополнительный)	Максимально допустимое расстояние от границы понижения до точки соединения ниже по течению. Соединение ниже по течению определяется как ближайшая ячейка с высотой ниже самой низкой ячейки в пределах понижения. Если расстояние до соединения ниже по течению больше этого значения, то понижение не будет включено в итоговый результат. По умолчанию 30 метров или эквивалент в единицах карты пространственной привязки для значения параметра in_surface_raster.	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"

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

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

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

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

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

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

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

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

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

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