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

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

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

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

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

Если входной растр является растром с плавающей точкой, выходные данные будут с плавающей точкой для всех доступных типов статистики.
Для опции Большинство, если есть привязка, выходные данные определяются наименьшем из значений привязки.

Подпись	Объяснение	Тип данных
Входной многомерный растр	Входной растр может быть только многомерным растром в облачном формате растра (файл `.crf`).	Raster Layer
Измерение (Дополнительный)	Имя измерения, по которому будет двигаться окно. Значение по умолчанию - это первое измерение, отличное от x, y, найденное во входном многомерном растре.	String
Окно Назад (Дополнительный)	Значение того, сколько срезов до или выше должно быть включено в определенное окно. Значение должно быть положительным целым числом от 1 до 100. Значение по умолчанию равно 1. Единицей измерения этого параметра является срез.	Long
Окно Вперед (Дополнительный)	Значение того, сколько срезов после или ниже должно быть включено в определенное окно. Значение должно быть положительным целым числом от 1 до 100. Значение по умолчанию равно 1. Единицей измерения этого параметра является срез.	Long
Обработка NoData (Дополнительный)	Определяет, как значения NoData будут обрабатываться при вычислении статистики. Данные–Значения NoData в пределах определенного окна будут игнорироваться при вычислении выбранного статистического показателя. При определении выходного значения будут использоваться только ячейки в пределах заданного окна, содержащие данные. Если обрабатываемая ячейка имеет значение 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`–Выходные значения будут 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

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

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

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

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

Пример кода

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 *

# 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"

# Run 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")

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

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

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

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

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

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

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

Параметры

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

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

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

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

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