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

Уровень лицензии:BasicStandardAdvanced

Резюме

Создает новый набор данных terrain.

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

Синтаксис

CreateTerrain_3d (in_feature_dataset, out_terrain_name, average_point_spacing, {max_overview_size}, {config_keyword}, {pyramid_type}, {windowsize_method}, {secondary_thinning_method}, {secondary_thinning_threshold})
ПараметрОбъяснениеТип данных
in_feature_dataset

Набор классов объектов, в котором будет создан набор данных terrain.

Feature Dataset
out_terrain_name

Выходной набор данных terrain.

String
average_point_spacing

В построении terrain используется среднее или номинальное горизонтальное расстояние между точками данных. Для данных фотограмметрии, лидарной и сонарной съемок интервал между точками обычно известен. Cледует использовать именно это значение. Если вы сомневаетесь в значении интервала, следует проверить данные. Интервал дается в горизонтальных единицах измерения в координатной системе набора пространственных данных.

Double
max_overview_size
(дополнительно)

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

Long
config_keyword
(дополнительно)

Ключевое слово конфигурации для ArcSDE. Ключевое слово конфигурации используется, чтобы оптимизировать хранение базы данных, и обычно настраивается администратором базы данных.

String
pyramid_type
(дополнительно)

Метод прореживания данных используется для построения пирамид terrain.

  • WINDOWSIZEПрореживание выполняется путем выбора точек данных в области, заданной имеющимся размером окна, для каждого уровня пирамидных слоев при использовании критерия, указанного в параметре Метод Размер окна (Window Size Method).
  • ZTOLERANCEПрореживание осуществляется указанием вертикальной точности каждого уровня пирамидных слоев, связанной с полным разрешением точек данных.
String
windowsize_method
(дополнительно)

Критерий, используемый для отбора точек в области, определяется размером окна. Этот параметр применим только тогда, когда в качестве параметра Тип пирамидных слоев (Pyramid Type) указан WINDOWSIZE.

  • ZMINТочка с минимальным значением высоты.
  • ZMAXТочка с максимальным значением высоты.
  • ZMEANТочка со значением высоты, наиболее близким к среднему значению всех высот.
  • ZMINMAXТочки с минимальным и максимальным значениями высоты.
String
secondary_thinning_method
(дополнительно)

Указывает дополнительные опции прореживания, чтобы уменьшить число точек на плоской поверхности, при использовании пирамид типа Размер окна. Область расценивается как плоская, если высоты точек внутри нее находятся в указанном пользователем пределе Вторичный порог прореживания (Secondary Thinning Threshold). Этот эффект лучше всего провляется на уровнях пирамидных слоев с высоким разрешением, так как маленькие области более вероятно будут расценены как плоские, нежели большие.

  • Нет сжатия (NONE)Вторичное прореживание не будет выполняться. Это значение используется по умолчанию.
  • MILDПрименяется для защиты линейных неоднородностей (например, форм домов и границ леса). Он рекомендуется для лидарных данных:земных и неземных точек. Он разредит меньшее количество точек.
  • MODERATEОбеспечивает приемлемое соотношение между точностью данных и быстродействием. Не защищает детали как мягкое прореживание, но позволяет осуществлять значительное приближение при фильтрации большего количества точек.
  • STRONGУдаляет большинство точек и не защищает детали объектов. Метод находит применение только на поверхностях, где уклон имеет тенденцию изменяться плавно. Например, сильное прореживание будет целесообразно для земной лидарной съёмки и батиметрии.
String
secondary_thinning_threshold
(дополнительно)

Вертикальный предел используется для активации вторичного прореживания вместе с фильтром Размера окна. Это значение должно устанавливаться равным вертикальной точности данных или большим.

Double

Пример кода

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

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

import arcpy
from arcpy import env

arcpy.CheckOutExtension('3D')
env.workspace = 'C:/data'
arcpy.CreateTerrain_3d('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
import exceptions, sys, traceback
from arcpy import env

# 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:
    arcpy.CheckOutExtension("3D")
    # 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:
    # Get the traceback object
    tb = sys.exc_info()[2]
    tbinfo = traceback.format_tb(tb)[0]
    # Concatenate error information into message string
    pymsg = "PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}"\
          .format(tbinfo, str(sys.exc_info()[1]))
    msgs = "ArcPy ERRORS:\n {0}\n".format(arcpy.GetMessages(2))
    # Return python error messages for script tool or Python Window
    arcpy.AddError(pymsg)
    arcpy.AddError(msgs)
finally:
    arcpy.CheckInExtension("3D")

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

Связанные темы

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

ArcGIS for Desktop Basic: Требует 3D Analyst
ArcGIS for Desktop Standard: Требует 3D Analyst
ArcGIS for Desktop Advanced: Требует 3D Analyst
9/10/2013