Трансформация Top Hat (Инструменты Spatial Analyst)

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

Обнаруживает пространственные структуры на поверхности растра путем вычисления преобразований top hat.

Более подробно о том, как работает инструмент Трансформация Top Hat

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

Выходной растр представляет высоту или глубину пространственных структур, обнаруженных в местоположении каждой ячейки.
Значение параметра Тип анализа задает тип пространственных структур, которые необходимо обнаружить. Есть два варианта — Хребет или Долина. Тип анализа Хребет выявляет пространственные структуры, которые выше своего окружения. Тип анализа Долина выявляет пространственные структуры, которые ниже своего окружения.
Значение параметра Окрестность определяет форму и размер окна, используемого для анализа. Как правило, обнаруживаются пространственные структуры, размер или ширина которых меньше этой окрестности.
Доступные формы окрестностей — это круг, прямоугольник и нерегулярный. Опция нерегулярная окрестность — это пользовательский окрестность, задаваемая керн-файлом.

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

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

Подпись

Объяснение

Тип данных

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

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

Raster Layer

Квартал

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

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

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

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

Круг, Радиус, Тип единиц

Круговая окрестность с заданным радиусом. Минимальное значение радиуса — 1 ячейка, максимальное — 2047 ячеек. Значение радиуса по умолчанию равно трем ячейкам.
Прямоугольник, Высота, Ширина, Тип единиц

Прямоугольная окрестность, определенная высотой и шириной. Минимальное значение ширины или высоты — 1 ячейка, максимальное — 4096 ячеек. По умолчанию – это квадрат со стороной, равной 3 ячейкам.
Нерегулярный, Керн-файл

Пользовательская окрестность с характеристиками, заданными определенным текстовым керн-файлом. Минимальное значение ширины или высоты ядра — 1 ячейка, максимальное — 4096 ячеек.

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

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

Neighborhood

Тип анализа

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

Задает тип выявляемых объектов.

Хребет–Будут обнаружены объекты, которые выше окружающей местности (такие как мосты, дамбы и горные хребты). Используется по умолчанию.
Долина–Будут обнаружены объекты, которые ниже окружающей местности (такие как водотоки и долины).

String

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

Подпись	Объяснение	Тип данных
Выходной растр	Выходной растр. Значения ячеек выходного растра представляют высоту или глубину объектов, обнаруженных в местоположении каждой ячейки, в зависимости от типа анализа. Когда опция Хребет указана для параметра Тип анализа, выходные значения представляют высоту объектов, обнаруженных в местоположении каждой ячейки. Если опция Долина указана для параметра Тип анализа, выходные значения представляют собой глубину объектов, обнаруженных в каждом местоположении ячейки.	Raster

Подпись

Объяснение

Тип данных

Выходной растр

Выходной растр.

Значения ячеек выходного растра представляют высоту или глубину объектов, обнаруженных в местоположении каждой ячейки, в зависимости от типа анализа. Когда опция Хребет указана для параметра Тип анализа, выходные значения представляют высоту объектов, обнаруженных в местоположении каждой ячейки. Если опция Долина указана для параметра Тип анализа, выходные значения представляют собой глубину объектов, обнаруженных в каждом местоположении ячейки.

Raster

TopHatTransform(in_raster, {neighborhood}, {analysis_type})

Имя Объяснение Тип данных

