Геоморфологические формы рельефа (Spatial Analyst)

Доступно с лицензией Spatial Analyst.

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

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

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

  • Геоморфон - это представление ландшафта, основанное на перепадах высот в пределах окружающей области целевой ячейки. 498 уникальных геоморфологических структур можно классифицировать в 10 обычных типов форм рельефа: равнина, вершина, хребет, плечо, отрог, склон, впадина, подножие, долина и яма (Ясевич и Степиски, 2012 г.).

  • Значение параметра Выходной растр форм рельефа (out_landforms_raster в Python) - это основные выходные данные. Этот растр представляет результат классификации геоморфонов в 10 типов форм рельефа с использованием таблицы перекодировки. Геоморфологические структуры - это дополнительные выходные данные, их можно сохранить, задав значение параметра с (out_geomorphons_raster в Python). Этот растр представляет уникальный идентификатор геоморфологической структуры. Его можно использовать для классификации геоморфонов по формам рельефа, отличным от тех, которые указаны в значении Выходной растр форм рельефа.

  • Окружающая область (область анализа) целевой ячейки задается параметрами Расстояние поиска (search_distance в Python) и Расстояние пропуска (skip_distance в Python). Эти параметры задают радиус области, которая будет использоваться для вычисления геоморфологической структуры целевой ячейки. Параметр Расстояние пропуска указывает расстояние от целевой ячейки, от которой начинается область анализа. Параметр Расстояние поиска указывает протяженность области. Значение параметра Расстояние пропуска должно быть меньше значения параметра Расстояние поиска.

  • Когда для параметра Расстояние поиска используется большое значение, результатом является большая область анализа, которая может предоставить больше информации об окружающей поверхности и повысить возможность классифицировать целевую ячейку как часть большого ландшафтного объекта. В то же время, большое значение может упустить небольшие формы рельефа. Например, ячейка может быть классифицирована как равнина в небольшой области анализа (маленькое значение Расстояния поиска), но в более широкой области анализа (большее значение Расстояния поиска) она может быть классифицирована как долина. Меньшие значения параметра Расстояние поиска приведут к небольшим областям анализа, где большие формы рельефа могут быть раздроблены на небольшие объекты и соответственно классифицированы.

  • Заданное значение параметра Расстояние пропуска приводит к целевому фокусированию на областях, удаленных от целевой ячейки, и создает более сглаженный растр классифицированных форм рельефа. Если значение Расстояние пропуска задано, все соседние ячейки в пределах области анализа будут рассматриваться при идентификации геоморфологической структуры.

  • Параметр Пороговое значение угла плоской поверхности (angle_threshold в Python) указывает разницу между углами линий взгляда, ниже которых видимая окружающая область будет считаться плоской. При определении значения параметра Пороговое значение угла плоской поверхности учитывайте размер ячейки значения параметра Входной растр поверхности. Например, разница в 1 градус означает несколько метров разницы высот для входного растра с большим размером ячейки. Большое значение параметра Пороговое значение угла плоской поверхности приведет к тому, что больше областей будет идентифицировано как равнина.

  • Указание значения Z-единиц (z_unit в Python) обеспечивает правильное вычисление разницы в высоте и углов линий взгляда, используемых для построения геоморфологические структуры и классификации форм рельефа.

    Если единицы измерения z-значения имеются вертикальной системе координат входного растра, то они будут применяться автоматически. Рекомендуется задавать z-единицы для входного растра, если они отсутствуют во входном растре поверхности. Вы можете использовать инструмент Определить проекцию для указания z-единиц. Если вертикальные координаты не заданы, по умолчанию будут использоваться метры. Этот инструмент покажет предупреждение, если заданные z-единицы являются некорректными на основании вычисления углов линий взгляда в направлении каждой из сторон света. Например, если значения высот ЦМР - метры, а для Z-единиц указаны сантиметры, поверхность будет рассматриваться как плоская, и формы рельефа будут классифицированы неправильно.

  • Ячейки NoData в растре поверхности будут игнорироваться, и таким ячейкам будет присвоено значение NoData в значениях параметров Выходной растр форм рельефа и Выходной растр геоморфонов.

  • Ссылки:

    • Jasiewicz, J and Stepinski, T. J., Geomorphons - a pattern recognition approach to classification and mapping of landforms, Geomorphology, 182, January 15, 2013: 147-56. https://doi.org/10.1016/j.geomorph.2012.11.005

