Set Territory Attribute Constraints (Territory Design)

Available with Business Analyst license.


Sets variables for adding constraints when solving the territory solution.


  • Only variables that have been added to the level will be available.

  • Territories are constrained by Minimum, Maximum, or Ideal Value.

  • Set the Weight parameter to 100 if there is only one variable to be used for constraints.

  • The Weight parameter will be set if there are multiple variables.

  • The Maximum and Minimum parameter values are hard constraints. Territories will not exceed or be below the specified values.

  • The Ideal Value parameter is a soft constraint. Territories can exceed or be below the specified value.


SetTerritoryAttributeConstraints(in_territory_solution, level, {constraints})
ParameterExplanationData Type

The Territory Design solution layer to be used in the analysis

Group Layer; Feature Dataset; String

The level to which the constraints will be applied.

[[variable, minimum, maximum, ideal_value, weight],...]

The variables that will be used for constraining the territory solution.

  • variable—Numeric value to be used as the constraint.
  • minimum—Numeric value that sets a hard limit for the territories' lower bound.
  • maximum—Numeric value that sets a hard limit for the territories' upper bound.
  • ideal_value—Numeric value that sets a soft limit for the ideal value for the territory solution.
  • weight—The influence a constraint value has on the territory solution. The number must be greater than 0.
Value Table

Derived Output

NameExplanationData Type

The updated territory solution.

Group Layer

Code sample

SetTerritoryAttributeConstraints example (Python window)

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

import arcpy"TerritorySolution", "Territories[1]", "populationtotals_totpop_cy 10000 100000 # 100")

Licensing information

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

Related topics