Найти статистику аргументов (Image Analyst)

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

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

Извлекает значение измерения или индекс канала, при котором достигается заданная статистика для каждого пиксела в многомерном или многоканальном растре.

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

  • Используйте инструмент Найти статистику аргументов для извлечения значения измерения (например, даты, высоты или глубины), в котором получается определенная статистика в стеке растров в многомерном наборе растровых данных. Или найдите число каналов, при котором эта статистика достигается в многоканальном растре.

    Например, вы можете узнать месяц, в котором каждый пиксел достигал самой высокой температуры поверхности моря за 30 лет сбора данных. Другой пример – у вас восьмиканальное изображение данных дистанционного зондирования, и вы хотите узнать, в каком канале было достигнуто минимальное значение отражательной способности для каждого пиксела.

  • Поддерживаемые многомерные наборы растровых данных включают Cloud Raster Format (CRF), многомерные наборы данных мозаики или многомерные растровые слои, созданные с помощью файлов формата netCDF, GRIB или HDF.

  • Этот инструмент создает многомерный набор растровых данных в формате Cloud Raster Format (CRF). В настоящее время другие форматы выхода не поддерживаются.

  • Если входной многомерный растр содержит только одно измерение, на выходе будет набор одноканальных растровых данных. Если входной слой многомерного растра содержит несколько измерений, выходной многомерный растр будет включать те измерения, которые не были включены в анализ.

Параметры

ПодписьОписаниеТип данных
Входной многомерный или многоканальный растр

Входной многомерный или многоканальный растр, который будет анализироваться.

Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
Измерение
(Дополнительный)

Измерение (переменная или канал), из которого будет извлекаться статистика. Этот параметр не требуется, если входной растр не является многомерным.

String
Определение измерения
(Дополнительный)

Определяет, как будет извлекаться статистика из заданного измерения.

  • ВсеСтатистика будет извлекаться по всем измерениям. Это значение по умолчанию
  • Ключевое слово интервалаСтатистика будет извлекаться из измерения времени в соответствии с ключевым словом интервала.
String
Интервал ключевого слова
(Дополнительный)

Единица времени, для которой будет извлекаться статистика.

Например, у вас есть пять лет ежедневных данных о температуре поверхности моря, и вы хотите узнать, в каком году наблюдалась максимальная температура. Задайте для Типа статистики Аргумент максимума, для Определения измерения выберите Ключевое слово интервала, а для Интервала ключевого слова - Ежегодно.

Или же, если вы желаете узнать, в каком месяце постоянно наблюдалась самая высокая температура, задайте для Типа статистики Аргумент максимума, для Определения измерения - Ключевое слово интервала, а для Интервала ключевого слова - Повтор ежемесячно. В результате будет создан растр, где каждый пиксел содержит месяц, в котором данная статистика наблюдалась за пятилетний период (например, 18.08.2008, 25.08.2016, 07.08.2013).

Этот параметр необходим, если для параметра Измерение задано StdTime, а для параметра Определение измерения - Ключевое слово интервала.

  • Через каждый деньСтатистика будет извлекаться по дням.
  • Через каждую неделюСтатистика будет извлекаться по неделям.
  • Через каждый месяцСтатистика будет извлекаться по месяцам.
  • Через каждый кварталСтатистика будет извлекаться по кварталам.
  • Каждый часСтатистика будет извлечена за тот час, в течение которого она состоялась.
  • ЕжедневноСтатистика будет извлечена за тот день, в течение которого она состоялась.
  • ЕженедельноСтатистика будет извлечена за ту неделю, в течение которой она состоялась.
  • ЕжемесячноСтатистика будет извлечена за тот месяц, в течение которого она состоялась.
  • ЕжеквартальноСтатистика будет извлечена за тот квартал, в течение которого она состоялась.
  • ЕжегодноСтатистика будет извлечена за тот год, в течение которого она состоялась.
String
Переменные [Dimension Info] (Описание)
(Дополнительный)

Переменная или переменные, которые будут анализироваться. Если входной растр не является многомерным, значения пикселов многоканального растра считаются переменной. Если входной растр является многомерным, а переменная не задана, то будут анализироваться все переменные в пределах заданного измерения.

Например, чтобы найти годы, в которые значения температуры были самыми высокими, укажите температуру в качестве переменной для анализа. Если вы не укажете ни одной переменной, а у вас есть данные и по температуре, и по выпадению осадков, то анализироваться будут обе переменные, и выходной многомерный растр будет включать обе переменные.

String
Тип статистики
(Дополнительный)

Задает статистику для извлечения из переменной или переменных по заданному измерению.

  • Аргумент минимумаБудет извлечено значение измерения, при котором достигается минимальное значение переменной. Это значение по умолчанию
  • Аргумент максимумаБудет извлечено значение измерения, при котором достигается максимальное значение переменной.
  • Аргумент медианыБудет извлечено значение измерения, при котором достигается медианное значение переменной.
  • ПродолжительностьБудет извлечено значение самого длительного периода измерения между минимальным и максимальным значениями переменной.
  • Аргумент значенияБудет извлечено значение измерения, при котором достигается указанное значение переменной.
