Движущаяся статистика по измерению (Image Analyst)—ArcGIS Pro

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

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

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

Вычисляет статистику по движущемуся окну для многомерных данных по заданному измерению.

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

Движущуюся статистику также можно назвать статистикой в движущемся окне, скользящей или бегущей статистикой. Вокруг каждого значения измерения устанавливается предварительно заданное окно, которое используется для вычисления различных статистических данных перед переходом к следующему значению. Параметры Окно Назад и Окно Вперед позволяют определять размеры окон с обеих сторон измерения.
Входной растр может быть только многомерным растром в облачном формате растра (файл .crf).
Этот инструмент будет обрабатывать только одно измерение. По умолчанию в качестве измерения обработки будет использоваться первое измерение, отличное от x,y.
Тип статистики Круговое среднее вычисляет среднее значение для углов или других круговых величин, таких как направление по компасу в градусах. Если выбран этот параметр, становится доступным параметр Значение охвата окружности. Используйте этот параметр, чтобы указать значение, вокруг которого происходит охват для вычисления среднего из них по окружности. Например, для расчета угла значение охвата окружности должно быть 360 градусов, что означает, что значение 360 будет преобразовано в 0, а значение 370 будет преобразовано в 10. Другое применение - для расчета времени по месяцам в году, и в этом случае значение охвата окружности должно быть равно 12. В этом случае входное значение 13 будет преобразовано в 1.
Если входной многомерный растр является целочисленным, допустимыми параметрами для Типа статистики являются Среднее, Круговое среднее, Большинство, Максимум, Медиана, Минимум и Процентиль. Если входной растр содержит значения float, тип Большинство не доступен.
Если входной растр является целочисленным, выходной растр будет целочисленным для опций Большинство, Максимум и Минимум. Выходные данные будут с типом float для статистики Среднее, Круговое среднее, Медиана и Процентиль.
Если входной растр типа с плавающей точкой, выходные данные будут числами с плавающей точкой для всех доступных типов статистики.
Для опции Большинство, если есть привязка, выходные данные определяются наименьшем из значений привязки.

Параметры

Подпись	Описание	Тип данных
Входной многомерный растр	Входной растр может быть только многомерным растром в облачном формате растра (файл .crf).	Raster Layer
Измерение (Дополнительный)	Название измерения, по значения которого будет двигаться окно. Значением по умолчанию является первое измерение, отличное от x, y, найденное во входном многомерном растре.	String
Окно Назад (Дополнительный)	Значение того, сколько срезов до или выше должно быть включено в определенное окно. Значение должно быть положительным целым числом от 1 до 100. Значение по умолчанию равно 1. Единицей измерения этого параметра является срез.	Long
Окно Вперед (Дополнительный)	Значение того, сколько срезов после или ниже должно быть включено в определенное окно. Значение должно быть положительным целым числом от 1 до 100. Значение по умолчанию равно 1. Единицей измерения этого параметра является срез.	Long
Обработка NoData (Дополнительный)	Указывает, как значения NoData будут обрабатываться при расчете статистики. Данные—Значения NoData во входных значениях будут игнорироваться в результатах определенного окна, в которое они попадают. Это значение по умолчанию NoData—Выходные значения не будут содержать данных, если во входных данных в определенном окне будут найдены какие-либо значения NoData. Заполнить NoData—Значения ячеек Nodata будут заменены с использованием выбранной статистики для значений в определенном окне.	String
Тип статистики (Дополнительный)	Указывает тип вычисляемой статистики. Среднее—Будет вычислено среднее (среднее значение) ячеек в определенном окне. Это значение по умолчанию Круговое среднее—Вычисление среднего для углов или других периодических показателей, таких как компасное направление в градусах, время дня или дробная часть вещественного числа. Если выбран этот тип статистики, становится доступным параметр Значение охвата окружности. Используйте этот параметр, чтобы указать значение охвата. Большинство—Будет определено Большинство (значение, встречающееся чаще всего) для ячеек в определенном окне. Максимум—Будет определен Максимум (наибольшее значение) для ячеек в определенном окне. Медиана—Будет определена Медиана для ячеек в определенном окне. Минимум—Будет определен Минимум (наименьшее значение) для ячеек в определенном окне. Процентиль—Будет рассчитан процентиль ячеек в определенном окне. Девяностый процентиль вычисляется по умолчанию. Когда выбран этот тип статистики, становятся доступными параметры Значение процентиля и Тип интерполяции процентиля. Используйте эти новые параметры, чтобы указать процентиль для вычисления и выбрать тип интерполяции для применения соответственно.	String
Значение процентиля (Дополнительный)	Будет вычислено значение процентиля. Значение по умолчанию – 90, для 90-го процентиля. Значение может варьироваться от 0 до 100. 0-й процентиль по существу эквивалентен Минимуму в статистике, а 100-й процентиль эквивалентен Максимуму. Значение 50 даст по существу тот же результат, что и Медиана в статистике. Этот параметр поддерживается, если параметр Тип статистики задан как Процентиль.	Double
Тип интерполяции Процентиль (Дополнительный)	Указывает метод интерполяции, который будет использоваться, когда значение процентиля попадает между двумя значениями ячейки. Этот параметр поддерживается только в том случае, если для параметра Тип статистики выбрано значение Медиана или Процентиль. Автоопределение—Если входной растр содержит целочисленные пикселы, будет использоваться метод Ближайший. Если тип пикселов входного растра с плавающей точкой, будет использоваться метод Линейный. Ближайший—Используется ближайшее доступное значение к процентилю. В этом случае выходной тип пиксела будет таким же, как и во входном растре. Линейный—Используется средневзвешенное значение двух окружающих значений из процентиля. В этом случае тип выходного пиксела будет с плавающей точкой.	String
Значение охвата окружности (Дополнительный)	Значение, которое будет использоваться для конвертации линейного значения до диапазона заданного кругового среднего. Это значение должно быть положительным Значением по умолчанию является 360 градусов. Этот параметр поддерживается, если параметр Тип статистики задан как Круговое среднее.	Double

