ArcMap

Setup Level Balancing Variables

Available with Business Analyst license.

Summary

Allows the setup of level balancing variables.

Usage

  • The Territory Level format is as follows: Level_Name[Level_Index]

  • Balancing Variables is an optional parameter. The pound sign, "#", may be specified to remove balancing variables from specified level.

    • Balancing variables can be specified in the following format: Variable Preference; ...
    • Variable – a name of any Summary-type field from an Alignment Layer for a specified Solution. Non-BDS layer’s variables have "_SUM" as a suffix (SUM calculator applied).
    • A preference must be specified for each variable. The range for each preference is from 0 to 100. The sum of all preferences must equal 100.

Syntax

arcpy.td.SetupLevelBalancingVariables_TD(in_territory_solution_layer, in_level, {in_balance_variables})
ParameterExplanationData Type
in_territory_solution_layer

The Territory Solution layer used to setup the parameters.

GP TD Layer
in_level

The Territory Level to modify.

String
in_balance_variables
[in_balance_variables,...]
(Optional)

The Balancing variable list 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

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

Related topics