String
Минимальное значение
(Дополнительный)

Минимальное значение переменной, которое должно использоваться для получения продолжительности.

Этот параметр необходим, если для параметра Тип статистики задано Продолжительность.

Double
Максимальное значение
(Дополнительный)

Максимальное значение переменной, которое должно использоваться для получения продолжительности.

Этот параметр необходим, если для параметра Тип статистики задано Продолжительность.

Double
Множественное случайное значение
(Дополнительный)

Значение пиксела, используемое для указания того, что данная статистика аргумента была достигнута более одного раза во входном наборе растровых данных. Если не задано, то значение пиксела будет значением измерения, как определено в параметре Появление, первое или последнее появление.

Long
Игнорировать NoData
(Дополнительный)

Указывает, будут ли игнорироваться значения NoData при анализе.

  • Отмечено – анализ будет включать все действительные пикселы по данному измерению и игнорировать пикселы NoData. Используется по умолчанию.
  • Не отмечено – результатом анализа будет значение NoData, если для этого пиксела по данному измерению есть хотя бы одно значение NoData.
Boolean
Значение аргумента
(Дополнительный)

Значение, для которого будет выполнено сравнение для извлечения измерения.

Этот параметр необходим, если для параметра Тип статистики задано Аргумент значения.

Значение, для которого будет выполнено сравнение для извлечения измерения.

Этот параметр необходим, если для параметра statistics_type задано ARGUMENT_VALUE.

Long
Сравнение
(Дополнительный)

Указывает тип сравнения, который будет использован для извлечения измерения.

  • РавноИзвлекаемое измерение равно указанному значению. Это значение по умолчанию
  • БольшеИзвлекаемое измерение больше указанного значения.
  • Меньше чемИзвлекаемое измерение меньше указанного значения.
String
Появление
(Дополнительный)

Определяет, будет ли возвращено значение измерения при первом или последнем достижении статистики аргумента.

  • Первое появлениеЗначение измерения будет возвращено при первом достижении статистики аргумента. Это значение по умолчанию
  • Последнее появлениеЗначение измерения будет возвращено при последнем достижении статистики аргумента.
String

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

ПодписьОписаниеТип данных
Выходной растр

Выходной набор растровых данных.

Raster

FindArgumentStatistics(in_raster, {dimension}, {dimension_def}, {interval_keyword}, {variables}, {statistics_type}, {min}, {max}, {multiple_occurrence}, {ignore_nodata}, {value}, {comparison}, {occurrence})
ИмяОписаниеТип данных
in_raster

Входной многомерный или многоканальный растр, который будет анализироваться.

Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
dimension
(Дополнительный)

Измерение (переменная или канал), из которого будет извлекаться статистика. Этот параметр не требуется, если входной растр не является многомерным.

String
dimension_def
(Дополнительный)

Определяет, как будет извлекаться статистика из заданного измерения.

  • ALLСтатистика будет извлекаться по всем измерениям. Это значение по умолчанию
  • INTERVAL_KEYWORDСтатистика будет извлекаться из измерения времени в соответствии с ключевым словом интервала.
String
interval_keyword
(Дополнительный)

Единица времени, для которой будет извлекаться статистика.

Например, у вас есть пять лет ежедневных данных о температуре поверхности моря, и вы хотите узнать, в каком году наблюдалась максимальная температура. Задайте для Типа статистики Аргумент максимума, для Определения измерения выберите Ключевое слово интервала, а для Интервала ключевого слова - Ежегодно.

Или же, если вы желаете узнать, в каком месяце постоянно наблюдалась самая высокая температура, задайте для Типа статистики Аргумент максимума, для Определения измерения - Ключевое слово интервала, а для Интервала ключевого слова - Повтор ежемесячно. В результате будет создан растр, где каждый пиксел содержит месяц, в котором данная статистика наблюдалась за пятилетний период (например, 18.08.2008, 25.08.2016, 07.08.2013).

Этот параметр необходим, если для параметра dimension задано StdTime, а для параметра dimension_def - INTERVAL_KEYWORD.

  • RECURRING_DAILYСтатистика будет извлекаться по дням.
  • RECURRING_WEEKLYСтатистика будет извлекаться по неделям.
  • RECURRING_MONTHLYСтатистика будет извлекаться по месяцам.
  • RECURRING_QUARTERLYСтатистика будет извлекаться по кварталам.
  • HOURLYСтатистика будет извлечена за тот час, в течение которого она состоялась.
  • DAILYСтатистика будет извлечена за тот день, в течение которого она состоялась.
  • WEEKLYСтатистика будет извлечена за ту неделю, в течение которой она состоялась.
  • MONTHLYСтатистика будет извлечена за тот месяц, в течение которого она состоялась.
  • QUARTERLYСтатистика будет извлечена за тот квартал, в течение которого она состоялась.
  • YEARLYСтатистика будет извлечена за тот год, в течение которого она состоялась.
