Setup Level Balancing Variables (Territory Design)

Summary

Tool allows setup level balancing variables.

Usage

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

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

  • Balancing variables can be specified in format: Variable 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)
  • 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

SetupLevelBalancingVariables_TD_td (in_territory_solution_layer, in_level, {in_balance_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_balance_variables [in_balance_variables,...] (Optional)	Balancing variables and preferences	GP Value Table

Code Sample

SetupLevelBalancingVariables example (Python window)

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

import arcgisscripting
gp = arcgisscripting.create()
gp.SetupLevelBalancingVariables_TD("new layer", "Territories[1]", "AREA_SUM 45;TOTPOP_CY_SUM 55")

SetupLevelBalancingVariables example 2 (stand-alone script)

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]"
balanceVars = "AREA_SUM 45;TOTPOP_CY_SUM 55"

# Execute tool
gp.SetupLevelBalancingVariables_TD(solution, level, balanceVars)

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