Треугольник TIN (3D Analyst)
Краткая информация
Экспортирует грани треугольников из набора данных триангулированной нерегулярной сети (TIN) в полигональный класс пространственных объектов и обеспечивает для каждого треугольника уклон, экспозицию, дополнительные атрибуты отмывки и значение тегов.
Рисунок
 |
Использование
Уклон и экспозиция вычисляются на основе плоскости треугольника. Уклон не может быть вычислен правильно, если линейные единицы измерения системы координат TIN используют угловые единицы измерения, как, например, десятичные градусы.
Линейные единицы измерения x, y и z должны быть выражены в одинаковых единицах измерения, чтобы вычисления уклона и отмывки давали точные результаты. Если единицы измерения отличаются, а вертикальные и горизонтальные системы координат TIN определены, то автоматически будет определен соответствующий z-фактор. Или же может использоваться параметр z-фактор (Z Factor) для определения коэффициента конвертации, который будет применяться к значениям высот.
Значения экспозиции выражены в градусах, при этом значение для Севера равно 0. Значения возрастают в направлении по часовой стрелке и записываются в поле Экспозиция (Aspect). Плоским треугольникам в TIN присваивается значение экспозиции, равное - 1.
Значения уклона могут быть выражены в градусах или процентах, а имя поля, в котором записываются эти значения, зависит от выбранного параметра Единицы уклона (Slope Units).
- PERCENT – значения уклона будут храниться в поле с именем Slope_Pct.
- DEGREE – значения уклона будут храниться в поле с именем Slope_Deg.
Значения отмывки отражают локализованный рельеф, создаваемый от источника света с азимутом и вертикальным углом, заданными параметром Отмывка (Hillshade). Для азимута значение 0 соответствует северу, значение яркости имеет диапазон от 0 до 255, где чем ниже значение, тем темнее.
ПараметрПоле значений тегов (Tag Value Field) будет активен, только если TIN имеет явно заданные значения тегов.
Синтаксис
| Параметр | Объяснение | Тип данных |
in_tin |
Входной TIN. | TIN Layer |
out_feature_class |
Выходной класс объектов. | Feature Class |
units (дополнительно) |
Единицы измерения, использующиеся для вычисления уклона.
| String |
z_factor (дополнительно) |
Коэффициент, на который будут умножаться Z-значения. Этот способ обычно используется для конвертации линейных Z-единиц для соответствия линейным единицам XY. Значение по умолчанию равно 1, при нем значения высоты не изменяются. | Double |
hillshade HILLSHADE <azimuth>, <angle> (дополнительно) |
Задает углы азимута и высоты источника света при применении эффекта отмывки для выходных данных векторного слоя. Значения азимута могут изменяться в диапазоне от 0 до 360 градусов, а высоты – от 0 до 90. Значения азимута 45 градусов и высоты 30 градусов записываются следующим образом: "HILLSHADE 45, 30". | String |
tag_field (дополнительно) |
Имя поля в выходном объекте, в котором будет сохранено значение тега треугольника. По умолчанию этот параметр пустой, поэтому значения тегов не будут записываться в выходные данные. | String |
Пример кода
В следующем примере показано использование этого инструмента в окне Python:
import arcpy
from arcpy import env
arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.TinTriangle_3d("tin", "tin_triangle.shp", "DEGREE", 1,"HILLSHADE 310,45", "tag")
В следующем примере показано использование этого инструмента в автономном скрипте Python:
'''****************************************************************************
Name: TinTriangle Example
Description: This script demonstrates how to use the
TinTriangle tool to extract triangles from each TIN in the
target workspace.
****************************************************************************'''
# Import system modules
import arcpy
from arcpy import env
import exceptions, sys, traceback
try:
arcpy.CheckOutExtension("3D")
# Set environment settings
env.workspace = "C:/data" # the target workspace
# Create list of TINs
TINList = arcpy.ListDatasets("*", "Tin")
# Verify the presence of TINs in the list
if TINList:
for dataset in TINList:
# Set Local Variables
TINList = arcpy.ListDatasets("*", "Tin")
slopeUnits = "PERCENT"
zfactor = 1
hillshade = "HILLSHADE 300, 45" # defines hillshade azimuth & angle
tagField = "Tag"
Output = dataset + "_triangles.shp" # name of the output file
#Execute TinTriangle
arcpy.ddd.TinTriangle(dataset, Output, slopeUnits, zfactor,
hillshade, tagField)
print "Finished."
else:
print "There are no TIN(s) in the " + env.workspace + " directory."
arcpy.CheckInExtension("3D")
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)