Найти статистику аргументов (Инструменты 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
Значение аргумента (Дополнительный)	Значение, на котором будет производиться сравнение для извлечения значения измерения. Этот параметр необходим, если для параметра Тип статистики задано Аргумент значения.	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 (Дополнительный)	Единица времени, для которой будет извлекаться статистика. Например, у вас есть пять лет ежедневных данных о температуре поверхности моря, и вы хотите узнать, в каком году наблюдалась максимальная температура. Установите параметр `statistics_type` в `ARGUMENT_MAX`, установите параметр `dimension_def` в `INTERVAL_KEYWORD` и установите параметр `interval_keyword` в `YEARLY`. Или, если вы хотите узнать месяц, в котором стабильно наблюдалась максимальная температура, установите параметр `statistics_type` на `ARGUMENT_MAX`, параметр `interval_keyword` на `dimension_def`, а параметр `INTERVAL_KEYWORD` на `RECURRING_MONTHLY`. В результате будет создан растр, где каждый пиксел содержит месяц, в котором данная статистика наблюдалась за пятилетний период (например, 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 (Дополнительный)	Значение, на котором будет производиться сравнение для извлечения значения измерения. Этот параметр необходим, если параметр `statistics_type` установлен на `ARGUMENT_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 *

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

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

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

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

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

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

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

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

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

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

Параметры

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

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

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

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