Skip to main content

GenerateTrend

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

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

Обсуждение

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

Указанный набор растровых данных является временным для растрового объекта. Чтобы сделать его постоянным, вы можете вызвать метод растрового объекта 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 *

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