Skip To Content

Subdivide Polygon

Summary

Divides polygon features into a number of equal areas or parts.

Usage

  • Euclidean or planar calculations are used to determine areas of polygon subdivisions. For best results, use an equal area, projected coordinate system that minimizes area distortion for polygons in your data's geographic location.

    Learn more about projected coordinate systems

  • Attribute values from the input feature classes will be copied to the output feature class. However, if the input is a layer or layers created by the Make Feature Layer tool and a field's Use Ratio Policy option is checked, a ratio of the input attribute value is calculated for the output attribute value. When Use Ratio Policy is checked, whenever a feature in an overlay operation is split, the attributes of the resulting features are a ratio of the attribute value of the input feature. The output value is based on the ratio into which the input feature geometry was divided. For example, If the input geometry was divided equally, each new feature's attribute value is assigned one-half of the input feature's attribute value. Use Ratio Policy only applies to numeric field types.

Syntax

SubdividePolygon_management (in_polygons, out_feature_class, method, {num_areas}, {target_area}, {target_width}, {split_angle}, {subdivision_type})
ParameterExplanationData Type
in_polygons

The polygon features to be subdivided.

Feature Layer
out_feature_class

The output feature class of subdivided polygons.

Feature Class
method

Specifies the method that will be used to divide the polygons.

  • NUMBER_OF_EQUAL_PARTS Polygons will be divided evenly into a number of parts. This is the default.
  • EQUAL_AREASPolygons will be divided into a specified number of parts of a certain area, and a remainder part.
String
num_areas
(Optional)

The number of areas into which the polygon will be divided if the NUMBER_OF_EQUAL_PARTS subdivision method is specified. The default is 5.

Long
target_area
(Optional)

The area of the equal parts if the EQUAL_AREAS subdivision method is specified. If the target_area is larger than the area of the input polygon, the polygon will not be subdivided. The default is 100000 square kilometers.

Areal Unit
target_width
(Optional)

This parameter is not yet supported.

Linear Unit
split_angle
(Optional)

The angle that will be used to draw the lines that divide the polygon. The default is 0.

Double
subdivision_type
(Optional)

Specifies how the polygons will be divided.

  • STRIPS Polygons will be divided into strips. This is the default.
  • STACKED_BLOCKSPolygons will be divided into stacked blocks.
String

Code sample

SubdividePolygon example 1 (Python window)

The following Python window script demonstrates how to use the SubdividePolygon tool in immediate mode.

import arcpy

arcpy.env.workspace = r"C:/data/project.gdb"
arcpy.SubdividePolygon_management(
    "studyarea", "subdivisions", "NUMBER_OF_EQUAL_PARTS", 10, "", "", 0, 
    "STRIPS")

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

Related topics