Solve Territories (Territory Design)

Available with Business Analyst license.

Summary

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

Usage

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

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

Parameters

LabelExplanationData Type
Input Territory Solution

The territory solution that will be used to solve territories.

Group Layer; Feature Dataset; String
Level

The level that will be used to solve territories.

String
Number of Territories Method

Specifies the method that will be used to calculate the number of territories.

  • User Defined —The number of territories will be provided by the user. This is the default.
  • Optimal —The number of territories will be calculated automatically.
String
Number of Territories
(Optional)

The 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 affected. The default value is 100.

Long

Derived Output

LabelExplanationData Type
Updated Territory Solution

The updated territory solution.

Group Layer

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

The territory solution that will be used to solve territories.

Group Layer; Feature Dataset; String
level

The level that will be used to solve territories.

String
method

Specifies the method that will be used when calculating the number of territories.

  • USER_DEFINEDThe number of territories will be provided by the user. This is the default.
  • OPTIMALThe number of territories will be calculated automatically.
String
number_territories
(Optional)

The 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 affected. 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 function.

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