| Label | Explanation | Data Type |
Output Feature Class | The path and name of the output feature class containing the tessellated grid. | Feature Class |
Extent
| The extent that the tessellation will cover. This can be the currently visible area, the extent of a dataset, or manually entered values.
| Extent |
Shape Type
(Optional) | Specifies the shape that will be generated.
| String |
Size
(Optional) | The area of each individual shape that comprises the tessellation. | Areal Unit |
Spatial Reference
(Optional) | The spatial reference to which the output dataset will be projected. If a spatial reference is not provided, the output will be projected to the spatial reference of the input extent. If neither has a spatial reference, the output will be projected in GCS_WGS_1984. | Spatial Reference |
H3 Resolution (Optional) | Specifies the H3 resolution of the hexagons. With each increasing resolution value, the area of the polygons will be one seventh the size.
This parameter is active when the Shape Type parameter is set to H3 hexagon. | Long |
Summary
Generates a tessellated grid of regular polygon features to cover a given extent. The tessellation can be of triangles, squares, diamonds, hexagons, H3 hexagons, or transverse hexagons.
Illustration
Usage
To ensure that the entire input extent is covered by the tessellated grid, the output features purposely extend beyond the input extent. This occurs because the edges of the tessellated grid will not always be straight lines, and gaps would be present if the grid was limited by the input extent.
The GRID_ID field will be added to the output.
When the Shape Type parameter value is H3 hexagon, the GRID_ID field values will be a unique hierarchical index for each cell.
For all other Shape Type parameter values, the GRID_ID field will be a unique ID for each feature. The format for the IDs is A-1, A-2, B-1, B-2, and so on. This allows for easy selection of rows and columns by query using the Select Layer By Attribute tool. For example, select all features in column A with GRID_ID like 'A-%', or select all features in row 1 with GRID_ID like '%-1'.
To generate a grid that excludes tessellation features that do not intersect features in another dataset, use the Select Layer By Location tool to select output polygons that contain the source features, and use the Copy Features tool to make a permanent copy of the selected output features to a new feature class.
The tool generates shapes by areal units. To determine the area of a shape based on the length of a side, use one of the following formulas to calculate the value of the Size parameter:
Shape Formula Example Hexagon or Transverse hexagon
To generate hexagons with a side length of 100 meters, specify the Size parameter value of 25980.76211353316 square meters (100 raised to the power of 2 multiplied by 3 multiplied by the square root of 3 divided by 2).
Square
To generate squares with a side length of 100 meters, specify the Size parameter value of 10,000 square meters (100 raised to the power of 2).
Diamond
To generate diamonds with a side length of 100 meters, specify the Size parameter value of 10,000 square meters (100 raised to the power of 2).
Triangle
To generate triangles with a side length of 100 meters, specify the Size parameter value of 4330.127018922193 square meters (100 raised to the power of 2 multiplied by the square root of 3 divided by 4).
The Shape Type parameter value's H3 hexagon option ignores the Size parameter. The area of the hexagon will be based on the H3 Resolution parameter value.
Parameters
arcpy.management.GenerateTessellation(Output_Feature_Class, Extent, {Shape_Type}, {Size}, {Spatial_Reference}, {H3_Resolution})| Name | Explanation | Data Type |
Output_Feature_Class | The path and name of the output feature class containing the tessellated grid. | Feature Class |
Extent | The extent that the tessellation will cover. This can be the currently visible area, the extent of a dataset, or manually entered values.
| Extent |
Shape_Type (Optional) | Specifies the shape that will be generated.
| String |
Size (Optional) | The area of each individual shape that comprises the tessellation. | Areal Unit |
Spatial_Reference (Optional) | The spatial reference to which the output dataset will be projected. If a spatial reference is not provided, the output will be projected to the spatial reference of the input extent. If neither has a spatial reference, the output will be projected in GCS_WGS_1984. | Spatial Reference |
H3_Resolution (Optional) | Specifies the H3 resolution of the hexagons. With each increasing resolution value, the area of the polygons will be one seventh the size.
This parameter is enabled when the Shape_Type parameter is set to H3_HEXAGON. | Long |
Code sample
The following Python window script demonstrates how to use the GenerateTessellation function in immediate mode.
import arcpy
tessellation_extent = arcpy.Extent(0.0, 0.0, 10.0, 10.0)
spatial_ref = arcpy.SpatialReference(4326)
arcpy.management.GenerateTessellation(r"C:\data\project.gdb\hex_tessellation",
tessellation_extent, "HEXAGON",
"100 SquareMiles", spatial_ref)The following Python window script demonstrates how to use the GenerateTessellation function to create H3 hexagons.
# Import modules
import arcpy
# Create some variables
out_gdb = r"C:\temp\project.gdb\h3_hexagon"
extent = arcpy.Extent(0.0, 0.0, 10.0, 10.0)
sr = arcpy.SpatialReference(4326)
# Generate H3 hexagons
arcpy.management.GenerateTessellation(out_gdb, Extent=extent, Shape_Type="H3_HEXAGON",
H3_Resolution=5, Spatial_Reference=sr)The following stand-alone Python script demonstrates how to programmatically extract an extent from a feature class and use the extent to fill the parameters of the GenerateTessellation function.
# Name: GenerateDynamicTessellation.py
# Purpose: Generate a grid of squares over the envelope of a provided feature
# class.
# Import modules
import arcpy
# Set paths of features
my_feature = r"C:\data\project.gdb\myfeature"
output_feature = r"C:\data\project.gdb\sqtessellation"
# Describe the input feature and extract the extent
description = arcpy.Describe(my_feature)
extent = description.extent
# Find the width, height, and linear unit used by the input feature class' extent
# Divide the width and height value by three.
# Multiply the divided values together and specify an area unit from the linear
# unit.
# Should result in a 4x4 grid covering the extent. (Not 3x3 since the squares
# hang over the extent.)
w = extent.width
h = extent.height
u = extent.spatialReference.linearUnitName
area = "{size} Square{unit}s".format(size=w/3 * h/3, unit=u)
# Use the extent's spatial reference to project the output
spatial_ref = extent.spatialReference
arcpy.management.GenerateTessellation(output_feature, extent, "SQUARE", area,
spatial_ref)Environments
Licensing information
- Basic: Yes
- Standard: Yes
- Advanced: Yes