Label | Explanation | Data Type |
Input Surface | The input triangulated irregular network (TIN) or terrain dataset surface. | Terrain Layer; TIN Layer |
Input Feature Class | The input polygon feature. | Feature Layer |
Output Feature Class | The output multipatch feature class. | Feature Class |
Maximum Strip Size (Optional) | Controls the maximum number of points used to create an individual triangle strip. Note that each multipatch is usually composed of multiple strips. The default value is 1,024. | Long |
Z Factor (Optional) | The factor by which z-values will be multiplied. This is typically used to convert z linear units to match x,y linear units. The default is 1, which leaves elevation values unchanged. This parameter is not available if the spatial reference of the input surface has a z-datum with a specified linear unit. | Double |
Area Field (Optional) | The name of the output field containing the planimetric, or 2D, area of the resulting multipatches. | String |
Surface Area Field (Optional) | The name of the output field containing the 3D area of the resulting multipatches. This area takes the surface undulations into consideration and is always larger than the planimetric area unless the surface is flat, in which case, the two are equal. | String |
Pyramid Level Resolution (Optional) | The z-tolerance or window-size resolution of the terrain pyramid level that will be used. The default is 0, or full resolution. | Double |
Summary
Creates surface-conforming multipatch features by draping polygon features over a surface.
Usage
Each polygon feature has its boundary profiled along the surface. Heights are obtained using linear interpolation by sampling at each input vertex and wherever the boundary line intersects surface triangle edges and nodes. This natural densification captures the full definition of the linear surface using a minimal number of samples. Then, all nodes that fall within the polygon are extracted. The nodes are re-triangulated in a new memory-based TIN, and the 3D polygon boundary is enforced as a clip polygon. The triangles of this new TIN are then extracted in a series of strips that are used to define a multipatch-based feature.
Resulting multipatch will capture the 3D surface representation in its geometry. Planimetric and surface area calculations are included in the output alongside other attributes from the input polygon.
Consider converting polygons to multipatches if you experience display problems with three-dimensional rendering of polygons draped on a surface.
The Maximum Triangle Strip Size value must be 3 or larger. This parameter specifies the maximum number of vertices allowed in any triangle strip used in constructing the multipatch. ArcGIS does not have a particular size limit or preference, but some 3D graphic cards might, as triangle strips are directly loaded to the 3D graphics application program interface (API) for rendering. The recommended range is between 128 and 2048.
Parameters
arcpy.ddd.InterpolatePolyToPatch(in_surface, in_feature_class, out_feature_class, {max_strip_size}, {z_factor}, {area_field}, {surface_area_field}, {pyramid_level_resolution})
Name | Explanation | Data Type |
in_surface | The input triangulated irregular network (TIN) or terrain dataset surface. | Terrain Layer; TIN Layer |
in_feature_class | The input polygon feature. | Feature Layer |
out_feature_class | The output multipatch feature class. | Feature Class |
max_strip_size (Optional) | Controls the maximum number of points used to create an individual triangle strip. Note that each multipatch is usually composed of multiple strips. The default value is 1,024. | Long |
z_factor (Optional) | The factor by which z-values will be multiplied. This is typically used to convert z linear units to match x,y linear units. The default is 1, which leaves elevation values unchanged. This parameter is not available if the spatial reference of the input surface has a z-datum with a specified linear unit. | Double |
area_field (Optional) | The name of the output field containing the planimetric, or 2D, area of the resulting multipatches. | String |
surface_area_field (Optional) | The name of the output field containing the 3D area of the resulting multipatches. This area takes the surface undulations into consideration and is always larger than the planimetric area unless the surface is flat, in which case, the two are equal. | String |
pyramid_level_resolution (Optional) | The z-tolerance or window-size resolution of the terrain pyramid level that will be used. The default is 0, or full resolution. | Double |
Code sample
The following sample demonstrates the use of this tool in the Python window.
arcpy.env.workspace = "C:/data"
arcpy.ddd.InterpolatePolyToPatch("sample.gdb/featuredataset/terrain", "polygon.shp", "out_multipatch.shp", 1024, 1, "Area", "SArea", 5)
The following sample demonstrates the use of this tool in a stand-alone Python script.
'''****************************************************************************
Name: InterpolatePolyToPatch Example
Description: This script demonstrates how to use the
InterpolatePolyToPatch tool.
****************************************************************************'''
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set Local Variables
inTerrain = "sample.gdb/featuredataset/terrain"
inPoly = "polygon.shp"
outMP = arcpy.CreateUniqueName("out_multipatch.shp")
#Execute InterpolatePolyToPatch
arcpy.ddd.InterpolatePolyToPatch(inTerrain, inPoly, outMP, 1024, 1, "Area", "SArea", 5)