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