Setup Level Capacity Constraints (Territory Design)

Summary

Tool allows setup level capacity constraints.

Usage

• Territory Level must be at format: Level_Name[Level_Index]

• Capacity Variables is optional parameter – "#" can be specified instead for remove balancing variables from specified level.

  • Capacity variables can be specified in format: Variable {Minimum} {Desired} {Maximum} Preference;...
  • Variable – name of any Summary-type field from Alignment Layer of specified Solution. Non-BDS layer’s variables have "_SUM" suffix (SUM calculator applied)
  • Minimum, Desired and Maximum are optional parameters and "#" can be specified instead of any of them, but at least one value must be specified
  • Minimum Capacity – territory must have at least specified value of the variable. CreateTerritories command automatically remove territories which have less value than specified
  • Desired Capacity – territory grows until the variable has specified value. Available range for this parameter is from Minimum Capacity to Maximum Capacity
  • Maximum Capacity – territory must stop growing if value of the variable will be exceeding specified value. Must be greater than Minimum Capacity
  • Preference must be specified for each variable. Valid range for each preference is from 0 to 100. Total sum of all preferences must be 100.

Syntax

SetupCapacityConstraints_TD_td (in_territory_solution_layer, in_level, {in_capacity_variables})

Parameter	Explanation	Data Type
in_territory_solution_layer	Territory Solution layer to setup parameters	GP TD Layer
in_level	Territory Level to modify	String
in_capacity_variables [in_capacity_variables,...] (Optional)	Capacity variables and preferences	GP Value Table

Code Sample

SetupCapacityConstraints_TD example (Python window)

The following Python window script demonstrates how to use the tool in immediate mode.

import arcgisscripting
gp = arcgisscripting.create()
gp.SetupCapacityConstraints_TD("new layer", "Territories[1]", "AREA_SUM 10000 # # 45;TOTPOP_CY_SUM # 3000000 5000000 55")

SetupCapacityConstraints_TD example 2 (stand-alone script)

l

The following stand-alone script demonstrates how to use the tool.

# Import system modules
import arcgisscripting
gp = arcgisscripting.create()

# Set local variables
solution = "new layer"
level = "Territories[1]"
capacityVars = "AREA_SUM 10000 # # 45;TOTPOP_CY_SUM # 3000000 5000000 55"

# Execute tool
gp.SetupCapacityConstraints_TD(solution, level, capacityVars)

Environments

This tool does not use any geoprocessing environments

Licensing Information

ArcGIS for Desktop Basic: Requires Business Analyst

ArcGIS for Desktop Standard: Requires Business Analyst

ArcGIS for Desktop Advanced: Requires Business Analyst