Изолинии процентиля значения (Spatial Analyst)—ArcGIS Pro

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

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

Создает контуры, определяющие верхний p% растра, путем ранжирования значений ячеек, выбора ячеек по пороговому значению процентиля и создания контуров экстремальных областей.

Более подробно о том, как работает инструмент Изолинии процентиля значения

Иллюстрация

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

Значения процентилей могут быть любыми от 0 до 100. Значение 100 может привести к пустому или тривиальному результату. Значение 0 возвращает весь допустимый контур.
Инструмент ранжирует ячейки по их значениям в порядке возрастания и возвращает верхний p процент ячеек растра. Порог процентиля вычисляется на основе ранжированных значений ячеек. Выходные данные выбирают ячейки, которые соответствуют или превышают пороговое значение.
Контур выходного полигона изолиний отражает область, охватываемую процентом от общей суммы экстремальных значений, превышающих указанный процентиль.
В случае повторных значений, равных пороговому значению, будут выбраны все повторные значения. В результате соседние процентили могут давать одинаковый порог и выходной полигон изолинии. Однако инструмент не будет занижать выборку значений относительно указанного процентиля.
Если указано несколько значений процентиля, выходные полигоны будут вложенными. Самый внутренний полигон соответствует наибольшим значениям, а самый внешний – покрывает меньшие значения.
Опция Плоскостной в параметре Метод может применяться, если анализ выполняется в локальном масштабе с проекцией, которая точно поддерживает правильные расстояния и площади.
Используйте опцию Геодезический для выполнения анализа в региональном или более крупном масштабе (например, с использованием Web Mercator или любой географической системы координат). Эта опция учитывает кривизну эллипсоида и корректно обрабатывает данные вблизи полюсов и международной линии смены дат.
Если параметр Игнорировать отрицательные значения не отмечен, инструмент будет учитывать отрицательные значения входных ячеек при вычислении.
Входной растр поверхности должен быть одноканальным.
Если целью является создание полигонов на основе совокупной величины значений ячеек, используйте инструмент Изолинии процентиля объема.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

Подпись	Описание	Тип данных
Входной растр поверхности	Входной растр, для которого будут рассчитаны полигоны изолиний. Это должен быть непрерывный растр. Тип входных растровых данных может быть целочисленным или с плавающей точкой.	Raster Layer
Выходные полигоны изолиний	Выходные объекты полигонов изолиний. Выходные данные включают полигоны изолиний для всех указанных значений процентилей.	Feature Class
Значения процентиля (Дополнительный)	Значения процентилей, для которых будут вычислены изолинии. Значение по умолчанию – 90, для ⁹⁰-го процентиля. Значения могут варьироваться от 0 до 100.	Double
Метод (Дополнительный)	Определяет, следует ли выполнять вычисление на основе планарного (плоская земля) или геодезического (эллипсоид) метода. Планарный метод целесообразно использовать в локальных областях с проекцией, которая поддерживает правильные расстояния и площади. Подходит для анализа территорий площадью с города, округа, либо небольшие области. Геодезический метод дает более точный результат, но может увеличить время обработки. Плоскостной—Расчет будет выполнен на проецированной плоскости при использовании декартовой системы координат 2D. Это значение по умолчанию Геодезический—Вычисления будут выполняться в Декартовой системе координат 3D с учетом формы земной поверхности в виде эллипсоида.	String
Игнорировать отрицательные значения (Дополнительный)	Указывает, будут ли отрицательные значения игнорироваться при вычислении процентиля. Отмечено — Отрицательные значения будут игнорироваться при вычислении процентиля. Не отмечено — Отрицательные значения не будут игнорироваться при вычислении процентиля; они будут включены. Это значение по умолчанию	Boolean

ValuePercentileContours(in_surface_raster, out_contour_polygons, {percentile_values}, {method}, {ignore_negative_values})

Имя	Описание	Тип данных
in_surface_raster	Входной растр, для которого будут рассчитаны полигоны изолиний. Это должен быть непрерывный растр. Тип входных растровых данных может быть целочисленным или с плавающей точкой.	Raster Layer
out_contour_polygons	Выходные объекты полигонов изолиний. Выходные данные включают полигоны изолиний для всех указанных значений процентилей.	Feature Class
percentile_values [percentile_values,...] (Дополнительный)	Значения процентилей, для которых будут вычислены изолинии. Значение по умолчанию – 90, для ⁹⁰-го процентиля. Значения могут варьироваться от 0 до 100.	Double
method (Дополнительный)	Определяет, следует ли выполнять вычисление на основе планарного (плоская земля) или геодезического (эллипсоид) метода. Планарный метод целесообразно использовать в локальных областях с проекцией, которая поддерживает правильные расстояния и площади. Подходит для анализа территорий площадью с города, округа, либо небольшие области. Геодезический метод дает более точный результат, но может увеличить время обработки. PLANAR—Расчет будет выполнен на проецированной плоскости при использовании декартовой системы координат 2D. Это значение по умолчанию GEODESIC—Вычисления будут выполняться в Декартовой системе координат 3D с учетом формы земной поверхности в виде эллипсоида.	String
ignore_negative_values (Дополнительный)	Указывает, будут ли отрицательные значения игнорироваться при вычислении процентиля. IGNORE_NEGATIVE_VALUES—Отрицательные значения будут проигнорированы при вычислении процентиля. USE_ALL_VALUES—Отрицательные значения не будут игнорироваться при вычислении процентиля; они будут включены. Это значение по умолчанию	Boolean

Пример кода

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

В следующем примере показано использование этого инструмента в окне Python:

import arcpy
from arcpy import env
from arcpy.sa import *

env.workspace = "C:/sapyexamples/data"
ValuePercentileContours("CrimeEventsDensity.tif", "ValP_CrimeDensity_Out.shp",
                        [50, 75, 90, 95, 99], method = "Planar", 
                        ignore_negative_values = "USE_ALL_VALUES")

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

В следующем примере показано использование этого инструмента в автономном скрипте Python.

## Name: ValuePercentileContours_Ex_standalone.py  
## Description: Identify different local intensity zones from density surface
## Requirements: Spatial Analyst Extension 
 
## Import system modules 
import arcpy  
from arcpy import env   
from arcpy.sa import *

## Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
 
## Set environment settings 
env.workspace = "C:/sapyexamples/data"
# To allow overwriting outputs change overwriteOutput option to True. 
env.overwriteOutput = False 
  
## Set local variables 
in_surface_raster = "CrimeEventsDensity.tif"
percentile_values = [50, 75, 90, 95, 99]
method = "Planar"
ignore_negative_values = "USE_ALL_VALUES"
out_volueP_contour = "ValueP_CrimeDensity_Out.shp"
  
## Execute: Create Volume Percentile Contours  
ValueP_out_contours = ValuePercentileContours(in_surface_raster, 
                                              out_volueP_contour, 
                                              percentile_values,
                                              method, ignore_negative_values)

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

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

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

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

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

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