Краткая информация
Конвертирует набор данных Terrain в новый класс пространственных объектов точек или мультиточек.
Иллюстрация
Использование
- Точки извлекаются для заданного уровня пирамидных слоев и области интереса.
- Если определен встроенный класс объектов, выходные точки будут поступать только из встроенных объектов. В противном случае, выходные точки будут браться из всех точек, образующих поверхность terrain.
Если внедренный объект содержит атрибуты лазерной съемки, такие как RGB, классификация или обратные значения, атрибуты будут записаны в выходной класс объектов. Но способ их записи будет зависеть от заданного типа геометрии:
- МУЛЬТИТОЧКА (MULTIPOINT)– Атрибуты будут сохранены в поле BLOB.
- ТОЧКА (POINT)– Атрибуты будут сохранены в числовых полях.
Более подробную информацию о внедренных объектах вы найдете в разделе Внедренные классы объектов.
Синтаксис
TerrainToPoints_3d (in_terrain, out_feature_class, {pyramid_level_resolution}, {source_embedded_feature_class}, {out_geometry_type})
Параметр | Объяснение | Тип данных |
in_terrain | Обрабатываемый набор данных terrain. | Terrain Layer |
out_feature_class | Класс объектов, который будет получен в результате работы инструмента. | Feature Class |
pyramid_level_resolution (Дополнительный) | z-допуск или разрешение размера окна для уровня пирамидных слоев Terrain, которое будет использоваться этим инструментом. Значением по умолчанию является 0, полное разрешение. | Double |
source_embedded_feature_class (Дополнительный) | Имя для внедренных точек, экспортируемых из набора данных terrain. Если внедренный объект определен, в выходные данные будут записаны точки только из этого объекта. В противном случае, будут экспортированы все точки из всех исходных данных в terrain. | String |
out_geometry_type (Дополнительный) | Тип геометрии выходного класса объектов.
| String |
Пример кода
TerrainToPoints Пример 1 (окно Python)
В следующем примере показано использование этого инструмента в окне Python.
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.TerrainToPoints_3d("sample.gdb/featuredataset/terrain", "terrain_points.shp", "6", "<NONE>", "POINT")
TerrainToPoints Пример 2 (автономный скрипт)
В следующем примере показано использование этого инструмента в автономном скрипте Python.
'''*****************************************************************
Name: TerrainToPoints Example
Description: This script demonstrates how to use the
TerrainToPoints tool.
*****************************************************************'''
# Import system modules
import arcpy
from arcpy import env
import exceptions, sys, traceback
try:
arcpy.CheckOutExtension("3D")
# Set environment settings
env.workspace = "C:/data"
# Set Local Variables
terrain = "sample.gdb/featuredataset/terrain"
outPts = arcpy.CreateUniqueName("terrain_pts", "sample.gdb")
outGeo = "POINT"
# Execute TerrainToPoints
arcpy.ddd.TerrainToPoints(terrain, outPts, 6, "<NONE>", outGeo)
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)
Параметры среды
- Текущая рабочая область (Current Workspace)
- Экстент (Extent)
- Выходная система координат (Output Coordinate System)
- Географические преобразования (Geographic Transformations)
- Разрешение XY (XY Resolution)
- Допуск XY (XY Tolerance)
- Разрешение Z (Z Resolution)
- Допуск Z (Z Tolerance)
- Выходное ключевое слово CONFIG (Output CONFIG Keyword)
- Автоподтверждение (Auto Commit)
Информация о лицензиях
- ArcGIS Desktop Basic: Требует 3D Analyst
- ArcGIS Desktop Standard: Требует 3D Analyst
- ArcGIS Desktop Advanced: Требует 3D Analyst