Параметры

ПодписьОписаниеТип данных
Входной растр поверхности

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

Raster Layer
Выходной растр геоморфонов
(Дополнительный)

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

Выходной растр должен быть целочисленным.

Raster Dataset
Пороговое значение угла плоской поверхности
(Дополнительный)

Пороговое значение угла (в градусах), ниже которого целевая ячейка будут классифицирована как равнина.

Значение по умолчанию составляет 1 градус. Для ЦМР низкого разрешения рекомендуется указывать значение больше значения по умолчанию.

Double
Единицы расстояния
(Дополнительный)

Указывает единицы расстояния, которые будут использоваться для параметров Расстояние поиска и Расстояние пропуска.

Расстояние будет измеряться в указанных единицах или количестве ячеек. Значение по умолчанию - Ячейки.

  • ЯчейкиЕдиницами измерения расстояния будут ячейки.
  • МетрыЕдиницами измерения расстояния будут метры.
  • СантиметрыЕдиницей измерения расстояния будет сантиметр.
  • КилометрыЕдиницами измерения расстояния будут километры.
  • ДюймыЕдиницей измерения расстояния будет дюйм.
  • ФутыЕдиницами измерения расстояния будут футы.
  • ЯрдЕдиницей измерения расстояния будет ярд.
  • МилиЕдиницами измерения расстояния будут мили.
String
Расстояние поиска
(Дополнительный)

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

Значением по умолчанию является 10. Используйте значение расстояния поиска, соответствующие типу и размеру форм рельефа, которые вы хотите классифицировать.

Double
Расстояние пропуска
(Дополнительный)

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

Классификация каждой отдельной ячейки определяется путем оценки соседних ячеек в пределах расстояния пропуска от центра целевой ячейки.

Double
Z единицы
(Дополнительный)

Задает линейные единицы измерения, которые будет использоваться для вертикальных z-значений.

Они определяется вертикальной системой координат, если она указана. Если вертикальной системы координат нет, то единицы измерения z-значений необходимо указать в списке единиц, чтобы обеспечить точный геодезический расчет. По умолчанию метры.

  • ДюймЛинейными единицами измерения будут дюймы.
  • ФутЛинейными единицами измерения будут футы.
  • ЯрдЛинейными единицами измерения будут ярды.
  • Миля (США)Линейными единицами измерения будут мили.
  • Морская миляЛинейными единицами измерения будут морские мили.
  • МиллиметрЛинейными единицами измерения будут миллиметры.
  • СантиметрЛинейными единицами измерения будут сантиметры.
  • МетрЛинейными единицами измерения будут метры.
  • КилометрЛинейными единицами измерения будут километры.
  • ДециметрЛинейными единицами измерения будут дециметры.
String

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

ПодписьОписаниеТип данных
Выходной растр форм рельефа

Выходной растр классифицированных форм рельефа.

Выходной растр должен быть целочисленным.

Каждое значение соответствует определенному типу форм рельефа: равнина (Flat) — значение ячейки 1, вершина (Peak) — 2, хребет (Ridge) — 3, плечо (Shoulder) — 4, отрог (Spur) — 5, склон (Slope) — 6, впадина (Hollow) — 7, подножие (Footslope) — 8, долина (Valley) — 9, яма (Pit) — 10.

Raster

GeomorphonLandforms(in_surface_raster, {out_geomorphons_raster}, {angle_threshold}, {distance_units}, {search_distance}, {skip_distance}, {z_unit})
ИмяОписаниеТип данных
in_surface_raster

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

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

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

Выходной растр должен быть целочисленным.

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

Пороговое значение угла (в градусах), ниже которого целевая ячейка будут классифицирована как равнина.

Значение по умолчанию составляет 1 градус. Для ЦМР низкого разрешения рекомендуется указывать значение больше значения по умолчанию.

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

