Terrain в точки (3D Analyst)
Краткая информация
Конвертирует набор данных Terrain в новый класс пространственных объектов точек или мультиточек.
Рисунок
Использование
- Точки извлекаются для заданного уровня пирамидных слоев и области интереса.
- Если внедренный класс объектов определен, выходные точки будут поступать только из внедренных объектов. В противном случае, выходные точки будут браться из всех точек, образующих поверхность terrain.
Если внедренный объект содержит атрибуты лазерной съемки, такие как RGB, классификация или обратные значения, атрибуты будут записаны в выходной класс объектов. Но способ их записи будет зависеть от заданного типа геометрии:
- МУЛЬТИТОЧКА (MULTIPOINT) – Атрибуты будут сохранены в поле BLOB.
- ТОЧКА (POINT) – Атрибуты будут сохранены в числовых полях.
Более подробную информацию о внедренных объектах вы найдете в разделе Внедренные классы объектов (Embedded feature classes).
Синтаксис
| Параметр | Объяснение | Тип данных |
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 |
Пример кода
В следующем примере показано использование этого инструмента в окне 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")
В следующем примере показано использование этого инструмента в автономном скрипте 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)