Изолинии процентиля значения (Инструменты Spatial Analyst)

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

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

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

Иллюстрация

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

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

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

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

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

Имя	Объяснение	Тип данных
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
smooth_outputs (Дополнительный)	Определяет, будут ли выходные полигоны сглажены до более простых форм или соответствовать границам ячеек входного растра. `SMOOTH`–Полигоны будут сглажены в более простые формы. Сглаживание выполняется таким образом, чтобы полигоны содержали минимальное число сегментов, оставаясь при этом как можно ближе к границам ячеек исходного растра. Используется по умолчанию. `NO_SMOOTH`–Границы полигонов будут проходить точно по границам ячеек входного растра. Если используется эта опция, то при конвертации класса полигональных объектов обратно в растр будет получен исходный растр.	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",
                        smooth_outputs="SMOOTH")

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 *

### 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"
smooth_outputs="SMOOTH"
out_volueP_contour = "ValueP_CrimeDensity_Out.shp"

## Run: Create Value Percentile Contours
ValueP_out_contours = ValuePercentileContours(in_surface_raster,
                                              out_volueP_contour,
                                              percentile_values,
                                              method, ignore_negative_values, smooth_outputs)

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

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

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

Basic: Требуется Spatial Analyst
Standard: Требуется Spatial Analyst
Advanced: Требуется Spatial Analyst