| Подпись | Описание | Тип данных |
Входной растр поверхности | Входной растр, для которого будут рассчитаны полигоны изолиний. Это должен быть непрерывный растр. Тип входных растровых данных может быть целочисленным или с плавающей точкой. | Raster Layer |
Выходные полигоны изолиний | Выходные объекты полигонов изолиний. Выходные данные включают полигоны изолиний для всех указанных значений процентилей. | Feature Class |
Значения процентиля (Дополнительный) | Значения процентилей, для которых будут вычислены изолинии. Значение по умолчанию – 90, для 90-го процентиля. Значения могут варьироваться от 0 до 100. | Double |
Метод (Дополнительный) | Определяет, следует ли выполнять вычисление на основе планарного (плоская земля) или геодезического (эллипсоид) метода. Планарный метод целесообразно использовать в локальных областях с проекцией, которая поддерживает правильные расстояния и площади. Подходит для анализа территорий площадью с города, округа, либо небольшие области. Геодезический метод дает более точный результат, но может увеличить время обработки.
| String |
Игнорировать отрицательные значения (Дополнительный) | Указывает, будут ли отрицательные значения игнорироваться при вычислении процентиля объема.
| Boolean |
Доступно с лицензией Spatial Analyst.
Краткая информация
Создает контуры, которые очерчивают наименьшую область, охватывающую p процентов от общей величины (значение × площадь ячейки) путем накопления ранжированных ячеек до порогового значения объема.
Более подробно о том, как работает инструмент Изолинии процентиля объема
Иллюстрация
Использование
Значения процентилей могут быть любыми от 0 до 100. Значение 0 может привести к пустому или тривиальному результату. Значение 100 возвращает весь допустимый контур.
Инструмент ранжирует ячейки по их значениям в порядке убывания и суммирует объем каждой ячейки (объем × площадь ячейки), пока общая сумма не достигнет p процентов от общего объема растра. Площадь рассчитывается по значению параметра Метод: Планарный или Геодезический. Пороговое значение объема процентиля — это значение на границе раздела. Выходные данные выбирают ячейки, которые соответствуют или превышают это пороговое значение.
Область, заключенная в выходной полигон изолинии, указывает область, охватываемую процентом от общей суммы объема, вычисленной с использованием значений процентиля. Площадь выходных полигонов отображает физический контур; она не равна объему, а представляет собой область, на которой находится p процентов объема.
В случае повторяющихся значений, равных пороговому значению объема, инструмент учитывает все значения, соответствующие этому пороговому значению. В результате выходной объем не будет ниже указанного процентиля. Следствием этого является то, что смежные процентили могут быть похожи.
Если указано несколько значений процентиля, выходные полигоны будут вложенными. Самый внутренний полигон соответствует наибольшим значениям, а самый внешний – покрывает меньшие значения.
Площадь формы полигона говорит о том, сколько земной поверхности попадает в эту крайнюю полосу.
Опция Плоскостной в параметре Метод может применяться, если анализ выполняется в локальном масштабе с проекцией, которая точно поддерживает правильные расстояния и площади.
Используйте опцию Геодезический для выполнения анализа в региональном или более крупном масштабе (например, с использованием Web Mercator или любой географической системы координат). Эта опция учитывает кривизну эллипсоида и корректно обрабатывает данные вблизи полюсов и международной линии смены дат.
Если параметр Игнорировать отрицательные значения не отмечен, инструмент будет учитывать отрицательные значения входных ячеек в анализе. Это может повлиять на итоговую сумму при вычислении объема.
Входной растр поверхности должен быть одноканальным.
Если целью является создание полигонов только на основе ранжированных значений ячеек, используйте инструмент Изолинии процентиля значения.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Параметры
VolumePercentileContours(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, для 90-го процентиля. Значения могут варьироваться от 0 до 100. | Double |
method (Дополнительный) | Определяет, следует ли выполнять вычисление на основе планарного (плоская земля) или геодезического (эллипсоид) метода. Планарный метод целесообразно использовать в локальных областях с проекцией, которая поддерживает правильные расстояния и площади. Подходит для анализа территорий площадью с города, округа, либо небольшие области. Геодезический метод дает более точный результат, но может увеличить время обработки.
| String |
ignore_negative_values (Дополнительный) | Указывает, будут ли отрицательные значения игнорироваться при вычислении процентиля объема.
| Boolean |
Пример кода
В следующем примере показано использование этого инструмента в окне 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")В следующем примере показано использование этого инструмента в автономном скрипте 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 *
## 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 = [25, 50, 75, 90, 95, 99]
method = "Planar"
ignore_negative_values = "USE_ALL_VALUES"
out_volP_contour = "VolumeP_CrimeDensity_Out.shp"
## Execute: Create Volume Percentile Contours
VolumP_out_contours = VolumePercentileContours(in_surface_raster,
out_volP_contour,
percentile_values, method,
ignore_negative_values)Параметры среды
Информация о лицензиях
- Basic: Обязательно Spatial Analyst
- Standard: Обязательно Spatial Analyst
- Advanced: Обязательно Spatial Analyst