Изолинии (3D Analyst)

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

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

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

Создает класс объектов изолиний из растровой поверхности.

Более подробно об изолиниях

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

  • Изолинии не выходят за пределы пространственного экстента растра, и они не создаются в областях значений NoData; поэтому сначала необходимо подогнать границы смежных входных данных изолиний в непрерывные наборы классов объектов. В качестве альтернативы стыковке изолиний в краевых зонах, вы можете выполнить объединение смежных растров до построения изолиний.

    Однако полигоны изолиний экстраполируются по внешнему ребру растра, если Тип изолиний отличен от Изолиния.

  • Изолинии могут быть построены для участков с отрицательными значениями растра. Значения изолиний на таких участках будут отрицательными. Отрицательные интервалы изолиний недопустимы.

  • При наличии дополнительного модуля ArcGIS Spatial Analyst более сглаженные, но менее точные изолинии можно получить путем предварительной обработки входного растра с помощью операции Фокальная статистика с опцией Mean или инструмента Фильтр с опцией Low.

  • Базовая изолиния используется в том случае, например, если вы хотите построить горизонтали через каждые 15 метров, начиная от высоты 10 метров. В данном случае 10 - базовая изолиния, а 15 интервал между изолиниями. Изолинии будут проведены через значения 10, 25, 40, 55 и так далее.

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

  • Тип изолиний используется для определения, будет ли выходной класс изолиний линейным или полигональным. Например, если у вас есть растр со значениями от 0 до 575, и интервал изолинии установлен на 250, инструмент может создать следующие классы. Представлены выходные данные, а также отдельные полигоны.

    • CONTOUR – линии на 250 и 500
    • CONTOUR_POLYGON – неперекрывающиеся полигоны между значениями 0 и 250, 250 и 500, 500 и 575 (рис. 1)

      Полигоны 0-250, 250-500 и 500-575

      Рис. 1. Опция Полигоны изолиний создаст три неперекрывающихся полигона: 0-250, 250-500 и 500-575.

    • CONTOUR_SHELL – перекрывающиеся полигоны 0-575, 0-500, and 0-250 (рис. 2)

      Полигоны 0-575, 0-500 и 0-250

      Рис. 2. Опция Оболочки изолиний создаст три перекрывающихся полигона: 0-575, 0-500 и 0-250.

    • CONTOUR_SHELL_UP – перекрывающиеся полигоны 0-575, 250-575 и 500-575 (рис. 3)

      Полигоны 0-575, 250-575 и 500-575

      Рис. 3. Опция Оболочки изолиний (сверху) создаст три перекрывающихся полигона: 0-575, 250-575 и 500-575.

  • Параметр Максимальное число вершин в объекте может использоваться для разделения объекта. Он должен использоваться только когда выходные объекты должны содержать очень большое число вершин (несколько миллионов). Этот параметр приводит к созданию выходных данных, схожих с результатом инструмента Нарезать.

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

    Выбор лимита зависит от доступной памяти на компьютере, где будет работать инструмент, и от размера объекта (более крупные объекты требуют больше памяти). На большинстве современных компьютеров с 64-разрядным ПО обычно не возникает проблем с объектами, содержащими сотни тысяч или миллионы вершин. Если вы сталкиваетесь с такими проблемами, установка большего значения для этого параметра, например, 1 миллион, может решить проблемы, связанные с размером объекта.

    Параметр Ограничение вершин может использоваться для разделения объекта. Он должен использоваться только когда выходные объекты должны содержать очень большое число вершин (несколько миллионов).

  • По умолчанию, этот инструмент использует преимущества многоядерных процессоров. Максимальное число ядер, которое может быть использовано,– четыре.

    Чтобы инструмент использовал меньшее число ядер, измените параметр среды parallelProcessingFactor.

  • Если в параметрах среды задан Экстент, а левый нижний угол выходного экстента не сопоставлен ни с одним углом ячейки входного растра, то в ходе обработки будет выполнен сдвиг ячеек входного растра, чтобы выровнять их относительно заданного экстента. Сдвиг вызовет пересчет входного растра с использованием билинейного метода. Следовательно, выходные объекты также будут смещаться, и результирующие выходные объекты могут не накладываться точно на исходный входной растр. Предотвратить этот сдвиг можно, используя в параметрах среды входной растр в качестве Растра привязки.

Параметры

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

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

Raster Layer
Выходной класс объектов

Выходные объекты изолиний.

Feature Class
Высота сечения

Интервал или расстояние между соседними изолиниями.

Этот параметр может быть представлен любым положительным числом.

Double
Базовая изолиния
(Дополнительный)

Значение базовой изолинии.

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

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

Коэффициент конвертации единиц измерения, применяемый при построении изолиний. Значение по умолчанию равно 1.

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

