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

Доступно с лицензией 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")

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

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

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