Add Level Variables (Territory Design)

Available with Business Analyst license.

Summary

Adds a new field at the specified level.

Usage

  • Fields that are added will be based on a numeric field from the level below the territory level and will be calculated based on the type of statistic specified by the user.

  • The variable is added to any level above the base or alignment level [0].

  • All numeric fields are supported.

Syntax

arcpy.td.AddLevelVariables(in_territory_solution, level, base_level, variables)
ParameterExplanationData Type
in_territory_solution

The input territory solution.

Group Layer; Feature Dataset; String
level

The level to which the calculated field will be added.

String
base_level

The level below the territory level from which the attribute value will be added.

String
variables
[[statistic, statistic_field, field_name, field_alias_name],...]

The variables that will be added to the level.

  • statistic_field—Field for statistical calculation.
  • statistic—Type of statistical calculation.
    • count—Employs count in the derivation of the statistical calculation.
    • sum—Employs summation in the derivation of the statistical calculation.
    • maximum—Employs the maximum value in the derivation of the statistical calculation.
    • minimum—Employs the minimum value in the derivation of the statistical calculation.
    • average—Employs average in the derivation of the statistical calculation.
    • median—Employs the use of median techniques in the derivation of the statistical calculation.
    • standard_deviation—Employs standard deviation in the derivation of the statistical calculation.
    • percent_of_total—Employs percentage techniques in the derivation of the statistical calculation.
  • field_name—Valid name of the field on the level where calculated data will be stored.
  • field_alias_name—Readable and understandable name of the calculated field.
Value Table

Derived Output

NameExplanationData Type
out_territory_solution

The updated territory solution.

Group Layer

Code sample

AddLevelVariables example (Python window)

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

import arcpy
arcpy.td.AddLevelVariables("TD", "Territory[1]", "BaseLevel[0]", "populationtotals_totpop_cy SUM TotalPopulation 'Total Pop'")

Environments

Licensing information

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

Related topics