Создать Terrain (Инструменты 3D Analyst)

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

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

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

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

Подпись	Объяснение	Тип данных
Входной набор классов объектов	Набор классов объектов, в котором будет находиться набор данных terrain.	Feature Dataset
Выходной Terrain	Имя выходного набора данных terrain.	String
Средний интервал между точками	При моделировании terrain используется среднее горизонтальное расстояние между точками данных. При измерениях с помощью сенсоров, таких как, фотограмметрии, лидарной и сонарной съемок, интервал между точками обычно известен. Используйте горизонтальные единицы системы координат набора объектов для интервала.	Double
Максимальный размер обзорного изображения (Дополнительный)	Обзор набора данных terrain напоминает эскизное отображение. Это очень грубое отображение набора данных terrain, его максимальный размер соответствует верхней границе количества точек измерений, которые выбираются для создания обзора.	Long
Ключевое слово конфигурации (Дополнительный)	Ключевое слово конфигурации, которое будет использоваться для оптимизации хранения данных terrain в многопользовательской базе данных.	String
Тип пирамидных слоев (Дополнительный)	Указывает метод прореживания данных, который будет использоваться для построения пирамидных слоёв terrain. Window Size–Data points in the area defined by a given window size for each pyramid level will be selected using the Window Size Method parameter value. This is the default. Z Tolerance–The vertical accuracy of each pyramid level relative to the full resolution of the data points will be specified.	String
Метод Размер окна (Дополнительный)	Указывает, как будут выбираться точки в области, определяемой размером окна. Этот параметр применим только тогда, когда выбран Размер окна для параметра Тип пирамидных слоев. Minimum Z–The point with the smallest elevation value will be selected. This is the default. Maximum Z–The point with the largest elevation value will be selected. Closest To Mean Z–The point with the elevation value closest to the average of all values will be selected. Minimum and Maximum Z–The points with the smallest and largest elevation values will be selected.	String
Порог вторичного прореживания (Дополнительный)	Указывает дополнительные опции прореживания, которые будут применяться, чтобы уменьшить число точек на плоских поверхностях, при использовании пирамидных слоев типа Размер окна. Область расценивается как плоская, если высоты точек внутри нее находятся в пределе Порог вторичного прореживания. Этот эффект лучше всего провляется на уровнях пирамидных слоев с высоким разрешением, так как маленькие области более вероятно будут расценены как плоские, нежели большие. None–No secondary thinning will be performed. This is the default. Mild–Mild thinning will be performed to preserve linear discontinuities (for example, building sides and forest boundaries). This method is recommended for lidar that includes both ground and nonground points. It will thin the fewest points. Moderate–Moderate thinning will be performed, which provides a balance between performance and accuracy. This method does not preserve as much detail as mild thinning but comes close while eliminating more points overall. Strong–Strong thinning will be performed, which removes the most points but is less likely to preserve sharply delineated features. Limit its use to surfaces where slope tends to change gradually. For example, strong thinning is efficient for bare-earth lidar and bathymetry.	String
Порог вторичного прореживания (Дополнительный)	Вертикальный предел, который будет использоваться для активации вторичного прореживания, когда для параметра Тип пирамидных слоев выбран Размер окна. Установите это значение равным вертикальной точности данных или больше.	Double
Метод триангуляции (Дополнительный)	Указывает, будут ли объекты перегиба включены в поверхность terrain путем уплотнения их сегментов в соответствии с правилами триангуляции Делоне для построения поверхности TIN. Триангуляция Делоне уплотнит объекты линии перегиба, чтобы разместить окружающие их точки таким образом, чтобы избежать создания длинных тонких треугольников, которые обычно дают нежелательные результаты при анализе поверхности на основе TIN. Кроме того, интерполяция ближайших окрестностей и создание полигонов Тиссена (Вороного) могут быть выполнены только в триангуляциях Делоне. Ограниченная триангуляция Делоне позволит избежать уплотнения объектов линии перегиба, включив сегменты линии перегиба в качестве ребер в поверхность TIN. Рассмотрите этот вариант, когда вам нужно явно задать определенные ребра, которые гарантированно не будут изменены (то есть разделены на несколько ребер) триангулятором. Delaunay–Breaklines will be densified to construct Delaunay triangles that accommodate the points surrounding them. This is the default. Constrained Delaunay–Breaklines will not be densified.	String

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

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

