Индекс топографического положения (Spatial Analyst)—ArcGIS Pro

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

Вычисляет значение индекса топографического положения для каждой ячейки в указанной окрестности.

Подробнее о том, как работает инструмент Индекс топографического положения

Использование

Выходной растр этого инструмента содержит значения индекса топографического положения (TPI) для каждой ячейки. Значение TPI представляет собой разницу между значением текущей ячейки и средним значением всех ячеек в ее окрестности.
Доступные формы окрестностей: кольцо (пончик), круг, прямоугольник и клин. Пользовательская форма окрестности может задаваться керн-файлом.
Если задана окрестность в виде круга, окрестность в форме кольца или клина, некоторые внешние ячейки диагонали могут не учитываться в вычислениях, т.к. центр ячейки должен быть заключён в окрестность.
Для нерегулярного типа окрестности требуется задать значение Керн-файла. Керн-файл представляет собой текстовый ASCII-файл, который определяет значения и форму взвешенной окрестности. Файл можно создать с помощью любого текстового редактора. У файла должно быть расширение .txt и не должно быть пробелов в имени.
Если формат выходного растра .crf, этот инструмент поддерживает параметр среды хранения растровых изображений Пирамида. Пирамиды будут созданы в выходных данных по умолчанию. Для любого другого формата вывода этот параметр среды не поддерживается, и пирамиды создаваться не будут.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

Подпись	Описание	Тип данных
Входной растр поверхности	Входной растр поверхности.	Raster Layer
Окрестность (Дополнительный)	Ячейки, расположенные вокруг обрабатываемой, значения которых будут использоваться в вычислении TPI. Есть несколько предопределенных типов окрестностей для выбора, или можно задать пользовательское ядро. Когда выбран тип окрестности, можно задать другие параметры, чтобы полностью определить форму, размер и единицы измерения. Окрестность по умолчанию – кольцо внутренним радиусом в одну ячейку и внешним радиусом в три ячейки. Доступны следующие формы типов окрестностей: Кольцо, Внутренний радиус, Внешний радиус, Тип единиц Окрестность в форме кольца (пончика), определяемая внутренним и внешним радиусами. Минимальное значение радиуса — 1 ячейка, а внешний радиус должен быть больше внутреннего. Максимальный внутренний радиус — 2046 ячеек, а максимальный внешний радиус — 2047 ячеек. Кольцо по умолчанию характеризуется внутренним радиусом, равным 1 ячейке, и внешним радиусом, равным 3 ячейкам. Круг, Радиус, Тип единиц Круговая окрестность с заданным радиусом. Минимальное значение радиуса — 1 ячейка, максимальное — 2047 ячеек. Значение радиуса по умолчанию равно трем ячейкам. Прямоугольник, Высота, Ширина, Тип единиц Прямоугольная окрестность, определенная высотой и шириной. Минимальное значение ширины или высоты — 1 ячейка, максимальное — 4096 ячеек. По умолчанию – это квадрат со стороной, равной 3 ячейкам. Клин, Радиус, Начальный угол, Конечный угол, Тип единиц Окрестность в форме клина задается радиусом, начальным углом и конечным углом. Минимальное значение радиуса — 1 ячейка, максимальное — 2047 ячеек. Клин строится в направлении против часовой стрелки от начального угла до конечного угла. Углы задаются в градусах, величина равная 0 или 360 представляет восток. Могут использоваться отрицательные значения углов. Клин по умолчанию имеет значение от 0 до 90 градусов, с радиусом, равным 3 ячейкам. Нерегулярный, Керн-файл Пользовательская окрестность с характеристиками, заданными определенным текстовым керн-файлом. Минимальное значение ширины или высоты ядра — 1 ячейка, максимальное — 4096 ячеек. Для типов окрестности кольцо, окружность, прямоугольник и клин единицы расстояния для параметров могут быть заданы в единицах Ячейка или единицах Карта. По умолчанию используются единицы ячейки. Для типа нерегулярной окрестности первая строка в керн-файле определяет ширину и высоту окрестности в количестве ячеек. Последующие строки показывают, как будет обрабатываться входное значение, которое соответствует расположению в керн-файле. Значение 0 в керн-файле показывает, что соответствующее расположение не будет включено в вычисление. Значение 1 в керн-файле показывает, что соответствующая входная ячейка будет включена в операцию.	Neighborhood

Подпись

Описание

Тип данных

Входной растр поверхности

Входной растр поверхности.

Raster Layer

Окрестность

(Дополнительный)

Ячейки, расположенные вокруг обрабатываемой, значения которых будут использоваться в вычислении TPI. Есть несколько предопределенных типов окрестностей для выбора, или можно задать пользовательское ядро.

Когда выбран тип окрестности, можно задать другие параметры, чтобы полностью определить форму, размер и единицы измерения. Окрестность по умолчанию – кольцо внутренним радиусом в одну ячейку и внешним радиусом в три ячейки.

Доступны следующие формы типов окрестностей:

Кольцо, Внутренний радиус, Внешний радиус, Тип единиц
Окрестность в форме кольца (пончика), определяемая внутренним и внешним радиусами. Минимальное значение радиуса — 1 ячейка, а внешний радиус должен быть больше внутреннего. Максимальный внутренний радиус — 2046 ячеек, а максимальный внешний радиус — 2047 ячеек. Кольцо по умолчанию характеризуется внутренним радиусом, равным 1 ячейке, и внешним радиусом, равным 3 ячейкам.
Круг, Радиус, Тип единиц
Круговая окрестность с заданным радиусом. Минимальное значение радиуса — 1 ячейка, максимальное — 2047 ячеек. Значение радиуса по умолчанию равно трем ячейкам.
Прямоугольник, Высота, Ширина, Тип единиц
Прямоугольная окрестность, определенная высотой и шириной. Минимальное значение ширины или высоты — 1 ячейка, максимальное — 4096 ячеек. По умолчанию – это квадрат со стороной, равной 3 ячейкам.
Клин, Радиус, Начальный угол, Конечный угол, Тип единиц
Окрестность в форме клина задается радиусом, начальным углом и конечным углом. Минимальное значение радиуса — 1 ячейка, максимальное — 2047 ячеек. Клин строится в направлении против часовой стрелки от начального угла до конечного угла. Углы задаются в градусах, величина равная 0 или 360 представляет восток. Могут использоваться отрицательные значения углов. Клин по умолчанию имеет значение от 0 до 90 градусов, с радиусом, равным 3 ячейкам.
Нерегулярный, Керн-файл
Пользовательская окрестность с характеристиками, заданными определенным текстовым керн-файлом. Минимальное значение ширины или высоты ядра — 1 ячейка, максимальное — 4096 ячеек.

Для типов окрестности кольцо, окружность, прямоугольник и клин единицы расстояния для параметров могут быть заданы в единицах Ячейка или единицах Карта. По умолчанию используются единицы ячейки.

Для типа нерегулярной окрестности первая строка в керн-файле определяет ширину и высоту окрестности в количестве ячеек. Последующие строки показывают, как будет обрабатываться входное значение, которое соответствует расположению в керн-файле. Значение 0 в керн-файле показывает, что соответствующее расположение не будет включено в вычисление. Значение 1 в керн-файле показывает, что соответствующая входная ячейка будет включена в операцию.

Neighborhood

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

Подпись	Описание	Тип данных
Выходной растр	Выходной растр индекса топографического положения.	Raster

TopographicPositionIndex(in_raster, {neighborhood})