Указывает единицы расстояния, которые будут использоваться для параметров Расстояние поиска и Расстояние пропуска.

Расстояние будет измеряться в указанных единицах или количестве ячеек. Значение по умолчанию - Ячейки.

Указывает единицы расстояния, которые будут использоваться для параметров search_distance и skip_distance.

Расстояние будет измеряться в указанных единицах или количестве ячеек. По умолчанию – CELLS.

  • CELLSЕдиницами измерения расстояния будут ячейки.
  • METERSЕдиницами измерения расстояния будут метры.
  • CENTIMETERSЕдиницей измерения расстояния будет сантиметр.
  • KILOMETERSЕдиницами измерения расстояния будут километры.
  • INCHESЕдиницей измерения расстояния будет дюйм.
  • FEETЕдиницами измерения расстояния будут футы.
  • YARDSЕдиницей измерения расстояния будет ярд.
  • MILESЕдиницами измерения расстояния будут мили.
String
search_distance
(Дополнительный)

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

Значением по умолчанию является 10. Используйте значение расстояния поиска, соответствующие типу и размеру форм рельефа, которые вы хотите классифицировать.

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

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

Классификация каждой отдельной ячейки определяется путем оценки соседних ячеек в пределах расстояния пропуска от центра целевой ячейки.

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

Задает линейные единицы измерения, которые будет использоваться для вертикальных z-значений.

Они определяется вертикальной системой координат, если она указана. Если вертикальной системы координат нет, то единицы измерения z-значений необходимо указать в списке единиц, чтобы обеспечить точный геодезический расчет. По умолчанию метры.

  • INCHЛинейными единицами измерения будут дюймы.
  • FOOTЛинейными единицами измерения будут футы.
  • YARDЛинейными единицами измерения будут ярды.
  • MILE_USЛинейными единицами измерения будут мили.
  • NAUTICAL_MILEЛинейными единицами измерения будут морские мили.
  • MILLIMETERЛинейными единицами измерения будут миллиметры.
  • CENTIMETERЛинейными единицами измерения будут сантиметры.
  • METERЛинейными единицами измерения будут метры.
  • KILOMETERЛинейными единицами измерения будут километры.
  • DECIMETERЛинейными единицами измерения будут дециметры.
String

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

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

Выходной растр классифицированных форм рельефа.

Выходной растр должен быть целочисленным.

Каждое значение соответствует определенному типу форм рельефа: равнина (Flat) — значение ячейки 1, вершина (Peak) — 2, хребет (Ridge) — 3, плечо (Shoulder) — 4, отрог (Spur) — 5, склон (Slope) — 6, впадина (Hollow) — 7, подножие (Footslope) — 8, долина (Valley) — 9, яма (Pit) — 10.

Raster

Пример кода

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

В следующем примере показано использование этого инструмента в окне Python.

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

from arcpy.sa import *
outGeomorphonLandforms = GeomorphonLandforms("elevation_1m.tif", "", "", "", "", "", "")
outGeomorphonLandforms.save("C:/sapyexamples/output/outgeorphonlandforms01.tif")
GeomorphonLandforms, пример 2 (автономный скрипт)

В следующем примере показано использование этого инструмента в автономном скрипте Python.

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

# Name: GeomorphonLandforms_standalone.py
# Description: Calculates geomorphons over a search distance of 50 meters, skipping cells within 2 meters
# of the target cell. Terrain is considered flat if the difference between elevation angles is less or equal to 2 degrees.
# The calculated geomorphons are classified into landforms and saved as a raster. 
# 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_1m.tif"
inAngleThreshold = 2
inDistanceUnits = "METERS"
inSearchDistance = 50
inSkipDistance = 2
inZunit = "METER"

# Execute the tool
outGeomorphonLandforms = GeomorphonLandforms(inRaster, "", inAngleThreshold, inDistanceUnits,
                                         inSearchDistance, inSkipDistance, inZunit)

# Save the output 
outGeomorphonLandforms.save("C:/sapyexamples/output/outgeomorphonlandforms02.tif")

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

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

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