Индекс топографического положения (Инструменты Spatial Analyst)

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

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

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

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

Выходной растр этого инструмента содержит значения индекса топографического положения (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

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

Форма окрестностей определяется классом 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 ячеек.

Neighborhood

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

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

Пример кода

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

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

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

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

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

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

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

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

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

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

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

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

Basic: Требуется Spatial Analyst
Standard: Требуется Spatial Analyst
Advanced: Требуется Spatial Analyst

Индекс топографического положения (Инструменты Spatial Analyst)

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

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

Параметры

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

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

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

Связанные разделы