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

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

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

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

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

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

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

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

• Этот инструмент создает набор многомерных растровых данных в облачном растровом формате (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

Python

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

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

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