String
variables
[variables,...]
(Дополнительный)

Переменная или переменные, которые будут анализироваться. Если входной растр не является многомерным, значения пикселов многоканального растра считаются переменной. Если входной растр является многомерным, а переменная не задана, то будут анализироваться все переменные в пределах заданного измерения.

Например, чтобы найти годы, в которые значения температуры были самыми высокими, укажите температуру в качестве переменной для анализа. Если вы не укажете ни одной переменной, а у вас есть данные и по температуре, и по выпадению осадков, то анализироваться будут обе переменные, и выходной многомерный растр будет включать обе переменные.

String
statistics_type
(Дополнительный)

Задает статистику для извлечения из переменной или переменных по заданному измерению.

  • ARGUMENT_MINБудет извлечено значение измерения, при котором достигается минимальное значение переменной. Это значение по умолчанию
  • ARGUMENT_MAXБудет извлечено значение измерения, при котором достигается максимальное значение переменной.
  • ARGUMENT_MEDIANБудет извлечено значение измерения, при котором достигается медианное значение переменной.
  • DURATIONБудет извлечено значение самого длительного периода измерения между минимальным и максимальным значениями переменной.
  • ARGUMENT_VALUEБудет извлечено значение измерения, при котором достигается указанное значение переменной.
String
min
(Дополнительный)

Минимальное значение переменной, которое должно использоваться для получения продолжительности.

Этот параметр необходим, если для параметра statistics_type задано DURATION.

Double
max
(Дополнительный)

Максимальное значение переменной, которое должно использоваться для получения продолжительности.

Этот параметр необходим, если для параметра statistics_type задано DURATION.

Double
multiple_occurrence
(Дополнительный)

Значение пиксела, используемое для указания того, что данная статистика аргумента была достигнута более одного раза во входном наборе растровых данных. Если не задано, то значение пиксела будет значением измерения, как определено в параметре occurrence, первое или последнее появление.

Long
ignore_nodata
(Дополнительный)

Указывает, будут ли игнорироваться значения NoData при анализе.

  • DATAАнализ будет включать все действительные пикселы вдоль данного измерения и игнорировать пикселы NoData. Используется по умолчанию.
  • NODATAРезультатом анализа будет значение NoData, если для этого пиксела по данному измерению есть значение NoData.
Boolean
value
(Дополнительный)

Значение, для которого будет выполнено сравнение для извлечения измерения.

Этот параметр необходим, если для параметра Тип статистики задано Аргумент значения.

Long
comparison
(Дополнительный)

Указывает тип сравнения, который будет использован для извлечения измерения.

  • EQUAL_TOИзвлекаемое измерение равно указанному значению. Это значение по умолчанию
  • GREATER_THANИзвлекаемое измерение больше указанного значения.
  • SMALLER_THANИзвлекаемое измерение меньше указанного значения.
String
occurrence
(Дополнительный)

Определяет, будет ли возвращено значение измерения при первом или последнем достижении статистики аргумента.

  • FIRST_OCCURRENCEЗначение измерения будет возвращено при первом достижении статистики аргумента. Это значение по умолчанию
  • LAST_OCCURRENCEЗначение измерения будет возвращено при последнем достижении статистики аргумента.
String

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

ИмяОписаниеТип данных
out_raster

Выходной набор растровых данных.

Raster

Пример кода

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

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

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

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

# get the date when the minimal precipitation was observed in each year
# as well as the date when the minimal temperature was observed in each year
argStatOutput = FindArgumentStatistics("prcp_temp_time_series.crf", "StdTime", "INTERVAL_KEYWORD", "YEARLY",
	"prcp;temp", "ARGUMENT_MIN", None, None, 0, "DATA")
	
# Save output
argStatOutput.save("C:/data/yearly_min_temp_precip.crf")
FindArgumentStatistics, пример 2 (автономный скрипт)

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

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

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

# Define input parameters
inFile = "C:/data/salinity.crf"
dimensionName = "Time"
dimensiondef = "ALL"
intervalkeyword = ''
variables = "temp"
arg_statistics_type = "DURATION"
min_value = 20
max_value = 25
multiple_occurrances_value = None
ignore_nodata = "NODATA"

# Execute 
# get the number of continous slices that have temperature value between 20 and 25
argStatOutput = FindArgumentStatistics(inFile, dimensionName, dimensiondef, intervalkeyword,
	variables, arg_statistics_type, min_value, max_value, multiple_occurrances_value, ignore_nodata)
	
# Save output
argStatOutput.save("C:/data/arg_statistics_output2.crf")

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

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

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