Добавить пирамидный слой Terrain (3D Analyst)

Сводка

Добавляет один или несколько уровней пирамидных слоев в существующий набор данных Terrain.

Дополнительные сведения о работе инструмента Определение уровней пирамидных слоев

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

  • Каждый уровень пирамидных слоев вводится как разделенная пробелом пара разрешения уровня пирамидного слоя и базовый масштаб (например, "20 24000" для окна размером 20 и с базовым масштабом 1:24000 или "1,5 10000" для допуска z 1,5 и базового масштаба 1:10000).

  • Разрешение уровня пирамидных слоев относится к z-допуску или размеру окна, используемых для пирамидных слоев.

    • Z-допуск определяет максимальное отклонение от высоты набора данных Terrain при полном разрешении.
    • Размер окна определяет область листов, используемую при укрупнении точек возвышения за счет выбора одной или двух точек из области с использованием метода определения размера окна, указанного при создании набора данных Terrain.
  • Базовый масштаб представляет самый крупный масштаб карты для отображения уровня пирамиды.

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

  • При использовании базы данных SDE входной набор данных Terrain не должен быть версионным.

Синтаксис

arcpy.3d.AddTerrainPyramidLevel(in_terrain, {pyramid_type}, pyramid_level_definition)
ParameterОбъяснениеТип данных
in_terrain

Обрабатываемый набор данных terrain.

Terrain Layer
pyramid_type
(Дополнительный)

Тип пирамидных слоев для набора данных Terrain. Этот параметр не используется в ArcGIS 9.3 и более поздних версиях, так как его цель — обеспечить обратную совместимость со скриптами и моделями, написанными в версии ArcGIS 9.2.

String
pyramid_level_definition
["<pyramid_level_resolution> <reference_scale>",...]

z-допуск или размер окна и связанный с ним базовый масштаб для каждого уровня пирамидных слоев, добавляемого в Terrain. Каждый уровень пирамидных слоев вводится как разделенная пробелом пара значений разрешения уровня пирамидного слоя и базового масштаба (например, "20 24000" для окна размером 20 и с базовым масштабом 1:24000 или "1,5 10000" для допуска z 1,5 и базового масштаба 1:10000). Разрешение уровня пирамиды можно указать как число с плавающей запятой, а базовый масштаб должен указываться целым числом.

Значение z-допуска задает максимальное отклонение от высоты набора данных Terrain при полном разрешении, а размер окна определяет площадь листа Terrain, используемую при прореживании высотных точек. При этом из площади выбирается одна или две точки с учетом метода определения размера окна, который указывается при создании terrain. Базовый масштаб представляет самый крупный масштаб карты, при котором активируется уровень пирамидного слоя. При отображении набора данных Terrain с масштабом, превышающем это значение, отображается следующий уровень пирамиды.

String

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

NameОбъяснениеТип данных
derived_out_terrain

Обновленная terrain.

Слой Terrain

Пример кода

Пример AddTerrainPyramidLevel 1 (окно Python)

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

arcpy.env.workspace = 'C:/data'
arcpy.AddTerrainPyramidLevel_3d('test.gdb/featuredataset/terrain', 'WINDOWSIZE', 
                              '2.5 10000; 5 25000; 10 50000')
AddTerrainPyramidLevel, пример 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)

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

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

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