Производные выходные данные

Подпись	Описание	Тип данных
Аргументы растровой функции JSON	Аргументы функции. Эти выходные данные предназначены только для внутреннего использования.	String

Возвращаемое значение

Подпись	Описание	Тип данных
Выходной многомерный растр	Выходной растр может быть только многомерным растром в облачном формате растра (файл .crf).	Raster

DimensionalMovingStatistics(in_raster, {dimension}, {backward_window}, {forward_window}, {nodata_handling}, {statistics_type}, {percentile_value}, {percentile_interpolation_type}, {circular_wrap_value})

Имя	Описание	Тип данных
in_raster	Входной растр может быть только многомерным растром в облачном формате растра (файл .crf).	Raster Layer
dimension (Дополнительный)	Название измерения, по значения которого будет двигаться окно. Значением по умолчанию является первое измерение, отличное от x, y, найденное во входном многомерном растре.	String
backward_window (Дополнительный)	Значение того, сколько срезов до или выше должно быть включено в определенное окно. Значение должно быть положительным целым числом от 1 до 100. Значение по умолчанию равно 1. Единицей измерения этого параметра является срез.	Long
forward_window (Дополнительный)	Значение того, сколько срезов после или ниже должно быть включено в определенное окно. Значение должно быть положительным целым числом от 1 до 100. Значение по умолчанию равно 1. Единицей измерения этого параметра является срез.	Long
nodata_handling (Дополнительный)	Указывает, как значения NoData будут обрабатываться при расчете статистики. DATA—Значения NoData во входных значениях будут игнорироваться в результатах определенного окна, в которое они попадают. Это значение по умолчанию NODATA—Выходные значения не будут содержать данных, если во входных данных в определенном окне будут найдены какие-либо значения NoData. FILL_NODATA—Значения ячеек Nodata будут заменены с использованием выбранной статистики для значений в определенном окне.	String
statistics_type (Дополнительный)	Указывает тип вычисляемой статистики. MEAN—Будет вычислено среднее (среднее значение) ячеек в определенном окне. Это значение по умолчанию CIRCULAR_MEAN—Вычисление среднего для углов или других периодических показателей, таких как компасное направление в градусах, время дня или дробная часть вещественного числа. Когда выбран этот тип статистики, используйте параметр circular_wrap_value, чтобы указать значение охвата. MAJORITY—Будет определено Большинство (значение, встречающееся чаще всего) для ячеек в определенном окне. MAXIMUM—Будет определен Максимум (наибольшее значение) для ячеек в определенном окне. MEDIAN—Будет определена Медиана для ячеек в определенном окне. MINIMUM—Будет определен Минимум (наименьшее значение) для ячеек в определенном окне. PERCENTILE—Будет рассчитан процентиль ячеек в определенном окне. Девяностый процентиль вычисляется по умолчанию. Когда выбран этот тип статистики, используйте параметры percentile_value и percentile_interpolation_type, чтобы указать процентиль для вычисления и выбрать тип интерполяции для применения соответственно.	String
percentile_value (Дополнительный)	Будет вычислено значение процентиля. Значение по умолчанию – 90, для 90-го процентиля. Значение может варьироваться от 0 до 100. 0-й процентиль по существу эквивалентен Минимуму в статистике, а 100-й процентиль эквивалентен Максимуму. Значение 50 даст по существу тот же результат, что и Медиана в статистике. Этот параметр поддерживается, если параметр statistics_type задан как PERCENTILE. Если был указан какой-либо другой тип статистики, то этот параметр будет проигнорирован.	Double
percentile_interpolation_type (Дополнительный)	Указывает метод интерполяции, который будет использоваться, когда значение процентиля попадает между двумя значениями ячейки. Этот параметр поддерживается, если параметр statistics_type задан как MEDIAN или PERCENTILE. Если был указан какой-либо другой тип статистики, то этот параметр будет проигнорирован. AUTO_DETECT—Если входной растр содержит целочисленные пикселы, будет использоваться метод NEAREST. Если тип пикселов входного растра с плавающей точкой, будет использоваться метод LINEAR. NEAREST—Используется ближайшее доступное значение к процентилю. В этом случае выходной тип пиксела будет таким же, как и во входном растре. LINEAR—Используется средневзвешенное значение двух окружающих значений из процентиля. В этом случае тип выходного пиксела будет с плавающей точкой.	String
circular_wrap_value (Дополнительный)	Значение, которое будет использоваться для конвертации линейного значения до диапазона заданного кругового среднего. Это значение должно быть положительным Значением по умолчанию является 360 градусов. Этот параметр поддерживается, если параметр statistics_type задан как CIRCULAR_MEAN. Если был указан какой-либо другой тип статистики, то этот параметр будет проигнорирован.	Double

