Solve Territories (Territory Design)

Available with Business Analyst license.

Summary

Creates and balances territories on the specified territory level provided the balancing variables are set.

Usage

  • The number of territories needs to be specified manually for the User Defined option.

  • Calculation of the optimal number of territories requires constraints to be set. Constraints can be based on a numeric value or a distance.

Syntax

arcpy.td.SolveTerritories(in_territory_solution, level, method, {number_territories}, {quality})
ParameterExplanationData Type
in_territory_solution

Territory solution used to solve territories.

Group Layer; Feature Dataset; String
level

Level used to solve territories.

String
method

Specifies the method used when calculating the number of territories.

  • USER_DEFINEDNumber of territories is user specified. This is the default.
  • OPTIMALNumber of territories is calculated automatically.
String
number_territories
(Optional)

Number of territories to be specified.

Long
quality
(Optional)

An integer between 1 and 200 that determines the performance of a solve operation. A lower value will provide better performance but quality may be lower. The default value is 100.

Long

Derived Output

NameExplanationData Type
out_territory_solution

The updated territory solution.

Group Layer

Code sample

SolveTerritories example (Python window)

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

import arcpy
arcpy.td.SolveTerritories("MyProject.gdb\Solution", "Territories[1]", "USER_DEFINED", 7, 100)

Environments

Licensing information

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

Related topics