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