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

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

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

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

Иллюстрация

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

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

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

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

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

VolumePercentileContours(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

Пример кода

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

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

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

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

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

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

## Name: VolumePercentileContours_Ex_standalone.py
## Description: Delineate areas of different magnitudes 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 = [25, 50, 75, 90, 95, 99]
method = "Planar"
ignore_negative_values = "USE_ALL_VALUES"
smooth_outputs="SMOOTH"
out_volP_contour = "VolumeP_CrimeDensity_Out.shp"

## Run: Create Volume Percentile Contours
VolumP_out_contours = VolumePercentileContours(in_surface_raster,
                                               out_volP_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