Contour

Сводка

Создает растровый объект для изолиний путем соединения точек с одинаковым значением из набора растровых данных. Горизонтали – это изолинии, созданные для визуализации растра.

Описание

Дополнительные сведения о работе этой функции см. в разделе Растровая функция Изолинии.

Указанный набор растровых данных является временным для растрового объекта. Чтобы сделать его постоянным, можно вызвать метод save растрового объекта.

Синтаксис

Contour (raster, {adaptive_smoothing}, {contour_type}, {z_base}, {number_of_contours}, {contour_interval}, {nth_contour_line_in_bold}, {z_factor})
ParameterОбъяснениеТип данных
raster

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

Raster
adaptive_smoothing

Величина сглаживания, применяемая к линии горизонтали. При более низком значении получаются менее сглаженные, ступенчатые изолинии, а увеличение значения приведет к более сглаженным изолиниям, выглядящим менее зазубренными.

(Значение по умолчанию — 2.5)

Double
contour_type

Тип создаваемых изолиний.

  • contour lines Соединяет точки одинаковой высоты, чтобы создать линию, представляющую постоянную высоту.
  • contour fill Заполняет область между каждой изолинией квантованным значением высоты.
  • smooth surface only Сглаживает входной слой высот, но не создает изолинии.

(Значение по умолчанию — contour lines)

String
z_base

Значение базовой изолинии. Изолинии строятся для значений выше и ниже значения этого параметра таким образом, чтобы охватить весь диапазон значений на входном растре.

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

(Значение по умолчанию — 0)

Double
number_of_contours

Число изолиний, которые будут созданы. Этот параметр динамически настраивает шаг горизонталей для соответствия рельефу на изображении и поддерживает стандартные интервалы 1, 5, 10 и т.д.

(Значение по умолчанию — 0)

Integer
contour_interval

Разница по высоте между линиями горизонталей.

Малая высота сечения используется в относительно плоских областях, а большие значения интервала используются для горного рельефа.

(Значение по умолчанию — 100)

Double
nth_contour_line_in_bold

Основная горизонталь, представляемая утолщенной линией.

(Значение по умолчанию — 5)

Integer
z_factor

z-factor является коэффициентом масштабирования, используемым для конвертации значений высоты для двух целей:

  • Для конвертации единиц высоты (например, метры или футы) в единицы горизонтальных координат набора данных, которые могут быть футами, метрами или градусами.
  • Для добавления вертикального преувеличения для визуального эффекта.

Если координаты x,y и z-значения приведены в одной и той же системе координат, коэффициент z должен быть равен 1. При вычислении результирующей выходной поверхности z-значения входной поверхности умножаются на коэффициент по z.

(Значение по умолчанию — 1)

Double
Значение отраженного сигнала
Тип данныхОбъяснение
Raster

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

Пример кода

Изолинии, пример 1

В этом примере создаются изолинии для предоставленного набора данных.

from arcpy.ia import *
out_contour_raster = Contour("contour_input.tif", "", "smooth surface only", "", "", 150, 10, 2)
out_contour_raster.save("C:/arcpyexamples/outputs/contour_surface.tif")
Изолинии, пример 2

В этом примере создаются изолинии для предоставленного набора данных.

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

# Set the analysis environments
arcpy.env.workspace = "C:/arcpyExamples/data"

# Set the local variables
in_raster = "contour_input.tif"

# Execute Contour function
out_contour_raster = Contour(in_raster, 3, "contour fill", 10, 20, 10, 3)

# Save the output
out_contour_raster.save("C:/arcpyExamples/outputs/contour_fill.tif")