Доступно с лицензией Spatial Analyst.
Доступно с лицензией 3D Analyst.
Краткая информация
Интерполирует поверхность растра на основании значений в точках с использованием метода тренда.
Использование
По мере увеличения порядка (степени) полинома подбираемая поверхность становится все более сложной. Полином высокой степени не всегда позволит получить наиболее точную поверхность; точность поверхности будет зависеть от данных.
Для использования опции LOGISTIC в Типе регрессии, поля z-значений входных точечных объектов должны иметь коды ноль (0) и единица (1).
Выходной размер ячейки можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки невозможно указать непосредственно как значение параметра, он будет получен из параметра среды Размер ячейки, если он был там задан. Если же и в параметр среды значение размера ячейки не указано, но настроен параметр Растр привязки, то будет использоваться значение величины его ячейки. Если же ни один из параметров не задан, то размер ячейки будет вычислен как наименьшее значение длины либо ширины экстента растра, поделенное на 250, при этом экстент берется из параметра среды Выходная система координат.
Если размер ячейки указан в виде числа, то инструмент будет использовать это значение для выходного растра.
Если для определения размера ячейки указан другой растр, в параметре будет показан путь к набору растровых данных вместо значения размера ячейки. Размер ячейки этого растра будет использоваться непосредственно в анализе указанная пространственная привязка набора данных будет такой же, как и выходная система координат. Если же пространственная привязка набора данных отличается от выходной пространственной привязки, на будет перепроецирована на основе выбранного Метода проецирования размера ячейки.
Дополнительный выходной файл RMS содержит информацию о среднеквадратической ошибке интерполяции. Эта информация может быть использована для определения лучшего значения для степени полинома, через изменение значения степени до тех пор, пока вы не получите наименьшее значение среднеквадратической ошибки. Более подробно о том, как работает Тренд, смотрите в файле RMS.
Некоторые входные данные могут содержать несколько точек с одинаковыми x,y координатами. Если значения точек в одних и тех же местоположениях совпадают, такие точки считаются идентичными, и предполагается, что они не влияют на выходные данные. Если значения различаются, такие точки рассматриваются как совпадающие.
Различные инструменты интерполяции могут использовать это условие для данных по-разному. Например, в некоторых случаях для вычисления используется первая встреченная совпадающая точка; в других случаях используется последняя точка. Такая ситуация может приводить к тому, что в некоторых точках выходного растра значения будут отличаться от ожидаемых. Решением этой проблемы может стать предварительная подготовка данных, при которой совпадающие точки будут удалены. Инструмент Собрать события в наборе инструментов Пространственная статистика полезен для идентификации совпадающих точек в ваших данных.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
Trend(in_point_features, z_field, {cell_size}, {order}, {regression_type}, {out_rms_file})
Параметр | Объяснение | Тип данных |
in_point_features | Входные точечные объекты, содержащие z-значения, с помощью которых будет построен растр поверхности. | Feature Layer |
z_field | Поле, в котором хранится значение высоты или величины для каждой точки. Это может быть числовое поле или поле формы Shape, если входные точечные объекты содержат z-значения. Если тип регрессии — Логический, значения в поле могут быть только 0 или 1. | Field |
cell_size (Дополнительный) | Размер ячейки выходного растра, который будет создан. Этот параметр можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки не был в явном виде задан как значение параметра, будет использоваться значение размера ячейки, указанное в параметрах среды геообработки, если же и оно не указано, будут использоваться дополнительные правила вычисления размера ячейки на основе входных данных. Более подробно см. использование. | Analysis Cell Size |
order (Дополнительный) | Степень полинома. Должно быть задано целым числом от 1 до 12. Значение, равное 1, будет означать, что для точек будет подобрана плоская поверхность, а более высокое значение приведет к построению поверхности более сложной формы. Значение по умолчанию равно 1. | Long |
regression_type (Дополнительный) | Используемый тип уравнения регрессии.
| String |
out_rms_file (Дополнительный) | Имя выходного текстового файла, который содержит информацию о среднеквадратической ошибке (RMS) и хи-квадрат интерполяции. Расширение файла должно быть .txt. | File |
Возвращаемое значение
Имя | Объяснение | Тип данных |
out_raster | Выходной растр интерполированной поверхности. Это всегда растр с плавающей точкой. | Raster |
Пример кода
Trend, пример 1 (окно Python)
В этом примере входными данными является точечный шейп-файл, интерполируется выходная поверхность - растр TIFF.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outTrend = Trend("ozone_pts.shp", "ozone", 2000, 2, "LINEAR")
outTrend.save("C:/sapyexamples/output/trendout.tif")
Trend, пример 2 (автономный скрипт)
В этом примере входными данными является точечный шейп-файл, интерполируется выходная поверхность - растр Grid.
# Name: Trend_Ex_02.py
# Description: Interpolate a series of point features
# onto a rectangular raster using a trend technique.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inPointFeatures = "ca_ozone_pts.shp"
zField = "ozone"
cellSize = 2000.0
PolynomialOrder = 2
regressionType = "LINEAR"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Trend
outTrend = Trend(inPointFeatures, zField, cellSize,
PolynomialOrder, regressionType)
# Save the output
outTrend.save("C:/sapyexamples/output/trendout02")
Параметры среды
Информация о лицензиях
- Basic: Требуется Spatial Analyst или 3D Analyst
- Standard: Требуется Spatial Analyst или 3D Analyst
- Advanced: Требуется Spatial Analyst или 3D Analyst