Dice (Data Management)

License Level:BasicStandardAdvanced

Summary

Subdivides a feature into smaller features based on a specified vertex limit. This tool is intended as a way to subdivide extremely large features that cause issues with drawing, analysis, editing, and/or performance but are difficult to split up with standard editing and geoprocessing tools. This tool should not be used in any cases other than those where tools are failing to complete successfully due to the size of features.

Usage

Syntax

Dice_management (in_features, out_feature_class, vertex_limit)
ParameterExplanationData Type
in_features

The input feature class or feature layer. The geometry type must be multipoint, line, or polygon.

Feature Layer
out_feature_class

The output feature class of diced features.

Feature Class
vertex_limit

Features with geometries that exceed this vertex limit will be subdivided before being written to the output feature class.

Long

Code Sample

Dice example (Python window)

The following Python window script demonstrates how to use the Dice function in immediate mode.

import arcpy
from arcpy import env
env.workspace = "C:/data/gdb/thailand.gdb"
arcpy.Dice_management('thailandBoundary', 'thai_Dice_1mill', 1000000)
Dice example 2 (Stand-alone script)

The following stand-alone script is a simple example of how to apply the Dice function in scripting.

# Dice.py
# Description: Simple example showing use of Dice tool

 
# Import system modules
import arcpy
from arcpy import env
env.workspace = "C:/data/gdb/canada.gdb"

# Set variables
fcName = "coastline"
outFcName = "coastline_Dice_750k"
vertLimit = 750000

#Process: Use the Dice function
arcpy.Dice_management (fcName, outFcName, vertLimit)

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: No
ArcGIS for Desktop Standard: No
ArcGIS for Desktop Advanced: Yes
5/7/2015