Set Territory Level Options (Territory Design)

Available with Business Analyst license.

Summary

Sets options for how territory levels are created.

Usage

• A Compactness parameter value of 100 is a circle where all parameters are satisfied.

• A low compactness value means variables and preferences are satisfied, but shape is compromised.

• The Fill Extent Automatically parameter assigns features to their closest territories regardless of the constraint parameters.

• By default, a random number generator is used to designate the seed value.

• The Random Number Generator Seed parameter uses the ACM-collected algorithm 599 algorithm to produce random territories. To generate consistent territories, use an integer value greater than or equal to 0.

Parameters

Dialog

Label	Explanation	Data Type
Input Territory Solution	The Territory Design solution layer that will be used in the analysis.	Group Layer; Feature Dataset; String
Level	The level to which the options will be applied.	String
Compactness (Optional)	A numeric value between 0 and 100 that defines the shape of territories.	Long
Fill Extent Automatically (Optional)	Specifies whether features are automatically assigned to the nearest territory. Checked—Features are automatically assigned to the nearest territory. Unchecked—Features are not automatically assigned to the nearest territory. This is the default.	Boolean
Random Number Generator Seed (Optional)	An integer used for the seed value. The default is no value and uses a random generator.	Long
Spatial Relationship (Optional)	Specifies the spatial relationship of how features are related to determine adjacency. Contiguity Edges Only—Polygon features that share a boundary or share a node with neighboring features.	String
Buffer Tolerance (Optional)	The distance between features to determine adjacency. Features that are within the buffer tolerance are considered adjacent features.	Linear Unit

Derived Output

Label	Explanation	Data Type
Updated Territory Solution	The updated territory solution.	Group Layer

Python

arcpy.td.SetTerritoryLevelOptions(in_territory_solution, level, {compactness}, {fill_extent}, {random_seed}, {spatial_relationship}, {buffer_tolerance})

Name	Explanation	Data Type
in_territory_solution	The Territory Design solution layer that will be used in the analysis.	Group Layer; Feature Dataset; String
level	The level to which the options will be applied.	String
compactness (Optional)	A numeric value between 0 and 100 that defines the shape of territories.	Long
fill_extent (Optional)	Specifies whether features are automatically assigned to the nearest territory. AUTO_FILL_EXTENT—Features are automatically assigned to the nearest territory. DO_NOT_AUTO_FILL_EXTENT—Features are not automatically assigned to the nearest territory. This is the default.	Boolean
random_seed (Optional)	An integer used for the seed value. The default is no value and uses a random generator.	Long
spatial_relationship (Optional)	Specifies the spatial relationship of how features are related to determine adjacency. CONTIGUITY_EDGES_ONLY—Polygon features that share a boundary or share a node with neighboring features.	String
buffer_tolerance (Optional)	The distance between features to determine adjacency. Features that are within the buffer tolerance are considered adjacent features.	Linear Unit

Derived Output

Name	Explanation	Data Type
out_territory_solution	The updated territory solution.	Group Layer

Code sample

SetTerritoryLevelOptions example (Python window)

The following Python window script demonstrates how to use the SetTerritoryLevelOptions tool.

import arcpy
arcpy.td.SetTerritoryLevelOptions("td", "Territories[1]", 75, "DO_NOT_AUTO_FILL_EXTENT", None, "CONTIGUITY_EDGES_ONLY", "20 DecimalDegrees")

Environments

Current Workspace, Data Source

Licensing information

• Basic: Requires Business Analyst
• Standard: Requires Business Analyst
• Advanced: Requires Business Analyst