Этот инструмент создает 3D-объекты, используя значения высоты, полученные из перекрывающихся частей входной поверхности. 3D-полигон будет хранить z-значения только по своему периметру, так как внутренняя часть 3D-полигона будет определена произвольно при визуализации. Поэтому 3D-полигоны, как правило, не подходят для представления неплоскостной информации о высоте. Для создания истинного представления поверхности используйте инструмент Интерполировать полигон в мультипатч.
Любые сегменты кривых линий или полигонов будут уплотнены на основе значения параметра Расстояние разбиения. Если расстояние разбиения не указано, это значение будет получено из входной поверхности. Для растра размером разбиения по умолчанию будет размер ячейки растра. Для TIN, terrain или набора данных LAS расстояние разбиения по умолчанию будет основываться на ребрах, созданных триангулированной поверхностью. Если кривая короче, чем размер разбиения, то кривая будет упрощена до линии с двумя точками, с использованием ее начальной и конечной точек.
При использовании интерполяции естественной окрестности необходимо указать расстояние выборки, равное или большее половины среднего интервала между точками на поверхности.
При использовании параметра Интерполировать только вершины объекты с вершинами, не попадающими в область данных поверхности, будут пропущены и не войдут в выходные данные, если только входная поверхность не является растровой и используется метод интерполяции Ближайшая окрестность.
Если входной класс объектов содержит m-значения, выходной класс объектов также будет содержать m-значения, а исходные m-значения вершин сохраняются.
Поверхность, которая будет использоваться для интерполяции z-значений.
LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer; Image Service
Входные объекты
Входные объекты, которые будут обработаны.
Feature Layer
Выходной класс пространственных объектов
Класс объектов, который будет получен.
Feature Class
Расстояние выборки
(Дополнительный)
Интервал, по которому будут интерполированы Z-значения. По умолчанию это размер ячейки набора растровых данных или естественное сгущение триангулированной поверхности.
Double
Коэффициент Z
(Дополнительный)
Коэффициент, на который будут умножаться z-значения. Этот способ обычно используется при конвертации линейных z-единиц для соответствия линейным единицам x,y. Значение по умолчанию равно 1, при нем значения высоты не изменяются. Этот параметр не доступен, если пространственная привязка входной поверхности имеет z-датум с заданными линейными единицами измерения.
Double
Метод
(Дополнительный)
Определяет метод интерполяции, используемый для определения значений высоты для выходных объектов. Опции будут доступны в зависимости от типа поверхности.
Bilinear–The value of the query point will be determined using bilinear interpolation. This is the default when the input is a raster surface.
Nearest Neighbor–The value of the query point will be determined using nearest neighbor interpolation. With this method, surface values will only be interpolated for the input feature's vertices. This option is only available for a raster surface.
Linear–Elevation values will be obtained from the plane defined by the triangle that contains the x,y-location of a query point. This is the default interpolation method for TIN, terrain, and LAS datasets.
Natural Neighbors–Elevation values will be obtained by applying area-based weights to the natural neighbors of a query point.
Conflate Minimum Z–Elevation values will be obtained from the smallest z-value found among the natural neighbors of a query point.
Conflate Maximum Z–Elevation values will be obtained from the largest z-value found among the natural neighbors of a query point.
Conflate Nearest Z–Elevation values will be obtained from the nearest value among the natural neighbors of a query point.
Conflate Z Closest To Mean–Elevation values will be obtained from the z-value that is closest to the average of all the natural neighbors of a query point.
String
Интерполировать только вершины
(Дополнительный)
Определяет, будет ли интерполяция выполняться по вершинам входного объекта (с игнорированием опции расстояния разбиения).
Отмечено–Interpolation will only occur along the vertices.
Не отмечено–Interpolation will occur using the sampling distance. This is the default.
Boolean
Уровень пирамидных слоев
(Дополнительный)
Z-допуск или разрешение размера окна для уровня пирамидных слоев Terrain, которое будет использоваться. Значением по умолчанию является 0, полное разрешение.
Double
Сохранять объекты частично выходящие за поверхность
(Дополнительный)
Определяет, будут ли сохраняться в выходных данных объекты, одна или несколько вершин которых выходят за пределы области данных растра. Параметр доступен только для растровой входной поверхности и при использовании интерполяции Ближайшая окрестность.
Отмечено–Each vertex that falls outside the raster surface will have its z-value derived from the trend of z-values calculated for the vertices within the raster surface and will be retained in the output.
Не отмечено–Features with at least one vertex that falls outside the raster surface will be skipped in the output. This is the default.
Boolean
Интерполяция m-значений для уплотненных вершин
(Дополнительный)
Указывает, будут ли значения m для вершин линий и полигонов, добавленных в результате уплотнения, интерполироваться из исходных входных вершин.
При применении, m-значения для уплотненных вершин интерполируются вдоль исходного сегмента между двумя существующими вершинами, имеющими m-значения. Если у какой-либо из исходных вершин отсутствует значение m, то значения m всех вновь добавленных вершин вдоль этого сегмента устанавливаются равными NaN.
Отмечено–The m-values for densified vertices will be interpolated.
Не отмечено–The m-values for densified vertices will not be interpolated. This is the default.
Поверхность, которая будет использоваться для интерполяции z-значений.
LAS Dataset Layer; Mosaic Layer; Raster Layer; Terrain Layer; TIN Layer; Image Service
in_feature_class
Входные объекты, которые будут обработаны.
Feature Layer
out_feature_class
Класс объектов, который будет получен.
Feature Class
sample_distance
(Дополнительный)
Интервал, по которому будут интерполированы Z-значения. По умолчанию это размер ячейки набора растровых данных или естественное сгущение триангулированной поверхности.
Double
z_factor
(Дополнительный)
Коэффициент, на который будут умножаться z-значения. Этот способ обычно используется при конвертации линейных z-единиц для соответствия линейным единицам x,y. Значение по умолчанию равно 1, при нем значения высоты не изменяются. Этот параметр не доступен, если пространственная привязка входной поверхности имеет z-датум с заданными линейными единицами измерения.
Double
method
(Дополнительный)
Определяет метод интерполяции, используемый для определения значений высоты для выходных объектов. Опции будут доступны в зависимости от типа поверхности.
BILINEAR–The value of the query point will be determined using bilinear interpolation. This is the default when the input is a raster surface.
NEAREST–The value of the query point will be determined using nearest neighbor interpolation. With this method, surface values will only be interpolated for the input feature's vertices. This option is only available for a raster surface.
LINEAR–Elevation values will be obtained from the plane defined by the triangle that contains the x,y-location of a query point. This is the default interpolation method for TIN, terrain, and LAS datasets.
NATURAL_NEIGHBORS–Elevation values will be obtained by applying area-based weights to the natural neighbors of a query point.
CONFLATE_ZMIN–Elevation values will be obtained from the smallest z-value found among the natural neighbors of a query point.
CONFLATE_ZMAX–Elevation values will be obtained from the largest z-value found among the natural neighbors of a query point.
CONFLATE_NEAREST–Elevation values will be obtained from the nearest value among the natural neighbors of a query point.
CONFLATE_CLOSEST_TO_MEAN–Elevation values will be obtained from the z-value that is closest to the average of all the natural neighbors of a query point.
String
vertices_only
(Дополнительный)
Определяет, будет ли интерполяция выполняться по вершинам входного объекта (с игнорированием опции расстояния разбиения).
VERTICES_ONLY–Interpolation will only occur along the vertices.
DENSIFY–Interpolation will occur using the sampling distance. This is the default.
Boolean
pyramid_level_resolution
(Дополнительный)
Z-допуск или разрешение размера окна для уровня пирамидных слоев Terrain, которое будет использоваться. Значением по умолчанию является 0, полное разрешение.
Double
preserve_features
(Дополнительный)
Определяет, будут ли сохраняться в выходных данных объекты, одна или несколько вершин которых выходят за пределы области данных растра. Параметр доступен только для растровой входной поверхности и при использовании интерполяции Ближайшая окрестность.
PRESERVE–Each vertex that falls outside the raster surface will have its z-value derived from the trend of z-values calculated for the vertices within the raster surface and will be retained in the output.
EXCLUDE–Features with at least one vertex that falls outside the raster surface will be skipped in the output. This is the default.
Boolean
interpolate_m_value
(Дополнительный)
Указывает, будут ли значения m для вершин линий и полигонов, добавленных в результате уплотнения, интерполироваться из исходных входных вершин.
При применении, m-значения для уплотненных вершин интерполируются вдоль исходного сегмента между двумя существующими вершинами, имеющими m-значения. Если у какой-либо из исходных вершин отсутствует значение m, то значения m всех вновь добавленных вершин вдоль этого сегмента устанавливаются равными NaN.
INTERPOLATE_M_VALUE–The m-values for densified vertices will be interpolated.
NO_INTERPOLATE_M_VALUE–The m-values for densified vertices will not be interpolated. This is the default.
Boolean
Пример кода
InterpolateShape, пример 1 (окно Python)
В следующем примере показано использование этого инструмента в окне Python:
В следующем примере показано использование этого инструмента в автономном скрипте Python:
'''*********************************************************************
Name: InterpolateShape Example
Description: This script demonstrates how to use InterpolateShape
on all 2D features in a target workspace.
*********************************************************************'''
# Import system modules
import arcpy
# Set local variables
inWorkspace = arcpy.GetParameterAsText(0)
surface = arcpy.GetParameterAsText(1)
try:
# Set default workspace
arcpy.env.workspace = inWorkspace
# Create list of feature classes in target workspace
fcList = arcpy.ListFeatureClasses()
if fcList:
for fc in fcList:
desc = arcpy.Describe(fc)
# Find 2D features
if not desc.hasZ:
# Set Local Variables
outFC = "{0}_3D.shp".format(desc.basename)
method = "BILINEAR"
# Run InterpolateShape
arcpy.ddd.InterpolateShape(surface, fc, outFC,
10, 1, method, True)
else:
print("{0} is not a 2D feature.".format(fc))
else:
print("No feature classes were found in {0}.".format(env.workspace))
except arcpy.ExecuteError:
print(arcpy.GetMessages())
except Exception as err:
print(err)