Имя	Описание	Тип данных
in_raster	Входной растр поверхности.	Raster Layer
neighborhood (Дополнительный)	Ячейки, расположенные вокруг обрабатываемой, значения которых будут использоваться в вычислении TPI. Есть несколько предопределенных типов окрестностей для выбора, или можно задать пользовательское ядро. Когда выбран тип окрестности, можно задать другие параметры, чтобы полностью определить форму, размер и единицы измерения. Окрестность по умолчанию – кольцо внутренним радиусом в одну ячейку и внешним радиусом в три ячейки. Форма окрестностей определяется классом Neighborhood. Доступные типы окрестностей NbrAnnulus, NbrCircle, NbrRectangle, NbrWedge и NbrIrregular. Доступны следующие формы типов окрестностей: NbrAnnulus({innerRadius}, {outerRadius}, {units}) Окрестность в форме кольца (пончика), определяемая внутренним и внешним радиусами. Минимальное значение радиуса — 1 ячейка, а внешний радиус должен быть больше внутреннего. Максимальный внутренний радиус — 2046 ячеек, а максимальный внешний радиус — 2047 ячеек. Кольцо по умолчанию характеризуется внутренним радиусом, равным 1 ячейке, и внешним радиусом, равным 3 ячейкам. NbrCircle({radius}, {units} Круговая окрестность с заданным радиусом. Минимальное значение радиуса — 1 ячейка, максимальное — 2047 ячеек. Значение радиуса по умолчанию равно трем ячейкам. NbrRectangle({width}, {height}, {units}) Прямоугольная окрестность, определенная высотой и шириной. Минимальное значение ширины или высоты — 1 ячейка, максимальное — 4096 ячеек. По умолчанию – это квадрат со стороной, равной 3 ячейкам. NbrWedge({radius}, {startAngle}, {endAngle}, {units}) Окрестность в форме клина задается радиусом, начальным углом и конечным углом. Минимальное значение радиуса — 1 ячейка, максимальное — 2047 ячеек. Клин строится в направлении против часовой стрелки от начального угла до конечного угла. Углы задаются в градусах, величина равная 0 или 360 представляет восток. Могут использоваться отрицательные значения углов. Клин по умолчанию имеет значение от 0 до 90 градусов, с радиусом, равным 3 ячейкам. NbrIrregular(inKernelFile) Пользовательская окрестность с характеристиками, заданными определенным текстовым керн-файлом. Минимальное значение ширины или высоты ядра — 1 ячейка, максимальное — 4096 ячеек. Для типа нерегулярной окрестности первая строка в керн-файле определяет ширину и высоту окрестности в количестве ячеек. Последующие строки показывают, как будет обрабатываться входное значение, которое соответствует расположению в керн-файле. Значение 0 в керн-файле показывает, что соответствующее расположение не будет включено в вычисление. Значение 1 в керн-файле показывает, что соответствующая входная ячейка будет включена в операцию.	Neighborhood

Имя

Описание

Тип данных

in_raster

Входной растр поверхности.

Raster Layer

neighborhood

(Дополнительный)

Ячейки, расположенные вокруг обрабатываемой, значения которых будут использоваться в вычислении TPI. Есть несколько предопределенных типов окрестностей для выбора, или можно задать пользовательское ядро.

Когда выбран тип окрестности, можно задать другие параметры, чтобы полностью определить форму, размер и единицы измерения. Окрестность по умолчанию – кольцо внутренним радиусом в одну ячейку и внешним радиусом в три ячейки.

Форма окрестностей определяется классом Neighborhood. Доступные типы окрестностей NbrAnnulus, NbrCircle, NbrRectangle, NbrWedge и NbrIrregular.

Доступны следующие формы типов окрестностей:

NbrAnnulus({innerRadius}, {outerRadius}, {units})
Окрестность в форме кольца (пончика), определяемая внутренним и внешним радиусами. Минимальное значение радиуса — 1 ячейка, а внешний радиус должен быть больше внутреннего. Максимальный внутренний радиус — 2046 ячеек, а максимальный внешний радиус — 2047 ячеек. Кольцо по умолчанию характеризуется внутренним радиусом, равным 1 ячейке, и внешним радиусом, равным 3 ячейкам.
NbrCircle({radius}, {units}
Круговая окрестность с заданным радиусом. Минимальное значение радиуса — 1 ячейка, максимальное — 2047 ячеек. Значение радиуса по умолчанию равно трем ячейкам.
NbrRectangle({width}, {height}, {units})
Прямоугольная окрестность, определенная высотой и шириной. Минимальное значение ширины или высоты — 1 ячейка, максимальное — 4096 ячеек. По умолчанию – это квадрат со стороной, равной 3 ячейкам.
NbrWedge({radius}, {startAngle}, {endAngle}, {units})
Окрестность в форме клина задается радиусом, начальным углом и конечным углом. Минимальное значение радиуса — 1 ячейка, максимальное — 2047 ячеек. Клин строится в направлении против часовой стрелки от начального угла до конечного угла. Углы задаются в градусах, величина равная 0 или 360 представляет восток. Могут использоваться отрицательные значения углов. Клин по умолчанию имеет значение от 0 до 90 градусов, с радиусом, равным 3 ячейкам.
NbrIrregular(inKernelFile)
Пользовательская окрестность с характеристиками, заданными определенным текстовым керн-файлом. Минимальное значение ширины или высоты ядра — 1 ячейка, максимальное — 4096 ячеек.

Для типа нерегулярной окрестности первая строка в керн-файле определяет ширину и высоту окрестности в количестве ячеек. Последующие строки показывают, как будет обрабатываться входное значение, которое соответствует расположению в керн-файле. Значение 0 в керн-файле показывает, что соответствующее расположение не будет включено в вычисление. Значение 1 в керн-файле показывает, что соответствующая входная ячейка будет включена в операцию.

Neighborhood

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

Имя	Описание	Тип данных
out_raster	Выходной растр индекса топографического положения.	Raster

Пример кода

TopographicPositionIndex, пример 1 (окно Python)

В этом примере вычисляется наименее часто возникающее значение в окрестности в форме кольца вокруг каждой ячейки входного растра.

from arcpy.sa import *
outTPI = TopographicPositionIndex("elevation.tif", "Annulus 1 3 CELL")
outTPI.save("C:/sapyexamples/output/tpiout01.tif")

TopographicPositionIndex, пример 2 (автономный скрипт)

В этом примере вычисляется наименее часто возникающее значение в окрестности 10 на 10 вокруг каждой ячейки входного растра.

# Name: TopographicPositionIndex_standalone.py
# Description: Calculates the TPI.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy.sa import *

# Set environment settings
arcpy.env.workspace = "C:/sapyexamples/data"

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

# Set local variables
inRaster = "elevation.tif"
inNeighborhood = "Circle 90 Map"

# Execute the tool
outTPI = TopographicPositionIndex(inRaster, inNeighborhood)

# Save the output 
outTPI.save("C:/sapyexamples/output/tpiout02.tif")

Параметры среды

Автоматическое подтверждение, Размер ячейки, Метод проецирования размера ячейки, Сжатие, Текущая рабочая область, Экстент, Географические преобразования, Маска, Выходное ключевое слово CONFIG, Выходная система координат, Временная рабочая область, Растр привязки, Размер листа

Информация о лицензиях

Basic: Обязательно Spatial Analyst
Standard: Обязательно Spatial Analyst
Advanced: Обязательно Spatial Analyst

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

Использование

Параметры

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

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

Пример кода

Параметры среды

Информация о лицензиях

В этом разделе