Имя	Объяснение	Тип данных
in_raster	Входной растр поверхности.	Raster Layer
neighborhood (Дополнительный)	Ячейки, расположенные вокруг обрабатываемой, значения которых будут использоваться в вычислении преобразования top hat. Есть несколько предопределенных типов окрестностей для выбора, или можно задать пользовательский Кернел. Когда выбран тип окрестностей, можно задать другие параметры, чтобы полностью определить форму, размер и единицы измерения. Окрестность по умолчанию — это круг с радиусом 3 ячейки. Форма окрестностей определяется классом `Neighborhood`. Доступные типы окрестностей: `NbrCircle`, `NbrRectangle` и `NbrIrregular`. Доступны следующие формы типов окрестностей: `NbrCircle({radius}, {units}` Круговая окрестность с заданным радиусом. Минимальное значение радиуса — 1 ячейка, максимальное — 2047 ячеек. Значение радиуса по умолчанию равно трем ячейкам. `NbrRectangle({width}, {height}, {units})` Прямоугольная окрестность, определенная высотой и шириной. Минимальное значение ширины или высоты — 1 ячейка, максимальное — 4096 ячеек. По умолчанию – это квадрат со стороной, равной 3 ячейкам. `NbrIrregular(inKernelFile)` Пользовательская окрестность с характеристиками, заданными определенным текстовым керн-файлом. Минимальное значение ширины или высоты ядра — 1 ячейка, максимальное — 4096 ячеек. Для типа нерегулярной окрестности первая строка в керн-файле определяет ширину и высоту окрестности в количестве ячеек. Последующие строки показывают, как будет обрабатываться входное значение, которое соответствует расположению в керн-файле. Значение 0 в керн-файле показывает, что соответствующее расположение не будет включено в вычисление. Значение 1 указывает, что соответствующая входная ячейка будет включена.	Neighborhood
analysis_type (Дополнительный)	Задает тип выявляемых объектов. `RIDGE`–Будут обнаружены объекты, которые выше окружающей местности (такие как мосты, дамбы и горные хребты). Используется по умолчанию. `VALLEY`–Будут обнаружены объекты, которые ниже окружающей местности (такие как водотоки и долины).	String

in_raster

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

Raster Layer

neighborhood

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

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

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

NbrCircle({radius}, {units}

Круговая окрестность с заданным радиусом. Минимальное значение радиуса — 1 ячейка, максимальное — 2047 ячеек. Значение радиуса по умолчанию равно трем ячейкам.
NbrRectangle({width}, {height}, {units})

Прямоугольная окрестность, определенная высотой и шириной. Минимальное значение ширины или высоты — 1 ячейка, максимальное — 4096 ячеек. По умолчанию – это квадрат со стороной, равной 3 ячейкам.
NbrIrregular(inKernelFile)

Пользовательская окрестность с характеристиками, заданными определенным текстовым керн-файлом. Минимальное значение ширины или высоты ядра — 1 ячейка, максимальное — 4096 ячеек.

Neighborhood

analysis_type

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

Задает тип выявляемых объектов.

RIDGE–Будут обнаружены объекты, которые выше окружающей местности (такие как мосты, дамбы и горные хребты). Используется по умолчанию.
VALLEY–Будут обнаружены объекты, которые ниже окружающей местности (такие как водотоки и долины).

String

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

Имя Объяснение Тип данных

Имя	Объяснение	Тип данных
out_raster	Выходной растр. Значения ячеек выходного растра представляют высоту или глубину объектов, обнаруженных в местоположении каждой ячейки, в зависимости от типа анализа. Когда опция `RIDGE` указана для параметра `analysis_type`, выходные значения представляют высоту объектов, обнаруженных в местоположении каждой ячейки. Когда опция `VALLEY` указана для параметра `analysis_type`, выходные значения представляют собой глубину объектов, обнаруженных в каждом местоположении ячейки.	Raster

out_raster

Выходной растр.

Значения ячеек выходного растра представляют высоту или глубину объектов, обнаруженных в местоположении каждой ячейки, в зависимости от типа анализа. Когда опция RIDGE указана для параметра analysis_type, выходные значения представляют высоту объектов, обнаруженных в местоположении каждой ячейки. Когда опция VALLEY указана для параметра analysis_type, выходные значения представляют собой глубину объектов, обнаруженных в каждом местоположении ячейки.

Raster

Пример кода

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

В этом примере вычисляется трансформация top hat для входного растра с использованием типа анализа Долина.

from arcpy.sa import *
outRas = TopHatTransform('elevation.tif', "Circle 3 CELL", 'VALLEY')
outRas.save("C:/sapyexamples/output/thtout01.tif")

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

В этом примере вычисляется трансформация top hat для входного растра с использованием типа анализа Хребет.

# Name: TopHatTransform_standalone.py
# Description: Calculates the top hat transform.
# 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"
inAnalysisType = "RIDGE"

# Run the tool
outRas = TopHatTransform(inRaster, inNeighborhood, inAnalysisType)

# Save the output
outRas.save("C:/sapyexamples/output/thtout02.tif")

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

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

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

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

Трансформация Top Hat (Инструменты Spatial Analyst)

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

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

Параметры

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

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

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

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