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 for the seed.
To generate consistent territories, use an integer value greater than or equal to 0.
Syntax
arcpy.td.SetTerritoryLevelOptions(in_territory_solution, level, {compactness}, {fill_extent}, {random_seed}, {spatial_relationship}, {buffer_tolerance})| Parameter | 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.
| 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.
| 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
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
Licensing information
- Basic: Requires Business Analyst
- Standard: Requires Business Analyst
- Advanced: Requires Business Analyst