Contour

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

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

Обсуждение

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

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

Синтаксис

Contour (raster, {adaptive_smoothing}, {contour_type}, {z_base}, {number_of_contours}, {contour_interval}, {nth_contour_line_in_bold}, {z_factor})
ПараметрОписаниеТип данных
raster

The input 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

The z-factor is a scaling factor used to convert the elevation values for two purposes:

  • To convert the elevation units (such as meters or feet) to the horizontal coordinate units of the dataset, which may be feet, meters, or degrees.
  • To add vertical exaggeration for visual effect.

If the x,y units and z units are in the same units of measure, the z-factor should be set to 1. The z-values of the input surface are multiplied by the z-factor when calculating the final output surface.

(Значение по умолчанию — 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")