Возвращаемое значение

Имя	Описание	Тип данных
out_raster	Выходной растр может быть только многомерным растром в облачном формате растра (файл .crf).	Raster

Производные выходные данные

Имя	Описание	Тип данных
raster_function_arguments_json	Аргументы функции. Эти выходные данные предназначены только для внутреннего использования.	String

Пример кода

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

В этом примере вычисляется среднее значение в окне с тремя срезами вокруг каждой ячейки входного многомерного растра.

import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/iapyexamples/data"
out_dimstats = DimensionalMovingStatistics("md_raster.crf", "StdTime",
                                           1, 1, "NODATA", "MEAN")
out_dimstats.save("C:/iapyexamples/output/DMS01.crf")

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

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

# Name: DimensionalMovingStatistics_standalone.py
# Description: Calculates majority on a multidimensional raster 
#                along its time dimension.
# Requirements: Image Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *

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

# Set the analysis environment
env.workspace = "C:/iapyexamples/data"

# Set local variables
in_raster = "mining_location.crf"
dimension = "StdTime"
backward_window = 2
forward_window = 2
nodata_handling = "FILL_NODATA"
statistics_type = "MAJORITY"

# Execute DimensionalMovingStatistics
out_dimstats = DimensionalMovingStatistics(in_raster, dimension, 
                 backward_window, forward_window, nodata_handling, 
                 statistics_type)

# Save the output
out_dimstats.save("C:/iapyexamples/output/mining_location_out.crf")

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

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

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

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

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

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

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

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

Параметры

Производные выходные данные

Возвращаемое значение

Возвращаемое значение

Производные выходные данные

Пример кода

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

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

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

В этом разделе