Создать Terrain (3D Analyst)

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

Создает набор данных Terrain.

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

• Значение параметра Средний интервал между точками должно отражать приближенное представление данных, использующихся в наборе terrain, так как оно используется для задания размера внутренних листов Terrain, служащих для оптимизации производительности анализа и отображения. Каждый лист может содержать не более, чем 200000 точек высот источника. Если данные собираются из значительно отличающихся источников, указанное значение должно соответствовать наименьшему интервалу.

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входной набор классов объектов	Набор классов объектов, в котором будет находиться набор данных terrain.	Feature Dataset
Выходной Terrain	Имя выходного набора данных terrain.	String
Средний интервал между точками	При моделировании terrain используется среднее горизонтальное расстояние между точками данных. При измерениях с помощью сенсоров, таких как, фотограмметрии, лидарной и сонарной съемок, интервал между точками обычно известен. Используйте горизонтальные единицы системы координат набора объектов для интервала.	Double
Максимальный размер обзорного изображения (Дополнительный)	Обзор набора данных terrain напоминает эскизное отображение. Это очень грубое отображение набора данных terrain, его максимальный размер соответствует верхней границе количества точек измерений, которые выбираются для создания обзора.	Long
Ключевое слово конфигурации (Дополнительный)	Ключевое слово конфигурации для оптимизации хранения наборов данных terrain в многопользовательской базе данных.	String
Тип пирамидных слоев (Дополнительный)	Указывает метод прореживания данных, который будет использоваться для построения пирамидных слоёв terrain. Размер окна—Точки данных в области, определенной заданным размером окна для каждого уровня пирамидных слоёв, будут выбраны с использованием значения параметра Метод Размер окна. Это значение по умолчанию Допуск Z—Будет указана вертикальная точность каждого уровня пирамидных слоев относительно полного разрешения точек данных.	String
Метод Размер окна (Дополнительный)	Указывает, как будут выбираться точки в области, определяемой размером окна. Этот параметр применим только тогда, когда выбран Размер окна для параметра Тип пирамидных слоев. Минимум Z—Будет выбрана точка с минимальным значением высоты. Это значение по умолчанию Максимум Z—Будет выбрана точка с максимальным значением высоты. Ближайшее к среднему Z—Будет выбрана точка со значением высоты, наиболее близким к среднему значению всех высот. Минимум и максимум Z—Будут выбраны точки с минимальным и максимальным значениями высоты.	String
Порог вторичного прореживания (Дополнительный)	Указывает дополнительные опции прореживания, которые будут применяться, чтобы уменьшить число точек на плоских поверхностях, при использовании пирамидных слоев типа Размер окна. Область расценивается как плоская, если высоты точек внутри нее находятся в пределе Порог вторичного прореживания. Этот эффект лучше всего проявляется на уровнях пирамидных слоев с высоким разрешением, так как маленькие области более вероятно будут расценены как плоские, нежели большие. Нет—Вторичное прореживание не будет выполняться. Это значение по умолчанию Мягкое—Мягкое прореживание будет применяться для защиты линейных неоднородностей (например, форм домов и границ леса). Этот метод рекомендуется для лидарных данных: наземных и не наземных точек. Он разредит меньшее количество точек. Среднее—Будет выполнено умеренное прореживание, которое обеспечивает баланс между производительностью и точностью. Этот метод не защищает детали, как это делает мягкое прореживание, но позволяет осуществлять значительное приближение при фильтрации большего количества точек. Сильное—Сильное прореживание будет удалять большинство точек и не защищает детали объектов. Метод находит применение только на поверхностях, где уклон имеет тенденцию изменяться плавно. Например, сильное прореживание целесообразно для наземной лидарной съёмки и батиметрии.	String
Порог вторичного прореживания (Дополнительный)	Вертикальный предел, который будет использоваться для активации вторичного прореживания, когда для параметра Тип пирамидных слоев выбран Размер окна. Установите это значение равным вертикальной точности данных или больше.	Double
Метод триангуляции (Дополнительный)	Указывает, будут ли структурные объекты включены в поверхность Terrain путем уплотнения их сегментов в соответствии с правилами триангуляции Делоне для построения поверхности TIN. Триангуляция Делоне уплотнит объекты линии перегиба, чтобы разместить окружающие их точки таким образом, чтобы избежать создания длинных тонких треугольников, которые обычно дают нежелательные результаты при анализе поверхности на основе TIN. Кроме того, интерполяция ближайших окрестностей и создание полигонов Тиссена (Вороного) могут быть выполнены только в триангуляциях по Делоне. Ограниченная триангуляция Делоне позволит избежать уплотнения объектов линии перегиба, включив сегменты линии перегиба в качестве ребер в поверхность TIN. Рассмотрите этот вариант, когда вам нужно явно задать определенные ребра, которые гарантированно не будут изменены (то есть разделены на несколько ребер) триангулятором. Делоне—Линии перегиба будут уплотнены для построения треугольников Делоне, которые будут соответствовать окружающим их точкам. Это значение по умолчанию Делоне с ограничениями—Линии перегиба не будут уплотнены.	String