arcpy.3d.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`–Data points in the area defined by a given window size for each pyramid level will be selected using the `windowsize_method` parameter value. This is the default. `ZTOLERANCE`–The vertical accuracy of each pyramid level relative to the full resolution of the data points will be specified.	String
windowsize_method (Дополнительный)	Указывает, как будут выбираться точки в области, определяемой размером окна. Этот параметр применим только тогда, когда выбрано значение `WINDOWSIZE` для параметра `pyramid_type`. `ZMIN`–The point with the smallest elevation value will be selected. This is the default. `ZMAX`–The point with the largest elevation value will be selected. `ZMEAN`–The point with the elevation value closest to the average of all values will be selected. `ZMINMAX`–The points with the smallest and largest elevation values will be selected.	String
secondary_thinning_method (Дополнительный)	Указывает дополнительные опции прореживания, которые будут применяться, чтобы уменьшить число точек на плоских поверхностях, при использовании пирамидных слоев типа Размер окна. Область считается плоской, если высота точек в этой области находится в пределах заданного значения параметра `secondary_thinning_threshold`. Этот эффект лучше всего провляется на уровнях пирамидных слоев с высоким разрешением, так как маленькие области более вероятно будут расценены как плоские, нежели большие. `NONE`–No secondary thinning will be performed. This is the default. `MILD`–Mild thinning will be performed to preserve linear discontinuities (for example, building sides and forest boundaries). This method is recommended for lidar that includes both ground and nonground points. It will thin the fewest points. `MODERATE`–Moderate thinning will be performed, which provides a balance between performance and accuracy. This method does not preserve as much detail as mild thinning but comes close while eliminating more points overall. `STRONG`–Strong thinning will be performed, which removes the most points but is less likely to preserve sharply delineated features. Limit its use to surfaces where slope tends to change gradually. For example, strong thinning is efficient for bare-earth lidar and bathymetry.	String
secondary_thinning_threshold (Дополнительный)	Вертикальное пороговое значение, которое будет использоваться для активации вторичного прореживания, когда для параметра `pyramid_type` выбран `WINDOWSIZE`. Установите это значение равным вертикальной точности данных или больше.	Double
triangulation_method (Дополнительный)	Указывает, будут ли объекты перегиба включены в поверхность terrain путем уплотнения их сегментов в соответствии с правилами триангуляции Делоне для построения поверхности TIN. Триангуляция Делоне уплотнит объекты линии перегиба, чтобы разместить окружающие их точки таким образом, чтобы избежать создания длинных тонких треугольников, которые обычно дают нежелательные результаты при анализе поверхности на основе TIN. Кроме того, интерполяция ближайших окрестностей и создание полигонов Тиссена (Вороного) могут быть выполнены только в триангуляциях Делоне. Ограниченная триангуляция Делоне позволит избежать уплотнения объектов линии перегиба, включив сегменты линии перегиба в качестве ребер в поверхность TIN. Рассмотрите этот вариант, когда вам нужно явно задать определенные ребра, которые гарантированно не будут изменены (то есть разделены на несколько ребер) триангулятором. `DELAUNAY`–Breaklines will be densified to construct Delaunay triangles that accommodate the points surrounding them. This is the default. `CONSTRAINED_DELAUNAY`–Breaklines will not be densified.	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)
    # Run TinDomain
    arcpy.ddd.TinDomain(tin, tinDomain, 'POLYGON')
    arcpy.AddMessage("Exporting TIN breaklines...")
    breaklines = "{0}/breaklines".format(fd)
    # Run TinLine
    arcpy.ddd.TinLine(tin, breaklines, "Code")
    arcpy.AddMessage("Exporting TIN nodes...")
    masspoints = "{0}/masspoints".format(fd)
    # Run TinNode
    arcpy.ddd.TinNode(sourceTIN, TIN_nodes)
    arcpy.AddMessage("Creating terrain dataset...")
    terrain = "terrain_from_tin"
    # Run 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"]
    # Run 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)
    # Run AddFeatureClassToTerrain
    arcpy.ddd.AddFeatureClassToTerrain(terrain, inFeatures)
    arcpy.AddMessage("Building terrain...")
    # Run BuildTerrain
    arcpy.ddd.BuildTerrain(terrain, "NO_UPDATE_EXTENT")
    arcpy.GetMessages()

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

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

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

Информация о лицензировании

Basic: Требуется 3D Analyst
Standard: Требуется 3D Analyst
Advanced: Требуется 3D Analyst

Создать Terrain (Инструменты 3D Analyst)

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

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

Параметры

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

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

Информация о лицензировании

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