GenerateTrend

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

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

Оценивает тренд для каждого пиксела вдоль измерения для одной или нескольких переменных в многомерном растре.

Обсуждение

Более подробную информацию о том, как работает эта функция, см. растровую функцию Создать тренд.

Указанный набор растровых данных является временным для растрового объекта. Чтобы сделать его постоянным, вы можете вызвать метод растрового объекта save.

Синтаксис

GenerateTrend (raster, dimension_name, {regression_type}, {cycle_length}, {cycle_unit}, {harmonic_frequency}, {polynomial_order}, {ignore_nodata}, {rmse}, {r2}, {slope_p_value}, {seasonal_period})

Параметр	Описание	Тип данных
raster	Входной многомерный набор растровых данных.	Raster
dimension_name	Имя измерения, по которому будет извлечен тренд для переменной или переменных, выбранных в анализе.	String
regression_type	Задает тип линии, которая будет использоваться со значениями пикселов в данном измерении. LINEAR—Переменные значения пикселов будут расположены вдоль линии линейного тренда. Это значение по умолчанию. HARMONIC—Переменные значения пикселов будут расположены вдоль линии гармонического тренда. POLYNOMIAL—Переменные значения пикселов будут расположены вдоль линии тренда полинома второго порядка. MANN-KENDALL—Переменные значения пикселов будут оцениваться с помощью теста тренда Mann-Kendall. SEASONAL-KENDALL—Переменные значения пикселов будут оцениваться с помощью теста тренда Seasonal-Kendall. (Значение по умолчанию — LINEAR)	String
cycle_length	Длина периодической вариации для моделирования. Этот параметр требуется, когда для параметра regression_type задано HARMONIC. Например, для насыщенности зеленого цвета листьев часто характерен явный цикл изменения в течение одного года, поэтому cycle_length составляет 1. Почасовые температурные данные характеризуются явным циклом изменения в течение одного дня, поэтому cycle_length составляет 1 день. Значение по умолчанию равно 1. (Значение по умолчанию — 1)	Integer
cycle_unit	Определяет единицу времени, которая будет использоваться для длины гармонического цикла. DAYS—Единицей измерения длины для гармонического цикла является день. YEARS—Единицей измерения длины для гармонического цикла является год. Это значение по умолчанию. (Значение по умолчанию — YEARS)	String
harmonic_frequency	Число моделей, использующихся в подгонке тренда, если значение regression_type равно HARMONIC. Значение по умолчанию – 1, то есть один гармонический цикл в год. Этот аргумент включается в анализ тренда только в том случае, если анализируемым измерением является время. (Значение по умолчанию — 1)	Integer
polynomial_order	Степень полинома, использующегося в подгонке тренда, если значение regression_type равно POLYNOMIAL. По умолчанию – 2, то есть полином второго порядка. Этот аргумент включается в анализ тренда только в том случае, если анализируемым измерением является время. (Значение по умолчанию — 2)	Integer
ignore_nodata	Определяет, будут ли игнорироваться значения NoData в анализе. True — анализ будет включать все действительные пикселы вдоль данного измерения и игнорировать любые пикселы NoData. Это значение по умолчанию. False — результатом анализа будет значение NoData, если для этого пиксела по данному измерению есть хотя бы одно значение NoData. (Значение по умолчанию — True)	Boolean
rmse	Указывает, следует ли вычислить среднеквадратичную ошибку (RMSE) линии тренда. True — RMSE будет вычислена. Это значение по умолчанию. False — RMSE не будет вычисляться. (Значение по умолчанию — True)	Boolean
r2	Указывает, следует ли вычислять статистику пригодности R-квадрата для линии тренда. True — R-квадрат будет вычисляться. False — R-квадрат не вычисляется. Это значение по умолчанию. (Значение по умолчанию — False)	Boolean
slope_p_value	Указывает, следует ли вычислять статистику p-значения для коэффициента уклона линии тренда. True — p-значение будет вычисляться. False — p-значение не вычисляется. Это значение по умолчанию. (Значение по умолчанию — False)	Boolean
seasonal_period	Определяет применяемую для периода единицу измерения. Необходим, если для аргумента regression_type задано SEASONAL-KENDALL. DAYS—Единицей измерения продолжительности для сезонного периода является день. Это значение по умолчанию. MONTHS—Единицей измерения продолжительности для сезонного периода является месяц. (Значение по умолчанию — DAYS)	String

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

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

Пример кода

Пример GenerateTrendRaster

В этом примере вычисляется соответствие гармоническому тренду временных рядов NDVI.

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

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

# Set the local variables
in_multidimensional_raster = "C:/data/ndvi_time_series.crf"
dimension_name = "StdTime"
regression_type = "HARMONIC"
cycle_length = 1
cycle_unit = "YEARS"
harmonic_frequency = 1
polynomial_order = None
ignore_nodata = True

rmse = True
r2 = False
slope_p_value = False
seasonal_period = None

# Apply GenerateTrendRaster function
trend_raster = arcpy.ia.GenerateTrend(in_multidimensional_raster,
                dimension_name, regression_type, cycle_length, cycle_unit, 
				harmonic_frequency, polynomial_order, ignore_nodata, rmse,
				r2, slope_p_value, seasonal_period)

# Save the output
trend_raster.save("C:/arcpyExamples/outputs/ndvi_trend_raster.crf")