Производные выходные данные

Подпись	Описание	Тип данных
Выходной Terrain	Новый набор данных terrain.	Terrain

Python

arcpy.ddd.CreateTerrain(in_feature_dataset, out_terrain_name, average_point_spacing, {max_overview_size}, {config_keyword}, {pyramid_type}, {windowsize_method}, {secondary_thinning_method}, {secondary_thinning_threshold}, {triangulation_method})

Имя	Описание	Тип данных
in_feature_dataset	Набор классов объектов, в котором будет находиться набор данных terrain.	Feature Dataset
out_terrain_name	Имя выходного набора данных terrain.	String
average_point_spacing	При моделировании terrain используется среднее горизонтальное расстояние между точками данных. При измерениях с помощью сенсоров, таких как, фотограмметрии, лидарной и сонарной съемок, интервал между точками обычно известен. Используйте горизонтальные единицы системы координат набора объектов для интервала.	Double
max_overview_size (Дополнительный)	Обзор набора данных terrain напоминает эскизное отображение. Это очень грубое отображение набора данных terrain, его максимальный размер соответствует верхней границе количества точек измерений, которые выбираются для создания обзора.	Long
config_keyword (Дополнительный)	Ключевое слово конфигурации для оптимизации хранения наборов данных terrain в многопользовательской базе данных.	String
pyramid_type (Дополнительный)	Указывает метод прореживания данных, который будет использоваться для построения пирамидных слоёв terrain. WINDOWSIZE—Точки данных в области, определенной заданным размером окна для каждого уровня пирамидных слоёв, будут выбраны с использованием значения параметра windowsize_method. Это значение по умолчанию ZTOLERANCE—Будет указана вертикальная точность каждого уровня пирамидных слоев относительно полного разрешения точек данных.	String
windowsize_method (Дополнительный)	Указывает, как будут выбираться точки в области, определяемой размером окна. Этот параметр применим только тогда, когда выбрано значение WINDOWSIZE для параметра pyramid_type. ZMIN—Будет выбрана точка с минимальным значением высоты. Это значение по умолчанию ZMAX—Будет выбрана точка с максимальным значением высоты. ZMEAN—Будет выбрана точка со значением высоты, наиболее близким к среднему значению всех высот. ZMINMAX—Будут выбраны точки с минимальным и максимальным значениями высоты.	String
secondary_thinning_method (Дополнительный)	Указывает дополнительные опции прореживания, которые будут применяться, чтобы уменьшить число точек на плоских поверхностях, при использовании пирамидных слоев типа Размер окна. Область расценивается как плоская, если высоты точек внутри нее находятся в пределе secondary_thinning_threshold. Этот эффект лучше всего проявляется на уровнях пирамидных слоев с высоким разрешением, так как маленькие области более вероятно будут расценены как плоские, нежели большие. NONE—Вторичное прореживание не будет выполняться. Это значение по умолчанию MILD—Мягкое прореживание будет применяться для защиты линейных неоднородностей (например, форм домов и границ леса). Этот метод рекомендуется для лидарных данных: наземных и не наземных точек. Он разредит меньшее количество точек. MODERATE—Будет выполнено умеренное прореживание, которое обеспечивает баланс между производительностью и точностью. Этот метод не защищает детали, как это делает мягкое прореживание, но позволяет осуществлять значительное приближение при фильтрации большего количества точек. STRONG—Сильное прореживание будет удалять большинство точек и не защищает детали объектов. Метод находит применение только на поверхностях, где уклон имеет тенденцию изменяться плавно. Например, сильное прореживание целесообразно для наземной лидарной съёмки и батиметрии.	String
secondary_thinning_threshold (Дополнительный)	Вертикальный предел, который будет использоваться для активации вторичного прореживания, когда для параметра pyramid_type выбран WINDOWSIZE. Установите это значение равным вертикальной точности данных или больше.	Double
triangulation_method (Дополнительный)	Указывает, будут ли структурные объекты включены в поверхность Terrain путем уплотнения их сегментов в соответствии с правилами триангуляции Делоне для построения поверхности TIN. Триангуляция Делоне уплотнит объекты линии перегиба, чтобы разместить окружающие их точки таким образом, чтобы избежать создания длинных тонких треугольников, которые обычно дают нежелательные результаты при анализе поверхности на основе TIN. Кроме того, интерполяция ближайших окрестностей и создание полигонов Тиссена (Вороного) могут быть выполнены только в триангуляциях по Делоне. Ограниченная триангуляция Делоне позволит избежать уплотнения объектов линии перегиба, включив сегменты линии перегиба в качестве ребер в поверхность TIN. Рассмотрите этот вариант, когда вам нужно явно задать определенные ребра, которые гарантированно не будут изменены (то есть разделены на несколько ребер) триангулятором. DELAUNAY—Линии перегиба будут уплотнены для построения треугольников Делоне, которые будут соответствовать окружающим их точкам. Это значение по умолчанию CONSTRAINED_DELAUNAY—Линии перегиба не будут уплотнены.	String

