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})
ParameterОбъяснениеТип данных
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")