Например, если значения высоты во входном растре в футах, но вы хотите, чтобы изолинии создавались на основе метров, задайте z-коэффициент как 0.3048 (т.к 1 фут = 0.3048 метра).

Другой пример – рассмотрим входной растр с географическими координатами WGS_84, при этом его высоты измеряются в метрах. Необходимо построить изолинии для этого растра с шагом 100 футов, причем базовым должно быть значение в 50 футов (т.е. изолинии будут проходить на высотах 50 футов, 150 футов, 250 футов и т.д.). Для этого задайте Интервал изолиний как 100, Базовую изолинию как 50, а коэффициент Z как 3.2808 (т.к. 1 метр = 3.2808 фута).

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

Задает тип выходных данных. Выходные данные могут представлять изолинии как в виде линий, так и в виде полигонов. Есть несколько опций для полигонов.

  • Изолинии —Класс полигональных объектов изолиний. Это значение по умолчанию.
  • Полигоны изолиний —Класс полигональных объектов изолиний с заливкой.
  • Оболочки изолиний —Класс полигональных объектов, в котором верхняя граница полигона кумулятивно увеличивается на величину интервала. Нижняя граница остается константой на минимуме растра.
  • оболочки изолиний вершины —Класс полигональных объектов, в котором нижняя граница полигона кумулятивно увеличивается от минимального значения растра на величину интервала изолинии. Верхняя граница не меняется и равна максимальному значению растра.
String
Максимальное число вершин в объекте
(Дополнительный)

Задает лимит вершин при разделении объекта. Должен использоваться только когда выходные объекты содержат очень большое число вершин (несколько миллионов).

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

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

Long

arcpy.ddd.Contour(in_raster, out_polyline_features, contour_interval, {base_contour}, {z_factor}, {contour_type}, {max_vertices_per_feature})
ИмяОписаниеТип данных
in_raster

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

Raster Layer
out_polyline_features

Выходные объекты изолиний.

Feature Class
contour_interval

Интервал или расстояние между соседними изолиниями.

Этот параметр может быть представлен любым положительным числом.

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

Значение базовой изолинии.

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

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

Коэффициент конвертации единиц измерения, применяемый при построении изолиний. Значение по умолчанию равно 1.

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

Например, если значения высоты во входном растре в футах, но вы хотите, чтобы изолинии создавались на основе метров, задайте z-коэффициент как 0.3048 (т.к 1 фут = 0.3048 метра).

Другой пример – рассмотрим входной растр с географическими координатами WGS_84, при этом его высоты измеряются в метрах. Необходимо построить изолинии для этого растра с шагом 100 футов, причем базовым должно быть значение в 50 футов (т.е. изолинии будут проходить на высотах 50 футов, 150 футов, 250 футов и т.д.). Для этого задайте для contour_interval 100, для base_contour 50 и для z_factor 3.2808 (т.к. 1 метр = 3.2808 фута).

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

Задает тип выходных данных. Выходные данные могут представлять изолинии как в виде линий, так и в виде полигонов. Есть несколько опций для полигонов.

  • CONTOURКласс полигональных объектов изолиний. Это значение по умолчанию.
  • CONTOUR_POLYGONКласс полигональных объектов изолиний с заливкой.
  • CONTOUR_SHELLКласс полигональных объектов, в котором верхняя граница полигона кумулятивно увеличивается на величину интервала. Нижняя граница остается константой на минимуме растра.
  • CONTOUR_SHELL_UPКласс полигональных объектов, в котором нижняя граница полигона кумулятивно увеличивается от минимального значения растра на величину интервала изолинии. Верхняя граница не меняется и равна максимальному значению растра.
String
max_vertices_per_feature
(Дополнительный)

Задает лимит вершин при разделении объекта. Должен использоваться только когда выходные объекты содержат очень большое число вершин (несколько миллионов).

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

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

Long

Пример кода

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

В этом примере создаются изолинии из растра типа Esri Grid, и они выводятся в виде шейп-файла.

import arcpy
from arcpy import env  
env.workspace = "C:/data"
arcpy.Contour_3d("elevation", "C:/output/outcontours.shp", 200, 0)
Contour, пример 2 (автономный скрипт)

В этом примере создаются изолинии из растра типа Esri Grid, и они выводятся в виде шейп-файла.

# Name: Contour_3d_Ex_02.py
# Description: Creates contours or isolines from a raster surface.
# Requirements: 3D Analyst Extension

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"

# Set local variables
inRaster = "elevation"
contourInterval = 200
baseContour = 0
outContours = "C:/sapyexamples/output/outcontours02.shp"

# Execute Contour
arcpy.Contour_3d(inRaster, outContours, contourInterval, baseContour)

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