Производные выходные данные

Имя	Описание	Тип данных
derived_out_terrain	Новый набор данных terrain.	Terrain

Пример кода

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

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

arcpy.env.workspace = 'C:/data'
arcpy.ddd.CreateTerrain('source.gdb/Redlands', 'Redlands_terrain',  5,
                      50000, '', 'WINDOWSIZE', 'ZMIN', 'NONE', 1)

CreateTerrain, пример 2 (автономный скрипт)

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

"""****************************************************************************
Name: Create Terrain from TIN
Description: This script demonstrates how to create a terrain dataset using
             features extracted from a TIN. It is particularly useful in
             situations where the source data used in the TIN is not available,
             and the amount of data stored in the TIN proves to be too large
             for the TIN. The terrain's scalability will allow improved
             display performance and faster analysis. The script is designed
             to work as a script tool with 5 input arguments.
****************************************************************************"""
# Import system modules
import arcpy

# Set local variables
tin = arcpy.GetParameterAsText(0) # TIN used to create terrain
gdbLocation = arcpy.GetParameterAsText(1) # Folder that will store terran GDB
gdbName = arcpy.GetParameterAsText(2) # Name of terrain GDB
fdName = arcpy.GetParameterAsText(3) # Name of feature dataset
terrainName = arcpy.GetParameterAsText(4) # Name of terrain

try:
    # Create the file gdb that will store the feature dataset
    arcpy.management.CreateFileGDB(gdbLocation, gdbName)
    gdb = '{0}/{1}'.format(gdbLocation, gdbName)
    # Obtain spatial reference from TIN
    SR = arcpy.Describe(tin).spatialReference
    # Create the feature dataset that will store the terrain
    arcpy.management.CreateFeatureDataset(gdb, fdName, SR)
    fd = '{0}/{1}'.format(gdb, fdName)
    # Export TIN elements to feature classes for terrain
    arcpy.AddMessage("Exporting TIN footprint to define terrain boundary...")
    boundary = "{0}/boundary".format(fd)
    # Execute TinDomain
    arcpy.ddd.TinDomain(tin, tinDomain, 'POLYGON')
    arcpy.AddMessage("Exporting TIN breaklines...")
    breaklines = "{0}/breaklines".format(fd)
    # Execute TinLine
    arcpy.ddd.TinLine(tin, breaklines, "Code")
    arcpy.AddMessage("Exporting TIN nodes...")
    masspoints = "{0}/masspoints".format(fd)
    # Execute TinNode
    arcpy.ddd.TinNode(sourceTIN, TIN_nodes)
    arcpy.AddMessage("Creating terrain dataset...")
    terrain = "terrain_from_tin"
    # Execute CreateTerrain
    arcpy.ddd.CreateTerrain(fd, terrainName, 10, 50000, "",
                            "WINDOWSIZE", "ZMEAN", "NONE", 1)
    arcpy.AddMessage("Adding terrain pyramid levels...")
    terrain = "{0}/{1}".format(fd, terrainName)
    pyramids = ["20 5000", "25 10000", "35 25000", "50 50000"]
    # Execute AddTerrainPyramidLevel
    arcpy.ddd.AddTerrainPyramidLevel(terrain, "", pyramids)
    arcpy.AddMessage("Adding features to terrain...")
    inFeatures = "{0} Shape softclip 1 0 10 true false boundary_embed <None> "\
             "false; {1} Shape masspoints 1 0 50 true false points_embed "\
             "<None> false; {2} Shape softline 1 0 25 false false lines_embed "\
             "<None> false".format(boundary, masspoints, breaklines)
    # Execute AddFeatureClassToTerrain
    arcpy.ddd.AddFeatureClassToTerrain(terrain, inFeatures)
    arcpy.AddMessage("Building terrain...")
    # Execute BuildTerrain
    arcpy.ddd.BuildTerrain(terrain, "NO_UPDATE_EXTENT")
    arcpy.GetMessages()

except arcpy.ExecuteError:
    print(arcpy.GetMessages())
except Exception as err:
    print(err)

Параметры среды

Текущая рабочая область, Автоматическое подтверждение, Выходное ключевое слово CONFIG